更新记录

1.0.0(2026-11-20)

  • 双模同源,升级蒸汽模式零重写:每件组件同时产出 .vue(普通 uni-app Vue3)与 .uvue(uni-app x 蒸汽渲染),props / 事件 / 插槽契约完全一致;今天用普通 uni-app,明天切蒸汽模式只换运行时,业务代码不用改。
  • 面向 AI 编程的三件套:① 随包 skills/(SKILL.md + 10 篇参考 + 选型 / 配方 / 反例);② llms.txt / llms-full.txt(契约生成的全量 API 压缩索引,可直接喂给模型);③ query.mjs 能力查询(判「有没有某属性」给出 文件:行 取证)与 check-page.mjs 页面自检(7 条规则,含组件/属性/事件/插槽与契约对账)。
  • 契约驱动,文档不漂:type.ts → contracts.json → readme / llms / 技能参考 全链自动生成并受门禁校验,AI 不会照抄过期文档。
  • 91 件组件 + 9 个组合式 API + 13 个命令式 API,零第三方依赖(uni_modules.dependencies: [])。
  • 端能力:uni-app x 的 Web(Chrome / Safari)、App(Android / iOS / 鸿蒙)、微信小程序同源;主题令牌单一事实源,内置暗色主题与运行时换肤。

平台兼容性

uni-app x(5.32)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ √ √ √

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× √ × √

zm-ui(通用组件库 · 蒸汽 + 双模)

面向 uni-app x(蒸汽模式) 与 普通 uni-app Vue3 的纯通用轻量组件库 —— 同一套源码编译到 APP(Android / iOS / 鸿蒙,蒸汽原生渲染)+ H5 + 微信小程序,并在普通 uni-app Vue3 工程里直接可用(easycom 自动取 .vue 孪生件)。由 Vue3 版 zm-ui 3.1.0 全量移植并按蒸汽模式规范重写(差异逐条登记于 changelog.md 1.0.0)。

双模分发:每个组件同时产出 <name>.uvue(uni-app x)与 <name>.vue(普通 uni-app Vue3),easycom 按工程类型自动分发(同名两文件并存时 uni-app x 优先 .uvue);props 默认值与纯逻辑下沉各组件 common.ts,两端共用一份事实源。

零第三方依赖(uni_modules.dependencies: []),可整包拷贝到 uni-app x 或普通 uni-app 工程直接使用(easycom 自动引入)。参考蓝本:wot-design-uni 的工程骨架 + RiceUI 的蒸汽模式实现范式。

组件列表

清单与 gate/contracts.json 的 components 一一对应(条目数以契约为准,本表不写死合计数字以免与实盘脱节); 每批发布的分批增量记在 changelog.md 对应版本条目里(1.0.0 = 13、1.1.0 = +31、1.2.0 = +14、1.3.0 = +18 —— 分批历史以 changelog.md 为准);累计件数一律不写死:以 gate/contracts.json 的 components 条目数为准(1.4.0 撤 zm-field-row 后实盘已变,文档写死必漂)。

公共纯函数层(不是组件,不进阶梯 / 无演示页):uni_modules/zm-ui/common/date.ts(pad2 / parseDate / formatDate / relativeTime / daysInMonth / monthMatrix / startOfDay / diffDays 八个函数 + 常量 DAY_MS / MONTH_MATRIX_SIZE,本地时区)与 common/color.ts(toRgbString / toRgba / mix 等)—— 零第三方依赖,可脱离组件单独 import;单测在开发工程(不随包)。

