Sparkle Design

Badge

バッジは特定の要素に対して通知の数やタスクの数などの数値情報を付与するために使用するコンポーネントです。

Badge の概要図

Anatomy: 解剖図

Badgeの構成要素を示す解剖図。1は円形のContainer、2はBadge中央に配置され数値を表示するValueを示します。
ItemNameDescriptionComponentOptional
1Containerコンテナ要素
2Valueバッジに数値を付与するためのテキスト要素任意

Options: 選択肢

Size

xs

xsサイズのバッジです。最も小さなサイズのバッジです。

xsサイズのBadge。情報を示す青色(normal)と警告を示す赤色(emphasis)の小さなドット状のBadgeが表示されています。

sm

smサイズのバッジです。

smサイズのBadge。情報を示す青色(normal)と警告を示す赤色(emphasis)の円形Badgeが表示されています。

md

mdサイズのバッジです。数値を含めることができます。

mdサイズのBadge。情報を示す青色(normal)と警告を示す赤色(emphasis)の2種類で、それぞれドット状と数値「8」を含むバージョンが表示されています。

lg

lgサイズのバッジです。最も大きなサイズのバッジです。数値を含めることができます。

lgサイズのBadge。情報を示す青色(normal)と警告を示す赤色(emphasis)の最大サイズで、それぞれドット状と数値「8」を含むバージョンが表示されています。

Variant

normal (Default)

デフォルトのカラースタイルです。重要な情報をユーザーに伝える際に使用します。

normalバリエーションのBadge。xs、sm、md、lgの4サイズが青色で表示され、重要な情報を伝える際に使用するデフォルトのカラースタイルです。

emphasis

強調のスタイルです。重要度が高く、画面全体において特に誘目して伝えたい情報に使用します。

emphasisバリエーションのBadge。xs、sm、md、lgの4サイズが赤色で表示され、重要度が高く特に誘目して伝えたい情報に使用する強調スタイルです。

isGapped

False

バッジの周囲に余白がないスタイルです。

バッジを独立して配置する場合に使用します。

余白なしのBadge。情報を示す青色(normal)と警告を示す赤色(emphasis)の数値「8」を含むBadgeが、周囲に余白なく表示されています。独立配置する場合に使用します。

True

バッジの周囲に余白があるスタイルです。

バッジをコンテンツの前面に重ねて使用する場合に使用します。

余白ありのBadge。情報を示す青色(normal)と警告を示す赤色(emphasis)の数値「8」を含むBadgeが、白い縁取りの余白と共にグレー背景上に表示されています。コンテンツの前面に重ねて使用します。

Behaviors: 振る舞い

最大値

バッジの数値には、ユーザーが最大値を適用することができます。適用した数値を超える場合は「+」によって省略されます。
例えば、最大値を「99」と設定すると100以上の場合は「99+」、最大値を「999」と設定すると1000以上の場合は「999+」と表示されます。

最大値の振る舞いを示す図。赤色のBadgeに「99+」と「999+」が表示されます。

Metrics: 寸法

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • padding Vertical: 4px
  • padding Horizontal: 8px
Badgeの寸法仕様を示す図。

Usage: 使い方

不適切な配置例。左側には「1024」という大きな数値のBadgeと編集アイコンが表示され、右側には編集アイコンの右上以外の位置にBadgeが配置されています。コンテンツの前面に配置する場合は右上以外に配置すると情報の認知順序やBadgeの視認性が低下します。
Don’t

バッジをコンテンツの前面に配置する場合は右上以外の場所に配置しないでください。
右上以外の場所に配置すると情報を適切な順序で認知することが困難になる懸念やバッジを適切に視認することが困難になる懸念があります。

サイズ比率の注意例。左側の編集アイコンには適切なサイズのBadgeが配置され、右側の編集アイコンには過度に大きなBadgeが配置されています。Badgeの大きさはコンテンツの大きさの0.5倍以上にしないよう留意します。
Caution

バッジをコンテンツの前面に配置する場合は、バッジの大きさはコンテンツの大きさに応じたサイズを指定してください。
バッジの大きさはコンテンツの大きさの0.5倍以上にはしないように留意します。

不適切な使用例。3つのリストアイテムに異なる色のBadge(青と赤)が混在しています。同じヒエラルキーのオブジェクトに対して複数のvariantを使用すると、Badgeは色によるステータス表現を担保していないため混乱を招きます。
Don’t

同じヒエラルキーのオブジェクトに対して、複数のvariantを使用しないでください。バッジコンポーネントは、色によるステータス表現を担保していません。

Contents: 内容

不適切な内容の例。メッセージアイコンに「1024」「9999+」という極端に大きな数値が表示されたBadgeが配置されています。大きな数値はユーザーに過度な認知負荷を与えるため、最大値を適用して適切な値を表示すべきです。
Don’t

極端に大きな数値をトリムせずに表示しないでください。「1024」や「9999」などの数値はユーザーに過度な認知負荷を与える懸念があるため、最大値を適用して適切な値を表示してください。

Change log: 変更履歴

DateChanges
2025/06/04Figma / ドキュメントをアップデート
2025/03/12ドキュメントを公開
2023/10/14Figmaを公開
小さな気づきや違和感があればお気軽に教えてください。
フィードバック
Chat illustration
Badge | Sparkle Design