Badge
一个轻量的 span 组件,提供五种变体。它只提供视觉强调,不附加交互行为或隐式 ARIA role。
@neumorphism-ui/badge预览
DefaultPrimarySoftOutlineDestructive
安装
安装: badge
npx shadcn@latest add @neumorphism-ui/badgeCLI 会依次处理 npm 依赖、base token、utils 和组件源码。
首次使用此 Registry?请先完成 namespace 配置 。
用法
Import
Badge import 代码
import { Badge } from "@/components/ui/badge"Example
Badge 用法代码
<div className="flex gap-2"> <Badge>默认</Badge> <Badge variant="primary">就绪</Badge> <Badge variant="soft">草稿</Badge> <Badge variant="destructive">失败</Badge> </div>
API 参考
| 组件 | 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
Badge | variant | "default" | "primary" | "soft" | "outline" | "destructive" | "default" | 选择状态的强调程度和颜色。 |
Badge | children必填 | React.ReactNode | — | 简短的状态或分类文本。 |
Badge | className | string | — | 扩展尺寸、间距和颜色。 |
无障碍
- 01
Badge 默认渲染为 span,因此必须直接提供能够说明状态的文本。
- 02
不要只用颜色区分状态,应使用 Ready、Failed 等明确文案。
- 03
如需点击操作,不要直接给 Badge 绑定事件,而应将其放在 Button 或链接中。