Tag 标签
附在某个条目上的简短标签用 Tag:状态、分类、关键词,或者多选里已选中的一个值;加上 checkable 就是一个可以切换的筛选项。图标上的数字请用 Badge;操作请用 Button。
Tag 是一个简短的标签,用来标记状态、分类或关键词。可以带关闭按钮,也可以用 checkable 做成开关。
#演示
#类型
type 选择颜色角色:浅色背景,加上同一色系的边框和文字。bordered={false} 去掉边框。
DefaultPrimaryAccentInfoSuccessWarningError
DefaultPrimaryAccentInfoSuccessWarningError
#尺寸与形状
四种尺寸,另外有 round 和 strong。
TinySmallMediumLarge
RoundStrongRound and strong
#可关闭
closable 加一个 × 按钮,无障碍名称取自语言包。点击时调用 onClose;除非设置了 triggerClickOnClose,否则不会触发标签本身的 onClick。
designfrontendPikaurgentlocked
#可选中
可选中的标签就是一个开关:渲染为 role="checkbox",点击、回车或空格都会调用 onCheckedChange。
AllDesignEngineeringResearchOpsArchived
#图标
OnlineAwayVerified
#自定义颜色
color 覆盖单个标签的背景、边框和文字颜色。颜色建议从 主题别名 里取,这样标签还在同一套颜色体系里,切到深色模式也会跟着变:实心标签用 fill 配 text-on-fill 文字,浅色标签用 surface、border 和 text。
Jade solidIris solidOcean solidAmber solidIris, subtle
#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。