跳到正文

Tag 标签

Tag 是一个简短的标签,用来标记状态、分类或关键词。可以带关闭按钮,也可以用 checkable 做成开关。

演示

类型

type 选择颜色角色:浅色背景,加上同一色系的边框和文字。bordered={false} 去掉边框。

尺寸与形状

四种尺寸,另外有 round 和 strong。

可关闭

closable 加一个 × 按钮,无障碍名称取自语言包。点击时调用 onClose;除非设置了 triggerClickOnClose,否则不会触发标签本身的 onClick。

可选中

可选中的标签就是一个开关:渲染为 role="checkbox",点击、回车或空格都会调用 onCheckedChange。

图标

自定义颜色

color 覆盖单个标签的背景、边框和文字颜色。颜色建议从 Raft 色板 里取,这样标签还在同一套颜色体系里,切到深色模式也会跟着变:实心标签用第 9 级配 contrast 文字,浅色标签用第 2、7、11 级。

Props

名称类型默认值说明版本
typedefault | primary | accent | info | success | warning | errordefault颜色角色。未发布
sizetiny | small | medium | largemedium高度和字号。未发布
borderedbooleantrue是否显示边框。不传时取 ConfigProvider 的 bordered。未发布
roundbooleanfalse胶囊形。未发布
strongbooleanfalse文字加粗。未发布
closablebooleanfalse加一个 × 按钮。checkable 时忽略。未发布
onClose(event) => voidundefined点击 × 时调用。未发布
triggerClickOnClosebooleanfalse点击 × 时同时触发标签的 onClick。未发布
checkablebooleanfalse把标签做成开关(role="checkbox")。未发布
checkedbooleanfalse可选中标签是否选中。未发布
onCheckedChange(checked: boolean) => voidundefined传入下一个选中状态。未发布
disabledbooleanfalse禁止关闭和切换。未发布
iconReactNodeundefined文字前面的图标。未发布
color{ color?, borderColor?, textColor? }undefined覆盖这个标签的颜色。未发布

Tag 同样支持原生 span 属性和 ref。