# Avatar Group

Tumpukan avatar yang mengembang saat hover, menampilkan nama di tooltip, dan meringkas sisa orang menjadi chip +N.

- Kategori: Animasi
- Status: stable
- Registry: https://markas.jenderalcorp.com/r/avatar-group.json
- CLI: `npx markasui@latest add avatar-group`

## Kapan dipakai

Menampilkan siapa saja di proyek, yang ditugaskan, atau yang memberi reaksi, dalam satu baris ringkas.

- Masukkan semua orang ke items dan biarkan max menentukan berapa yang tampil
- Isi groupLabel sesuai isinya, misalnya "Penanggung jawab"
- Di atas latar selain canvas, atur warna ring lewat custom property --avatar-ring, misalnya [--avatar-ring:var(--color-surface)]
- Sisakan ruang di atas grup untuk tooltip

## Kode

### Blade

Simpan di `resources/views/components/markas/avatar-group.blade.php`. Tanpa dependensi tambahan.

```blade
@props([
    'items' => [],
    'max' => 4,
    'size' => 'md',
    'groupLabel' => 'Members',
    'moreLabel' => '{count} more',
])

@php
    $root = 'group/avatars isolate flex items-center';
    $item = 'group/avatar relative shrink-0 transition-[margin] duration-200 ease-out hover:z-10 motion-reduce:transition-none';
    $face = 'flex items-center justify-center overflow-hidden rounded-full font-medium ring-2 ring-[var(--avatar-ring,var(--color-canvas))] transition-[translate,scale] duration-200 ease-out select-none group-hover/avatar:-translate-y-1 group-hover/avatar:scale-110 motion-reduce:transition-none';
    $image = 'object-cover';
    $fallback = 'bg-primary-soft text-primary';
    $more = 'bg-subtle text-ink';
    $tooltip = 'pointer-events-none absolute bottom-full left-1/2 mb-2 -translate-x-1/2 translate-y-1 rounded-md bg-ink px-2 py-1 text-xs font-medium whitespace-nowrap text-canvas opacity-0 shadow-overlay transition duration-150 ease-out group-hover/avatar:translate-y-0 group-hover/avatar:opacity-100 motion-reduce:transition-none';
    $sizes = [
        'sm' => 'size-8 text-xs',
        'md' => 'size-10 text-sm',
        'lg' => 'size-12 text-base',
    ];
    $overlaps = [
        'sm' => 'not-first:-ml-1.5 group-hover/avatars:not-first:ml-0.5',
        'md' => 'not-first:-ml-2 group-hover/avatars:not-first:ml-1',
        'lg' => 'not-first:-ml-2.5 group-hover/avatars:not-first:ml-1.5',
    ];

    // Huruf pertama kata pertama dan terakhir, sama dengan getInitials() di versi React dan Vue.
    $initials = function (string $name): string {
        $words = preg_split('/\s+/u', trim($name), -1, PREG_SPLIT_NO_EMPTY) ?: [];
        $pick = count($words) > 1 ? [$words[0], end($words)] : $words;

        return mb_strtoupper(implode('', array_map(fn ($word) => mb_substr($word, 0, 1), $pick)));
    };

    $shown = array_slice($items, 0, $max);
    $hidden = array_slice($items, $max);
    $hiddenNames = implode(', ', array_map(fn ($person) => $person['name'], $hidden));
@endphp

<div role="group" aria-label="{{ $groupLabel }}" {{ $attributes->class([$root]) }}>
    @foreach ($shown as $person)
        <span class="{{ $item }} {{ $overlaps[$size] }}">@if (! empty($person['src']))<img src="{{ $person['src'] }}" alt="{{ $person['name'] }}" class="{{ $face }} {{ $image }} {{ $sizes[$size] }}" />@else<span role="img" aria-label="{{ $person['name'] }}" class="{{ $face }} {{ $fallback }} {{ $sizes[$size] }}">{{ $initials($person['name']) }}</span>@endif<span aria-hidden="true" class="{{ $tooltip }}">{{ $person['name'] }}</span></span>
    @endforeach
    @if (count($hidden) > 0)
        <span class="{{ $item }} {{ $overlaps[$size] }}"><span class="{{ $face }} {{ $more }} {{ $sizes[$size] }}"><span aria-hidden="true">+{{ count($hidden) }}</span><span class="sr-only">{{ str_replace('{count}', (string) count($hidden), $moreLabel) }}</span></span><span aria-hidden="true" class="{{ $tooltip }}">{{ $hiddenNames }}</span></span>
    @endif
</div>
```

