@gener8v/icons

中文文档
0.64.0发布于 2026/11/10MITTypeScriptES Module零依赖近 30 天下载 4872

GENER8V设计系统实际使用的Phosphor子集,作为可树震动反应组件.

中文使用文档
文档目录15 节
  1. 安装
  2. 使用
  3. 图标
  4. 行动
  5. 导航
  6. 状态
  7. 记录
  8. 通讯
  9. 人员和代理人
  10. 访问
  11. 理由
  12. 施政
  13. 添加图标
  14. 为什么是子集
  15. 与其他软件包的关系

@ gener8v/相册

GENER8V设计系统使用的图标,取自 磷酸盐 时间 常重并被作为可树震动反应组件运出.

安装

npm i @gener8v/icons

根据麻省理工学院的许可,该包在npm上公开. 它需要回放 18 或以后,没有别的.

使用

import { ArrowRight, Warning } from '@gener8v/icons';

<button className="btn btn-primary">Continue<ArrowRight /></button>

每个图标取出普通的SVG道具并遵循三个规则:

  • 大小来自文字. 图标是 1em 方形,所以它们和周围的类型相符. 内部 .btn 中央支助组 1.15em因此,每个按钮大小都有一个图标。 设置大小 直接通过 width 财务报告和审定财务报表 height。 。 。 .
  • 颜色来自文本. 填满是 currentColor。图标永远不会获得自己的颜色 符号,所以同样的格莱弗在轻卡上和被填充的按钮内工作.
  • 默认隐藏在屏幕阅读器中 . 标签旁边的图标是装饰 aria-hidden。通过 aria-label 当圣像必须自立时 对于一个只有图标的按钮, 使用情况 <Button iconOnly aria-label="…"> 从 @gener8v/ui,这就要求标签.

图标

每个图标在GENER8V产品中有一个含义. 用它来表达这个意思,所以它读的一样 每一个屏幕。 演示页 design/foundations/icons.html 显示相同的设定; 盘旋图标 看它是为了什么.

68个偶像分9组.

行动

一个人对屏幕上的东西做的事.

图标磷酸盐源用它来
ArrowsDownUparrows-down-up更改列表的顺序 。 一个列的当前方向是 CaretUp 或者说 CaretDown。 。 。 .
ArrowSquareOutarrow-square-out离开产品:在别的地方打开,通常在新标签中. 从来没有一个链接 留在记录.
Copycopy复制一个值到剪贴板上——一个ID,一个链接,一个片段——而不离开表面.
DotsThreedots-three更多的是菜单而不是页面.
DownloadSimpledownload-simple从记录中取出一些东西 像别人保存的文件一样.
Funnelfunnel缩小列表显示的内容. 记录保留;只有视图改变.
Linklink-simple一件事情与另一件事情结合在一起——这是与事实相对抗的,来源于事实.
MagnifyingGlassmagnifying-glass已经在这里找到一些东西了 而不是问一个问题.
Minusminus拿走一个 或降低一个值 对应方为: Plus。 。 。 .
PencilSimplepencil-simple编辑已经存在的东西 . Note 这是有人写的字条,这是改变字条的行为.
Plusplus再加一个表面已经列出的东西.
Trashtrash删取一物为好. 一种保存历史档案或取代历史档案的产品,而不提供这种资料.
UploadSimpleupload-simple将材料放入记录.
Xx关闭或解雇。 从不删除——即 Trash。 。 。 .

导航

移动在表面之间,打开被折叠的东西.

图标磷酸盐源用它来
ArrowLeftarrow-left从地上回到打开它的地上——导航 CaretLeft 从未使用.
ArrowRightarrow-right前进,在控制 继续的东西 而不是确认它.
CaretDowncaret-down一组打开。 每一个地方都一样的chevron, 所以国家读相同.
CaretLeftcaret-left退后,在一个集合之内——一页,一步. 永远不要从地表航行.
CaretRightcaret-right一组关闭, 和铁路项目 引向某处.
CaretUpcaret-up打开并关闭点击的组合, 以及某类的升起端 .
Househouse产品的起步:每个地表都能返回的地方.
Listlist导航在窄屏幕上折叠而去。 不是记录清单——这就是内容,也不是控制.
Settingssliders-horizontal设置:产品如何配置,与其持有的内容相对.

状态

某事的状态,可以一眼看.

图标磷酸盐源用它来
Bellbell这个人还没有看到的新东西 通知 页面上没有留言.
Checkcheck完成,或选择。 永远不要"好"——一个被包涵的要求不是赞美.
CheckCirclecheck-circle以状态成功完成 . Check 标记完成或选择;圆使其成为结果.
CircleNotchcircle-notch运行,作为一个状态标签。 装入的控件使用自旋器, 其动画化; 此 glyph 不 .
Flagflag-pennant划上旗子而不是解决——一个矛盾,一个被搁置的公开决定被触动.
Infoinfo值得我们知道的东西 没有什么改变。 永远不要用更安静的颜色警告.
Questionquestion帮助,或者什么尚未回答。 从来没有 Info 以伪装.
Warningwarning出事了,总得有人行动 从来没有用过缺席.
XCirclex-circle失败,作为一个状态. X 关闭或解职;圆会使它成为结果.

记录

记录中的东西.

