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

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-23T08:54:30.235Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-23T08:55:03.791Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -40,7 +40,7 @@
 
 ## @ui-arch/ui（skin-dom）v0.1.0
 
-25 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。
+26 个 DOM 组件，统一用法：组件是普通函数，传入 props 返回 DOM 节点；需要状态时先创建 signal 再双向绑定。引入 CSS：import '@ui-arch/ui/ui.css'（内部已消费 tokens）。
 
 ### button — 按钮 Button
 
@@ -351,6 +351,31 @@ badge({ label: '成功', variant: 'success' })
 
 现场演示：apps/docs/demo.html#sec-feedback
 
+### tag — 标签 Tag
+
+参数：
+
+- label（必填）：string —— 标签文案
+- variant（默认 default）：'default' | 'success' | 'warning' | 'danger' | 'info' —— 语义色；缺省 default
+- closable（默认 false）：boolean —— 显示 × 关闭按钮；缺省 false（纯展示）
+- onClose（回调）：() => void —— 关闭回调：调用方从数据源移除该项后重新渲染
+
+示例：
+
+```
+tag({ label: '前端', variant: 'info', closable: true, onClose: () => remove('前端') })
+```
+
+手把手：
+
+1. 纯展示用 badge，需要可移除的标签（筛选项 / 已选条件）用 tag
+2. 按语义选 variant：info 中性标记、success 通过、warning 待处理、danger 已失效
+3. closable: true 时必须配 onClose：把数据源里的该项删掉再重渲染（组件无状态，不自行摘除节点）
+4. 组合用法：容器里用 renderList 按信号数组渲染 tag 列表，删除即写回信号
+5. 标签是内联元素，可直接排进 .row 等容器，自动换行由容器决定
+
+现场演示：apps/docs/demo.html#sec-tag
+
 ### alert — 提示条 Alert
 
 参数：
@@ -667,6 +692,7 @@ API 速览：
 - 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 收起