Tag 标签
用于分类、筛选与状态的紧凑标签
用法
颜色与尺寸
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 参考
属性
| 属性名 | 类型 | 默认值 | 说明 |
|---|---|---|---|
label | string | null | '' | 无默认插槽时显示的文本;null 视为空字符串。 |
icon | string | '' | 前置图标类名。 |
color | string | 'var(--tx-color-primary)' | 文字与图标色,也是派生背景与边框的基准色。 |
background | string | '' | 自定义背景色;默认由 color 半透明混合。 |
border | string | '' | 自定义边框色;默认由 color 半透明混合。 |
size | 'sm' | 'md' | 'sm' | 标签密度。 |
closable | boolean | false | 渲染关闭按钮。 |
closeAriaLabel | string | 'Remove tag' | 关闭按钮的 aria-label,传入本地化文本。 |
disabled | boolean | false | 禁用点击与关闭。 |
pill | boolean | false | 全圆角胶囊外形,用于需与方角标签区分的筛选芯片。 |
variant | 'outline' | 'soft' | 'plain' | 'outline' | 填充配方,见下表。 |
dot | string | - | 前置圆点颜色;不传则不渲染。 |
dotSize | number | 6 | 圆点直径(px)。 |
count | number | - | 尾部计数;0 也会渲染,不传则不渲染。 |
类型
| 取值 | 填充 | 发丝边 | 文字 | 适用 |
|---|---|---|---|---|
outline | 12% | 32% | 原色 | 默认 |
soft | 20% | 34% | 92% 原色混入墨色 | 彩色底上的 11px 小字 |
plain | 中性填充 | 中性发丝边 | 次级墨色 | 忽略 color;用于 +3 等溢出计数与次要元信息 |
显式传入的 background / border 优先于任何 variant。
事件
| 事件名 | 参数 | 说明 |
|---|---|---|
click | MouseEvent | 未禁用时点击触发;绑定后 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