# @fiscozen/alert 中文文档

规范地址：https://npmcn.com/package/%40fiscozen/alert/

版本：3\.0\.7
npm 元数据更新时间：2026-09-29T15:22:22.186Z
中文译文更新时间：2026-11-14T20:29:10.710Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40fiscozen/alert
原文对照：https://npmcn.com/package/%40fiscozen/alert/?lang=original

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

- 包体积（解压后）：669 kB，22 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：3 个
- peer 依赖：vue ^3\.4\.13，vue-router ^4\.3\.0，tailwindcss ^3\.4\.1，@fiscozen/icons ^1\.0\.8
- 首次发布：2024-06-21T10:04:43.342Z
- 最新版本发布：2026-09-29T15:22:21.884Z
- 近 30 天下载量：4061（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 12 个）

## 中文简介

设计系统警报部分

## 安装

```sh
npm install @fiscozen/alert
```

也可以使用：`pnpm add @fiscozen/alert`、`yarn add @fiscozen/alert`、`bun add @fiscozen/alert`

## README

# @fiscozen/警报

警示组件:及时征集信息(信息,错误,警告,成功,危险).

> 关于用法文档和实例,见 [故事书文档 - 信件 / FzAlert](https://main--*.storybook.inspire.cloud/?path=/docs/documentation-messages-fzalert)。 。 。 .

## 发展

### 设置

从 repo 根: 安装依赖性 `pnpm install`。运行单元测试 `pnpm --filter @fiscozen/alert test:unit`。从 repo 根运行故事本以尝试组件.

### 建筑

-   **备选案文**数字 : `background` (总是扩大,可选标题和行动), `accordion` (可折叠), `text` (只描述,没有标题/行动/解散,透明的背景,语气被忽略).
-   **调音**: 驱动图标、背景和边框 `background` 财务报告和审定财务报表 `accordion`; 已忽略 `text` (透明背景;图标仍然反映语义学的语气).
-   **环境**数字 : `frontoffice` (默认) vs `backoffice`影响铺设(`p-12` 对 `p-6`)并传递给 `FzButton` 编号 : `FzIconButton`变量 `text` + 键 `environment: 'backoffice'`,主要图标使用大小 `sm`; 否则 `md`。 。 。 .

### 守则组织

-   `src/FzAlert.vue`: 主要组件; 计算 `safeVariant`, (中文(简体) ), `safeEnvironment`, (中文(简体) ), `isTextVariant`, (中文(简体) ), `iconSize`, (中文(简体) ), `containerClass`等 (中文(简体) ).
-   `src/types.ts`数字 : `AlertProps`, (中文(简体) ), `AlertVariant`; 破损道具 `alertStyle`, (中文(简体) ), `size`。 。 。 .
-   `src/index.ts`: 出口成分和类型.

### 关键概念

**文本变体**:没有标题,没有按钮/链接动作,没有相撞,没有被忽略. 集装箱用途 `bg-transparent` (不应用以数字为基础的背景和边框)。 图标大小为 `sm` 何时 `environment === 'backoffice'`, (中文(简体) ), `md` 以其他方式(`iconSize` (计算).

**环境与补丁**: 根 div 获得 `p-6` 只有在后台。 内部 `FzContainer` 用途 `p-6` (后台办公)或 `p-12` (前沿办公室).

### 测试

-   单位测试 : `pnpm --filter @fiscozen/alert test:unit` (或 `test:unit --run -u` 以更新快照).
-   测试覆盖渲染、道具(包括所有变体) `text`),事件,CSS课程,无障碍预期,边缘案例,和快照(包括: `text` 财务报告和审定财务报表 `text` +后台).

### 构建

-   `pnpm --filter @fiscozen/alert build`: 运行 `vue-tsc` 财务报告和审定财务报表 `vite build`。 。 。 .

## 常见问题

### @fiscozen/alert 是什么？

设计系统警报部分

### 如何安装 @fiscozen/alert？

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

### @fiscozen/alert 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/fiscozen\_\_alert 是否存在。

### @fiscozen/alert 支持 ESM 还是 CommonJS？

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

### @fiscozen/alert 可以商用吗？

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

### @fiscozen/alert 的下载量有多少？

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

### @fiscozen/alert 还在维护吗？

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