```blade
<x-markas.avatar-group
    :items="[
        ['name' => 'Dewi Lestari', 'src' => '/avatars/dewi.jpg'],
        ['name' => 'Budi Santoso'],
        ['name' => 'Siti Aminah'],
        ['name' => 'John Carter'],
        ['name' => 'Maya Putri'],
    ]"
    :max="3"
    group-label="Anggota proyek"
    more-label="{count} lainnya"
/>
```

### React

Simpan di `src/components/markas/AvatarGroup.tsx`. Tanpa dependensi tambahan.

```tsx
import type { ComponentProps } from "react";

const root = "group/avatars isolate flex items-center";
const item =
  "group/avatar relative shrink-0 transition-[margin] duration-200 ease-out hover:z-10 motion-reduce:transition-none";
const face =
  "flex items-center justify-center overflow-hidden rounded-full font-medium ring-2 ring-[var(--avatar-ring,var(--color-canvas))] transition-[translate,scale] duration-200 ease-out select-none group-hover/avatar:-translate-y-1 group-hover/avatar:scale-110 motion-reduce:transition-none";
const image = "object-cover";
const fallback = "bg-primary-soft text-primary";
const more = "bg-subtle text-ink";
const tooltip =
  "pointer-events-none absolute bottom-full left-1/2 mb-2 -translate-x-1/2 translate-y-1 rounded-md bg-ink px-2 py-1 text-xs font-medium whitespace-nowrap text-canvas opacity-0 shadow-overlay transition duration-150 ease-out group-hover/avatar:translate-y-0 group-hover/avatar:opacity-100 motion-reduce:transition-none";
const sizes = {
  sm: "size-8 text-xs",
  md: "size-10 text-sm",
  lg: "size-12 text-base",
};
const overlaps = {
  sm: "not-first:-ml-1.5 group-hover/avatars:not-first:ml-0.5",
  md: "not-first:-ml-2 group-hover/avatars:not-first:ml-1",
  lg: "not-first:-ml-2.5 group-hover/avatars:not-first:ml-1.5",
};

const cx = (...c: (string | false | null | undefined)[]) =>
  c.filter(Boolean).join(" ");

/** Huruf pertama kata pertama dan terakhir, sama dengan versi Blade dan Vue. */
function getInitials(name: string): string {
  const words = name.trim().split(/\s+/).filter(Boolean);
  const picked = words.length > 1 ? [words[0], words[words.length - 1]] : words;
  return picked
    .map((word) => Array.from(word ?? "")[0] ?? "")
    .join("")
    .toUpperCase();
}

export type AvatarGroupItem = { name: string; src?: string | null };

export type AvatarGroupProps = ComponentProps<"div"> & {
  items: AvatarGroupItem[];
  max?: number;
  size?: keyof typeof sizes;
  groupLabel?: string;
  moreLabel?: string;
};

export function AvatarGroup({
  items,
  max = 4,
  size = "md",
  groupLabel = "Members",
  moreLabel = "{count} more",
  className,
  ...props
}: AvatarGroupProps) {
  const shown = items.slice(0, max);
  const hidden = items.slice(max);

  return (
    <div
      role="group"
      aria-label={groupLabel}
      {...props}
      className={cx(root, className)}
    >
      {shown.map((person, index) => (
        <span key={index} className={cx(item, overlaps[size])}>
          {person.src ? (
            <img
              src={person.src}
              alt={person.name}
              className={cx(face, image, sizes[size])}
            />
          ) : (
            <span
              role="img"
              aria-label={person.name}
              className={cx(face, fallback, sizes[size])}
            >
              {getInitials(person.name)}
            </span>
          )}
          <span aria-hidden="true" className={tooltip}>
            {person.name}
          </span>
        </span>
      ))}
      {hidden.length > 0 && (
        <span className={cx(item, overlaps[size])}>
          <span className={cx(face, more, sizes[size])}>
            <span aria-hidden="true">+{hidden.length}</span>
            <span className="sr-only">
              {moreLabel.replace("{count}", String(hidden.length))}
            </span>
          </span>
          <span aria-hidden="true" className={tooltip}>
            {hidden.map((person) => person.name).join(", ")}
          </span>
        </span>
      )}
    </div>
  );
}
```

