ドキュメントを検索

Avatar

ユーザーを表す画像。読み込み中または読み込み失敗時にはフォールバックが表示されます。

アバター用のWAI-ARIA APGパターンはありません。Avatarはネイティブの<img>をレンダリングするため、他の画像と同様にaltテキストによって名前が付けられます。

LU
import { component$, useStyles$ } from '@builder.io/qwik';
import { Avatar } from '@leve-ui/avatar';
import styles from './default.css?inline';

export default component$(() => {
  useStyles$(styles);

  return (
    <Avatar.Root class="avatar-default">
      <Avatar.Image
        src="https://i.pravatar.cc/96?img=5"
        alt="Sample user"
        width={48}
        height={48}
        class="avatar-default-image"
      />
      <Avatar.Fallback class="avatar-default-fallback">LU</Avatar.Fallback>
    </Avatar.Root>
  );
});

インストール#

個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。

pnpm add @leve-ui/avatar

構造#

import { Avatar } from '@leve-ui/avatar'; // or '@leve-ui/core'

<Avatar.Root>
  <Avatar.Image />
  <Avatar.Fallback />
</Avatar.Root>
パーツ要素説明
Avatar.Root<span>画像とフォールバックをラップし、読み込み状態を追跡します。
Avatar.Image<img>画像。読み込みが完了するまで非表示になります。
Avatar.Fallback<span>画像の読み込み中、失敗時、またはsrcがない場合に表示されます。画像が読み込まれると削除されます。

例#

フォールバック#

画像の読み込みに失敗した場合、フォールバック(ここではイニシャル)が表示されたままになります。

LU

APIリファレンス#

Root#

Propデフォルト型
onStatusChange$–QRL<(status: 'idle' | 'loading' | 'loaded' | 'error') => void>

画像の読み込み状態が変化したときに呼び出されます。

すべての<span>属性も受け入れます。

データ属性値
data-leve-avatar常に存在

Rootにはdata-stateがありません。読み込み状態はRootの後にレンダリングされるImageによって決定されます(ADR 0010)。状態に応じてRootにスタイルを適用するには、:has()(例: [data-leve-avatar]:has([data-leve-avatar-image][data-state="loaded"]))を使用してください。

画像#

独自のpropはありません。 すべての<img>属性を受け入れます。

データ属性値
data-leve-avatar-image常に存在
data-state"idle" | "loading" | "loaded" | "error"

画像は状態が"loaded"になるまでhidden属性を持ちます。

フォールバック#

独自のpropはありません。 すべての<span>属性を受け入れます。

データ属性値
data-leve-avatar-fallback常に存在
data-state"idle" | "loading" | "error"

アクセシビリティ#

  • 常にAvatar.Imageにaltを渡してください。画像が誰を表しているかを説明します(ユーザー名など)。アバターの隣にユーザー名がすでに表示されている場合は、スクリーンリーダーが二重に読み上げないようにalt=""を使用してください。
  • フォールバックはプレーンテキストであり、表示中はスクリーンリーダーによって読み上げられます。近くに表示されている名前を単に繰り返すだけの場合は、aria-hidden="true"で非表示にしてください。
  • Avatarにはキーボード操作がありません。アバターがリンクまたはボタンである場合は、アクセシブルな名前を持つ<a>または<button>でラップしてください。