Avatar
ユーザーを表す画像。読み込み中または読み込み失敗時にはフォールバックが表示されます。
アバター用のWAI-ARIA APGパターンはありません。Avatarはネイティブの<img>をレンダリングするため、他の画像と同様にaltテキストによって名前が付けられます。
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>
);
});.avatar-default {
display: inline-flex;
align-items: center;
justify-content: center;
width: 48px;
height: 48px;
border-radius: 9999px;
overflow: hidden;
background: light-dark(#daf0ff, #009dfd26);
font-family: inherit;
}
.avatar-default-image {
width: 100%;
height: 100%;
object-fit: cover;
}
/* Initials shown while the image is loading or when it fails */
.avatar-default-fallback {
font-size: 15px;
font-weight: 600;
color: light-dark(#006ce9, #4cb8ff);
}インストール#
個別のパッケージをインストールするか、@leve-ui/coreを使用してすべてのコンポーネントを一度に取得します。
pnpm add @leve-ui/avatarnpm install @leve-ui/avataryarn add @leve-ui/avatarbun add @leve-ui/avatarpnpm add @leve-ui/corenpm install @leve-ui/coreyarn add @leve-ui/corebun add @leve-ui/core構造#
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がない場合に表示されます。画像が読み込まれると削除されます。 |
例#
フォールバック#
画像の読み込みに失敗した場合、フォールバック(ここではイニシャル)が表示されたままになります。
import { component$, useStyles$ } from '@builder.io/qwik';
import { Avatar } from '@leve-ui/avatar';
import styles from './fallback.css?inline';
export default component$(() => {
useStyles$(styles);
return (
<Avatar.Root class="avatar-fallback">
<Avatar.Image src="/not-found.png" alt="Broken image" class="avatar-fallback-image" />
<Avatar.Fallback class="avatar-fallback-fallback">LU</Avatar.Fallback>
</Avatar.Root>
);
});.avatar-fallback {
display: inline-flex;
align-items: center;
justify-content: center;
width: 48px;
height: 48px;
border-radius: 9999px;
overflow: hidden;
background: light-dark(#daf0ff, #009dfd26);
font-family: inherit;
}
.avatar-fallback-image {
width: 100%;
height: 100%;
object-fit: cover;
}
/* Initials shown while the image is loading or when it fails */
.avatar-fallback-fallback {
font-size: 15px;
font-weight: 600;
color: light-dark(#006ce9, #4cb8ff);
}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>でラップしてください。