Skies.ui
元件 (Components)

Badge 標籤

行內狀態標籤,支援六種語意變體,適合顯示狀態、分類或計數。

Badge 標籤

Badge 是輕量行內元件,用於傳達狀態、分類或計數。以 cva 管理 variant,完整支援 forwardRefclassName 覆寫。

預設用法

DefaultSecondaryOutline
import { Badge } from "@skies-ui/ui";

<Badge>Default</Badge>
<Badge variant="secondary">Secondary</Badge>
<Badge variant="outline">Outline</Badge>

變體(variant)

defaultsecondarydestructiveoutlinesuccesswarning
<Badge variant="default">default</Badge>
<Badge variant="secondary">secondary</Badge>
<Badge variant="destructive">destructive</Badge>
<Badge variant="outline">outline</Badge>
<Badge variant="success">success</Badge>
<Badge variant="warning">warning</Badge>
variant用途
default主色強調(primary token)
secondary次要資訊
destructive錯誤或危險
outline低調邊框樣式
success成功或啟用狀態
warning警示或待處理

搭配圖示

Badge 支援行內子節點,可夾入任何 SVG / Lucide icon:

已啟用

待確認

import { Check } from "lucide-react";
import { Badge } from "@skies-ui/ui";

<Badge variant="success">
  <Check size={10} />
  已啟用
</Badge>

API 摘要

項目說明
variantdefault | secondary | destructive | outline | success | warning
className額外 class,透過 cn 合併
ref轉送至底層 <span>
其餘 props任何 <span> 原生屬性

badgeVariants 可單獨匯出,在非 <span> 節點重用相同視覺(例如 <a> 標籤徽章)。

On this page