# alien-ui-react **Repository Path**: mirrors_alienzhou/alien-ui-react ## Basic Information - **Project Name**: alien-ui-react - **Description**: a set of UI components for react - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-10-22 - **Last Updated**: 2026-10-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # alien-ui-react 一套给 React 18 用的组件库,视觉上延续 2016 年那版的珊瑚色 `#f59176` 和青绿点缀 `#7cb2ad`。 ## 环境 - Node.js >= 18 - 包管理器用 npm ## 命令 ```bash npm install npm run dev # 打开 playground,默认 http://localhost:5173 npm test # vitest run npm run typecheck # tsc --noEmit npm run build # 产物在 dist/ npm run storybook # 组件 story,端口 6006 ``` ## 在项目里用 把 React 18 装在你自己的依赖里。这个包只提供组件,不会把 React 打进 bundle。 ```tsx import { Button, Textbox } from 'alien-ui-react'; import 'alien-ui-react/style.css'; export function Example() { return ; } ``` `package.json` 的 `exports` 暴露了入口 `.` 和样式 `./style.css`。构建结果是 ESM,并带有 `dist/index.d.ts`。 ## 组件 | 组件 | 作用 | | --- | --- | | Header | 标题条,`text`、`fontSize` | | Textbox | 文本输入,`value` / `onChange` | | Radio | 单选组 | | Checkbox | 多选组 | | Combobox | 可过滤的单选或多选,点外部关闭 | | Slider | 拖拽滑条,`min` / `max` / `step` | | Spinner | 数值步进 | | Toggle | 开关,`checked` / `onChange` | | Datebox | 日期选择,值为 `YYYY-MM-DD` | | Searchbox | 搜索框,回车或点击触发 `onSearch` | | Button | `primary` / `default` / `text` | | Form、FormItem | 字段注册和提交校验,不依赖第三方表单库 | | Select | 单选下拉 | | Modal | 弹层,Esc 和点击遮罩关闭 | | Toast | `toast.success` / `error` / `info` / `warning`,需要 `ToastProvider` | | Tooltip | 悬停或聚焦显示,`placement` 为 `top` 或 `bottom` | | Tabs | 页签,方向键切换 | | Table | 表格和空状态 | | Pagination | 分页 | | Row、Col | 24 栅格,`Col` 的 `span` 为 1–24 | | Card | 带标题的卡片 | 输入类组件同时支持受控 `value` 和非受控 `defaultValue`。布尔值用 `boolean`,不要再传 `'true'` / `'false'`。