跳到正文

Tag 标签

附在某个条目上的简短标签用 Tag:状态、分类、关键词,或者多选里已选中的一个值;加上 checkable 就是一个可以切换的筛选项。图标上的数字请用 Badge;操作请用 Button。

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

演示

类型

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

尺寸与形状

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

可关闭

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

可选中

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

图标

自定义颜色

color 覆盖单个标签的背景、边框和文字颜色。颜色建议从 主题别名 里取,这样标签还在同一套颜色体系里,切到深色模式也会跟着变:实心标签用 fill 配 text-on-fill 文字,浅色标签用 surface、border 和 text。

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。