@epilot360/icons

中文文档
1.18.8发布于 2026/10/29MITTypeScriptCommonJS零依赖近 30 天下载 4.5万

License npm version

中文使用文档
文档目录10 节
  1. 安装
  2. 文档
  3. 使用量
  4. 360门户网站外的使用
  5. 使用 SVG
  6. 使用 svgIcon( )
  7. 发展
  8. 释放
  9. 添加自定义图标( 非材料)
  10. 本地运行

@ epilot360/ icons (英语)

License npm version

以 材料符号。 。 。 .

安装

yarn add @epilot360/icons

文档

查看我们 故事书文档。 。 。 .

使用量

这个 @epilot360/icons 软件包在360门户网站中作为外部系统模块被运出.

您可以以名称导入任何图标作为反应组件 :

import { Edit as EditIcon, EpilotIcon } from '@epilot360/icons'

<EditIcon />
// or
<EpilotIcon name="edit" />

360门户网站外的使用

避免捆绑整个 @epilot360/icons 库中,您可以直接导入模块:

import EditIcon from '@epilot360/icons/react/Edit'
;<EditIcon />

使用 SVG

要直接使用作为此套件的一部分运出 svg 文件, 例如: file-loader 您可以从 :

import EditIconSVG from '@epilot360/icons/svg/Edit/icon.svg'
import EditIconSVGFill from '@epilot360/icons/svg/Edit/icon-fill.svg'
;<img src={EditIconSVG} />

使用 svgIcon( )

这个 svgIcon() 函数返回原始 SVG 作为字符串.

import { svgIcon } from '@epilot360/icons';

<div dangerouslySetInnerHTML={{ __html: svgIcon({ name: 'epilot' }) }} />

<pre>
  {svgIcon({ name: 'epilot', variant: 'filled', width: 48, height: 48, fill: 'white' })}
</pre>

发展

本地运行故事本 :

yarn storybook

要添加新图标, 请修改 icons.config.yaml 并运行代码脚本.

yarn codegen

你应该立刻看到你的新图标.

释放

在添加新图标后 :

  1. 弹出两个版本 package.json 财务报告和审定财务报表 version.json (包括时间戳)
  2. 将您的更改提交到新分支
  3. 创建合并请求并将其合并到 main
  4. 在MR合并后,标记合并承诺 main数字 :
git checkout main
git pull
git tag v<version>
git push origin v<version>

例如:

git tag v1.17.47
git push origin v1.17.47

添加自定义图标( 非材料)

首先将自定义图标添加到 icons.config.yaml 无 svg_import 属性。 这样可以防止 高于自定义图标模块的代码源 .

然后添加自定义 svg. 见 src/svg/Epilot 举个例子.

本地运行

yarn
yarn start
# bundle served at http://localhost:5600/bundle.js

版本与发布记录

@epilot360/icons 共发布 125 个版本,首次发布于 2023/10/20;过去 12 个月发布了 21 个版本。

版本发布日期距今
1.18.8latest2026/10/2915 天前
1.18.72026/10/061 个月前
1.18.62026/10/061 个月前
1.18.42026/09/102 个月前
1.18.22026/07/163 个月前
1.18.12026/06/244 个月前

关于 @epilot360/icons 的常见问题

如何安装 @epilot360/icons?

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

@epilot360/icons 支持 TypeScript 吗?

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

@epilot360/icons 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@epilot360/icons 可以商用吗?

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

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

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

@epilot360/icons 还在维护吗?

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