Tag#
数据展示
@rockshin/tao-ui使用紧凑标签展示类别、状态或可选择筛选条件。
#何时使用
需要在较小空间表达状态、分类或轻量选择时使用 Tag。
推荐
- 语义颜色保持一致。
- 可关闭与可选择标签提供明确交互反馈。
避免
- 不要用大量彩色 Tag 制造视觉噪音。
#代码演示
#基础用法
DefaultPrimarySuccessWarningError
TSX
import { Stack, Tag } from '@rockshin/tao-ui';
function TagExample() {
return (
<Stack direction="horizontal" gap="sm">
<Tag>Default</Tag>
<Tag color="primary">Primary</Tag>
<Tag color="success">Success</Tag>
<Tag color="warning">Warning</Tag>
<Tag color="error">Error</Tag>
</Stack>
);
}
export default TagExample;#变体
FilledSuccessWarning
SolidSuccessError
OutlinedWarning
TSX
import { Stack, Tag } from '@rockshin/tao-ui';
function TagVariants() {
return (
<Stack gap="md">
<Stack direction="horizontal" gap="sm">
<Tag variant="filled" color="primary">
Filled
</Tag>
<Tag variant="filled" color="success">
Success
</Tag>
<Tag variant="filled" color="warning">
Warning
</Tag>
</Stack>
<Stack direction="horizontal" gap="sm">
<Tag variant="solid" color="primary">
Solid
</Tag>
<Tag variant="solid" color="success">
Success
</Tag>
<Tag variant="solid" color="error">
Error
</Tag>
</Stack>
<Stack direction="horizontal" gap="sm">
<Tag variant="outlined" color="primary">
Outlined
</Tag>
<Tag variant="outlined" color="warning">
Warning
</Tag>
</Stack>
</Stack>
);
}
export default TagVariants;#自定义颜色与可关闭标签
Custom tealCustom ochreClosableDisabled
TSX
import { useState } from 'react';
import { Stack, Tag } from '@rockshin/tao-ui';
function CustomTags() {
const [feedback, setFeedback] = useState('');
return (
<>
<Stack direction="horizontal" gap="sm">
<Tag color="#245b57" variant="solid">
Custom teal
</Tag>
<Tag color="#8a5a21" variant="outlined">
Custom ochre
</Tag>
{feedback !== 'closed' && (
<Tag color="primary" closeIcon onClose={() => setFeedback('closed')}>
Closable
</Tag>
)}
<Tag disabled color="primary" variant="solid">
Disabled
</Tag>
</Stack>
<output
aria-live="polite"
style={{
display: 'block',
marginTop: 12,
whiteSpace: 'pre-wrap',
overflowWrap: 'anywhere',
}}
>
{feedback}
</output>
</>
);
}
export default CustomTags;#可选择标签
DesignEngineeringResearch
TSX
import { CheckableTag, Stack } from '@rockshin/tao-ui';
import { useState } from 'react';
function CheckableTags() {
const [selected, setSelected] = useState(['Design']);
return (
<Stack direction="horizontal" gap="sm">
{['Design', 'Engineering', 'Research'].map((label) => (
<CheckableTag
key={label}
checked={selected.includes(label)}
onChange={(checked) =>
setSelected((items) =>
checked
? [...items, label]
: items.filter((item) => item !== label),
)
}
>
{label}
</CheckableTag>
))}
</Stack>
);
}
export default CheckableTags;#自定义颜色
用颜色参数表达业务分类,文字仍应直接说明含义。
IndigoPinkTealOrangeViolet
IndigoPinkTealOrangeViolet
IndigoPinkTealOrangeViolet
TSX
import { Stack, Tag } from '@rockshin/tao-ui';
export default function TagCustomColor() {
return (
<Stack gap="md">
<Stack direction="horizontal" gap="sm">
<Tag color="#6366f1">Indigo</Tag>
<Tag color="#ec4899">Pink</Tag>
<Tag color="#14b8a6">Teal</Tag>
<Tag color="#f97316">Orange</Tag>
<Tag color="#8b5cf6">Violet</Tag>
</Stack>
<Stack direction="horizontal" gap="sm">
<Tag color="#6366f1" variant="solid">
Indigo
</Tag>
<Tag color="#ec4899" variant="solid">
Pink
</Tag>
<Tag color="#14b8a6" variant="solid">
Teal
</Tag>
<Tag color="#f97316" variant="solid">
Orange
</Tag>
<Tag color="#8b5cf6" variant="solid">
Violet
</Tag>
</Stack>
<Stack direction="horizontal" gap="sm">
<Tag color="#6366f1" variant="outlined">
Indigo
</Tag>
<Tag color="#ec4899" variant="outlined">
Pink
</Tag>
<Tag color="#14b8a6" variant="outlined">
Teal
</Tag>
<Tag color="#f97316" variant="outlined">
Orange
</Tag>
<Tag color="#8b5cf6" variant="outlined">
Violet
</Tag>
</Stack>
</Stack>
);
}#带图标的标签
图标提供辅助识别,标签文本保留完整业务含义。
🔥Hot✅Done⚡Fast🏷️Label
TSX
import { Stack, Tag } from '@rockshin/tao-ui';
export default function TagWithIcon() {
return (
<Stack direction="horizontal" gap="sm">
<Tag icon={<span>🔥</span>} color="error">
Hot
</Tag>
<Tag icon={<span>✅</span>} color="success">
Done
</Tag>
<Tag icon={<span>⚡</span>} color="warning">
Fast
</Tag>
<Tag icon={<span>🏷️</span>}>Label</Tag>
</Stack>
);
}#可选择标签
通过 checked 与变更回调实现轻量的分类筛选。
reactvueangularsveltesolid
TSX
import { CheckableTag, Stack } from '@rockshin/tao-ui';
import { useState } from 'react';
export default function TagCheckable() {
function Demo() {
const [selected, setSelected] = useState<string[]>(['react']);
const options = ['react', 'vue', 'angular', 'svelte', 'solid'];
return (
<Stack direction="horizontal" gap="sm">
{options.map((opt) => (
<CheckableTag
key={opt}
checked={selected.includes(opt)}
onChange={(checked) =>
setSelected((prev) =>
checked ? [...prev, opt] : prev.filter((x) => x !== opt),
)
}
>
{opt}
</CheckableTag>
))}
</Stack>
);
}
return <Demo />;
}#不可操作标签
禁用时停止选择或移除操作,保留标签内容供查看。
DisabledDisabled SolidCan't CloseCan't Check
TSX
import { CheckableTag, Stack, Tag } from '@rockshin/tao-ui';
export default function TagDisabled() {
return (
<Stack direction="horizontal" gap="sm">
<Tag disabled>Disabled</Tag>
<Tag disabled color="primary" variant="solid">
Disabled Solid
</Tag>
<Tag disabled onClose={() => {}}>
Can't Close
</Tag>
<CheckableTag disabled>Can't Check</CheckableTag>
</Stack>
);
}#API
#Tag
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| disabled | 是否禁用 | boolean | undefined | - |
| className | 节点类名 | string | undefined | - |
| style | 节点样式 | CSSProperties | undefined | - |
#Tag.CheckableTag
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| disabled | 是否禁用 | boolean | undefined | - |
| className | 节点类名 | string | undefined | - |
| style | 节点样式 | CSSProperties | undefined | - |
#CheckableTag
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| disabled | 是否禁用 | boolean | undefined | - |
| className | 节点类名 | string | undefined | - |
| style | 节点样式 | CSSProperties | undefined | - |