```tsx
import { AvatarGroup } from "@/components/markas/AvatarGroup";

<AvatarGroup
  items={[
    { name: "Dewi Lestari", src: "/avatars/dewi.jpg" },
    { name: "Budi Santoso" },
    { name: "Siti Aminah" },
    { name: "John Carter" },
    { name: "Maya Putri" },
  ]}
  max={3}
  groupLabel="Anggota proyek"
  moreLabel="{count} lainnya"
/>;
```

### Vue

Simpan di `src/components/markas/AvatarGroup.vue`. Tanpa dependensi tambahan.

```vue
<script setup lang="ts">
import { computed } from "vue";

type Size = "sm" | "md" | "lg";
export type AvatarGroupItem = { name: string; src?: string | null };

const props = withDefaults(
  defineProps<{
    items: AvatarGroupItem[];
    max?: number;
    size?: Size;
    groupLabel?: string;
    moreLabel?: string;
  }>(),
  { max: 4, size: "md", groupLabel: "Members", moreLabel: "{count} more" },
);

const root = "group/avatars isolate flex items-center";
const item =
  "group/avatar relative shrink-0 transition-[margin] duration-200 ease-out hover:z-10 motion-reduce:transition-none";
const face =
  "flex items-center justify-center overflow-hidden rounded-full font-medium ring-2 ring-[var(--avatar-ring,var(--color-canvas))] transition-[translate,scale] duration-200 ease-out select-none group-hover/avatar:-translate-y-1 group-hover/avatar:scale-110 motion-reduce:transition-none";
const image = "object-cover";
const fallback = "bg-primary-soft text-primary";
const more = "bg-subtle text-ink";
const tooltip =
  "pointer-events-none absolute bottom-full left-1/2 mb-2 -translate-x-1/2 translate-y-1 rounded-md bg-ink px-2 py-1 text-xs font-medium whitespace-nowrap text-canvas opacity-0 shadow-overlay transition duration-150 ease-out group-hover/avatar:translate-y-0 group-hover/avatar:opacity-100 motion-reduce:transition-none";
const sizes = {
  sm: "size-8 text-xs",
  md: "size-10 text-sm",
  lg: "size-12 text-base",
};
const overlaps = {
  sm: "not-first:-ml-1.5 group-hover/avatars:not-first:ml-0.5",
  md: "not-first:-ml-2 group-hover/avatars:not-first:ml-1",
  lg: "not-first:-ml-2.5 group-hover/avatars:not-first:ml-1.5",
};

/** Huruf pertama kata pertama dan terakhir, sama dengan versi Blade dan React. */
function getInitials(name: string): string {
  const words = name.trim().split(/\s+/).filter(Boolean);
  const picked = words.length > 1 ? [words[0], words[words.length - 1]] : words;
  return picked
    .map((word) => Array.from(word ?? "")[0] ?? "")
    .join("")
    .toUpperCase();
}

const shown = computed(() => props.items.slice(0, props.max));
const hidden = computed(() => props.items.slice(props.max));
const hiddenNames = computed(() =>
  hidden.value.map((person) => person.name).join(", "),
);
const moreText = computed(() =>
  props.moreLabel.replace("{count}", String(hidden.value.length)),
);
</script>

<template>
  <div role="group" :aria-label="props.groupLabel" :class="root">
    <span
      v-for="(person, index) in shown"
      :key="index"
      :class="[item, overlaps[props.size]]"
    >
      <img
        v-if="person.src"
        :src="person.src"
        :alt="person.name"
        :class="[face, image, sizes[props.size]]"
      />
      <span
        v-else
        role="img"
        :aria-label="person.name"
        :class="[face, fallback, sizes[props.size]]"
        >{{ getInitials(person.name) }}</span
      >
      <span aria-hidden="true" :class="tooltip">{{ person.name }}</span>
    </span>
    <span v-if="hidden.length > 0" :class="[item, overlaps[props.size]]">
      <span :class="[face, more, sizes[props.size]]"
        ><span aria-hidden="true">+{{ hidden.length }}</span
        ><span class="sr-only">{{ moreText }}</span></span
      >
      <span aria-hidden="true" :class="tooltip">{{ hiddenNames }}</span>
    </span>
  </div>
</template>
```

