@fiscozen/alert

中文文档
3.0.7发布于 2026/09/29MITES Module近 30 天下载 4061

设计系统警报部分

中文使用文档
文档目录7 节
  1. 发展
  2. 设置
  3. 建筑
  4. 守则组织
  5. 关键概念
  6. 测试
  7. 构建

@fiscozen/警报

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

关于用法文档和实例,见 故事书文档 - 信件 / 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 共发布 17 个版本,首次发布于 2024/06/21;过去 12 个月发布了 12 个版本。

版本发布日期距今
3.0.7latest2026/09/291 个月前
3.0.62026/09/072 个月前
3.0.52026/07/173 个月前
3.0.42026/06/154 个月前
3.0.32026/06/105 个月前
3.0.22026/06/095 个月前

关于 @fiscozen/alert 的常见问题

@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 和提交记录判断。