组件/Tag 标签

Tag 标签

用于分类、筛选与状态的紧凑标签

Verified自 0.3.4

用法

颜色与尺寸

color 决定文字色,并派生背景与边框。

Loading demo...

可关闭

closable 渲染关闭按钮;close 只表达移除意图,由宿主更新数据。

Loading demo...

图标与自定义色

background 与 border 覆盖由 color 派生的颜色。

Loading demo...

交互与禁用

绑定 @click 后标签成为可聚焦的按钮;disabled 阻断 click 与 close。

Loading demo...

标签 + 按钮

Loading demo...

最佳实践

  • 标签用于元数据与状态提示,不要替代主按钮。
  • label 保持简短,并且不依赖颜色也能读懂。
  • 可移除的筛选项、用户标签与临时范围使用 closable。
  • 原始自定义色对比度不足时,显式提供 background / border。
  • 删除前由宿主确认;TxTag 只发出意图。

API 参考

属性

属性名类型默认值说明
labelstring | null''无默认插槽时显示的文本;null 视为空字符串。
iconstring''前置图标类名。
colorstring'var(--tx-color-primary)'文字与图标色,也是派生背景与边框的基准色。
backgroundstring''自定义背景色;默认由 color 半透明混合。
borderstring''自定义边框色;默认由 color 半透明混合。
size'sm' | 'md''sm'标签密度。
closablebooleanfalse渲染关闭按钮。
closeAriaLabelstring'Remove tag'关闭按钮的 aria-label,传入本地化文本。
disabledbooleanfalse禁用点击与关闭。
pillbooleanfalse全圆角胶囊外形,用于需与方角标签区分的筛选芯片。
variant'outline' | 'soft' | 'plain''outline'填充配方,见下表。
dotstring-前置圆点颜色;不传则不渲染。
dotSizenumber6圆点直径(px)。
countnumber-尾部计数;0 也会渲染,不传则不渲染。

类型

取值填充发丝边文字适用
outline12%32%原色默认
soft20%34%92% 原色混入墨色彩色底上的 11px 小字
plain中性填充中性发丝边次级墨色忽略 color;用于 +3 等溢出计数与次要元信息

显式传入的 background / border 优先于任何 variant。

事件

事件名参数说明
clickMouseEvent未禁用时点击触发;绑定后 Enter / Space 同样触发。
close-未禁用时点击关闭按钮触发。

插槽

插槽名Props说明
default-替换 label 文本,保留图标与关闭按钮。

概述

  • 未绑定 @click 时根节点是不带角色的静态元数据;绑定后为可聚焦的 role="button",禁用时带 aria-disabled。
  • 关闭按钮是原生 button type="button",aria-label 取自 closeAriaLabel。
  • 关闭点击不冒泡,close 不会同时触发 click。
  • disabled 降低透明度、禁用关闭按钮,并阻断 click 与 close。

技术实现

  • 源码:packages/tuffex/packages/components/src/tag/。
查看源码
packages/tuffex/packages/components/src/tag/index.ts