```vue
<template>
  <AvatarGroup
    :items="team"
    :max="3"
    group-label="Anggota proyek"
    more-label="{count} lainnya"
  />
</template>
```

### Svelte

Simpan di `src/lib/components/markas/AvatarGroup.svelte`. Tanpa dependensi tambahan.

```svelte
<script lang="ts" module>
  export type AvatarGroupItem = { name: string; src?: string | null };
</script>

<script lang="ts">
  import type { HTMLAttributes } from "svelte/elements";

  const root = "group/avatars isolate flex items-center";
  const item =
    "group/avatar relative shrink-0 transition-[margin] duration-200 ease-out hover:z-10 motion-reduce:transition-none";
  const face =
    "flex items-center justify-center overflow-hidden rounded-full font-medium ring-2 ring-[var(--avatar-ring,var(--color-canvas))] transition-[translate,scale] duration-200 ease-out select-none group-hover/avatar:-translate-y-1 group-hover/avatar:scale-110 motion-reduce:transition-none";
  const image = "object-cover";
  const fallback = "bg-primary-soft text-primary";
  const more = "bg-subtle text-ink";
  const tooltip =
    "pointer-events-none absolute bottom-full left-1/2 mb-2 -translate-x-1/2 translate-y-1 rounded-md bg-ink px-2 py-1 text-xs font-medium whitespace-nowrap text-canvas opacity-0 shadow-overlay transition duration-150 ease-out group-hover/avatar:translate-y-0 group-hover/avatar:opacity-100 motion-reduce:transition-none";
  const sizes = {
    sm: "size-8 text-xs",
    md: "size-10 text-sm",
    lg: "size-12 text-base",
  };
  const overlaps = {
    sm: "not-first:-ml-1.5 group-hover/avatars:not-first:ml-0.5",
    md: "not-first:-ml-2 group-hover/avatars:not-first:ml-1",
    lg: "not-first:-ml-2.5 group-hover/avatars:not-first:ml-1.5",
  };

  /** First letter of the first and last word, same as the Blade, React, and Vue versions. */
  function getInitials(name: string): string {
    const words = name.trim().split(/\s+/).filter(Boolean);
    const picked =
      words.length > 1 ? [words[0], words[words.length - 1]] : words;
    return picked
      .map((word) => Array.from(word ?? "")[0] ?? "")
      .join("")
      .toUpperCase();
  }

  type Props = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
    items: AvatarGroupItem[];
    max?: number;
    size?: keyof typeof sizes;
    /** Accessible name of the group. */
    groupLabel?: string;
    /** Hidden text on the +N chip. {count} is replaced with the number of hidden people. */
    moreLabel?: string;
  };

  let {
    items,
    max = 4,
    size = "md",
    groupLabel = "Members",
    moreLabel = "{count} more",
    class: className,
    ...rest
  }: Props = $props();

  const shown = $derived(items.slice(0, max));
  const hidden = $derived(items.slice(max));
</script>

<div role="group" aria-label={groupLabel} {...rest} class={[root, className]}>
  {#each shown as person, index (index)}
    <span class={[item, overlaps[size]]}
      >{#if person.src}<img
          src={person.src}
          alt={person.name}
          class={[face, image, sizes[size]]}
        />{:else}<span
          role="img"
          aria-label={person.name}
          class={[face, fallback, sizes[size]]}>{getInitials(person.name)}</span
        >{/if}<span aria-hidden="true" class={tooltip}>{person.name}</span
      ></span
    >
  {/each}
  {#if hidden.length > 0}
    <span class={[item, overlaps[size]]}
      ><span class={[face, more, sizes[size]]}
        ><span aria-hidden="true">+{hidden.length}</span><span class="sr-only"
          >{moreLabel.replace("{count}", String(hidden.length))}</span
        ></span
      ><span aria-hidden="true" class={tooltip}
        >{hidden.map((person) => person.name).join(", ")}</span
      ></span
    >
  {/if}
</div>
```

