@digital-ai/dot-illustrations

中文文档
2.0.64发布于 2026/11/03SEE LICENSE IN <LICENSE.md>零依赖近 30 天下载 4777

设计团队保存插图和Dev团队找到插图的中心位置.

中文使用文档
文档目录14 节
  1. 目录
  2. 资产类型
  3. 浏览演示
  4. 使用插图
  5. 反应.. DotIllustration 通过 dot-components
  6. 标准 HTML
  7. 使用整合标志
  8. 反应.. DotIllustration 通过 dot-components
  9. 标准 HTML
  10. 使用任务图标
  11. 反应.. DotIllustration 通过 dot-components
  12. 标准 HTML
  13. 添加新插图或集成标志
  14. 解决问题

点与点

Digital.ai UX中央资产库——用于产品和文件的插图和集成标志.

📖 浏览演示 ~


目录


资产类型

类型文件夹主题反应组件
说明illustrations/light/ + 键 illustrations/dark/光+暗DotIllustration
整合标志integrations/单( 无暗变体)DotIllustration
任务图标tasks/单( 无暗变体)DotIllustration

整合标志和任务图标 DotIllustration,不是单独的 图标组件 - 与说明部分相同的部分,仅以 单主题 SVG 代替轻/暗对. 任务图标 属于新 (S-135988)-取自"点"的固定颜色管道/工作流程徽章图标 原子库( 图解节点) 27123-30795). 节点的15个图标中有13个在 范围(2个作为AI类排除在外)。 SVG已经到位. 见 tasks/README.md 身份认证.


浏览演示

https://digital-ai.github.io/dot-illustrations/demo/* (中文(简体) )* 联合国

