125k

Avatar

ユーザーを表すフォールバック付きの画像要素。

CNER
CNLRER
+3
import {
  Avatar,
  AvatarBadge,

インストール

pnpm dlx shadcn@latest add avatar

使い方

import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar"
<Avatar>
  <AvatarImage src="https://github.com/shadcn.png" />
  <AvatarFallback>CN</AvatarFallback>
</Avatar>

構成

次の構成を使用して、Avatar を構築します。

Avatar
├── AvatarImage
├── AvatarFallback
└── AvatarBadge

次の構成を使用して、AvatarGroup を構築します。

AvatarGroup
├── Avatar
│   ├── AvatarImage
│   ├── AvatarFallback
│   └── AvatarBadge
├── Avatar
│   ├── AvatarImage
│   ├── AvatarFallback
│   └── AvatarBadge
└── AvatarGroupCount

基本

画像とフォールバックを備えた基本的なアバター コンポーネント。

CN
import {
  Avatar,
  AvatarFallback,

バッジ

AvatarBadge コンポーネントを使用して、アバターにバッジを追加します。バッジはアバターの右下に配置されます。

CN
import {
  Avatar,
  AvatarBadge,

className プロップを使用して、カスタム色、サイズなどのカスタム スタイルをバッジに追加します。

<Avatar>
  <AvatarImage src="https://github.com/shadcn.png" alt="@shadcn" />
  <AvatarFallback>CN</AvatarFallback>
  <AvatarBadge className="bg-green-600 dark:bg-green-800" />
</Avatar>

アイコン付きバッジ

<AvatarBadge> 内のアイコンを使用することもできます。

PP
import { PlusIcon } from "lucide-react"

import {

アバターグループ

AvatarGroup コンポーネントを使用して、アバターのグループを追加します。

CNLRER
import {
  Avatar,
  AvatarFallback,

アバター グループ数

<AvatarGroupCount> を使用して、グループにカウントを追加します。

CNLRER
+3
import {
  Avatar,
  AvatarFallback,

アイコン付きアバター グループ

<AvatarGroupCount> 内のアイコンを使用することもできます。

CNLRER
import { PlusIcon } from "lucide-react"

import {

サイズ

アバターのサイズを変更するには、size プロップを使用します。

CNCNCN
import {
  Avatar,
  AvatarFallback,

ドロップダウン

Avatar コンポーネントをドロップダウン メニューのトリガーとして使用できます。

"use client"

import {

RTL

shadcn/ui で RTL サポートを有効にするには、RTL 構成ガイド を参照してください。

CNER
CNLRER
+٣
"use client"

import * as React from "react"

API リファレンス

アバター

Avatar コンポーネントは、アバター イメージとフォールバックをラップするルート コンポーネントです。

小道具タイプデフォルト
size"default" | "sm" | "lg""default"
classNamestring-

アバター画像

AvatarImage コンポーネントはアバター画像を表示します。すべての Base UI Avatar Image プロップを受け入れます。

小道具タイプデフォルト
srcstring-
altstring-
classNamestring-

アバターフォールバック

AvatarFallback コンポーネントは、画像のロードに失敗した場合にフォールバックを表示します。すべての Base UI Avatar Fallback プロップを受け入れます。

小道具タイプデフォルト
classNamestring-

アバターバッジ

AvatarBadge コンポーネントは、アバター上にバッジ インジケーターを表示します。通常は右下に配置されます。

小道具タイプデフォルト
classNamestring-

アバターグループ

AvatarGroup コンポーネントは、スタイルが重なったアバターのグループを表示します。

小道具タイプデフォルト
classNamestring-

アバターグループ数

AvatarGroupCount コンポーネントは、アバター グループ内のカウント インジケーターを表示し、通常は追加のアバターの数を示します。

小道具タイプデフォルト
classNamestring-

Base UI Avatar のプロップの詳細については、Base UI ドキュメント を参照してください。