```svelte
<script lang="ts">
  import AvatarGroup from "$lib/components/markas/AvatarGroup.svelte";

  const team = [
    { name: "Dewi Lestari", src: "/dewi.jpg" },
    { name: "Budi Santoso" },
  ];
</script>

<AvatarGroup items={team} max={3} groupLabel="Project members" />
```

### Astro

Simpan di `src/components/markas/AvatarGroup.astro`. Tanpa dependensi tambahan.

```astro
---
import type { HTMLAttributes } from "astro/types";

const root = "group/avatars isolate flex items-center";
const item =
  "group/avatar relative shrink-0 transition-[margin] duration-200 ease-out hover:z-10 motion-reduce:transition-none";
const face =
  "flex items-center justify-center overflow-hidden rounded-full font-medium ring-2 ring-[var(--avatar-ring,var(--color-canvas))] transition-[translate,scale] duration-200 ease-out select-none group-hover/avatar:-translate-y-1 group-hover/avatar:scale-110 motion-reduce:transition-none";
const image = "object-cover";
const fallback = "bg-primary-soft text-primary";
const more = "bg-subtle text-ink";
const tooltip =
  "pointer-events-none absolute bottom-full left-1/2 mb-2 -translate-x-1/2 translate-y-1 rounded-md bg-ink px-2 py-1 text-xs font-medium whitespace-nowrap text-canvas opacity-0 shadow-overlay transition duration-150 ease-out group-hover/avatar:translate-y-0 group-hover/avatar:opacity-100 motion-reduce:transition-none";
const sizes = {
  sm: "size-8 text-xs",
  md: "size-10 text-sm",
  lg: "size-12 text-base",
};
const overlaps = {
  sm: "not-first:-ml-1.5 group-hover/avatars:not-first:ml-0.5",
  md: "not-first:-ml-2 group-hover/avatars:not-first:ml-1",
  lg: "not-first:-ml-2.5 group-hover/avatars:not-first:ml-1.5",
};

/** First letter of the first and last word, same as the Blade, React, and Vue versions. */
function getInitials(name: string): string {
  const words = name.trim().split(/\s+/).filter(Boolean);
  const picked = words.length > 1 ? [words[0], words[words.length - 1]] : words;
  return picked
    .map((word) => Array.from(word ?? "")[0] ?? "")
    .join("")
    .toUpperCase();
}

export type AvatarGroupItem = { name: string; src?: string | null };

type Props = HTMLAttributes<"div"> & {
  items: AvatarGroupItem[];
  max?: number;
  size?: keyof typeof sizes;
  /** Accessible name of the group. */
  groupLabel?: string;
  /** Hidden text on the +N chip. {count} is replaced with the number of hidden people. */
  moreLabel?: string;
};

const {
  items,
  max = 4,
  size = "md",
  groupLabel = "Members",
  moreLabel = "{count} more",
  class: className,
  ...rest
} = Astro.props;
const shown = items.slice(0, max);
const hidden = items.slice(max);
---

<div role="group" aria-label={groupLabel} {...rest} class:list={[root, className]}>
  {
    shown.map((person) => (
      <span class:list={[item, overlaps[size]]}>
        {person.src ? (
          <img src={person.src} alt={person.name} class:list={[face, image, sizes[size]]} />
        ) : (
          <span role="img" aria-label={person.name} class:list={[face, fallback, sizes[size]]}>
            {getInitials(person.name)}
          </span>
        )}
        <span aria-hidden="true" class={tooltip}>{person.name}</span>
      </span>
    ))
  }
  {
    hidden.length > 0 && (
      <span class:list={[item, overlaps[size]]}>
        <span class:list={[face, more, sizes[size]]}>
          <span aria-hidden="true">+{hidden.length}</span>
          <span class="sr-only">{moreLabel.replace("{count}", String(hidden.length))}</span>
        </span>
        <span aria-hidden="true" class={tooltip}>
          {hidden.map((person) => person.name).join(", ")}
        </span>
      </span>
    )
  }
</div>
```

