# @emoo-ai/ui-react 中文文档

规范地址：https://npmcn.com/package/%40emoo-ai/ui-react/

版本：0\.1\.7
npm 元数据更新时间：2026-11-05T03:18:14.667Z
中文译文更新时间：2026-11-16T05:36:10.938Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40emoo-ai/ui-react
原文对照：https://npmcn.com/package/%40emoo-ai/ui-react/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：722 kB，119 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：19 个
- peer 依赖：react ^19\.2\.8，react-dom ^19\.2\.8
- 首次发布：2026-10-29T06:42:48.206Z
- 最新版本发布：2026-11-05T03:18:14.502Z
- 近 30 天下载量：1959（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

React 19 编译交付包：预编译样式 + 组件。宿主不需要 Tailwind、Sass 或任何 Vue/EP 工具链。

## 安装

```sh
npm install @emoo-ai/ui-react
```

也可以使用：`pnpm add @emoo-ai/ui-react`、`yarn add @emoo-ai/ui-react`、`bun add @emoo-ai/ui-react`

## README

# @emoo-ai/ ui- react

反应 19:++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++。

## 空虚

```ts
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、扫描 节点 模块 ^ Vue/EP.JS不注入样式,CSS必须显式导入。 → 反应/反应 DOM 等同,Radix、图标和工具依赖按 包.json安装。。

A. 数据位`buttonVariants` QQDialog 47. root, Trigger, Portal, Close, Overlay, Content, Header, Footer, Title, Description; Title/Description QQ。

## 尾风 4 +

QQ 尾风 QQ( 功能层), 组件层 。**\+ 层 +**飞行前基地:

```css
/* 先于组件 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 冲突。 */
```

\=================================================================================================`cn`\=============================================================================================================== (==================================================================。

## 门户网站

翻译: `.dark`时 `--emoo-*`; QQ/ 本地图集QQQ `--emoo-btn-solid-bg/color`{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我还得说 `--emoo-card-solid-bg`键。

· 传送器 `<DialogContent container={element}>` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `.dark`键。`closeLabel` 可注入本地化文案。

## 组件族

-   : 按钮/按钮组, 输入/文本/ NativeSelect; Field/InputGroup; 检查框/无线电组/开关/滑鼠/Slider/Select; Toggle/Tabs/Accordion。
-   147: Alert/Badge/Empty/EmptyValue、Skeleton/Spinner/Progress/Loading Overlay、Avatar、Toaster/toast。
-   。
-   :芯片/分块/分块/塔格斯输入/ValueDiff/HistoryList;-(atePicker/AmountInput/Spec field))-Upload-Datatable(TanStack表-封装)-SearchBox,NavMenu/NavSegmented,Sidebar Shell,GhostButton/ActionPill。
-   。

进取 + 4. Radix 值/ 最大值, +; CommandDialog + cmdk + 选择可清除的 + 占位符 + , 已失效 + 内容 + 容器 。

烤面包机主题 . dark . . . . . . . . 。

本包以编译产物方式发布,源码不随包。。

## 常见问题

### @emoo-ai/ui-react 是什么？

React 19 编译交付包：预编译样式 \+ 组件。宿主不需要 Tailwind、Sass 或任何 Vue/EP 工具链。

### 如何安装 @emoo-ai/ui-react？

在项目目录运行 npm install @emoo-ai/ui-react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.2\.8）、react-dom（^19\.2\.8）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @emoo-ai/ui-react 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @emoo-ai/ui-react 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @emoo-ai/ui-react 可以商用吗？

@emoo-ai/ui-react 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @emoo-ai/ui-react 的下载量有多少？

根据 npm 官方下载统计，@emoo-ai/ui-react 在 2026/10/14 – 2026/11/12 这 30 天内被下载 1,959 次，日均约 65 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @emoo-ai/ui-react 还在维护吗？

最新版本 0\.1\.7 发布于 2026/11/05（11 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

