# Accordion

Daftar bagian yang bisa dibuka dan ditutup, dibangun dari details dan summary native tanpa JavaScript.

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

## Kapan dipakai

FAQ atau pengaturan panjang yang perlu diringkas menjadi bagian yang bisa dibuka satu per satu.

- Key atau value hanya huruf kecil, angka, dan underscore karena dipakai sebagai nama slot
- Jangan menaruh konten penting yang wajib dibaca di bagian yang tertutup

## Kode

### Blade

Simpan di `resources/views/components/markas/accordion.blade.php`. Tanpa dependensi tambahan.

```blade
@props([
    'items' => [],
    'type' => 'single',
    'defaultValue' => null,
])

@php
    $root = 'w-full divide-y divide-line border-y border-line';
    $item = 'group';
    $summary = 'flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-4 text-left text-sm font-medium text-ink transition-colors duration-150 ease-out hover:text-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary motion-reduce:transition-none [&::-webkit-details-marker]:hidden';
    $icon = 'size-4 shrink-0 text-muted transition-transform duration-200 ease-out group-open:rotate-180 motion-reduce:transition-none';
    $content = 'pb-4 text-sm text-muted';

    $defaults = array_map('strval', (array) ($defaultValue ?? []));
    $openValues = $type === 'single' ? array_slice($defaults, 0, 1) : $defaults;
    // Same id on every render, so Livewire's morph (which matches elements by id) keeps the element. Pass `id` to set it.
    $idKey = 'markas-accordion|'.(isset($this) && $this instanceof \Livewire\Component ? $this->getId() : '').'|'.($attributes->get('wire:key') ?? $attributes->whereStartsWith('wire:model')->first() ?? $attributes->get('name')).'|';
    for ($idIndex = 0; $__env->hasRenderedOnce($idKey.$idIndex); $idIndex++);
    $__env->markAsRenderedOnce($idKey.$idIndex);
    $name = $type === 'single' ? 'markas-accordion-'.hash('xxh32', $idKey.$idIndex) : null;
@endphp

<div {{ $attributes->class([$root]) }}>
    @foreach ($items as $key => $title)
        <details
            wire:ignore.self
            class="{{ $item }}"
            @if ($name) name="{{ $name }}" @endif
            @if (in_array((string) $key, $openValues, true)) open @endif
        >
            <summary class="{{ $summary }}">
                <span>{{ $title }}</span>
                <svg class="{{ $icon }}" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6" /></svg>
            </summary>
            <div class="{{ $content }}">{{ $__laravel_slots[(string) $key] ?? '' }}</div>
        </details>
    @endforeach
</div>
```

```blade
<x-markas.accordion :items="['pengiriman' => 'Berapa lama pengiriman?', 'retur' => 'Bagaimana cara retur?']" default-value="pengiriman">
    <x-slot:pengiriman>Pesanan tiba dalam 2 sampai 4 hari kerja.</x-slot:pengiriman>
    <x-slot:retur>Ajukan retur dalam 7 hari lewat halaman pesanan.</x-slot:retur>
</x-markas.accordion>
```

Tidak butuh Alpine.js.

### React

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

```tsx
import { useId, type ComponentProps, type ReactNode } from "react";

const root = "w-full divide-y divide-line border-y border-line";
const item = "group";
const summary =
  "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-4 text-left text-sm font-medium text-ink transition-colors duration-150 ease-out hover:text-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary motion-reduce:transition-none [&::-webkit-details-marker]:hidden";
const icon =
  "size-4 shrink-0 text-muted transition-transform duration-200 ease-out group-open:rotate-180 motion-reduce:transition-none";
const content = "pb-4 text-sm text-muted";
const cx = (...c: (string | false | null | undefined)[]) =>
  c.filter(Boolean).join(" ");

export type AccordionItem = {
  value: string;
  title: ReactNode;
  content: ReactNode;
};

export type AccordionProps = Omit<ComponentProps<"div">, "defaultValue"> & {
  items: AccordionItem[];
  type?: "single" | "multiple";
  defaultValue?: string | string[];
};

export function Accordion({
  items,
  type = "single",
  defaultValue,
  className,
  ...props
}: AccordionProps) {
  const generatedName = useId();
  const defaults = ([] as string[]).concat(defaultValue ?? []);
  const openValues = type === "single" ? defaults.slice(0, 1) : defaults;
  const name = type === "single" ? generatedName : undefined;

  return (
    <div className={cx(root, className)} {...props}>
      {items.map((entry) => (
        <details
          key={entry.value}
          className={item}
          name={name}
          open={openValues.includes(entry.value)}
        >
          <summary className={summary}>
            <span>{entry.title}</span>
            <svg
              className={icon}
              viewBox="0 0 24 24"
              fill="none"
              stroke="currentColor"
              strokeWidth="1.5"
              strokeLinecap="round"
              strokeLinejoin="round"
              aria-hidden="true"
            >
              <path d="m6 9 6 6 6-6" />
            </svg>
          </summary>
          <div className={content}>{entry.content}</div>
        </details>
      ))}
    </div>
  );
}
```

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