本发布包(UI 组件版):只收录 UI 组件与公共层;功能组件 zm-file-picker / zm-date-format 暂不收录, 演示工程(**)、图标 SVG 源(design/)与开发门禁 / 单测(、gate/tests/`)不随包分发。

组件名 说明
zm-icon 自持图标(内置 986 条目 / 749 基础名,<image> + data-uri SVG 绘制,无字体图标依赖)
zm-icon-print 打印域界面图标直用组件(36 基础名 / 49 条目,固定 source;渲染复用 zm-icon)
zm-icon-color 内置通用彩色图标直用组件(27 枚系统/业务;固定源 icons.ts;zmc 前缀;不提供 color)
zm-icon-label 标签图元图标(5 类 / 114 枚,标签画布与宫格;渲染走 data-uri SVG)
zm-toolbar 通用底部工具栏(左图标组 / 右按钮组,separate / joined / flush 三形态,theme 注入)
zm-tree 树形展示 / 选择(展开集受控 + 单选 / 多选半选 + 懒加载 + 搜索)
zm-sortable 单列列表拖拽排序(长按起拖 + 跨项重排 + 手柄模式)
zm-table 数据网格(列配置驱动的只读表格:表头 / 列宽 / 对齐 / 主键列 / 条纹 / 行点击 / #cell 单元格插槽 + 空态)
zm-progress-circle 圆形进度(canvas 环 / 半圆仪表盘 + 钳位 + 可选补间)
zm-index-bar 字母 / 分组索引导航(右侧索引 + 吸顶头 + 已知项高定位)
zm-tour 漫游引导(分步高亮 + 说明面板;四块矩形遮罩挖洞、目标缺失策略、高亮/内容/按钮插槽)
zm-safe-verify 安全验证(puzzle 拼图缺口 / slide 拖到目标位两形态;轨迹与容差双校验、配色外形可配、失败重试)
zm-card 卡片壳(底色 / 圆角 / 投影 / 内边距;可选封面图 / 标题 / 副标题 / 状态图标 / 正文 / 底部按钮)
zm-button 按钮(语义色 × 变体 × 尺寸;square 图标方钮;text prop 首选文案通道)
zm-segmented 分段器(并列互斥切换;block / plain 两形态;多选 / 图标项 / 弱化)
zm-input 输入框(单行 <input> / 多行 <textarea> 统一外壳,v-model)
zm-slider 滑块(单/双滑块;横向/竖向;细轨/管道;刻度·气泡·极值·双色;stepper 内置 −/+)
zm-sidebar 竖排互斥导航(面板左侧页签,宽度自持;fill 等分高度)
zm-picker 底部选择器(单列点选,先选后确认 / 点选即生效两模式)
zm-grid 宫格容器(图标 + 可选文字网格,列数可配;子件 zm-grid-item)
zm-waterflow 瀑布流容器(list + #item 插槽;多列不等高、自动测高;不内滚)
zm-waterflow-item 瀑布流项(内部子件:绝对定位 + 自测高回传)
zm-number 数字步进(min/max/step,失焦钳位回写)
zm-text 只读文本(tone / size / 色 + 可选关键词高亮;1.4.0 吸收 zm-highlight)
zm-toast 轻提示(成功 / 失败 / 加载 / 纯文字;命令式 API,各页自挂;notify 同一出口)
zm-dialog 对话框(确认 / 提示双按钮 + 受控显隐 + 内置遮罩)
zm-action-sheet 操作菜单(底部操作项 + 独立取消区,受控显隐)
zm-popup 弹出层(五方位定位 center/top/bottom/left/right + 内置遮罩,浮层族底座)
zm-switch 开关(自定义开/关值 + 内部文案/图标 + 滑块图标 + beforeChange;缺省胶囊轨道,square 档滑块同步变方)
zm-checkbox 复选框(组多选 / 独立使用;形状·选中色·尺寸三层回落)
zm-checkbox-group 复选框组(多选受控集合 + 组级禁用与样式下发)
zm-radio 单选框(组单选互斥 / 独立使用;恒圆形,选中色·尺寸三层回落)
zm-radio-group 单选框组(当前值受控 + 组级禁用与样式下发)
zm-rate 评分(整星 / 半星;只读与禁用;数量·尺寸·间距·双色可配)
zm-tag 标签(五语义色 × 实底 / 浅底 + 圆角 + small + 可关闭)
zm-badge 徽标(角标 / 独立两形态;数字封顶、小圆点、四方位偏移)
zm-avatar 头像(图片 / 字符 / 图标 / 空占位;头像组:叠压 / 平铺 / 数量折叠 / 点击 / more 插槽)
zm-divider 分割线(文字三方位、虚线、插槽自定义内容、通长线)
zm-collapse 折叠面板(组:多选 / 手风琴 + 展开集合受控)
zm-collapse-item 折叠面板项(标题 + 副文案 + 箭头 + 禁用 + name 回落序号)
zm-tabs 标签页·头模式(均分标签头 + 指示条 + 受控选中;面板由消费方自控)
zm-navbar 自定义导航栏(返回区 + 标题 + 右区 + 状态栏占位 + 吸顶)
zm-back-top 回到顶部(滚动阈值显隐 + 平滑回顶,需消费方回传 scrollTop)
zm-skeleton 骨架屏(容器:loading 出默认模板 / 否则出插槽内容)
zm-skeleton-item 骨架占位块(原子块:px / rpx / % 三口径 + 方角/圆角/圆形三外形)
zm-progress 进度条·线形(百分比 / 区间值 + 语义终态 + 分段颜色 + 内外文字 + right 插槽 + 自定义圆角)
zm-notice-bar 通告栏(四语义色底 + 可选图标 + 可关闭 + 单行省略)
zm-empty 空状态(图标 + 文案 + 操作区插槽)
zm-search 搜索框(图标 + 输入 + 清除 + 可选操作文字 + 键盘确认)
zm-textarea 多行文本域(rows 换算固定高 + 字数统计 + 禁用)
zm-code-input 多格码输入(二合一):inputMode="system" 走系统输入法(验证码)/ "keypad" 内嵌 zm-keypad 自绘键盘(PIN · 车牌 · 身份证)+ 掩码 + fill 等分 + 错误态
zm-keypad 自绘键盘(不走系统输入法):number 整数 / password qwerty / plate 车牌双页 / idcard 四档,右侧竖条确认;只派发按键事件,取值归消费方(/026)
zm-row 栅格行(24 栏:gutter 下发给列)
zm-col 栅格列(span 取宽 / offset 左移,百分号内联)
zm-loading 加载指示(转圈 + 可选文字;横排 / 竖排,两端画法分叉)
zm-countdown 倒计时(毫秒入参 + HH:mm:ss / 天数进位 + 归零 finish)
zm-datetime-picker 日期时间选择(年月日时分多列 + 确认/点选两模式 + 范围钳位)
zm-calendar 日历(6×7 月历网格 + 单日 / 区间 / 多选 + 翻页 + 范围与指定日期禁用 + 实例方法)
zm-cascader 级联选择(树形数据逐级下钻多列 + 面包屑回退 + 叶子确认)
zm-form 表单容器(model / 表级规则 / 标签宽与禁用只读下发 + validateCount 整表校验)
zm-form-item 表单项(标签列 + 控件插槽 + 错误行,三级错误仲裁)
zm-uploader 上传(选图 + 网格缩略图 + 删除;不内置上传请求)
zm-qrcode 二维码(包内纯算法,零依赖零 canvas,data-uri SVG 渲染)
zm-barcode 一维条码(7 种码制,编码核复用 common/symbology,data-uri SVG 渲染)
zm-watermark 水印(文字行列平铺覆盖,不拦交互)
zm-space 间距器(ucss 无 gap 的替代件:横/纵 + 换行 + 对齐 + 撑满)
zm-space-item 间距子项(包内容即拿间距;间距值从所在 zm-space 注入读)
zm-scroll-x 横向滚动容器(scroll-view 横滚 + 滚动条可控 + 可选进度指示;间距沿用 zm-space-item)
zm-swiper 轮播(原生 swiper + 自绘指示点;自动播放 / 循环 / 可选标题条)
zm-swipe-actions 侧滑操作容器(互斥展开上下文源;开新项收旧项)
zm-swipe-actions-item 侧滑操作项(左右滑出按钮组;吸附/回弹 240ms 过渡;点击派发)
zm-steps 步骤条(水平 / 垂直;done·current·todo 三态 + 可选点选跳步)
zm-float-fab 悬浮按钮(角落固定 + 子项展开;四角定位 / 自定义尺寸)
zm-pagination 分页(页码窗口 + 上一页 / 下一页,含省略号;受控当前页)
zm-dropdown-menu 下拉筛选菜单(子项互斥展开 + 整组选中值回写)
zm-dropdown-item 下拉筛选子项(标题格 + 选项面板,组内受控 / 独立自管)
zm-image 图片外壳(圆角 / 加载占位 / 失败兜底 / 可选点击预览)
zm-cell 列表单元格 / 表单控件行(左图标 + 标题 / 副文案 + 右值或插槽 + 箭头;1.4.0 吸收 zm-field-row)
zm-tabbar 底部导航栏(图标 + 文字 + 徽标 / 红点,受控选中 + 安全区占位;自绘场景用)
zm-sticky 吸顶容器(滚到阈值固定;受控 scrollTop,不自行监听滚动、不测高)
zm-notify 顶部通知(命令式消息条:四语义色 + 停留时长;出口并入 zm-toast,挂 toast 一件即得)
zm-popover 气泡卡片(四方位浮层菜单 / 说明;点外部或选项关闭)
zm-load-more 加载更多(loading / finished / error / normal 四态;仅 error 可点重试)
zm-overlay 遮罩层(全屏半透明底座:受控显隐 + 点关 + 拦滚动 + 可插槽;浮层族公共件)
zm-text-ellipsis 文本省略(按行截断 + 可选展开 / 收起;原生 max-lines)
zm-amount 金额显示(千分位 / 小数位 / 货币符号 / 单位分段 / 符号位置 / 中文大写;纯展示件)
zm-signature 手写板(<canvas type="2d"> 直绘;触摸 + 鼠标双通道;父件经 ref 调 clear / isEmpty / exportImage 三方法取 dataURL;)

每个组件的完整说明(属性 / 事件 / 插槽 / 令牌 / 兼容注意)见 components/<name>/readme.md。

AI 技能(随包分发)

包内自带一套面向 AI 编程助手的技能,拷走组件库即得,无需额外安装:skills/zm-ui/

包根另有两份 AI 入口:llms.txt(索引:定位 / 事实源优先级 / 命令 / 93 件一句话 + 链接)与 llms-full.txt(压缩全量 API:每件 props=默认(枚举) · events · slots);升级 / 读旧代码的「旧写法 → 新写法」对照见 MIGRATION.md。三份均由契约生成或人工维护,改契约后 llms.txt 自动随门禁校验。

文件 内容
SKILL.md 定位(双模组件库)、开工四步、事实源优先级、六条红线、平台差异与路由表
references/catalog.md 组件目录(分类 + 用途 + props/事件/插槽数),生成物
references/tokens.md 主题令牌(默认值 + 用途 + 使用组件),生成物
references/composables.md 组合式 / 命令式 API(签名 + 返回面 + 关联组件),生成物
references/components/<name>.md 单件参考:用途 / 属性 / 易错点 / 事件 / 插槽 / 令牌 / 用法 / 兼容注意 / 双端一致性,生成物
references/notes/<name>.md 人工深度指引(选型、正反例),生成时并入该件参考
references/selection.md 选型指引:区块 → 组件映射 + 同类件辨析
references/patterns.md 场景配方(表单 / 设置页 / 确认流 / 列表 / 上传 / 反馈)
references/antipatterns.md 反例集:错误写法 → 正确写法
references/conventions.md 通用约定(任何端都成立)
references/platform-matrix.md 端 × 模式能力矩阵
references/vapor.md 蒸汽端硬限制与替代做法
scripts/query.mjs 零依赖能力查询,输出带 文件:行
scripts/check-page.mjs 零依赖页面自检(T1~T7:蒸汽红线 + 组件/属性/事件/插槽存在性),宿主工程直接跑
# 判「有没有某能力」只认这个出口,不要靠 readme 或记忆
node uni_modules/zm-ui/skills/zm-ui/scripts/query.mjs list
node uni_modules/zm-ui/skills/zm-ui/scripts/query.mjs info zm-button
node uni_modules/zm-ui/skills/zm-ui/scripts/query.mjs has zm-button loading
node uni_modules/zm-ui/skills/zm-ui/scripts/query.mjs props clearable
node uni_modules/zm-ui/skills/zm-ui/scripts/query.mjs api useToast   # 组合式 / 命令式 API
node uni_modules/zm-ui/skills/zm-ui/scripts/query.mjs example zm-button  # 可复制用法
node uni_modules/zm-ui/skills/zm-ui/scripts/query.mjs icon arrow    # 检索图标名

# 页面自检(改完页面跑这个,别靠肉眼):T1~T7 = 蒸汽红线 + 组件/prop/事件/插槽存在性
node uni_modules/zm-ui/skills/zm-ui/scripts/check-page.mjs
node uni_modules/zm-ui/skills/zm-ui/scripts/check-page.mjs --json        # CI / agent 消费
node uni_modules/zm-ui/skills/zm-ui/scripts/check-page.mjs --only T7     # 只查 API 存在性

使用方式:CodeBuddy 用户把 skills/zm-ui/ 拷到 ~/.codebuddy/skills/(或工程内 .codebuddy/skills/),重载窗口即可在技能列表看到。

维护约定:catalog.md / tokens.md / components/*.md 由开发工程的 scripts/gen-skill-docs.mjs 从 gate/contracts.json 与各组件源码生成(生成物首行有 AUTO-GENERATED 标记,不要手改;生成器不随包分发)。提升判断力的内容写在 references/notes/<name>.md 与 selection.md / patterns.md / antipatterns.md;改组件契约后重跑生成器,门禁会拦「技能参考未重生成」。

组合式 API

第 5 类交付物,目录 composables/(与组件六件套、命令式 api.ts 并列):

API 用途 引入
useConfig() 读取全局默认值通道(size / disabled / readonly + strOf / disabledOf / readonlyOf 四级仲裁) import { useConfig } from '.../uni_modules/zm-ui/composables/index.ts'
useToast() 命令式 toast / notify 的组合式包装(含 actionText + onAction 撤销条;仍须页面挂一次 <zm-toast />) import { useToast } from '.../uni_modules/zm-ui/composables/index.ts'
useDialog() confirm / alert / prompt 三方法 + 模板绑定状态(页面挂一次 <zm-dialog>;弹层走 zm-popup 底座) import { useDialog } from '.../uni_modules/zm-ui/composables/index.ts'
useCountDown(ms) 倒计时状态机:remain / days / hours / minutes / seconds / running / start / pause / reset import { useCountDown } from '.../uni_modules/zm-ui/composables/index.ts'
useUpload(opts) 文件列表 / 额度状态机(只选择与额度,不发请求) import { useUpload } from '.../uni_modules/zm-ui/composables/index.ts'
useFormDisabled() 表单禁用 / 只读读取(与 zm-form-item 同一口径) import { useFormDisabled } from '.../uni_modules/zm-ui/composables/index.ts'
useLockScroll() 浮层滚动锁(计数器式,嵌套安全) import { useLockScroll } from '.../uni_modules/zm-ui/composables/index.ts'
useTouch() 触摸手势归一(deltaX / deltaY / direction / isDragging;策略留消费件) import { useTouch } from '.../uni_modules/zm-ui/composables/index.ts'
useImagePreview() 图片预览端能力封装(web / App 各端支持;小程序等其余端 supported=false 并降级) import { useImagePreview } from '.../uni_modules/zm-ui/composables/index.ts'

useVideoPreview 有意不立(本库无视频播放件,零消费)。

// 宿主自定义表单控件接入同一套禁用 / 只读(不改优先级)
const { disabled, readonly } = useFormDisabled()

// 浮层滚动锁:lock / unlock 成对;locked 驱动容器分支
const { locked, lock, unlock } = useLockScroll()

依赖方向单向:composables → common/** 与 components/*/api.ts;api.ts 零框架依赖、不得反向 import composables(包门禁 R39 机检)。vue 的显式导入只允许出现在 composables/。演示见画廊「组合式 API」分类(*`)。

