Sparkle Design

Avatar

アバターはユーザーやエンティティを視覚的に表現するためのコンポーネントです。

Avatar の概要図

Anatomy: 解剖図

Avatarの構成要素を示す解剖図。1は円形の画像を表示するContainer、2は右上に配置され通知カウントを表示するBadgeを示します。
ItemNameDescriptionComponentOptional
1Containerコンテナ要素
2Badge任意のカウントを表示するバッジ要素Badge任意

Options: 選択肢

Size

xs

xsサイズのアバターです。限られたスペースや、コンポーネント内に配置する際に使用します。

xsサイズのAvatar。24x24pxの最小サイズです。

sm

smサイズのアバターです。

smサイズのAvatar。32x32pxのサイズです。

md

mdサイズのアバターです。デフォルトのサイズです。

mdサイズのAvatar。40x40pxのデフォルトサイズです。

lg

lgサイズのアバターです。

lgサイズのAvatar。48x48pxのサイズです。

xl

xlサイズのアバターです。

xlサイズのAvatar。64x64pxのサイズです。

2xl

2xlサイズのアバターです。

2xlサイズのAvatar。96x96pxのサイズです。

3xl

3xlサイズのアバターです。ページ内で、メインレベルのコンテンツに使用します。

3xlサイズのAvatar。128x128pxの最大サイズです。

Variant

image

ユーザーやエンティティの画像を表示します。画像は自動的にコンテナにフィットするようにリサイズされます。

imageバリエーションのAvatar。

initial

ユーザーやエンティティのイニシャルを表示します。背景色はカスタマイズ可能です。

initialバリエーションのAvatar。オレンジの円形のコンテナ内にイニシャル「SA」が表示されます。

pictogram

デフォルトのユーザーアイコンを表示します。画像やイニシャルが利用できない場合のフォールバックとして使用します。

pictogramバリエーションのAvatar。円形のコンテナ内にデフォルトのユーザーアイコンが表示されます。

isBadge

false

バッジを表示しない、デフォルトの状態です。

バッジなしのAvatar。

true

バッジを表示します。未読メッセージなど、Avatarが示す内容に対して通知がある場合などに使用します。

バッジありのAvatar。右上に青色のBadgeが表示されます。

Behaviors: 振る舞い

画像の表示

画像は常にコンテナ内でアスペクト比を維持します。画像は中央に配置され、必要に応じてクロップされます。

画像表示の振る舞いを示す図。

フォールバック

画像の読み込みに失敗した場合、pictogramにフォールバックします。

画像読み込み失敗時のフォールバックを示す図。「Load」状態から「Failed」を経て、最終的にデフォルトのユーザーアイコン(pictogram)にフォールバックします。

Metrics: 寸法

xs

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 24px
  • Container Width: 24px
xsサイズの寸法仕様を示す図。

sm

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 32px
  • Container Width: 32px
smサイズの寸法仕様を示す図。

md

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 40px
  • Container Width: 40px
mdサイズの寸法仕様を示す図。

lg

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 48px
  • Container Width: 48px
lgサイズの寸法仕様を示す図。

xl

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 64px
  • Container Width: 64px
xlサイズの寸法仕様を示す図。

2xl

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 96px
  • Container Width: 96px
2xlサイズの寸法仕様を示す図。

3xl

  • Vertical Resizing: Hug
  • Horizontal Resizing: Hug
  • Container Height: 128px
  • Container Width: 128px
3xlサイズの寸法仕様を示す図。

Usage: 使い方

適切な使用例。イニシャル「TY」を表示したAvatarが「山田 太郎」という名前とメールアドレスと共に配置されます。
Do

適切なサイズを選択し、コンテキストに合わせて使用してください。

不適切な使用例。イニシャル「TY」を表示したAvatarの右上に緑色のBadgeが表示されています。右側に「山田 太郎」という名前とメールアドレスが配置されます。
Don’t

バッジをステータス表現として使用しないでください。バッジの使用方法については、Badge を参照してください。

Change log: 変更履歴

DateChanges
2025/07/18ドキュメントを公開
小さな気づきや違和感があればお気軽に教えてください。
フィードバック
Chat illustration