Badge

要素にステータスや通知を付加する小さなラベルコンポーネント。新着表示やカウント表示に使用します。

Basic

jui-badge の最も基本的な使用例です。

Neutral

Variants

variant プロパティを使用してコンポーネントの視覚的なスタイルを変更します。

Neutral Brand Success Danger Warning Info

Sizes

size プロパティを使用してコンポーネントの大きさを変更します。

Small Medium

Pill

pill プロパティを使用して角丸の強いピル型バッジを作成します。

Neutral Brand Success Danger

関連コンポーネント

  • Avatar — ユーザーやオブジェクトを視覚的に表現するコンポーネント
  • Button — ユーザーがアクションを実行するためのボタンコンポーネント

ブラウザ対応

このコンポーネントが使用しているブラウザ機能と対応状況です。

機能用途ChromeFirefoxSafariステータス
color-mix()カラーバリアント111+113+16.4+Baseline 2023

💡 color-mix() はバリアントごとの色生成に使用しています。2023年以降の主要ブラウザすべてで対応済みです。

Baseline 情報

機能Baseline 達成Widely Available 予定
color-mix()2023年2025年後半 ✅

アクセシビリティ

  • WAI-ARIA:
    • バッジはラベルテキストを内包する単純なインライン要素(<span>)として描画されます。rolearia-* 属性は付与されず、ステータスやカテゴリの意味はスロットに渡したテキスト内容そのものによって伝わります。
    • 色(variant)は意味を補強する視覚的な手がかりですが、色だけに依存しないよう、スロットには内容が分かるテキストを渡してください。
  • 対話要素: このコンポーネントは表示専用で、クリックなどの対話的な振る舞いやキーボード操作は持ちません。

プロパティ

コンポーネントが受け付ける属性(Props)の一覧と詳細仕様です。

PropertyAttributeDescriptionTypeDefault
pillpill丸型にするかどうかbooleanfalse
sizesizeバッジのサイズ"md" | "sm"'sm'
variantvariantバッジのバリアント"brand" | "danger" | "info" | "neutral" | "success" | "warning"'neutral'

スロット

コンポーネント内に子要素を挿入するためのスロット一覧です。

SlotDescription
ラベルテキスト(デフォルトスロット)

シャドウパーツ

CSSから直接スタイリング可能な内部要素(Parts)の一覧です。

PartDescription
"badge"バッジのルート要素

Built with StencilJS