间距与留白口径

「组件为什么不自带间距」是有意设计(与主流组件库同口径):组件只负责自己的内边距,不带外边距;外边距(页面留白、元素间隔)归宿主 / 页面,这样父级拿回布局控制权,也不会组合出双倍间距。

场景 口径 取用方式
组件内边距 间距尺度 --zm-ui-space-2xs/xs/sm/md/lg/xl/2xl = 4/8/12/16/24/32/48rpx 容器型组件的根内边距已全部接到尺度(zm-cell / zm-empty / zm-form / zm-input / zm-load-more / zm-notice-bar / zm-segmented / zm-slider);在祖先节点覆盖令牌即整体调档
页面左右留白 --zm-ui-gutter(默认 24rpx) 宿主页面容器取用;demo 工程示范见工程根 uni.scss 的 .zm-demo-page
同层元素间隔 zm-space + zm-space-item(ucss 无 gap 属性) <zm-space direction="horizontal" :size="12"><zm-space-item>…</zm-space-item></zm-space>
栅格列间距 zm-row 的 gutter prop(列经注入读取) 行负 margin + 列 padding ⇒ 列间正好一个完整间距、行缘仍与父容器对齐

「组件根不带外边距」由库自身保证:全库组件根块 0 处 margin(件数以 gate/contracts.json 为准,本文不写死合计数字;唯一负 margin 是 zm-row 的 gutter 机制)。新增组件同样受此约束,内边距须取 --zm-ui-space-* 且令牌三处同源(styles/_variable.scss + gate/contracts.json + 组件 @include mx.zm-tokens(...),门禁 R16/R17 强制)。

