iter: d12 新增可关闭标签 tag 组件

This commit is contained in:
ui-arch-bot
2026-10-23 16:55:10 +08:00
parent d1a2864470
commit 9eefdcbd75
11 changed files with 223 additions and 11 deletions
+44 -3
View File
@@ -1,7 +1,7 @@
{
"name": "@ui-arch/ui",
"type": "skin-dom",
"description": "DOM 皮肤组件库:button / textField / textarea / slider / checkbox / switch / select / menu / radioGroup / accordion / breadcrumb / card / badge / alert / toast / tooltip / popover / skeleton / spinner / progress / tabs / pagination / modal / form / formItem / dataTable,构建在 @ui-arch/frame 与 @ui-arch/table-core 之上,样式只消费 --ua-* 令牌。",
"description": "DOM 皮肤组件库:button / textField / textarea / slider / checkbox / switch / select / menu / radioGroup / accordion / breadcrumb / card / badge / tag / alert / toast / tooltip / popover / skeleton / spinner / progress / tabs / pagination / modal / form / formItem / dataTable,构建在 @ui-arch/frame 与 @ui-arch/table-core 之上,样式只消费 --ua-* 令牌。",
"tags": [
"components",
"dom",
@@ -26,6 +26,7 @@
"breadcrumb(props):面包屑,nav + ol 语义结构,末项为当前页(aria-current),有 href 走原生链接、无 href 交给 onNavigate",
"card(props, ...children):卡片容器",
"badge(props):徽标,variant = default | success | warning | danger",
"tag(props):可关闭标签,variant 五档语义色,closable + onClose 支持从数据源移除(纯展示请用 badge)",
"alert(props):提示条,variant = info | success | warning | danger",
"toast.info/success/warning/error(message, duration?):消息提示工厂,右上角堆叠,默认 3s 自动消失,出入场微动画;showToast(props) 为完整入参版本(closable 显示关闭按钮,同屏最多 4 条)",
"tooltip(props, trigger):悬浮提示,包裹触发器,hover / focus 延迟 150ms 出场,移出 / 失焦 / Esc 收起",
@@ -72,7 +73,8 @@
"FormProps",
"DataTableProps",
"PopoverProps",
"SliderProps"
"SliderProps",
"TagProps"
]
},
"usage": "const checked = signal(false); checkbox({ label: '同意', checked }); const open = signal(false); modal({ title: '确认', open }, '内容')",
@@ -82,7 +84,7 @@
"语义色 variant 四档:default|info / success / warning / danger,一律来自令牌,禁止硬编码颜色"
],
"docs": {
"intro": "25 个 DOM 组件,统一用法:组件是普通函数,传入 props 返回 DOM 节点;需要状态时先创建 signal 再双向绑定。引入 CSS:import '@ui-arch/ui/ui.css'(内部已消费 tokens)。",
"intro": "26 个 DOM 组件,统一用法:组件是普通函数,传入 props 返回 DOM 节点;需要状态时先创建 signal 再双向绑定。引入 CSS:import '@ui-arch/ui/ui.css'(内部已消费 tokens)。",
"steps": [
"安装依赖:pnpm add @ui-arch/ui @ui-arch/frame(workspace 内自动链接)",
"引入样式:在应用入口 import '@ui-arch/ui/ui.css',暗色主题在根元素设 data-theme='dark'",
@@ -565,6 +567,45 @@
"状态语义靠 variant 承载,不要自造颜色;纯展示不可交互,需要操作请配 button"
]
},
{
"id": "tag",
"title": "标签 Tag",
"demo": "sec-tag",
"props": [
{
"n": "label",
"t": "string",
"r": 1,
"d": "标签文案"
},
{
"n": "variant",
"t": "'default' | 'success' | 'warning' | 'danger' | 'info'",
"d": "语义色;缺省 default",
"df": "default"
},
{
"n": "closable",
"t": "boolean",
"d": "显示 × 关闭按钮;缺省 false(纯展示)",
"df": "false"
},
{
"n": "onClose",
"t": "() => void",
"k": 1,
"d": "关闭回调:调用方从数据源移除该项后重新渲染"
}
],
"example": "tag({ label: '前端', variant: 'info', closable: true, onClose: () => remove('前端') })",
"steps": [
"纯展示用 badge,需要可移除的标签(筛选项 / 已选条件)用 tag",
"按语义选 variant:info 中性标记、success 通过、warning 待处理、danger 已失效",
"closable: true 时必须配 onClose:把数据源里的该项删掉再重渲染(组件无状态,不自行摘除节点)",
"组合用法:容器里用 renderList 按信号数组渲染 tag 列表,删除即写回信号",
"标签是内联元素,可直接排进 .row 等容器,自动换行由容器决定"
]
},
{
"id": "alert",
"title": "提示条 Alert",