@emoo-ai/ui-react
React 19 编译交付包:预编译样式 + 组件。宿主不需要 Tailwind、Sass 或任何 Vue/EP 工具链。
使用
import '@emoo-ai/brand/tokens.css'
import '@emoo-ai/ui-react/styles.css'
import { Button, Dialog, DialogTrigger, DialogContent, DialogTitle, DialogDescription } from '@emoo-ai/ui-react'
不需要 Tailwind、Sass、扫描 node_modules 或安装 Vue/EP。JS 不注入样式,CSS 必须显式导入。React/React DOM 为 peers,Radix、图标和工具依赖按 package.json 安装。
Button 保留原生 ref/props、asChild、variant/size/shape 和 data-slot;buttonVariants 可独立生成同样的预编译工具类。Dialog 提供 Root、Trigger、Portal、Close、Overlay、Content、Header、Footer、Title、Description;Title/Description 必须由调用方按语义提供。
Tailwind 4 共存
组件使用包内预编译的 Tailwind 工具类(utilities layer),最小原生基线放在 components layer。必须先建立 layer 顺序,否则后加载的 preflight base 层可能压过库样式:
/* 先于组件 CSS 引入;可作为应用统一 CSS 入口。 */
@layer theme, base, components, utilities;
@import 'tailwindcss';
@import '@emoo-ai/brand/tokens.css';
@import '@emoo-ai/ui-react/styles.css';
/* 宿主覆盖最后;同为 utility 层时后写规则胜,cn 处理组件自身 className 冲突。 */
也可先导入只声明上述顺序的 layers.css,再从 JS 分别导入样式。库本身不带 preflight,所需工具类已预编译,不要求宿主扫描源码,不写全局 reset;cn/twMerge 不替代正确的 CSS 级联。
主题和 portal
宿主在 html 切换 .dark,或覆盖相应 --emoo-*;库不管理系统主题/localStorage。实心按钮使用 --emoo-btn-solid-bg/color,焦点使用品牌强调色,不把全部 primary 机械改为紫色。Dialog 使用不透明 --emoo-card-solid-bg。
默认 Portal 到 body,继承根 token;局部白标变量必须把 <DialogContent container={element}> 放进主题容器,保证继承。局部容器只覆盖指定变量,不代表 brand 自动支持嵌套 .dark。closeLabel 可注入本地化文案。
组件族
- 基础:Button/ButtonGroup、Input/Textarea/NativeSelect、Field/InputGroup、Checkbox/RadioGroup/Switch/Slider/Select、Toggle/Tabs/Accordion。
- 反馈:Alert/Badge/Empty/EmptyValue、Skeleton/Spinner/Progress/LoadingOverlay、Avatar、Toaster/toast。
- 浮层:Dialog/AlertDialog/Sheet/Drawer(Vaul)/Popover/Tooltip/HoverCard/DropdownMenu/ContextMenu/Command。
- 复合件:Chips/Segmented/TagsInput/ValueDiff/HistoryList;表单字段(DatePicker/AmountInput/SpecField)、Upload、DataTable(TanStack Table 封装,支持虚拟滚动)、SearchBox、NavMenu/NavSegmented、SidebarShell、GhostButton/ActionPill。
- 框架原语:Direction/AspectRatio/Resizable/ScrollArea/InputOTP、Card/Item/Kbd/Separator/Pagination/Attachment。
Progress 向 Radix 传递真实 value/max,非有限值为不确定态;CommandDialog 自带 cmdk 根上下文。Select clearable 维持受控清空与 placeholder 协议,disabled 不可清空。浮层 Content 可选 container。
Toaster 可传 theme,缺省观察根 .dark,不保存偏好。Sonner/Vaul 等第三方组件可能自行注入其上游运行时样式;本包 Tailwind 样式仍须显式导入。默认文案暂为中文/英文两套,不宣称完整 i18n。
本包以编译产物方式发布,源码不随包。