```astro
---
import AvatarGroup from "@/components/markas/AvatarGroup.astro";

const team = [{ name: "Dewi Lestari", src: "/dewi.jpg" }, { name: "Budi Santoso" }];
---

<AvatarGroup items={team} max={3} groupLabel="Project members" />
```

### Angular

Simpan di `src/app/markas/avatar-group.component.ts`. Tanpa dependensi tambahan.

```ts
import {
  ChangeDetectionStrategy,
  Component,
  computed,
  input,
} from "@angular/core";

const root = "group/avatars isolate flex items-center";
const item =
  "group/avatar relative shrink-0 transition-[margin] duration-200 ease-out hover:z-10 motion-reduce:transition-none";
const face =
  "flex items-center justify-center overflow-hidden rounded-full font-medium ring-2 ring-[var(--avatar-ring,var(--color-canvas))] transition-[translate,scale] duration-200 ease-out select-none group-hover/avatar:-translate-y-1 group-hover/avatar:scale-110 motion-reduce:transition-none";
const image = "object-cover";
const fallback = "bg-primary-soft text-primary";
const more = "bg-subtle text-ink";
const tooltip =
  "pointer-events-none absolute bottom-full left-1/2 mb-2 -translate-x-1/2 translate-y-1 rounded-md bg-ink px-2 py-1 text-xs font-medium whitespace-nowrap text-canvas opacity-0 shadow-overlay transition duration-150 ease-out group-hover/avatar:translate-y-0 group-hover/avatar:opacity-100 motion-reduce:transition-none";
const sizes = {
  sm: "size-8 text-xs",
  md: "size-10 text-sm",
  lg: "size-12 text-base",
};
const overlaps = {
  sm: "not-first:-ml-1.5 group-hover/avatars:not-first:ml-0.5",
  md: "not-first:-ml-2 group-hover/avatars:not-first:ml-1",
  lg: "not-first:-ml-2.5 group-hover/avatars:not-first:ml-1.5",
};

/** First letter of the first and last word, same as the Blade, React, and Vue versions. */
function getInitials(name: string): string {
  const words = name.trim().split(/\s+/).filter(Boolean);
  const picked = words.length > 1 ? [words[0], words[words.length - 1]] : words;
  return picked
    .map((word) => Array.from(word ?? "")[0] ?? "")
    .join("")
    .toUpperCase();
}

export type AvatarGroupItem = { name: string; src?: string | null };
export type AvatarGroupSize = keyof typeof sizes;

/** Attribute selector on the group div: aria-label, class, and other attributes stay on it. */
@Component({
  selector: "div[markas-avatar-group]",
  changeDetection: ChangeDetectionStrategy.OnPush,
  host: {
    role: "group",
    "[attr.aria-label]": "groupLabel()",
    "[class]": "root",
  },
  template: `
    @for (person of shown(); track $index) {
      <span [class]="itemClasses()">
        @if (person.src) {
          <img
            [src]="person.src"
            [alt]="person.name"
            [class]="imageClasses()"
          />
        } @else {
          <span
            role="img"
            [attr.aria-label]="person.name"
            [class]="fallbackClasses()"
            >{{ initials(person.name) }}</span
          >
        }
        <span aria-hidden="true" [class]="tooltip">{{
          person.name
        }}</span></span
      >
    }
    @if (hidden().length > 0) {
      <span [class]="itemClasses()"
        ><span [class]="moreClasses()"
          ><span aria-hidden="true">+{{ hidden().length }}</span
          ><span class="sr-only">{{ moreText() }}</span></span
        ><span aria-hidden="true" [class]="tooltip">{{
          hiddenNames()
        }}</span></span
      >
    }
  `,
})
export class AvatarGroup {
  readonly items = input.required<AvatarGroupItem[]>();
  readonly max = input(4);
  readonly size = input<AvatarGroupSize>("md");
  /** Accessible name of the group. */
  readonly groupLabel = input("Members");
  /** Hidden text on the +N chip. {count} is replaced with the number of hidden people. */
  readonly moreLabel = input("{count} more");

  protected readonly root = root;
  protected readonly tooltip = tooltip;
  protected readonly initials = getInitials;
  protected readonly shown = computed(() => this.items().slice(0, this.max()));
  protected readonly hidden = computed(() => this.items().slice(this.max()));
  protected readonly hiddenNames = computed(() =>
    this.hidden()
      .map((person) => person.name)
      .join(", "),
  );
  protected readonly moreText = computed(() =>
    this.moreLabel().replace("{count}", String(this.hidden().length)),
  );
  protected readonly itemClasses = computed(
    () => `${item} ${overlaps[this.size()]}`,
  );
  protected readonly imageClasses = computed(
    () => `${face} ${image} ${sizes[this.size()]}`,
  );
  protected readonly fallbackClasses = computed(
    () => `${face} ${fallback} ${sizes[this.size()]}`,
  );
  protected readonly moreClasses = computed(
    () => `${face} ${more} ${sizes[this.size()]}`,
  );
}
```

