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

packages/skin/ui/src/index.ts

@@ -12,6 +12,7 @@ export { accordion } from './accordion.js';
 export { breadcrumb } from './breadcrumb.js';
 export { card } from './card.js';
 export { badge } from './badge.js';
+export { tag } from './tag.js';
 export { alert } from './alert.js';
 export { toast, showToast } from './toast.js';
 export { tooltip } from './tooltip.js';

packages/skin/ui/src/tag.ts

@@ -0,0 +1,16 @@
+import { h } from '@ui-arch/frame';
+import type { TagProps } from './types.js';
+
+/*** 标签：语义色小胶囊，可选 × 关闭；与 badge 的分工是 tag 可交互（带关闭回调） ***/
+export function tag(props: TagProps): HTMLElement {
+  const label = h('span', { class: 'ua-tag-label' }, props.label);
+  if (!props.closable) {
+    return h('span', { class: `ua-tag ua-tag-${props.variant ?? 'default'}` }, label); // 纯展示形态
+  }
+  return h(
+    'span',
+    { class: `ua-tag is-closable ua-tag-${props.variant ?? 'default'}` },
+    label,
+    h('button', { type: 'button', class: 'ua-tag-close', 'aria-label': `移除 ${props.label}`, onClick: () => props.onClose?.() }, '×'),
+  );
+}

packages/skin/ui/src/types.ts

@@ -163,6 +163,14 @@ export interface BadgeProps {
   variant?: 'default' | 'success' | 'warning' | 'danger'; // 语义色；缺省 default
 }
 
+/*** 标签入参（可关闭，与纯展示的 badge 区分） ***/
+export interface TagProps {
+  label: string;   // 标签文案
+  variant?: 'default' | 'success' | 'warning' | 'danger' | 'info'; // 语义色；缺省 default
+  closable?: boolean; // 显示 × 关闭按钮；缺省 false
+  onClose?: () => void; // 关闭回调（调用方自行从数据源移除该项）
+}
+
 /*** 提示条入参 ***/
 export interface AlertProps {
   message: string; // 提示内容

packages/skin/ui/ua.manifest.json

@@ -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",

packages/skin/ui/ui.css

@@ -539,6 +539,51 @@
   padding-bottom: 12px;
 }
 
+/* —— 标签（可关闭） —— */
+.ua-tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 2px 8px;
+  border: 1px solid var(--ua-color-border);
+  border-radius: 999px;
+  background: var(--ua-color-surface);
+  color: var(--ua-color-text);
+  font-size: var(--ua-font-size-sm);
+  line-height: 1.6;
+  transition: border-color 0.15s, background 0.15s;
+}
+.ua-tag-success {
+  border-color: color-mix(in srgb, var(--ua-color-success) 55%, transparent);
+  background: color-mix(in srgb, var(--ua-color-success) 10%, var(--ua-color-bg));
+}
+.ua-tag-warning {
+  border-color: color-mix(in srgb, var(--ua-color-warning) 55%, transparent);
+  background: color-mix(in srgb, var(--ua-color-warning) 12%, var(--ua-color-bg));
+}
+.ua-tag-danger {
+  border-color: color-mix(in srgb, var(--ua-color-danger) 55%, transparent);
+  background: color-mix(in srgb, var(--ua-color-danger) 10%, var(--ua-color-bg));
+}
+.ua-tag-info {
+  border-color: color-mix(in srgb, var(--ua-color-accent) 55%, transparent);
+  background: color-mix(in srgb, var(--ua-color-accent) 10%, var(--ua-color-bg));
+}
+.ua-tag-close {
+  padding: 0;
+  border: none;
+  background: none;
+  color: var(--ua-color-text-muted);
+  font-size: 12px;
+  line-height: 1;
+  cursor: pointer;
+  transition: color 0.15s, transform 0.15s;
+}
+.ua-tag-close:hover {
+  color: var(--ua-color-text);
+  transform: scale(1.15);
+}
+
 /* —— 滑块 —— */
 .ua-slider {
   display: inline-flex;
@@ -1113,6 +1158,8 @@
   .ua-crumb-link,
   .ua-pop,
   .ua-slider-input,
+  .ua-tag,
+  .ua-tag-close,
   .ua-switch-track,
   .ua-switch-thumb,
   .ua-tab,