演示让你:

  • 浏览 73个插图 (全球和板子), 114个整合标志,以及 13个任务图标 (任务部分)
  • 切换到 说明, (中文(简体) ), 一体化,以及 任务 使用搜索栏旁的切换器
  • 搜索 两节都有模糊的自动完成
  • 过滤插图 A-Z 类 (仅集成——114个标志受益于字母导航)
  • 单击任意一张牌 打开带有复制准备的代码片段的详细模式
  • 恒星项目 以便以你的喜好保存它们
  • 上传新插图或集成标志 从浏览器( 见 上传新(中文(简体) )

使用插图

反应.. DotIllustration 通过 dot-components

import { DotIllustration } from '@digital-ai/dot-components';

// Light (default)
<DotIllustration illustrationId="empty" />

// Dark
<DotIllustration illustrationId="done" theme="dark" />

// With tooltip
<DotIllustration illustrationId="features" tooltip="See all features" />

满 DotIllustration ∗∗∗

标准 HTML

<link rel="stylesheet" href="./index.css" />

<!-- Light theme -->
<span class="dot-illustration">
  <img class="done light" />
</span>

<!-- Dark theme -->
<span class="dot-illustration">
  <img class="done dark" />
</span>

总是设置清晰 width 财务报告和审定财务报表 height ——该图书馆没有内置的缩放默认值.


使用整合标志

反应.. DotIllustration 通过 dot-components

import { DotIllustration } from '@digital-ai/dot-components';
import '@digital-ai/dot-illustrations/integrations/index.css';

<DotIllustration illustrationId="jenkins" className="dot-integration" ariaLabel="Jenkins" />

工作间: DotIllustration 它不支持整合标志 拥有的。 它只装入根 index.css 并包入图像 .dot-illustration,但整合规则是 .dot-integration img.<id> 内 integrations/index.css。在您的应用程序中导入此文件一次并通过 className="dot-integration",将类添加到包装上。 无 两者,图像都是空的.

标准 HTML

<link rel="stylesheet" href="./integrations/index.css" />

<span class="dot-integration">
  <img class="jenkins" />
</span>

整合标志是: 仅一个主题 他们没有暗色的变体.


使用任务图标

反应.. DotIllustration 通过 dot-components

import { DotIllustration } from '@digital-ai/dot-components';

<DotIllustration illustrationId="task-manual" className="dot-task-icon" ariaLabel="Manual task" />

工作间: DotIllustration 不支持任务图标。 这个 将图像包入 .dot-illustration但是任务规则是 .dot-task-icon img.<id>他们生活在根部 index.css,哪个 dot-components 已经装入,所以通过 className="dot-task-icon" 实值 够了。 没有它,图像就变成空的.

标准 HTML

<link rel="stylesheet" href="./index.css" />

<span class="dot-task-icon">
  <img class="task-manual" />
</span>

任务图标是 仅一个主题 ——固定颜色徽章,无深色变体.

状态 : 任务段的船,有浏览/复制/装入UI的线条, 13个镜内图标ID, 以及他们的SVG都到位了 — 见 tasks/README.md。仍然开放:将这些内容作为真实内容出版 iconId单位 @digital-ai/dot-icons。 。 。 .


设计师分步指南: 文档/附加资产。它涵盖了插图、集成标志和任务图标: Figma 导出、文件、文件 illustrations.json 线条、支票和合并后发生的情况.

简而言之,每笔资产均在 illustrations.json,以及 npm run build 写入 index.css, (中文(简体) ), integrations/index.css,演示列表和 demo/descriptions.json 从它。 别用手来编辑.

  1. 在新分支上, 添加 SVG 文件 :

    仁爱文件大小
    说明illustrations/light/global/my-new-state.svg 财务报告和审定财务报表 illustrations/dark/global/my-new-state.svg (使用时 dashboards/ 用于仪表板插图)248×248 (磁盘 353×212)
    整合标志integrations/my-tool.svg40×40 (韩语)
    任务图标tasks/my-task-icon.svg40×40 (韩语)
  2. 添加一行到 illustrations.json,在其组的末尾(全球插图,仪表板插图,集成标志,然后是任务图标):

    {"id":"my-new-state","kind":"illustration","category":"global","label":"My new state","description":"This is the my-new-state illustration."},
    {"id":"my-tool","kind":"integration","category":null,"label":"My tool","description":null},
    {"id":"my-task-icon","kind":"task","category":null,"label":"My task icon task","description":null},
    

    ID是带有连字符的小写. label 是演示文稿复制的代码使用的 aria 标签 . category 财务报告和审定财务报表 description 仅用于插图.

  3. 运行构建(节点20或后期,不需要安装),测试和检查:

    npm run build
    npm test
    npm run check
    
  4. 提交SVG, illustrations.json 而文件的构建已更改。 打开拉动请求并张贴到 #点- 组件 在Slack审查.

在演示中上传新内容 进行第1步和第2步的交接,并在发送任何文件前检查每个文件和ID。 然后由审查员运行 npm run build 在它的分枝上,在合并之前推出。 它尚不能打开主机演示的拉出请求: digital-ai 该组织的OAuth App访问限制屏蔽了它的应用. 它的工作从当地 复制的演示与 node demo/local-proxy.js编辑 指南 有步骤.


解决问题

最新 dot-illustrations 未接获 dot-components

添加一个 resolutions 条目 package.json数字 :

"resolutions": {
  "@digital-ai/dot-illustrations": "latest"
}

未显示的集成图像

确保CSS的集成进口: <link rel="stylesheet" href="./integrations/index.css" />在反应中,也通过 className="dot-integration" (见 使用整合标志) (中文(简体) ). 图书馆使用 content: url() 打开 <img> 要素—— <img> 标记必须 没有 src 属性 班级必须准确匹配整合身份.


详情: 点设计系统-说明

版本与发布记录

@digital-ai/dot-illustrations 共发布 94 个版本,首次发布于 2024/03/13;过去 12 个月发布了 31 个版本。

版本发布日期距今
2.0.64latest2026/11/038 天前
2.0.632026/11/038 天前
2.0.622026/11/038 天前
2.0.612026/11/038 天前
2.0.592026/11/029 天前
2.0.602026/11/029 天前

关于 @digital-ai/dot-illustrations 的常见问题

@digital-ai/dot-illustrations 是什么?

设计团队保存插图和Dev团队找到插图的中心位置.

如何安装 @digital-ai/dot-illustrations?

在项目目录运行 npm install @digital-ai/dot-illustrations,或使用 pnpm add / yarn add / bun add。

@digital-ai/dot-illustrations 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/digital-ai__dot-illustrations 是否存在。

@digital-ai/dot-illustrations 可以商用吗?

@digital-ai/dot-illustrations 使用 SEE LICENSE IN <LICENSE.md> 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@digital-ai/dot-illustrations 的下载量有多少?

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

@digital-ai/dot-illustrations 还在维护吗?

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