<Accordion
  defaultValue="pengiriman"
  items={[
    {
      value: "pengiriman",
      title: "Berapa lama pengiriman?",
      content: "Pesanan tiba dalam 2 sampai 4 hari kerja.",
    },
    {
      value: "retur",
      title: "Bagaimana cara retur?",
      content: "Ajukan retur dalam 7 hari lewat halaman pesanan.",
    },
  ]}
/>;
```

### Vue

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

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

export type AccordionItem = { value: string; title: string };

const props = withDefaults(
  defineProps<{
    items: AccordionItem[];
    type?: "single" | "multiple";
    defaultValue?: string | string[];
  }>(),
  { type: "single", defaultValue: undefined },
);

const root = "w-full divide-y divide-line border-y border-line";
const item = "group";
const summary =
  "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-4 text-left text-sm font-medium text-ink transition-colors duration-150 ease-out hover:text-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary motion-reduce:transition-none [&::-webkit-details-marker]:hidden";
const icon =
  "size-4 shrink-0 text-muted transition-transform duration-200 ease-out group-open:rotate-180 motion-reduce:transition-none";
const content = "pb-4 text-sm text-muted";

const generatedName = useId();
const openValues = computed(() => {
  const defaults = ([] as string[]).concat(props.defaultValue ?? []);
  return props.type === "single" ? defaults.slice(0, 1) : defaults;
});
const name = computed(() =>
  props.type === "single" ? generatedName : undefined,
);
</script>

<template>
  <div :class="root">
    <details
      v-for="entry in props.items"
      :key="entry.value"
      :class="item"
      :name="name"
      :open="openValues.includes(entry.value)"
    >
      <summary :class="summary">
        <span>{{ entry.title }}</span>
        <svg
          :class="icon"
          viewBox="0 0 24 24"
          fill="none"
          stroke="currentColor"
          stroke-width="1.5"
          stroke-linecap="round"
          stroke-linejoin="round"
          aria-hidden="true"
        >
          <path d="m6 9 6 6 6-6" />
        </svg>
      </summary>
      <div :class="content"><slot :name="entry.value" /></div>
    </details>
  </div>
</template>
```

```vue
<template>
  <Accordion
    default-value="pengiriman"
    :items="[
      { value: 'pengiriman', title: 'Berapa lama pengiriman?' },
      { value: 'retur', title: 'Bagaimana cara retur?' },
    ]"
  >
    <template #pengiriman>Pesanan tiba dalam 2 sampai 4 hari kerja.</template>
    <template #retur>Ajukan retur dalam 7 hari lewat halaman pesanan.</template>
  </Accordion>
</template>
```

### Svelte

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

```svelte
<script lang="ts" module>
  import type { Snippet } from "svelte";

  export type AccordionItem = {
    value: string;
    title: string;
    /** Plain text or a snippet for rich content. */
    content?: string | Snippet;
  };
</script>

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

  const root = "w-full divide-y divide-line border-y border-line";
  const item = "group";
  const summary =
    "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-4 text-left text-sm font-medium text-ink transition-colors duration-150 ease-out hover:text-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary motion-reduce:transition-none [&::-webkit-details-marker]:hidden";
  const icon =
    "size-4 shrink-0 text-muted transition-transform duration-200 ease-out group-open:rotate-180 motion-reduce:transition-none";
  const content = "pb-4 text-sm text-muted";

  type Props = HTMLAttributes<HTMLDivElement> & {
    items: AccordionItem[];
    type?: "single" | "multiple";
    defaultValue?: string | string[];
  };

  let {
    items,
    type = "single",
    defaultValue,
    class: className,
    ...rest
  }: Props = $props();

  const generatedName = $props.id();
  const openValues = $derived.by(() => {
    const defaults = ([] as string[]).concat(defaultValue ?? []);
    return type === "single" ? defaults.slice(0, 1) : defaults;
  });
  const name = $derived(type === "single" ? generatedName : undefined);
</script>

<div class={[root, className]} {...rest}>
  {#each items as entry (entry.value)}
    <details class={item} {name} open={openValues.includes(entry.value)}>
      <summary class={summary}>
        <span>{entry.title}</span>
        <svg
          class={icon}
          viewBox="0 0 24 24"
          fill="none"
          stroke="currentColor"
          stroke-width="1.5"
          stroke-linecap="round"
          stroke-linejoin="round"
          aria-hidden="true"
        >
          <path d="m6 9 6 6 6-6" />
        </svg>
      </summary>
      <div class={content}>
        {#if typeof entry.content === "function"}
          {@render entry.content()}
        {:else}
          {entry.content ?? ""}
        {/if}
      </div>
    </details>
  {/each}
</div>
```

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

  const items = [
    {
      value: "pengiriman",
      title: "Berapa lama pengiriman?",
      content: "Pesanan tiba dalam 2 sampai 4 hari kerja.",
    },
    { value: "retur", title: "Bagaimana cara retur?", content: retur },
  ];
