Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Avatar

    Foto profil bulat dengan tiga ukuran dan inisial nama sebagai fallback saat gambar kosong atau gagal dimuat.

    Rani Wulandari
    Rani Wulandari
    Rani Wulandari
    BS SA R Dewi Lestari
    BSSARDewi Lestari

    Avatar

    <x-markas.avatar name="Rani Wulandari" size="md" src="/demo/avatar.svg" />
    import { Avatar } from "@/components/markas/Avatar";
    
    <Avatar name="Rani Wulandari" size="md" src="/demo/avatar.svg" />
    import Avatar from "@/components/markas/Avatar.vue";
    
    <Avatar name="Rani Wulandari" size="md" src="/demo/avatar.svg" />
    <script lang="ts">
      import Avatar from "$lib/components/markas/Avatar.svelte";
    
      const photo =
        "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";
    </script>
    
    <div class="flex items-center gap-4">
      <Avatar name="Budi Santoso" size="sm" />
      <Avatar name="Siti Aminah" />
      <Avatar name="rina" size="lg" />
      <Avatar name="Dewi Lestari" size="lg" src={photo} />
    </div>
    ---
    import Avatar from "@/components/markas/Avatar.astro";
    
    const photo =
      "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 class="flex items-center gap-4">
      <Avatar name="Budi Santoso" size="sm" />
      <Avatar name="Siti Aminah" />
      <Avatar name="rina" size="lg" />
      <Avatar name="Dewi Lestari" size="lg" src={photo} />
    </div>
    import { Component } from "@angular/core";
    import { Avatar } from "./markas/avatar.component";
    
    @Component({
      selector: "markas-example",
      imports: [Avatar],
      template: `
        <div class="flex items-center gap-4">
          <markas-avatar name="Budi Santoso" size="sm" />
          <markas-avatar name="Siti Aminah" />
          <markas-avatar name="rina" size="lg" />
          <markas-avatar name="Dewi Lestari" size="lg" [src]="photo" />
        </div>
      `,
    })
    export default class AvatarExample {
      protected readonly photo =
        "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";
    }

    Contoh

    Ukuran

    BS BS BS Dewi Lestari Dewi Lestari Dewi Lestari
    BSBSBSDewi LestariDewi LestariDewi Lestari
    BSBSBSDewi LestariDewi LestariDewi Lestari
    BS BS BS Dewi Lestari Dewi Lestari Dewi Lestari
    BSBSBSDewi LestariDewi LestariDewi Lestari

    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

    Dewi Lestari BS SA JC +5 more members
    9 people on this project
    Dewi LestariBSSAJC+5 more members
    9 people on this project
    Dewi LestariBSSAJC+5 more members
    9 people on this project
    Dewi Lestari BS SA JC +5more members
    9 people on this project
    Dewi LestariBSSAJC+5 more members
    9 people on this project

    Dengan status

    BS Online SA Away JC Offline
    BSOnlineSAAwayJCOffline
    BSOnlineSAAwayJCOffline
    BS Online SA Away JC Offline
    BSOnlineSAAwayJCOffline

    Dalam daftar

    • Sarah Miller

      sarah@markasui.com

      Owner
    • Budi Santoso

      budi@markasui.com

      Editor
    • Siti Aminah

      siti@markasui.com

      Viewer
    • Sarah Miller

      sarah@markasui.com

      Owner
    • Budi Santoso

      budi@markasui.com

      Editor
    • Siti Aminah

      siti@markasui.com

      Viewer
    • Sarah Miller

      sarah@markasui.com

      Owner
    • Budi Santoso

      budi@markasui.com

      Editor
    • Siti Aminah

      siti@markasui.com

      Viewer
    • Sarah Miller

      sarah@markasui.com

      Owner
    • Budi Santoso

      budi@markasui.com

      Editor
    • Siti Aminah

      siti@markasui.com

      Viewer
    • Sarah Miller

      sarah@markasui.com

      Owner
    • Budi Santoso

      budi@markasui.com

      Editor
    • Siti Aminah

      siti@markasui.com

      Viewer

    Instalasi

    npx markasui@latest add avatar

    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 Santoso menjadi BS, ani menjadi A. Fungsi getInitials diekspor dari versi React dan Vue.
    • Atribut tambahan (loading, width, data-*) jatuh ke <img>. Elemen fallback hanya menerima class.
    • Di Blade, gambar yang sudah gagal sebelum Alpine aktif tetap terdeteksi lewat x-init (memeriksa complete dan naturalWidth).
    • Avatar tidak punya teks bawaan. Nama aksesibel berasal dari name atau alt, jadi isi keduanya dalam Bahasa Indonesia bila perlu, misalnya alt="Foto Budi".

    Props

    NamaTipeDefaultKeterangan
    namestring-Nama orang. Dipakai untuk inisial dan sebagai alt bawaan.
    srcstring-URL gambar. Kalau kosong atau gagal dimuat, inisial yang tampil.
    altstringnameTeks alternatif. Isi string kosong bila avatar hanya dekorasi di samping nama yang sudah tertulis.
    size'sm' | 'md' | 'lg'mdUkuran 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.