展示
Tag
主题标签——一个话题、一项技术、一个筛选面。
什么时候用它
若干个并排出现、供人扫读。关于一条记录的一个事实是 Badge。
示例
default
AllTypeScriptRustPhotography
说明
一个主题标签——一个话题、一项技术、一个筛选维度。
和 Badge 不同,后者承载的是状态或计数。标签说的是某个东西关于什么,所以好几个会挨在一行里让读者扫;而徽章是关于某一条记录的某一个事实。
刻意做成纯展示的。要让标签能筛选列表,请在调用处用按钮或链接把它包起来并传 active——这样焦点环、按下态和键盘处理,就都留在真正拥有它们的那个元素上。
属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| children必填 | ReactNode | — | |
| active | boolean | false | 渲染成按下/选中的样子。搭配外层按钮上的 `aria-pressed` 使用。 |
同时接受 HTMLAttributes<HTMLSpanElement> 里的全部属性,它们会直接透传给底层元素,不再逐条列出。
无障碍
- 纯展示。要用它做筛选,就把它包进 button 并传 active——焦点圈和按下状态该留在真正拥有它们的元素上。