</script>

{#snippet retur()}
  Ajukan retur dalam 7 hari lewat <a href="/pesanan">halaman pesanan</a>.
{/snippet}

<Accordion {items} defaultValue="pengiriman" />
```

`content` menerima teks biasa atau snippet untuk isi kaya.

### Astro

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

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

export type AccordionItem = {
  value: string;
  title: string;
  /** Plain text. Without it the section renders the slot named after value. */
  content?: string;
};

type Props = HTMLAttributes<"div"> & {
  items: AccordionItem[];
  type?: "single" | "multiple";
  defaultValue?: string | string[];
};

const root = "w-full divide-y divide-line border-y border-line";
const item = "group";
const summary =
  "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-4 text-left text-sm font-medium text-ink transition-colors duration-150 ease-out hover:text-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary motion-reduce:transition-none [&::-webkit-details-marker]:hidden";
const icon =
  "size-4 shrink-0 text-muted transition-transform duration-200 ease-out group-open:rotate-180 motion-reduce:transition-none";
const content = "pb-4 text-sm text-muted";

const {
  items,
  type = "single",
  defaultValue,
  class: className,
  ...rest
} = Astro.props;

const defaults = ([] as string[]).concat(defaultValue ?? []);
const openValues = type === "single" ? defaults.slice(0, 1) : defaults;
const name =
  type === "single"
    ? `markas-accordion-${crypto.randomUUID().slice(0, 8)}`
    : undefined;
const slotted = await Promise.all(
  items.map((entry) =>
    entry.content === undefined && Astro.slots.has(entry.value)
      ? Astro.slots.render(entry.value)
      : undefined,
  ),
);
---

<div class:list={[root, className]} {...rest}>
  {
    items.map((entry, index) => (
      <details
        class={item}
        name={name}
        open={openValues.includes(entry.value)}
      >
        <summary class={summary}>
          <span>{entry.title}</span>
          <svg
            class={icon}
            viewBox="0 0 24 24"
            fill="none"
            stroke="currentColor"
            stroke-width="1.5"
            stroke-linecap="round"
            stroke-linejoin="round"
            aria-hidden="true"
          >
            <path d="m6 9 6 6 6-6" />
          </svg>
        </summary>
        <div class={content}>
          {slotted[index] === undefined ? (
            entry.content
          ) : (
            <Fragment set:html={slotted[index]} />
          )}
        </div>
      </details>
    ))
  }
</div>
```

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

const items = [
  {
    value: "pengiriman",
    title: "Berapa lama pengiriman?",
    content: "Pesanan tiba dalam 2 sampai 4 hari kerja.",
  },
  { value: "retur", title: "Bagaimana cara retur?" },
];
---

<Accordion items={items} defaultValue="pengiriman">
  <p slot="retur">Ajukan retur dalam 7 hari lewat halaman pesanan.</p>
</Accordion>
```

Item tanpa `content` merender slot dengan nama sama seperti `value`-nya. Tidak ada JavaScript yang dikirim.

### Angular

Simpan di `src/app/markas/accordion.component.ts`. Tanpa dependensi tambahan.

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

const root = "w-full divide-y divide-line border-y border-line";
const item = "group";
const summary =
  "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-4 text-left text-sm font-medium text-ink transition-colors duration-150 ease-out hover:text-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary motion-reduce:transition-none [&::-webkit-details-marker]:hidden";
const icon =
  "size-4 shrink-0 text-muted transition-transform duration-200 ease-out group-open:rotate-180 motion-reduce:transition-none";
const content = "pb-4 text-sm text-muted";

export type AccordionItem = {
  value: string;
  title: string;
  /** Plain text or an ng-template reference for rich content. */
  content?: string | TemplateRef<unknown>;
};

let nextId = 0;

/**
 * Host stays out of layout; the user's class moves to the root element.
 * Rich content: `<ng-template #pro>...</ng-template>` and `content: pro` in the item.
 */
@Component({
  selector: "markas-accordion",
  changeDetection: ChangeDetectionStrategy.OnPush,
  imports: [NgTemplateOutlet],
  host: { class: "contents" },
  template: `
    <div [class]="rootClasses()">
      @for (entry of items(); track entry.value) {
        <details
          [class]="item"
          [attr.name]="name()"
          [open]="openValues().includes(entry.value)"
        >
          <summary [class]="summary">
            <span>{{ entry.title }}</span>
            <svg
              [class]="icon"
              viewBox="0 0 24 24"
              fill="none"
              stroke="currentColor"
              stroke-width="1.5"
              stroke-linecap="round"
              stroke-linejoin="round"
              aria-hidden="true"
            >
              <path d="m6 9 6 6 6-6" />
            </svg>
          </summary>
          <div [class]="content">
            @if (isTemplate(entry.content)) {
              <ng-container [ngTemplateOutlet]="entry.content" />
            } @else {
              {{ entry.content ?? "" }}
            }
          </div>
        </details>
      }
    </div>
  `,
})
export class Accordion {
  readonly items = input.required<AccordionItem[]>();
  readonly type = input<"single" | "multiple">("single");
  readonly defaultValue = input<string | string[]>();
  readonly userClass = input("", { alias: "class" });

  protected readonly item = item;
  protected readonly summary = summary;
  protected readonly icon = icon;
  protected readonly content = content;
  private readonly generatedName = `markas-accordion-${nextId++}`;
  protected readonly openValues = computed(() => {
    const defaults = ([] as string[]).concat(this.defaultValue() ?? []);
    return this.type() === "single" ? defaults.slice(0, 1) : defaults;
  });
  protected readonly name = computed(() =>
    this.type() === "single" ? this.generatedName : null,
  );
  protected readonly rootClasses = computed(() =>
    [root, this.userClass()].filter(Boolean).join(" "),
  );

  protected isTemplate(
    value: AccordionItem["content"],
  ): value is TemplateRef<unknown> {
    return typeof value === "object";
  }
}
```

```ts
import { Component } from "@angular/core";
import { Accordion } from "./markas/accordion.component";

@Component({
  selector: "app-faq",
  imports: [Accordion],
  template: `
    <ng-template #retur>
      Ajukan retur dalam 7 hari lewat <a href="/pesanan">halaman pesanan</a>.
    </ng-template>
    <markas-accordion
      [items]="[
        {
          value: 'pengiriman',
          title: 'Berapa lama pengiriman?',
          content: 'Pesanan tiba dalam 2 sampai 4 hari kerja.',
        },
        { value: 'retur', title: 'Bagaimana cara retur?', content: retur },
      ]"
      defaultValue="pengiriman"
    />
  `,
})
export class Faq {}
```

`content` menerima teks biasa atau referensi `ng-template` untuk isi kaya.

## Props

| Nama | Tipe | Default | Keterangan |
| --- | --- | --- | --- |
| `items` | `Blade: array<key, title> · React: { value, title, content }[] · Vue: { value, title }[] · Svelte: { value, title, content: string \| Snippet }[] · Astro: { value, title, content? }[] · Angular: { value, title, content: string \| TemplateRef }[]` | [] | Daftar bagian. Di Blade dan Vue, isi tiap bagian lewat slot dengan nama sama seperti key/value. Astro memakai slot bernama yang sama bila item tidak punya content. Svelte menerima snippet dan Angular referensi ng-template untuk isi kaya. |
| `type` | `'single' \| 'multiple'` | 'single' | single: hanya satu bagian terbuka (atribut name yang sama di details). multiple: bebas. |
| `defaultValue` | `string \| string[]` | - | Bagian yang terbuka saat pertama dirender. Pada type single hanya nilai pertama yang dipakai. |

## Aksesibilitas

- Memakai details dan summary native, jadi summary berperan sebagai tombol dengan status terbuka atau tertutup.
- Enter dan Spasi pada summary membuka dan menutup bagian.
- Ikon chevron diberi aria-hidden.

## Catatan

- `type="single"` (default) memberi atribut `name` yang sama ke setiap `details`, sehingga browser menutup bagian lain secara native. Pakai `type="multiple"` agar beberapa bagian bisa terbuka bersamaan.
- Browser lama yang belum mendukung `details[name]` tetap bisa membuka bagian, hanya tidak eksklusif.
- Komponen ini tidak punya teks bawaan. Judul dan isi berasal dari data Anda sendiri, jadi cukup tulis dalam Bahasa Indonesia.
