データとフィードバック@neumorphism-ui/avatar

Avatar

Base UI Avatar を基盤に、画像の読み込み状態と fallback への切り替えを管理します。3つの size、ステータス badge、重なり合う group、残り人数の count を提供します。

@neumorphism-ui/avatar
Registry JSON

プレビュー

SMAMUI
チーム
ANDESO
+9

インストール

インストール: avatarnpx shadcn@latest add @neumorphism-ui/avatar

CLI が npm 依存関係、base token、utils、コンポーネントソースを順番に処理します。

この Registry を初めて使う場合は、先に namespace の設定 を完了してください。

使い方

Import

Avatar の import コード
import {
  Avatar,
  AvatarBadge,
  AvatarFallback,
  AvatarGroup,
  AvatarGroupCount,
  AvatarImage,
} from "@/components/ui/avatar"

Example

Avatar の使用コード
<AvatarGroup>
  <Avatar size="lg">
    <AvatarImage src="/members/ana.jpg" alt="Ana Martins" />
    <AvatarFallback>AM</AvatarFallback>
    <AvatarBadge aria-label="オンライン" />
  </Avatar>
  <Avatar size="lg">
    <AvatarFallback>UI</AvatarFallback>
  </Avatar>
  <AvatarGroupCount aria-label="ほか8人のメンバー">+8</AvatarGroupCount>
</AvatarGroup>

API リファレンス

コンポーネントプロパティ型デフォルト説明
Avatarsize"sm" | "default" | "lg""default"Avatar と badge の size をまとめて変更します。
AvatarImagesrcstring—表示する画像の URL です。
AvatarImagealt必須string—画像が表す人物または対象を識別する代替テキストです。
AvatarFallbackdelayMsnumber0fallback を表示するまでの遅延時間です。
AvatarBadgechildrenReact.ReactNode—ステータスの dot または小さなステータスアイコンを表示します。

アクセシビリティ

  • 01

    人物を識別する画像の alt にはその人の名前を使用します。同じ名前が隣に表示される場合は空の alt でも構いません。

  • 02

    AvatarBadge がオンライン状態などの意味を伝える場合は、aria-label または視覚的に非表示のテキストを提供してください。

  • 03

    AvatarGroupCount の +8 のような count には、その意味を説明する aria-label を追加してください。