Tag 标签
Tag 是一个简短的标签,用来标记状态、分类或关键词。可以带关闭按钮,也可以用 checkable 做成开关。
演示
类型
type 选择颜色角色:浅色背景,加上同一色系的边框和文字。bordered={false} 去掉边框。
尺寸与形状
四种尺寸,另外有 round 和 strong。
可关闭
closable 加一个 × 按钮,无障碍名称取自语言包。点击时调用 onClose;除非设置了 triggerClickOnClose,否则不会触发标签本身的 onClick。
可选中
可选中的标签就是一个开关:渲染为 role="checkbox",点击、回车或空格都会调用 onCheckedChange。
图标
自定义颜色
color 覆盖单个标签的背景、边框和文字颜色。颜色建议从 Raft 色板 里取,这样标签还在同一套颜色体系里,切到深色模式也会跟着变:实心标签用第 9 级配 contrast 文字,浅色标签用第 2、7、11 级。
Props
| 名称 | 类型 | 默认值 | 说明 | 版本 |
|---|---|---|---|---|
type | default | primary | accent | info | success | warning | error | default | 颜色角色。 | 未发布 |
size | tiny | small | medium | large | medium | 高度和字号。 | 未发布 |
bordered | boolean | true | 是否显示边框。不传时取 ConfigProvider 的 bordered。 | 未发布 |
round | boolean | false | 胶囊形。 | 未发布 |
strong | boolean | false | 文字加粗。 | 未发布 |
closable | boolean | false | 加一个 × 按钮。checkable 时忽略。 | 未发布 |
onClose | (event) => void | undefined | 点击 × 时调用。 | 未发布 |
triggerClickOnClose | boolean | false | 点击 × 时同时触发标签的 onClick。 | 未发布 |
checkable | boolean | false | 把标签做成开关(role="checkbox")。 | 未发布 |
checked | boolean | false | 可选中标签是否选中。 | 未发布 |
onCheckedChange | (checked: boolean) => void | undefined | 传入下一个选中状态。 | 未发布 |
disabled | boolean | false | 禁止关闭和切换。 | 未发布 |
icon | ReactNode | undefined | 文字前面的图标。 | 未发布 |
color | { color?, borderColor?, textColor? } | undefined | 覆盖这个标签的颜色。 | 未发布 |
Tag 同样支持原生 span 属性和 ref。