# @c2n/symbols 中文文档

规范地址：https://npmcn.com/package/%40c2n/symbols/

版本：1\.0\.23
npm 元数据更新时间：2026-11-07T18:02:04.129Z
中文译文更新时间：2026-11-08T22:37:47.235Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40c2n/symbols
原文对照：https://npmcn.com/package/%40c2n/symbols/?lang=original
项目主页：https://github.com/code2nguyen/web-components#readme
源码仓库：https://github.com/code2nguyen/web-components

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

- 包体积（解压后）：1.1 MB，489 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-09-29T17:23:54.934Z
- 最新版本发布：2026-11-07T18:02:03.919Z
- 近 30 天下载量：2576（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 31 个）

## 中文简介

157个即时插图作为Lit网络组件,用于空状态,状态面板,登机,商务,安全和出错等页面: `<c2-symbol-empty-inbox>`, (中文(简体) ), `<c2-symbol-no-results>`, (中文(简体) ), `<c2-symbol-success>`还有更多.

## 安装

```sh
npm install @c2n/symbols
```

也可以使用：`pnpm add @c2n/symbols`、`yarn add @c2n/symbols`、`bun add @c2n/symbols`

## README

# 符号

157个即时插图作为Lit网络组件,用于空状态,状态面板,登机,商务,安全和出错等页面: `<c2-symbol-empty-inbox>`, (中文(简体) ), `<c2-symbol-no-results>`, (中文(简体) ), `<c2-symbol-success>`还有更多.

艺术作品是用一个160x160的网格绘制的(麻省理工学院,像其他寄存器一样),其中的每一种颜色都出自一组小可主题角色,因此一个主题一并重现整个组合,暗模式通过 `@c2n/theme`。 。 。 .

## 安装

```bash
npm install @c2n/symbols
```

## 使用量

只导入您使用的符号 :

```typescript
import '@c2n/symbols/symbols/empty-inbox.js'
```

```html
<c2-symbol-empty-inbox></c2-symbol-empty-inbox>
```

或者登记整个集:

```typescript
import '@c2n/symbols'
```

符号默认为装饰 (`aria-hidden`) (中文(简体) ). 给它 `label` 当它意味着没有附近的文本重复:

```html
<c2-symbol-offline label="You are offline"></c2-symbol-offline>
```

符号名称、目录(标题、类别、描述)、标签助手和 `SymbolElement` 从软件包根导出基类.

### 在状态面板中

```html
<c2-status-panel media="illustration" heading="No results" description="Try a different keyword or clear the filters.">
  <c2-symbol-no-results slot="media"></c2-symbol-no-results>
</c2-status-panel>
```

## 他们

| 财产 | 默认 | 作用 |
| --- | --- | --- |
| `--c2-symbol--size` | `120px` | 宽度和高度 |
| `--c2-symbol--stroke-width` | `3` | 160×160帆布上的轮廓宽度 |
| `--c2-symbol__backdrop--color` | `#f4f4f5` | 艺术品后面的软盘 |
| `--c2-symbol__surface--color` | `#ffffff` | 物体的相貌, 在彩色形状上绘制的标记 |
| `--c2-symbol__muted--color` | `#e4e4e7` | 二级填料,地面阴影 |
| `--c2-symbol__line--color` | `#a1a1aa` | 默认大纲 |
| `--c2-symbol__ink--color` | `#71717a` | 细小的固体细节 |
| `--c2-symbol__primary--color` | `#0265dc` | 百分点 |
| `--c2-symbol__primary-soft--color` | `#edf1fe` | 轻口音填充 |
| `--c2-symbol__accent--color` | `#fbbf24` | 黄金亮点: 星星、硬币、灯泡、相片 |
| `--c2-symbol__success--color` | `#16a34a` | 成功标志 |
| `--c2-symbol__warning--color` | `#f59e0b` | 警徽和危险标志 |
| `--c2-symbol__error--color` | `#dc2626` | 错误的徽章和击穿 |

设定 `--c2-symbol__backdrop--color: transparent` 把盘子放下.

## 正在添加或编辑一个符号

构成部分 `src/symbols/` 产生并致力于。 来源是 `svg/<name>.svg` 加进一个条目 `svg/catalog.json` (标题,类别-) `empty`, (中文(简体) ), `status`, (中文(简体) ), `error`, (中文(简体) ), `security`, (中文(简体) ), `commerce`, (中文(简体) ), `communication`, (中文(简体) ), `files` 或者说 `onboarding` ——和说明)。 源头必须使用精确的包装 `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 160 160">` 从一个班级取出每种颜色:充活的角色`backdrop`, (中文(简体) ), `surface`, (中文(简体) ), `muted`, (中文(简体) ), `ink`, (中文(简体) ), `primary`, (中文(简体) ), `primary-soft`, (中文(简体) ), `accent`, (中文(简体) ), `success`, (中文(简体) ), `warning`, (中文(简体) ), `error`),默认大纲 `line`,或彩色中风 `line-<role>`。生成器拒绝 `fill`, (中文(简体) ), `stroke`, (中文(简体) ), `style` 还有其他的班级 然后运行 :

```bash
npm run generate -w packages/icons/symbols
npm run build -w packages/icons/symbols
```

## 常见问题

### @c2n/symbols 是什么？

157个即时插图作为Lit网络组件,用于空状态,状态面板,登机,商务,安全和出错等页面: \<c2-symbol-empty-inbox\>, \(中文\(简体\) \), \<c2-symbol-no-results\>, \(中文\(简体\) \), \<c2-symbol-success\>还有更多\.

### 如何安装 @c2n/symbols？

在项目目录运行 npm install @c2n/symbols，或使用 pnpm add / yarn add / bun add。

### @c2n/symbols 支持 TypeScript 吗？

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

### @c2n/symbols 支持 ESM 还是 CommonJS？

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

### @c2n/symbols 可以商用吗？

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

### @c2n/symbols 的下载量有多少？

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

### @c2n/symbols 还在维护吗？

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