图标磷酸盐源用它来
Booksbooks模块:该项目对照治理库进行衡量.
CalendarBlankcalendar-blank日期——到期、排定、举行——与时间长度相对应.
ChartBarchart-bar以图表方式绘制的数字:报告、衡量标准. Graph 事情是这样结合的,这是多少.
Clockclock东西需要多久,或者白天. History 这是记录的过去,这是时间本身.
Coveragelist-checks标准要求什么,涵盖多少.
Filefile记录上的文件——上传、提供或引用.
Folderfolder与一份文件相比,文件保存地点.
Graphgraph记录为外形:什么与什么结合.
Historyclock-counter-clockwise这个项目是怎么变成那样的 而不是现在的真相.
Imageimage证据就是一张图片——一张截图,一张有人寄来的图表.
Notenote-pencil一个人写下来的东西, 除了上传的东西.
Paperclippaperclip某件东西附在一件物品上,与记录上的文件相对应.
Pathpath通向的路线——一行一行,一行一行.
Tagtag一个人申请的分类标签 不是系统决定的状态.

通讯

人们说的话和它穿过的通道.

图标磷酸盐源用它来
ChatCirclechat-circle关于作品的评论线. Transcript 这是在一次会议上说过的话;这是人们后来所说的工作.
EnvelopeSimpleenvelope-simple电子邮件:发送到产品外的收件箱中或外出的信息.
Microphonemicrophone-stage一个声音:一个采访,一个会话,一个说话的人.
Transcriptchat-teardrop-text所说的话,写下来的——一个编码会话.

人员和代理人

谁干的活 特工从不被引为人.

图标磷酸盐源用它来
Buildingsbuildings一个组织——一个客户,一个供应商,一个参与工作的一方——反对其中的人.
Robotrobot一个特工 与人相分出,故意而无所出.
Sparklesparkle由模特儿起草并等一个人. 标记输出; Robot 是制造它的代理人.
UserCircleuser-circle一个人,一个人的名字不会读作一个人.
Usersusers一群人——一个团队,一个目录. 一个人 UserCircle。 。 。 .

访问

签名,什么是私人的.

图标磷酸盐源用它来
Keykey一个证书 脚本使用, 没有人签名.
Locklock属于它的私人项目.
SignInsign-in签名,在登录屏幕及其按钮上.
SignOutsign-out有意签出. 不,对于一个过期的会话.

理由

观察可以基于以下三个理由:说、观察、推断.

图标磷酸盐源用它来
Eyeeye央视:已见出事来,或有文件显示. 以相为一为三因.
Inferredlightbulb-filament推断:从所说的话中得出结论。 无论观察结果如何,这个标签都必须贴上.
Quotesquotes说:有人说了. 以相为一为三因.

施政

规则是否生效, 和什么已经移动到它下面.

图标磷酸盐源用它来
ArrowsClockwisearrows-clockwiseStale:在重建中等待工作,因为它依赖于改变的东西。 其他图标集称为此 RefreshCw。 。 。 .
GitDiffgit-diff在做出反对的决定之下,一项标准发生了变化。 其他图标集称为此 GitCompareArrows。 。 。 .
Governedshield-check生效。 正在应用一条规则的模块.
Scalesscales通过权衡证据作出的判决——评估,裁定.
Shelvedbookmark-simple已编写,未生效——架上.
Stampstamp批准:名人签名.

添加图标

  1. 先从上面的表格中看 如果图标已经覆盖了含义,请使用.
  2. 查找 Phosphoor 中的格言 常设经常 重量。 不使用其他重量:一个中两个重量 界面看起来像两个图标集.
  3. 复制已有文件到 src/ 改为 src/<Name>.tsx 和粘贴 在glyph's path。 。 。 .
  4. 在博士评论中,给Phosphor 名字,一个句子说明图标的意思 @group 从上表.
  5. 导出它从 src/index.ts。 。 。 .
  6. 运行 pnpm build 从寄存器根。 更新此文件中的表格和演示 页 次.
  7. 运行 pnpm test。如果一个图标不导出,没有说明的含义或组,则测试失败,或者 正在丢失此文件或演示页.

名称. 使用 Phosphor 名称( ưμ㼯A)MagnifyingGlass, (中文(简体) ), ArrowsClockwise除非图标代表 一个产品概念。 那就为这个概念命名: Governed 是磷酸盐 shield-check,以及 Inferred 实值 lightbulb-filament。 。 。 .

为什么是子集

磷脂有大约1500个图标. 一种设计系统,所有产品都由船载运 取出一千五百格来画出几十个. 此集持有 GENER8V 产品所需的图标, 它正在增长 当一个产品需要一个新的.

与其他软件包的关系

此软件包不依赖于 @gener8v/ui 或者说 @gener8v/tokens设计系统的静态 HTML 页面没有捆绑器,因此它们会插入相同的SVG路径而不是导入此软件包.

版本与发布记录

@gener8v/icons 共发布 80 个版本,首次发布于 2026/08/24;过去 12 个月发布了 80 个版本。

版本发布日期距今
0.64.0latest2026/11/106 天前
0.63.02026/11/0511 天前
0.62.02026/11/0511 天前
0.61.02026/11/0411 天前
0.60.02026/11/0412 天前
0.59.12026/11/0312 天前

关于 @gener8v/icons 的常见问题

@gener8v/icons 是什么?

GENER8V设计系统实际使用的Phosphor子集,作为可树震动反应组件.

如何安装 @gener8v/icons?

在项目目录运行 npm install @gener8v/icons,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(>=18)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gener8v/icons 支持 TypeScript 吗?

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

@gener8v/icons 支持 ESM 还是 CommonJS?

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

@gener8v/icons 可以商用吗?

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

@gener8v/icons 的下载量有多少?

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

@gener8v/icons 还在维护吗?

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