# Avatar

> Menampilkan orang atau artis sebagai foto atau inisial.

Avatar menampilkan orang atau artis sebagai foto, atau sebagai inisial kalau belum ada foto.

## Kapan dipakai

- Pakai di samping nama di tabel, komentar, dan menu akun.
- Selalu pasangkan dengan nama dalam teks, kecuali namanya sudah ada tepat di sebelahnya.

_Pratinjau langsung versi React dan Vue: https://design.sosialoka.tech/id/components/avatar/_

## Anatomi

1. Inisial di latar lembut
2. Gambar
3. Tumpukan, dengan cincin warna kartu

Lingkaran (`radius-full`, satu-satunya bentuk bulat di sistem ini) berisi foto, atau inisial di atas `muted` dengan teks `muted-foreground`.

## Varian

Ukuran diatur lewat class `size-*`. Bawaannya 32px.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `AvatarImage src alt` | `AvatarImage :src alt` | argumen pertama `ShadAvatar` | string | tidak ada | Fotonya. |
| `AvatarFallback` | `AvatarFallback` | `placeholder` | elemen | tidak ada | Inisial saat memuat atau tanpa foto. |

## Kode

**React**
```tsx
import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar"

const portrait =
  "data:image/svg+xml;utf8," +
  encodeURIComponent(
    '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" fill="#cbd5e1"/><circle cx="32" cy="26" r="12" fill="#94a3b8"/><rect x="14" y="42" width="36" height="22" rx="11" fill="#94a3b8"/></svg>'
  )

export default function AvatarDemo() {
  return (
    <div className="flex items-center gap-3">
      <Avatar>
        <AvatarImage src={portrait} alt="Foto profil" />
        <AvatarFallback>RS</AvatarFallback>
      </Avatar>
      <Avatar>
        <AvatarFallback>BL</AvatarFallback>
      </Avatar>
    </div>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Avatar, AvatarFallback, AvatarImage } from "@/components/ui/avatar"

const portrait =
  "data:image/svg+xml;utf8," +
  encodeURIComponent(
    '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect width="64" height="64" fill="#cbd5e1"/><circle cx="32" cy="26" r="12" fill="#94a3b8"/><rect x="14" y="42" width="36" height="22" rx="11" fill="#94a3b8"/></svg>',
  )
</script>

<template>
  <div class="flex items-center gap-3">
    <Avatar>
      <AvatarImage :src="portrait" alt="Foto profil" />
      <AvatarFallback>RS</AvatarFallback>
    </Avatar>
    <Avatar>
      <AvatarFallback>BL</AvatarFallback>
    </Avatar>
  </div>
</template>
```

**Flutter**
```dart
import 'package:flutter/widgets.dart';
import 'package:shadcn_ui/shadcn_ui.dart';

class AvatarDemo extends StatelessWidget {
  const AvatarDemo({super.key});

  @override
  Widget build(BuildContext context) {
    return const Row(
      mainAxisSize: MainAxisSize.min,
      children: [
        ShadAvatar('assets/portrait.png', placeholder: Text('RS')),
        SizedBox(width: 12),
        ShadAvatar('', placeholder: Text('BL')),
      ],
    );
  }
}
```

## Pasang

**React**
```bash
npx shadcn@latest add https://design.sosialoka.tech/r/react/avatar.json
```

**Vue**
```bash
npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/avatar.json
```

## Aksesibilitas

- Beri foto `alt` berisi nama orangnya, atau `alt=""` kalau namanya sudah ada di sebelahnya.
