# @flipdish/ui-icons 中文文档

规范地址：https://npmcn.com/package/%40flipdish/ui-icons/

版本：0\.7\.0
npm 元数据更新时间：2026-10-21T09:38:24.136Z
中文译文更新时间：2026-11-14T23:21:10.612Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40flipdish/ui-icons
原文对照：https://npmcn.com/package/%40flipdish/ui-icons/?lang=original
源码仓库：https://github.com/flipdishbytes/flipdish-design-system

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

- 包体积（解压后）：3 MB，5923 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：react ^19\.0\.0，react-native-svg \>=15\.0\.0
- 首次发布：2026-06-22T11:34:47.473Z
- 最新版本发布：2026-10-21T09:38:23.874Z
- 近 30 天下载量：2798（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

Flipdish Design System 图标 — 一个稳定的,源码不可知的导入表面包接@udifiedui/icons.

## 安装

```sh
npm install @flipdish/ui-icons
```

也可以使用：`pnpm add @flipdish/ui-icons`、`yarn add @flipdish/ui-icons`、`bun add @flipdish/ui-icons`

## README

# `@flipdish/ui-icons`

一个用于Flipdish设计系统的图标的单一源不可知导入面. 环绕 [`@untitledui/icons`](https://www.npmjs.com/package/@untitledui/icons) 在稳定接合后,加上任何Flipdish特定自定义图标.

```tsx
import { SearchLg } from "@flipdish/ui-icons";
```

> **内部设计体系,公开发布.** 为Flipdish产品所建,在Flipdish微前端共享;为此在公共npm注册处而不是作为通用图标库.

**Flipdish设计系统的一部分:**

| 软件包 | 目的 |
| --- | --- |
| [`@flipdish/ui-tokens`](https://www.npmjs.com/package/@flipdish/ui-tokens) | 设计符号——颜色、类型尺度、间隔 |
| **`@flipdish/ui-icons`** | 图标集( 本软件包) |
| [`@flipdish/ui-library`](https://www.npmjs.com/package/@flipdish/ui-library) | 构成部分 |
| [`@flipdish/ui-connected`](https://www.npmjs.com/package/@flipdish/ui-connected) | API 连接组件 |

## 安装

```bash
pnpm add @flipdish/ui-icons
```

`react` 是唯一的对等依赖(相片是React组件;您提供了React).

## 使用量

偏好每只小米的子道——在网络上和回放原生体上相同,也是唯一的形式 metro上的树摇(根管将列出的每个图标拉入本地捆绑) :

```tsx
import { SearchLg } from "@flipdish/ui-icons/SearchLg";
import { PlaceholderIcon } from "@flipdish/ui-icons/PlaceholderIcon";

<SearchLg className="size-5 text-secondary" />;
```

Root 导入仍然对 Web 有效( 和 routed 的本地子集 ) `src/index.native.ts`:

```tsx
import { SearchLg, FileIcon, PlaceholderIcon } from "@flipdish/ui-icons";
```

在网络上,图标采用标准 `SVGProps<SVGSVGElement>`,使用时 `currentColor`大小 通过道具/用具——所以它们通过语义符号公用重新着色(`text-*`和阴暗 模式为免费。 所命名的无害环境管理出口在生产结构中保持可树动性(本套产品和 `@untitledui/icons` 都声明 `sideEffects: false`) (中文(简体) ).

在土著反应中 `react-native` 导出条件选择 a `react-native-svg` 构建 建造时从上游生成(`scripts/generate-icons.mjs`因此,每一个上游 图标通过其子路径提供。 原生图标取用 `size` 编号 : `color` 编号 : `strokeWidth` 相当 比网络 `width` 编号 : `height` 编号 : `SVGProps`默认值 `color` 是一个光模代表 `fg-quaternary` (单位:千美元)`#a3a3a3`; 通过 `color` 明确当父组件知道 符号 。 六个方向图标只带网络 `data-rtl-flip` 丢入属性 本地的——RTL镜像是消费屏幕的责任.

## 为什么一个单独的包

-   **精益组件库** ——图标集大而版本独立;将其捆入 `@flipdish/ui-library` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}每个消费者都会大叫 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}不管他们用的是什么图标.
-   **稳定接合** - 消费者从 `@flipdish/ui-icons`;支持源可以不中断导入站点而改变.
-   **跨平台准备** ——隔离图标保存最终的网络(SVG)+回放原生(`react-native-svg`)从组件层分出.

## 更改日志

见 [变动情况](https://github.com/flipdishbytes/flipdish-design-system/blob/main/packages/ui-icons/CHANGELOG.md) 为释放历史.

## 捐款

这个包裹住在 [`flipdish-design-system`](https://github.com/flipdishbytes/flipdish-design-system) 单相机 撰稿人文件——包括如何添加或推翻一个图标——与该地的资料来源并存.

## 常见问题

### @flipdish/ui-icons 是什么？

Flipdish Design System 图标 — 一个稳定的,源码不可知的导入表面包接@udifiedui/icons\.

### 如何安装 @flipdish/ui-icons？

在项目目录运行 npm install @flipdish/ui-icons，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @flipdish/ui-icons 支持 TypeScript 吗？

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

### @flipdish/ui-icons 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @flipdish/ui-icons 可以商用吗？

@flipdish/ui-icons 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @flipdish/ui-icons 的下载量有多少？

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

### @flipdish/ui-icons 还在维护吗？

最新版本 0\.7\.0 发布于 2026/10/21（25 天前）；至今共发布 9 个版本，其中过去 12 个月发布了 9 个；首次发布于 2026/06/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

