# @gener8v/icons 中文文档

规范地址：https://npmcn.com/package/%40gener8v/icons/

版本：0\.64\.0
npm 元数据更新时间：2026-11-09T17:08:53.057Z
中文译文更新时间：2026-11-16T02:56:41.550Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gener8v/icons
原文对照：https://npmcn.com/package/%40gener8v/icons/?lang=original
项目主页：https://github.com/gener8v/gener8v.designer.design-system#readme
源码仓库：https://github.com/gener8v/gener8v.designer.design-system

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

- 包体积（解压后）：93.6 kB，140 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react \>=18
- 首次发布：2026-08-24T13:57:22.681Z
- 最新版本发布：2026-11-09T17:08:52.872Z
- 近 30 天下载量：4872（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：80（近 12 个月 80 个）

## 中文简介

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

## 安装

```sh
npm install @gener8v/icons
```

也可以使用：`pnpm add @gener8v/icons`、`yarn add @gener8v/icons`、`bun add @gener8v/icons`

## README

# @ gener8v/相册

GENER8V设计系统使用的图标,取自 [磷酸盐](https://phosphoricons.com/) 时间 常重并被作为可树震动反应组件运出.

## 安装

```bash
npm i @gener8v/icons
```

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

## 使用

```tsx
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组.

### 行动

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

| 图标 | 磷酸盐源 | 用它来 |
| --- | --- | --- |
| `ArrowsDownUp` | `arrows-down-up` | 更改列表的顺序 。 一个列的当前方向是 `CaretUp` 或者说 `CaretDown`。 。 。 . |
| `ArrowSquareOut` | `arrow-square-out` | 离开产品:在别的地方打开,通常在新标签中. 从来没有一个链接 留在记录. |
| `Copy` | `copy` | 复制一个值到剪贴板上——一个ID,一个链接,一个片段——而不离开表面. |
| `DotsThree` | `dots-three` | 更多的是菜单而不是页面. |
| `DownloadSimple` | `download-simple` | 从记录中取出一些东西 像别人保存的文件一样. |
| `Funnel` | `funnel` | 缩小列表显示的内容. 记录保留;只有视图改变. |
| `Link` | `link-simple` | 一件事情与另一件事情结合在一起——这是与事实相对抗的,来源于事实. |
| `MagnifyingGlass` | `magnifying-glass` | 已经在这里找到一些东西了 而不是问一个问题. |
| `Minus` | `minus` | 拿走一个 或降低一个值 对应方为: `Plus`。 。 。 . |
| `PencilSimple` | `pencil-simple` | 编辑已经存在的东西 . `Note` 这是有人写的字条,这是改变字条的行为. |
| `Plus` | `plus` | 再加一个表面已经列出的东西. |
| `Trash` | `trash` | 删取一物为好. 一种保存历史档案或取代历史档案的产品,而不提供这种资料. |
| `UploadSimple` | `upload-simple` | 将材料放入记录. |
| `X` | `x` | 关闭或解雇。 从不删除——即 `Trash`。 。 。 . |

### 导航

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

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

### 状态

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

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

### 记录

记录中的东西.

| 图标 | 磷酸盐源 | 用它来 |
| --- | --- | --- |
| `Books` | `books` | 模块:该项目对照治理库进行衡量. |
| `CalendarBlank` | `calendar-blank` | 日期——到期、排定、举行——与时间长度相对应. |
| `ChartBar` | `chart-bar` | 以图表方式绘制的数字:报告、衡量标准. `Graph` 事情是这样结合的,这是多少. |
| `Clock` | `clock` | 东西需要多久,或者白天. `History` 这是记录的过去,这是时间本身. |
| `Coverage` | `list-checks` | 标准要求什么,涵盖多少. |
| `File` | `file` | 记录上的文件——上传、提供或引用. |
| `Folder` | `folder` | 与一份文件相比,文件保存地点. |
| `Graph` | `graph` | 记录为外形:什么与什么结合. |
| `History` | `clock-counter-clockwise` | 这个项目是怎么变成那样的 而不是现在的真相. |
| `Image` | `image` | 证据就是一张图片——一张截图,一张有人寄来的图表. |
| `Note` | `note-pencil` | 一个人写下来的东西, 除了上传的东西. |
| `Paperclip` | `paperclip` | 某件东西附在一件物品上,与记录上的文件相对应. |
| `Path` | `path` | 通向的路线——一行一行,一行一行. |
| `Tag` | `tag` | 一个人申请的分类标签 不是系统决定的状态. |

### 通讯

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

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

### 人员和代理人

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

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

### 访问

签名,什么是私人的.

| 图标 | 磷酸盐源 | 用它来 |
| --- | --- | --- |
| `Key` | `key` | 一个证书 脚本使用, 没有人签名. |
| `Lock` | `lock` | 属于它的私人项目. |
| `SignIn` | `sign-in` | 签名,在登录屏幕及其按钮上. |
| `SignOut` | `sign-out` | 有意签出. 不,对于一个过期的会话. |

### 理由

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

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

### 施政

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

| 图标 | 磷酸盐源 | 用它来 |
| --- | --- | --- |
| `ArrowsClockwise` | `arrows-clockwise` | Stale:在重建中等待工作,因为它依赖于改变的东西。 其他图标集称为此 `RefreshCw`。 。 。 . |
| `GitDiff` | `git-diff` | 在做出反对的决定之下,一项标准发生了变化。 其他图标集称为此 `GitCompareArrows`。 。 。 . |
| `Governed` | `shield-check` | 生效。 正在应用一条规则的模块. |
| `Scales` | `scales` | 通过权衡证据作出的判决——评估,裁定. |
| `Shelved` | `bookmark-simple` | 已编写,未生效——架上. |
| `Stamp` | `stamp` | 批准:名人签名. |
|  |  |  |

## 添加图标

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 是什么？

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 和提交记录判断。

