# @db-ui/base 中文文档 规范地址：https://npmcn.com/package/%40db-ui/base/ 版本：0\.29\.4 npm 元数据更新时间：2025-11-08T22:00:31.899Z 中文译文更新时间：2026-11-11T19:10:37.631Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40db-ui/base 原文对照：https://npmcn.com/package/%40db-ui/base/?lang=original 项目主页：https://db-ui.github.io/base/ 源码仓库：https://github.com/db-ui/base ## 关键信息（来自 npm 元数据） - 包体积（解压后）：10.2 MB，6603 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - 运行依赖：0 个 - 首次发布：2022-05-06T16:14:38.943Z - 最新版本发布：2025-11-08T22:00:31.447Z - 近 30 天下载量：4524（2026-10-12 至 2026-11-10，npm 官方下载统计） - 已发布版本数：79（近 12 个月 0 个） ## 中文简介 以DB设计系统为基础提供基本标志和资产. ## 安装 ```sh npm install @db-ui/base ``` 也可以使用：`pnpm add @db-ui/base`、`yarn add @db-ui/base`、`bun add @db-ui/base` ## README # DB UI 基础 [![REUSE status](https://api.reuse.software/badge/github.com/db-ui/base)](https://api.reuse.software/info/github.com/db-ui/base) [![REUSE Compliance Check](https://github.com/db-ui/base/actions/workflows/99-reuse-compliance-check.yml/badge.svg)](https://github.com/db-ui/base/actions/workflows/99-reuse-compliance-check.yml) 创建版权许可说明( L) [真实的](https://git.fsfe.org/reuse/tool) > \[大 我们发布了新的稳定版本 [DB UX 设计系统 v3](https://github.com/db-ux-design-system/core-web),它是这代DB设计系统的后继. 特别是对于新项目,我们强烈建议: [DB UX 设计系统 v3](https://github.com/db-ux-design-system/core-web)。 。 。 . 新版本有一些巨大的好处和优化,特别是在无障碍测试,进一步更好的框架支持和持续开发方面. > 请注意,从现在开始我们不会提供任何新的功能,只有bug修正直到2026年底的EOL. 带有 DB UI 基础,我们提供基础 设计托肯斯和资产基于 [DB UX 设计系统 v2](https://marketingportal.extranet.deutschebahn.com/marketingportal/Design-Anwendungen/db-ux-design-system/version-2/Components),可以在网络和本地应用项目中共享. 要了解更多情况,请看看我们 [主机模板b](https://db-ui.github.io/base/)。 。 。 . ## 德国Bahn品牌 由于我们想在用户和客户的数码旅程中完美地支持他们,使用德乙品牌和商标,即使在使用我们提供的这个产品代码时,也必然有明确的指导方针和限制;德乙完全保留了对德乙品牌的所有权利和所有权,尽管我们正在提供DB UI产品的代码,在Apache 2.0许可下可以自由使用并发布. 请看看我们 [品牌门户](https://marketingportal.extranet.deutschebahn.com/) 就任何品牌问题与谁联系。 由于这些资产和视觉指南是从我们德国Bahn营销门户上收回的,你同意 [(原始内容存档于2013-10-12). Algemeine Nutzungsbedingungen für das DB-Marketingportal (german)](https://marketingportal.extranet.deutschebahn.com/marketingportal/Nutzungsbedingungen-9702684#) 以防使用它们. 对于Deutsche Bahn网站和应用程序以外的任何用途,您必须删除或替换任何Deutsche Bahn品牌和设计资产以及受保护的特征和商标。 我们甚至还计划提供一个中立的主题,使你不用德乙的商标就能更容易地使用我们的产品. 这尤其涉及到目录中的文件 `/assets/` 财务报告和审定财务报表 `source/images` 财务报告和审定财务报表 `source/favicon.ico` 还有. ## 如何消费 ### 常规 `npm` 上下文 安装 DB UI 这样的基础: ```bash npm i -save @db-ui/base ``` #### 尾风 根据您的框架安装尾风 : [安装](https://tailwindcsscom/docs/installation)但是别用 `npx tailwindcss init`。 。 。 . 相反, 在您的工程中运行此命令 : ```bash node ./node_modules/@db-ui/base/build/tailwind/tailwind-config-generator.mjs ``` 这将创建您的 `tailwind.config.js`。 。 。 . * * * 如果您不想有一个自定义配置, 您也可以通过运行使用默认的尾风配置 : ```bash node ./node_modules/@db-ui/base/build/tailwind/tailwind-config-generator.mjs default ``` * * * 配置包含所有颜色,字体和间隔. 请检查date=中的日期值 (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助(帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助) (帮助). ## 如何发挥作用/贡献 发言非常受欢迎,请参看 [捐款指南](https://npmcn.com/package/%40db-ui/base/CONTRIBUTING.md)。 。 。 . 所有风格标志和资产都在这个包中. 做任何修改以满足你的需要。 这个软件包有iOS,Android,和网络代码,并基于 [亚马逊风格词典](https://amzn.github.io/style-dictionary/) 完整实例. 要开始,就跑 ```shell npm install npm run build ``` 这个 `npm build` 任务是指为每个平台生成文件而执行样式词典的构建步骤。 每次在样式词典中更改某事,如改变颜色或添加符号,你都必须再次运行这个命令来生成文件. ## 第三方承认! - [由 opr.vc 打开隐私](https://opr.vc/) ## 行为守则 作为成员、贡献者和领导人,我们保证参与我们的工作 人人无骚扰的体验 [《公约》的行为守则](https://npmcn.com/package/%40db-ui/base/CODE-OF-CONDUCT.md)。 。 。 . ## 许可证 DB源代码根据Apache许可证,2.0版,2004年1月获得许可; 您不得使用此文件,除非符合许可证。 你可以拿到一份副本 apache 许可证 [https://apache.org/licenses/LICENSE-2.0 (英语)](https://apache.org/licenses/LICENSE-2.0)。DB 源代码 不包括任何DB特定设计资产,如字体,图标,商标,品牌等. [Apache 2.0 许可证](https://npmcn.com/package/%40db-ui/base/LICENSES/Apache-2.0.txt) 所有Deutsche Bahn AG(下称“DB”)的具体设计资产,如字体、图标、, 商标、品牌等(以下简称“DB设计”)的许可如下: 许可证协议(“DB设计许可证”) [DB 设计许可证](https://npmcn.com/package/%40db-ui/base/LICENSES/LicenseRef-DB-Designs-License.txt) ## 常见问题 ### @db-ui/base 是什么？ 以DB设计系统为基础提供基本标志和资产\. ### 如何安装 @db-ui/base？ 在项目目录运行 npm install @db-ui/base，或使用 pnpm add / yarn add / bun add。 ### @db-ui/base 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/db-ui\_\_base 是否存在。 ### @db-ui/base 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @db-ui/base 可以商用吗？ @db-ui/base 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @db-ui/base 的下载量有多少？ 根据 npm 官方下载统计，@db-ui/base 在 2026/10/12 – 2026/11/10 这 30 天内被下载 4,524 次，日均约 151 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @db-ui/base 还在维护吗？ 最新版本 0\.29\.4 发布于 2025/11/09（1 年前）；至今共发布 79 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/05/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。