数据与反馈@neumorphism-ui/badge

Badge

一个轻量的 span 组件,提供五种变体。它只提供视觉强调,不附加交互行为或隐式 ARIA role。

@neumorphism-ui/badge
Registry JSON

预览

DefaultPrimarySoftOutlineDestructive

安装

安装: badgenpx shadcn@latest add @neumorphism-ui/badge

CLI 会依次处理 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 参考

组件属性类型默认值说明
Badgevariant"default" | "primary" | "soft" | "outline" | "destructive""default"选择状态的强调程度和颜色。
Badgechildren必填React.ReactNode—简短的状态或分类文本。
BadgeclassNamestring—扩展尺寸、间距和颜色。

无障碍

  • 01

    Badge 默认渲染为 span,因此必须直接提供能够说明状态的文本。

  • 02

    不要只用颜色区分状态,应使用 Ready、Failed 等明确文案。

  • 03

    如需点击操作,不要直接给 Badge 绑定事件,而应将其放在 Button 或链接中。