暗色主题

暗色是一套额外的令牌取值(styles/_variable.scss 的 $zm-token-dark-overrides),只覆盖值、不新增令牌名;所有组件消费的仍是同一批 --zm-ui-*,因此不需要改任何组件代码。

接入三步:

  1. 全局样式块(uni-app x 只有 App.uvue 的 <style> 一个合法入口)引一次样式:
@import '@/uni_modules/zm-ui/styles/theme-dark.scss';
  1. 把开关落到类上 —— 加在哪个容器,哪个子树按暗色渲染(推荐加在页面根):
<view class="page" :class="dark ? 'zm-theme-dark' : ''">…</view>
  1. 图标同步重烘(图标色烘在 data-uri 里,读不到 CSS 变量):
import { setThemeMode } from '@/uni_modules/zm-ui/common/theme-palette.ts'
setThemeMode(dark ? 'dark' : 'light')

口径与边界:

  • 不跟随系统:库不读 prefers-color-scheme,开关完全由宿主掌握(与「同一份代码在各机器上表现一致」的可预期性要求一致)。
  • 只覆盖颜色:圆角 / 间距 / 控件宽在暗色下不变;令牌对照表见 SPEC-UI §2 的「暗色值」列。
  • 不要和 zm-all-tokens 挂同一个元素:两者都声明 --zm-ui-*,同元素上按规则顺序决胜;把 zm-theme-dark 放在后代容器上最稳。
  • 组件私有深色档与本主题独立:zm-code theme="dark"、zm-keypad theme="dark"、zm-code-input keypadTheme、zm-popover theme 是各自调色板,不随本主题;需要时由页面显式传档。
  • 键盘(zm-keypad)浅色档不随暗色主题:它的键面配色走私有中间量,而「私有变量套库令牌」在 App 端属链式变量、不解析(见 zm-keypad/index.scss 头注),故该件请用自带 theme="dark"。
  • 切换会清空自定义覆盖:setThemeMode('light') 走的是「清空调色板覆盖」,此前用 setThemePalette() 设过的品牌色需在切换后重新设置。

