@gitlab/duo-ui

中文文档
16.9.7发布于 2026/11/16MITTypeScriptESM + CJS近 30 天下载 23.2万

Duo UI 组件

中文使用文档
文档目录9 节
  1. 故事书
  2. 使用量
  3. 快速启动 - 开发
  4. 测试
  5. 单位测试
  6. 视觉回归测试
  7. 释放
  8. 贡献指南
  9. 问题

Duo UI (英语)

Duo UI是一个库,是所有Duo组件的所在地,它们由多个Host系统共享.

故事书

最新主要分支: https://gitlab-org.gitlab.io/duo-ui/ 页面存档备份,存于互联网档案馆

使用量

  1. 要在您的工程中使用 Duo UI, 请添加为依赖 :

    yarn add @gitlab/duo-ui
    

    说明: 确保同时安装 Duo UI 的对等依赖性 。 参见 package.json 用于对等关系依赖及其预期版本的列表.

快速启动 - 开发

说明: Duo UI不是设计在Windows本土上建造的. 无论是 WSL 维基月球 或者说 GitPod 图像 可用于设置 类似UNIX的环境来建造它.

确保你有 节点 16.x(LTS)和 雅伦 1.22 联合国 或更新.

# Clone the project
git clone [email protected]:gitlab-org/duo-ui.git

# Navigate to the root of the project
cd duo-ui

# Install all the dependencies of the project
yarn # or yarn install

# Build and launch storybook to see the components in the browser
yarn storybook

转到 http://localhost:9001/ (英语)

测试

单位测试

组件单位测试在 tests/components测试按以下顺序进行: 用于组织组件的目录结构.

  • yarn test:unit 运行所有单位测试.

  • yarn test:unit:watch 在监视模式下运行所有单元测试.

  • yarn test:unit:debug 运行所有单元测试,并允许将调试器附加到测试跑道中.

  • yarn jest [name_pattern] 运行符合指定名称模式的 spec 文件.

实例

  • yarn jest datepicker 将所有 spec 文件匹配到包含单词的名称 选取日期。 。 。 .

  • yarn jest datepicker -t "when draw event is emitted" 更远一步,只进行测试 带有一个符合向 t 旗帜.

视觉回归测试

Duo UI 使用可视快照测试来防止带 CSS 和 组件的布局变化。 更多关于这一点,请在 视觉测试文件。 。 。 .

释放

见 更新 Duo UI 软件包 如何使用 @gitlab/duo-ui 在各种项目中不断更新软件包.

贡献指南

请参考 捐款额 详细介绍如何添加新的组件和 普遍向Duo UI捐款.

问题

有问题吗? 看看我们 财务问题你也许能找到答案.

版本与发布记录

@gitlab/duo-ui 共发布 287 个版本,首次发布于 2024/10/25;过去 12 个月发布了 126 个版本。

版本发布日期距今
16.9.7latest2026/11/16今天
16.9.62026/11/123 天前
16.9.52026/11/0610 天前
16.9.42026/11/0511 天前
16.9.32026/11/0412 天前
16.9.22026/11/0313 天前

关于 @gitlab/duo-ui 的常见问题

@gitlab/duo-ui 是什么?

Duo UI 组件

如何安装 @gitlab/duo-ui?

在项目目录运行 npm install @gitlab/duo-ui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:vue(^2.7.16)、pikaday(^1.8.0)、bootstrap(>=4.5.3 <=4.6.2)、dompurify(>=2.5.2 <3.0.0 || >=3.1.2)、@gitlab/ui(>=112.3.1)、emoji-regex(>=10.0.0)、tailwindcss(^3)、@gitlab/svgs(^1.116.0 || ^2.0.0 || ^3.0.0)、highlight.js(>=11.0.0 <12.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gitlab/duo-ui 支持 TypeScript 吗?

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

@gitlab/duo-ui 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gitlab/duo-ui 可以商用吗?

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

@gitlab/duo-ui 的下载量有多少?

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

@gitlab/duo-ui 还在维护吗?

最新版本 16.9.7 发布于 2026/11/16(今天);至今共发布 287 个版本,其中过去 12 个月发布了 126 个;首次发布于 2024/10/25。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。