Foto profil bulat dengan tiga ukuran dan inisial nama sebagai fallback saat gambar kosong atau gagal dimuat.
<x-markas.avatar name="Rani Wulandari" size="sm" /><x-markas.avatar name="Rani Wulandari" size="sm" src="/demo/avatar.svg" /><x-markas.avatar name="Rani Wulandari" size="md" /><x-markas.avatar name="Rani Wulandari" size="md" src="/demo/avatar.svg" /><x-markas.avatar name="Rani Wulandari" size="lg" /><x-markas.avatar name="Rani Wulandari" size="lg" src="/demo/avatar.svg" />import { Avatar } from "@/components/markas/Avatar";
<Avatar name="Rani Wulandari" size="sm" />import { Avatar } from "@/components/markas/Avatar";
<Avatar name="Rani Wulandari" size="sm" src="/demo/avatar.svg" />import { Avatar } from "@/components/markas/Avatar";
<Avatar name="Rani Wulandari" size="md" />import { Avatar } from "@/components/markas/Avatar";
<Avatar name="Rani Wulandari" size="md" src="/demo/avatar.svg" />import { Avatar } from "@/components/markas/Avatar";
<Avatar name="Rani Wulandari" size="lg" />import { Avatar } from "@/components/markas/Avatar";
<Avatar name="Rani Wulandari" size="lg" src="/demo/avatar.svg" />import Avatar from "@/components/markas/Avatar.vue";
<Avatar name="Rani Wulandari" size="sm" />import Avatar from "@/components/markas/Avatar.vue";
<Avatar name="Rani Wulandari" size="sm" src="/demo/avatar.svg" />import Avatar from "@/components/markas/Avatar.vue";
<Avatar name="Rani Wulandari" size="md" />import Avatar from "@/components/markas/Avatar.vue";
<Avatar name="Rani Wulandari" size="md" src="/demo/avatar.svg" />import Avatar from "@/components/markas/Avatar.vue";
<Avatar name="Rani Wulandari" size="lg" />import Avatar from "@/components/markas/Avatar.vue";
<Avatar name="Rani Wulandari" size="lg" src="/demo/avatar.svg" />Contoh
Ukuran
<div class="flex items-center gap-4">
<x-markas.avatar name="Budi Santoso" size="sm" />
<x-markas.avatar name="Budi Santoso" />
<x-markas.avatar name="Budi Santoso" size="lg" />
<x-markas.avatar name="Dewi Lestari" size="sm" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='48' height='48' viewBox='0 0 48 48'%3E%3Crect width='48' height='48' fill='rgb(46 107 58)'/%3E%3Ccircle cx='24' cy='19' r='8' fill='rgb(231 239 229)'/%3E%3Cpath d='M8 46c1-9 8-15 16-15s15 6 16 15z' fill='rgb(231 239 229)'/%3E%3C/svg%3E" />
<x-markas.avatar name="Dewi Lestari" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='48' height='48' viewBox='0 0 48 48'%3E%3Crect width='48' height='48' fill='rgb(46 107 58)'/%3E%3Ccircle cx='24' cy='19' r='8' fill='rgb(231 239 229)'/%3E%3Cpath d='M8 46c1-9 8-15 16-15s15 6 16 15z' fill='rgb(231 239 229)'/%3E%3C/svg%3E" />
<x-markas.avatar name="Dewi Lestari" size="lg" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='48' height='48' viewBox='0 0 48 48'%3E%3Crect width='48' height='48' fill='rgb(46 107 58)'/%3E%3Ccircle cx='24' cy='19' r='8' fill='rgb(231 239 229)'/%3E%3Cpath d='M8 46c1-9 8-15 16-15s15 6 16 15z' fill='rgb(231 239 229)'/%3E%3C/svg%3E" />
</div>Inisial
- Budi Santoso
- Ahmad Rian Putra
- rina
- Maria José GarcÃa
- Budi Santoso
- Ahmad Rian Putra
- rina
- Maria José GarcÃa
- Budi Santoso
- Ahmad Rian Putra
- rina
- Maria José GarcÃa
- Budi Santoso
- Ahmad Rian Putra
- rina
- Maria José GarcÃa
- Budi Santoso
- Ahmad Rian Putra
- rina
- Maria José GarcÃa
Grup bertumpuk
<div class="flex items-center gap-3">
<div role="group" aria-label="Project members" class="flex">
<x-markas.avatar name="Dewi Lestari" src="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='48' height='48' viewBox='0 0 48 48'%3E%3Crect width='48' height='48' fill='rgb(46 107 58)'/%3E%3Ccircle cx='24' cy='19' r='8' fill='rgb(231 239 229)'/%3E%3Cpath d='M8 46c1-9 8-15 16-15s15 6 16 15z' fill='rgb(231 239 229)'/%3E%3C/svg%3E" class="ring-2 ring-canvas" />
<x-markas.avatar name="Budi Santoso" class="-ml-2 ring-2 ring-canvas" />
<x-markas.avatar name="Siti Aminah" class="-ml-2 ring-2 ring-canvas" />
<x-markas.avatar name="John Carter" class="-ml-2 ring-2 ring-canvas" />
<span class="-ml-2 inline-flex size-10 items-center justify-center rounded-full bg-subtle text-sm font-medium text-ink ring-2 ring-canvas">+5<span class="sr-only"> more members</span></span>
</div>
<span class="text-sm text-muted">9 people on this project</span>
</div>Dengan status
Dalam daftar
-
Owner
Sarah Miller
sarah@markasui.com
-
Editor
Budi Santoso
budi@markasui.com
-
Viewer
Siti Aminah
siti@markasui.com
- Owner
Sarah Miller
sarah@markasui.com
- Editor
Budi Santoso
budi@markasui.com
- Viewer
Siti Aminah
siti@markasui.com
- Owner
Sarah Miller
sarah@markasui.com
- Editor
Budi Santoso
budi@markasui.com
- Viewer
Siti Aminah
siti@markasui.com
- Owner
Sarah Miller
sarah@markasui.com
- Editor
Budi Santoso
budi@markasui.com
- Viewer
Siti Aminah
siti@markasui.com
- Owner
Sarah Miller
sarah@markasui.com
- Editor
Budi Santoso
budi@markasui.com
- Viewer
Siti Aminah
siti@markasui.com
Instalasi
npx markasui@latest add avatarpnpm dlx markasui@latest add avataryarn dlx markasui@latest add avatarbunx --bun markasui@latest add avatar- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Pasang dependensi:
npm install alpinejs - Salin source komponen di bawah ini ke
resources/views/components/markas/avatar.blade.php.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Avatar.tsx.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Avatar.vue.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/lib/components/markas/Avatar.svelte.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/components/markas/Avatar.astro.
- Pastikan Tailwind CSS v4 dan markas.css sudah terpasang. Lihat Instalasi.
- Salin source komponen di bawah ini ke
src/app/markas/avatar.component.ts.
Pemakaian
<x-markas.avatar name="Budi Santoso" size="sm" />
<x-markas.avatar name="Siti Aminah" :src="$user->photo_url" />
<x-markas.avatar name="Dewi Lestari" src="/img/dewi.jpg" size="lg" alt="" />Fallback saat gambar gagal dimuat butuh Alpine.js. Livewire 3 dan 4 sudah membawa Alpine. Tanpa src, inisial dirender tanpa JavaScript.
import { Avatar } from "@/components/markas/Avatar";
<Avatar name="Budi Santoso" size="sm" />
<Avatar name="Siti Aminah" src={user.photoUrl} />
<Avatar name="Dewi Lestari" src="/img/dewi.jpg" size="lg" alt="" /><script setup lang="ts">
import Avatar from "@/components/markas/Avatar.vue";
</script>
<template>
<Avatar name="Budi Santoso" size="sm" />
<Avatar name="Siti Aminah" :src="user.photoUrl" />
<Avatar name="Dewi Lestari" src="/img/dewi.jpg" size="lg" alt="" />
</template><script lang="ts">
import Avatar from "$lib/components/markas/Avatar.svelte";
</script>
<Avatar name="Dewi Lestari" src="/avatars/dewi.jpg" size="lg" />
<Avatar name="Budi Santoso" />---
import Avatar from "@/components/markas/Avatar.astro";
---
<Avatar name="Dewi Lestari" src="/avatars/dewi.jpg" size="lg" />
<Avatar name="Budi Santoso" />Script kecil yang dibundel mengganti gambar yang gagal dimuat dengan inisial.
import { Component } from "@angular/core";
import { Avatar } from "./markas/avatar.component";
@Component({
selector: "app-example",
imports: [Avatar],
template: `
<markas-avatar name="Dewi Lestari" src="/avatars/dewi.jpg" size="lg" />
<markas-avatar name="Budi Santoso" />
`,
})
export class Example {}- Inisial diambil dari huruf pertama kata pertama dan terakhir:
Budi SantosomenjadiBS,animenjadiA. FungsigetInitialsdiekspor dari versi React dan Vue. - Atribut tambahan (
loading,width,data-*) jatuh ke<img>. Elemen fallback hanya menerimaclass. - Di Blade, gambar yang sudah gagal sebelum Alpine aktif tetap terdeteksi lewat
x-init(memeriksacompletedannaturalWidth). - Avatar tidak punya teks bawaan. Nama aksesibel berasal dari
nameataualt, jadi isi keduanya dalam Bahasa Indonesia bila perlu, misalnyaalt="Foto Budi".
Props
| Nama | Tipe | Default | Keterangan |
|---|---|---|---|
name | string | - | Nama orang. Dipakai untuk inisial dan sebagai alt bawaan. |
src | string | - | URL gambar. Kalau kosong atau gagal dimuat, inisial yang tampil. |
alt | string | name | Teks alternatif. Isi string kosong bila avatar hanya dekorasi di samping nama yang sudah tertulis. |
size | 'sm' | 'md' | 'lg' | md | Ukuran 32, 40, atau 48 piksel. |
Aksesibilitas
- Gambar selalu punya alt, bawaannya sama dengan name.
- Inisial fallback memakai role img dan aria-label yang sama dengan alt, jadi screen reader membaca nama, bukan huruf.
- Dengan alt kosong, avatar disembunyikan dari screen reader (aria-hidden).
Komponen terkait
Komponen data lain dengan class yang sama di setiap framework.
- CardKartu untuk mengelompokkan konten dengan judul, deskripsi, isi, dan footer opsional.
- CarouselDeretan slide berbasis CSS scroll snap dengan tombol sebelumnya dan berikutnya, titik opsional, dan navigasi panah. Tanpa autoplay.
- Code BlockBlok kode monospace dengan nama file opsional, nomor baris, dan tombol salin. Teks polos tanpa pewarnaan sintaks.
- KbdKeycap untuk shortcut keyboard memakai elemen kbd native, dua ukuran, dengan kombinasi tombol dirender sebagai keycap terpisah.
- Scroll AreaKontainer bergulir dengan scrollbar tipis berwarna token yang bisa difokus dan digulir lewat keyboard. Tanpa JavaScript.
- SeparatorGaris pemisah horizontal atau vertikal, dekoratif secara default, dengan label opsional di tengah garis seperti "atau".