# @duro-app/ui 中文文档

规范地址：https://npmcn.com/package/%40duro-app/ui/

版本：6\.1\.0
npm 元数据更新时间：2026-11-12T13:46:21.825Z
中文译文更新时间：2026-11-13T00:39:36.788Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40duro-app/ui
原文对照：https://npmcn.com/package/%40duro-app/ui/?lang=original
项目主页：https://github.com/fredericrous/duro-design-system
源码仓库：https://github.com/fredericrous/duro-design-system

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

- 包体积（解压后）：5.9 MB，1493 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：react ^19\.0\.0，effect ^3\.0\.0，react-dom ^19\.0\.0，react-native \>=0\.81\.0，react-hook-form ^7\.55\.0，react-native-svg ^15\.12\.0，react-strict-dom ^0\.0\.55，@hookform/resolvers ^5\.0\.0，@tanstack/react-table \>=8\.0\.0，react-native-worklets \>=0\.5\.0，react-native-reanimated \>=4\.1\.0，react-native-gesture-handler ^2\.28\.0，react-native-safe-area-context ^5\.6\.0
- 首次发布：2026-03-02T04:44:23.763Z
- 最新版本发布：2026-11-12T13:46:21.596Z
- 近 30 天下载量：6811（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：166（近 12 个月 166 个）

## 中文简介

杜罗的部件,用 [反应限制大小](https://github.com/facebook/react-strict-dom):网络和反应原生的一个源. 组成部分文件、道具和食谱: `npx @duro-app/cli <Name>`,或存储器的 `CLAUDE.md`。 。 。 .

## 安装

```sh
npm install @duro-app/ui
```

也可以使用：`pnpm add @duro-app/ui`、`yarn add @duro-app/ui`、`bun add @duro-app/ui`

## README

# @duro-app/ui (英语)

杜罗的部件,用 [反应限制大小](https://github.com/facebook/react-strict-dom)数字 : 用于网络和反应原生源。 文档、道具和 食谱 : `npx @duro-app/cli <Name>`,或存储器的 `CLAUDE.md`。 。 。 .

```sh
pnpm add @duro-app/ui @duro-app/tokens react-strict-dom react-hook-form
```

## 原生反应

Metro解决了软件包 `react-native` 导出条件到 `src/index.native.ts`,具有原生部件的一桶 变种 (`npx @duro-app/cli <Name>` 说 `native: true`(三); `@duro-app/ui/form` 决定: `src/form.native.ts`. bail - preset - expo 编译源代码.

**相会相会.** 地铁不树震, 所以在本地 每一个这些是 需要,尽管 npm 把它们列为可选(它们是网页构建的) 可选对等器 :

| 端点 | 对于 |
| --- | --- |
| `react-native` ≥ 0.81 | 平台 |
| `react-native-gesture-handler` ^2.28 (中文(简体) ) | 拖曳工作表, 托斯特刷相 |
| `react-native-reanimated` ≥ 4.1, `react-native-worklets` ≥ 0.5 | 手势和在 UI 线条上的 Spinner |
| `react-native-safe-area-context` ^ 5.6 (单位:千美元) | 套接字( 包含 `SafeAreaProvider`; 前路由器确实如此) |
| `react-native-svg` ^15.12 (中文(简体) ) | 图标和格言 |
| `react-hook-form` ^ 7.55 (中文(简体) ) | 字段绑定( 两个平台都需要的对等器) |
| `@hookform/resolvers` ^5, `effect` 页:1 | 仅限 `@duro-app/ui/form` |

**各取一册.** 决定 `react`, (中文(简体) ), `react-native`当地同龄人, `react-strict-dom`, (中文(简体) ), `react-hook-form`, (中文(简体) ), `@hookform/resolvers`, (中文(简体) ), `effect` 财务报告和审定财务报表 `@duro-app/*` 从应用程序,所以捆绑有一个反应渲染器和一个 反应限制度。 带有链接或工作空间副本的地铁Duro `resolveRequest` 解决了应用程序上的名字 `package.json` 这样做; `examples/native/metro.config.mjs` 在这个寄存器中是一.

**当地人不同.**

-   对话框、 绘图器、 菜单、 Popover 和 选择和Combox 工作表 一个RN `Modal`; Toast通过一个门户主机来绘制. 挂载 `PortalHost` 内置 a 土生土长的路由 土司在土生土长.
-   选择并打开下方工作表;工具提示不绘图并给出 文本到触发器作为无障碍提示.
-   A 类 `type="submit"` 内部按钮 `Form` 提交( 没有 DOM 提交) 活动).
-   没有箭头键:键盘导航是网络的;本地得到 屏幕阅读器角色和状态.

## 常见问题

### @duro-app/ui 是什么？

杜罗的部件,用 反应限制大小:网络和反应原生的一个源\. 组成部分文件、道具和食谱: npx @duro-app/cli \<Name\>,或存储器的 CLAUDE\.md。 。 。 \.

### 如何安装 @duro-app/ui？

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

### @duro-app/ui 支持 TypeScript 吗？

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

### @duro-app/ui 支持 ESM 还是 CommonJS？

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

### @duro-app/ui 可以商用吗？

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

### @duro-app/ui 的下载量有多少？

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

### @duro-app/ui 还在维护吗？

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