# @aircall/react-icons 中文文档
规范地址：https://npmcn.com/package/%40aircall/react-icons/
版本：0\.8\.3
npm 元数据更新时间：2026-08-18T07:55:57.591Z
中文译文更新时间：2026-11-06T15:39:26.982Z
软件包许可：ISC
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40aircall/react-icons
原文对照：https://npmcn.com/package/%40aircall/react-icons/?lang=original
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：868 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react ^16\.14\.0 \|\| ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0
- 首次发布：2026-01-10T10:40:45.445Z
- 最新版本发布：2026-08-18T07:55:56.621Z
- 近 30 天下载量：2868（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）
## 中文简介
Aircall Design 图标作为SVG React 组件分发,不依赖样式组件.
## 安装
```sh
npm install @aircall/react-icons
```
也可以使用：`pnpm add @aircall/react-icons`、`yarn add @aircall/react-icons`、`bun add @aircall/react-icons`
## README
# @ aircall/ react-icons (美国英语)
Aircall Design 图标作为 SVG React 组件分发.
这个软件包提供了一个现代的轻量级替代品,可以取代 `@aircall/icons` 不依赖 `styled-components` 或者说 `@xstyled`。 。 。 .
## 安装
```bash
pnpm add @aircall/react-icons
```
## 使用量
```tsx
import { PlayFilled, PauseFilled } from '@aircall/react-icons';
// Basic usage
// With size prop (sets both width and height)
// With individual dimensions
// With color (inherits from CSS color)
// With ref
const iconRef = useRef(null);
// With other SVG props
```
## 道具
| Prop | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `size` | `number | string` | `'24px'` | 设置宽度和高度 |
| `width` | `number | string` | `'24px'` | 图标的宽度( 由 `size`(中文(简体) ) |
| `height` | `number | string` | `'24px'` | 图标的高度( 由 `size`(中文(简体) ) |
| `ref` | `Ref` | \- 说吧 | 转发到 SVG 元素的 react ref |
| `...props` | `SVGProps` | \- 说吧 | 任何有效的 SVG 道具 |
## 从@aircall/icons迁移
替换从 `@aircall/icons` 与 `@aircall/react-icons`数字 :
```diff
- import { PlayFilled } from '@aircall/icons';
+ import { PlayFilled } from '@aircall/react-icons';
```
API相似,但没有 `styled-components` 造型道具. 使用 `size` 用于造型的道具或标准CSS.
## 发展
从 SVG 生成图标 :
```bash
pnpm --filter=@aircall/react-icons run generate:icons
```
构建软件包 :
```bash
pnpm --filter=@aircall/react-icons run build:package
```
## 图标来源
图标来源于 Figma 设计文件 : [图标 v2](https://www.figma.com/design/E7CkpbntmWohYYHk9a6E3H/%F0%9F%96%BC%EF%B8%8F-Icons-v2)
SVG 文件应放入 `src/svgs/` 目录并遵循命名公约:
- 使用带连字符的PascalCase(例如, `Play-Filled.svg`, (中文(简体) ), `Chevron-Down-Outlined.svg`(中文(简体) )
- SVGR 将转换为组件名( 例如 , ), `PlayFilled`, (中文(简体) ), `ChevronDownOutlined`(中文(简体) )
## 为什么是这个包裹?
这个软件包的创建是为了提供一个现代的轻量级替代品,以取代 `@aircall/icons` 即:
1. **没有CSS-in-JS依赖关系** - 取消对 `styled-components` 财务报告和审定财务报表 `@xstyled`
2. **较小的捆绑大小** - 图标是纯SVG组件,最小的包装码
3. **更好的摇树** - 每个图标是一个单独的文件,可以单独导入
4. **现代反应模式** - 用途 `React.forwardRef` 适当转发
5. **类型脚本支持** - 道具和部件类型的完整类型脚本定义
## 常见问题
### @aircall/react-icons 是什么？
Aircall Design 图标作为SVG React 组件分发,不依赖样式组件\.
### 如何安装 @aircall/react-icons？
在项目目录运行 npm install @aircall/react-icons，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^16\.14\.0 \|\| ^17\.0\.0 \|\| ^18\.0\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @aircall/react-icons 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @aircall/react-icons 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @aircall/react-icons 可以商用吗？
@aircall/react-icons 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @aircall/react-icons 的下载量有多少？
根据 npm 官方下载统计，@aircall/react-icons 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,868 次，日均约 96 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @aircall/react-icons 还在维护吗？
最新版本 0\.8\.3 发布于 2026/08/18（2 个月前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/01/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。