```ts
import { Component } from "@angular/core";
import { AvatarGroup } from "./markas/avatar-group.component";

@Component({
  selector: "app-members",
  imports: [AvatarGroup],
  template: `
    <div
      markas-avatar-group
      [items]="team"
      [max]="3"
      groupLabel="Project members"
    ></div>
  `,
})
export class Members {
  team = [{ name: "Dewi Lestari", src: "/dewi.jpg" }, { name: "Budi Santoso" }];
}
```

## Props

| Nama | Tipe | Default | Keterangan |
| --- | --- | --- | --- |
| `items` | `{ name: string; src?: string }[]` | [] | Orang di dalam grup. Tanpa src, inisial name yang tampil. |
| `max` | `number` | 4 | Jumlah avatar yang tampil sebelum sisanya diringkas menjadi chip +N. |
| `size` | `'sm' \| 'md' \| 'lg'` | md | Ukuran avatar 32, 40, atau 48 piksel. Tumpukan ikut menyesuaikan. |
| `groupLabel` | `string` | Members | Nama aksesibel grup, misalnya "Anggota proyek". |
| `moreLabel` | `string` | {count} more | Teks tersembunyi di chip +N untuk screen reader. {count} diganti jumlah orang yang tersembunyi. |

## Aksesibilitas

- Tumpukan berupa group dengan nama aksesibel dari groupLabel.
- Setiap avatar adalah gambar bernama orang itu (alt atau role img dengan aria-label), jadi screen reader tidak butuh tooltip.
- Tooltip dan +N yang terlihat memakai aria-hidden; chip membacakan moreLabel.
- Dengan reduced motion, efek mengembang dan terangkat terjadi seketika tanpa transisi.

## Catatan

- Tanpa JavaScript. Versi Blade tidak butuh Alpine.js; efek hover murni CSS.
- Orang setelah `max` diringkas menjadi chip +N. Tooltip-nya berisi nama mereka dan screen reader membaca `moreLabel` ("2 lainnya").
- Ring di antara avatar memakai warna canvas. Di atas kartu, isi `class="[--avatar-ring:var(--color-surface)]"`.
- Tooltip muncul di atas grup, jadi sisakan ruang di sana.