zm-icon 自持图标

包内自带的轻量图标组件:不使用字体图标、不依赖任何第三方图标库。以 <image> + data-uri SVG 绘制(蒸汽模式 CSS 不支持 mask,Vue3 版的 mask 口径已重写),颜色随 color 或令牌 --zm-ui-icon-color 变化,尺寸随 size。

<zm-icon name="edit" :size="20" color="#8B7355" />
属性 说明 类型 默认值
name 图标名(见下方清单);不存在时不渲染、不报错 String —(必填)
source 外部图标源(可选,{ w, h, tabler, body } 映射):命中覆盖内置集、未命中回落;供兄弟包注入域专用图标 Object null
color 图标颜色;缺省取 --zm-ui-icon-color(默认 #2C3A4B)。⚠ 传 var(--x) 时经 Element API 异步解析(首帧可能闪兜底色);不支持 currentColor String ''
size 尺寸:数字按 px,也可传带单位字符串 Number | String 24
width / height 非方形盒(0 = 用 size):长条图案图标(线型 48×24)成对使用 Number | String 0

内置图标(5910 条目 / 64 类)

749 个基础名为线型;有 filled 版的自动追加 <name>-filled(实心),共 237 个实心变体,演示页以 ·F 后缀标注。

通用操作

button edit delete delete-filled copy cut clipboard clipboard-filled plus minus close check search refresh more-horizontal more-vertical share download upload save filter filter-filled filter-off gear gear-filled tools sort-ascending sort-descending arrows-sort zoom-scan zoom-scan-filled rotate-clockwise-2 eye eye-filled eye-off thumb-up thumb-up-filled gauge gauge-filled pointer pointer-filled dashboard dashboard-filled toggle-left toggle-left-filled checks sandbox checkbox ear-scan body-scan line-scan trash-off object-scan no-copyright password-user window-maximize dots tool logout paywall tooltip stopwatch automation grip-vertical focus-centered creative-commons augmented-reality time-duration-off health-recognition hand-off hand-grab

导航 / 箭头

home home-filled menu-2 map-pin map-pin-filled current-location current-location-filled compass compass-filled chevron-up chevron-down chevron-left chevron-right chevrons-left chevrons-right arrow-up arrow-down arrow-left arrow-right arrow-back-up arrow-forward-up arrow-big-right arrow-big-right-filled arrow-up-right arrow-down-left arrows-exchange corner-down-left corner-down-right corner-up-left corner-up-right arrows-maximize arrows-minimize external-link caret-up caret-up-filled caret-down caret-down-filled fold login axis-x reload select switch selector step-out s-turn-up u-turn-left arrow-narrow-left arrow-narrow-right arrow-narrow-up arrow-narrow-down

布局 / 视图

layout-grid layout-grid-filled grid-4x4 apps apps-filled layout-list layout-list-filled layout-sidebar layout-sidebar-filled layout-navbar layout-navbar-filled layout-bottombar layout-bottombar-filled layout-columns layout-rows layout-board layout-dashboard layout-dashboard-filled columns adjustments adjustments-filled list-check separator maximize minimize table table-filled

状态 / 提示

info-circle info-circle-filled alert-circle alert-circle-filled alert-triangle alert-triangle-filled circle-check circle-check-filled circle-x circle-x-filled help-circle help-circle-filled ban clock clock-filled hourglass hourglass-filled loader progress shield-check shield-check-filled shield-x bell bell-filled bell-off bell-ringing bell-ringing-filled notification message message-filled message-circle message-circle-filled mail mail-filled send phone phone-filled phone-off badge-3d badge-3d-filled mailbox messages mail-opened mail-opened-filled inbox phone-call message-dots send-2

用户 / 权限

user user-filled users user-plus user-minus user-circle user-check user-x id contact building briefcase briefcase-filled key key-filled lock lock-filled lock-open shield shield-filled shield-lock shield-lock-filled fingerprint mood-kid mood-kid-filled mood-sad mood-sad-filled mood-wrrr mood-wrrr-filled mood-angry mood-angry-filled gender-genderfluid gender-hermaphrodite user-square users-group id-badge

文件 / 数据

file file-filled files file-text file-text-filled file-plus file-download file-download-filled file-upload folder folder-filled folder-open clipboard-list clipboard-list-filled link unlink paperclip archive archive-filled database server cloud cloud-filled cloud-upload cloud-download package box book book-filled presentation presentation-filled article article-filled relation-one-to-one relation-one-to-one-filled books book-off notebook certificate script-plus report-search news note notes invoice contract chalkboard page-break rubber-stamp spacing-vertical schema row-remove column-remove file-code file-analytics file-invoice file-invoice-filled file-search folder-check folder-plus folder-search database-cog server-2 cloud-lock

设备 / 连接

printer qrcode barcode scan wifi wifi-off bluetooth battery battery-filled plug usb device-mobile device-mobile-filled device-desktop device-desktop-filled device-laptop device-tablet device-tablet-filled device-tv device-tv-filled cpu keyboard keyboard-filled mouse mouse-filled router disc disc-filled dialpad dialpad-filled calculator calculator-filled dual-screen dual-screen-filled binary-tree binary-tree-filled antenna broadcast fridge browser devices playstation-x signal-h-plus viewport-wide cardboards-off nfc power vinyl shredder access-point wash-machine cell-signal-off topology-bus network http-get error-404-off load-balancer circuit-battery

媒体

photo photo-filled camera camera-filled video video-filled music microphone microphone-filled volume volume-off player-play player-play-filled player-pause player-pause-filled player-stop player-stop-filled headphones headphones-filled movie device-gamepad-2 photo-off picture-in-picture picture-in-picture-filled polaroid polaroid-filled macro macro-filled contrast contrast-filled exposure exposure-filled brightness brightness-filled tilt-shift tilt-shift-filled playlist shareplay speakerphone cast radio repeat headset hdr shadow aperture panorama-vertical-off photo-scan camera-off video-off music-off player-skip-back player-skip-back-filled player-skip-forward player-skip-forward-filled

商业 / 电商

shopping-cart shopping-cart-filled shopping-bag tag tag-filled tags tags-filled gift gift-filled wallet credit-card credit-card-filled receipt receipt-filled truck truck-filled discount discount-filled ticket coin coin-filled currency-dollar chart-bar chart-pie chart-pie-filled chart-line trending-up trending-down cash-banknote cash-banknote-filled coins tie shoe sock diaper hanger jacket perfume backpack e-passport transfer-in clothes-rack transaction-yen shopping-cart-plus tag-off gift-card gift-card-filled credit-card-pay receipt-tax cash currency-euro chart-donut chart-donut-filled

时间 / 天气

calendar calendar-filled calendar-event calendar-event-filled alarm alarm-filled sun sun-filled moon moon-filled cloud-rain umbrella umbrella-filled wind snowflake temperature sunrise sunrise-filled sunset sunset-filled history calendar-off

文本 / 编辑

text writing-sign bold italic underline strikethrough list list-numbers indent-decrease indent-increase quote quote-filled highlight text-size code-circle code-circle-filled align-box-left-top align-box-left-top-filled backspace backspace-filled code typography quotes slideshow blockquote cursor-text input-search alphabet-bangla at tex forms regex space eraser heading kerning pilcrow asterisk baseline emphasis language markdown overline scribble signature subscript float-left vocabulary letter-case superscript clear-formatting

符号 / 标记

point point-filled flag flag-filled bookmark bookmark-filled droplet droplet-filled heart heart-filled star star-filled copyleft copyleft-filled copyright copyright-filled cross cross-filled yin-yang yin-yang-filled biohazard biohazard-filled rating-12-plus ce om ankh mars peace torii venus command menorah

品牌

brand-wechat brand-alipay brand-github brand-github-filled brand-google brand-google-filled brand-apple brand-apple-filled brand-android brand-tiktok brand-tiktok-filled brand-angular brand-angular-filled brand-discord brand-discord-filled brand-twitter brand-twitter-filled brand-youtube brand-youtube-filled brand-whatsapp brand-whatsapp-filled brand-windows brand-windows-filled brand-facebook brand-facebook-filled brand-linkedin brand-linkedin-filled brand-instagram brand-instagram-filled brand-pinterest brand-pinterest-filled brand-x brand-x-filled brand-kick brand-kick-filled brand-opera brand-opera-filled brand-steam brand-steam-filled brand-vimeo brand-vimeo-filled brand-weibo brand-weibo-filled brand-paypal brand-paypal-filled brand-sketch brand-sketch-filled brand-stripe brand-stripe-filled brand-tabler brand-tabler-filled brand-tinder brand-tinder-filled brand-tumblr brand-tumblr-filled brand-vercel brand-vercel-filled brand-patreon brand-patreon-filled brand-spotify brand-spotify-filled brand-dribbble brand-dribbble-filled brand-snapchat brand-snapchat-filled brand-bitbucket brand-bitbucket-filled brand-messenger brand-messenger-filled brand-aws brand-php brand-vue brand-rust

设计 / 开发

palette palette-filled cards cards-filled bounce-left bounce-left-filled crop-portrait crop-portrait-filled lasso-polygon lasso-polygon-filled bug bug-filled sitemap sitemap-filled asset asset-filled assembly assembly-filled versions versions-filled function function-filled brush pencil pencil-x color-filter layers-linked bucket-droplet blur mask angle frame ruler slice ad-off resize vector ease-in polygon scissors template container drag-drop hierarchy paint-off shape-off stack-pop ux-circle background blend-mode components dimensions freeze-row cap-rounded flip-vertical radius-top-left packages source-code timeline-event-plus ai a-b alt api sdk seo logs divide percentage math-x-plus-x variable-plus brackets-contain-start sum equal omega bmp csv gif jpg git-fork git-merge logic-or

建筑 / 场所

fence fence-filled buildings smart-home wall tower podium home-2 building-community building-store school hospital

交通 / 出行

bus bus-filled car car-filled bike bike-filled train train-filled car-suv car-suv-filled caravan caravan-filled motorbike motorbike-filled air-balloon air-balloon-filled garden-cart garden-cart-filled automatic-gearbox automatic-gearbox-filled ship plane forklift firetruck wrecking-ball tir tank crane drone moped track wiper camper sleigh backhoe scooter tractor sailboat ambulance bulldozer map-2 route world globe globe-filled plane-departure plane-arrival anchor walk run parking gas-station gas-station-filled charging-pile charging-pile-filled

健康 / 医疗

bandage bandage-filled eyeglass eyeglass-filled face-mask face-mask-filled sunglasses sunglasses-filled baby-carriage baby-carriage-filled pill pill-filled flask flask-filled lungs lungs-filled brain heartbeat microscope checkup-list virus-search face-mask-off first-aid-kit vaccine-bottle dna old cane fall pills razor skull dental stethoscope vaccine wheelchair activity

天气 / 自然

flare flare-filled flower flower-filled mountain mountain-filled seedling seedling-filled butterfly butterfly-filled christmas-tree christmas-tree-filled cactus cactus-filled spider spider-filled fish-bone fish-bone-filled rainbow haze mist comet storm whirl tornado uv-index leaf plant leaf-off plant-off flower-off growth ripple meteor-off feather-off cat bat deer pig-off sun-high sun-high-filled moon-stars cloud-snow thermometer tent

食物 / 饮品

egg egg-filled beer beer-filled milk milk-filled apple apple-filled bread bread-filled cup cake meat candy coffee ice-cream eggs carrot baguette dog-bowl bottle bottle-filled lemon mushroom mushroom-filled cheese pizza pizza-filled burger salad salad-filled cookie cookie-filled chef-hat chef-hat-filled

游戏 / 运动

dice dice-filled puzzle puzzle-filled play-card-a play-card-a-filled ghost ghost-filled barbell barbell-filled bow bow-filled golf golf-filled chess chess-filled archery-arrow pumpkin-scary axe ufo pick joker piano robot swimming ping-pong ball-tennis ski-jumping cliff-jumping pool ball-basketball ball-football trophy trophy-filled medal award award-filled target

其他

gps gps-filled pin pin-filled location location-filled campfire campfire-filled windmill windmill-filled sign-left sign-left-filled navigation navigation-filled medical-cross medical-cross-filled ironing ironing-filled tree beach planet rocket satellite trees route-x pokeball monkeybar location-x north-star fire-hydrant road grave prison stairs theater volcano geometry viewfinder picnic-table traffic-cone masks-theater bleach zodiac-gemini

打印域 36 基础名 / 49 条目与标签图元 114 枚已并入本集(2026-11-03 吸收合并,同名去重);zm-icon-print / zm-icon-label 的 icons.ts 是由 scripts/gen-icon-set.mjs 从本集派生的子集档(打包边界不变),彩色图标见 zm-ui/components/zm-icon-color。

拷贝约束

组件样式 @import './index.scss' → 内部 @use '../../styles/mixin' 依赖包内 styles/,故须以整个 zm-ui 包为单位拷贝,不可单独拷某个组件目录。

更新日志

见 changelog.md。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无。本插件不申请任何系统权限。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无。本插件不采集任何用户数据,不请求任何服务器地址。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无。本插件不包含任何广告。

暂无用户评论。