# Accordion

> Menampilkan dan menyembunyikan bagian isi satu per satu.

Accordion menumpuk bagian-bagian di bawah judulnya dan membukanya satu per satu, supaya halaman yang panjang tetap ringkas.

## Kapan dipakai

- Pakai untuk tanya jawab, kelompok pengaturan, dan detail yang hanya dibutuhkan sebagian orang.
- Pakai [Tabs](https://design.sosialoka.tech/id/components/tabs/) untuk berpindah antartampilan dari hal yang sama, dan halaman biasa kalau setiap bagian penting.
- Jangan sembunyikan informasi wajib di bagian yang tertutup: orang mungkin tidak pernah membukanya.
- Di HP, accordion juga mengubah baris tabel menjadi bagian-bagian; lihat pola [Tabel responsif](https://design.sosialoka.tech/id/patterns/responsive-table/).

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

## Anatomi

1. Header bagian yang terbuka
2. Isi
3. Bagian yang tertutup
4. Chevron

Item dipisahkan `border-b` berwarna `border`. Setiap item punya trigger (`py-4 text-sm font-medium`, dengan chevron yang berputar 180° saat terbuka) dan isinya (`pb-4 text-sm`).

## Varian

| Mode | Pakai untuk |
| --- | --- |
| Satu terbuka (bawaan) | Tanya jawab, cukup satu jawaban yang dibaca. |
| Beberapa terbuka (`multiple`) | Kelompok pengaturan yang dibandingkan. |

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `multiple` | `type="single"` / `"multiple"` | `ShadAccordion` / `ShadAccordion.multiple` | mode | satu terbuka | Berapa bagian yang boleh terbuka. |
| selalu bisa ditutup | `collapsible` | selalu bisa ditutup | boolean | `false` di Vue | Bagian yang terbuka bisa ditutup lagi. |
| `value` / `defaultValue` | `v-model` / `default-value` | `initialValue` | nilai | tidak ada | Bagian yang terbuka. |
| `AccordionItem value` | `AccordionItem value` | `ShadAccordionItem value` | nilai | tidak ada | Nama satu bagian. |

## Kode

**React**
```tsx
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/ui/accordion"

const questions = [
  { q: "Berapa lama clearance selesai?", a: "Biasanya 5–7 hari kerja setelah dokumenmu lengkap. Kamu dapat kabar di setiap langkah." },
  { q: "Lagu apa saja yang bisa kamu cover?", a: "Lagu yang ada di katalog kami. Cari judulnya di menu Katalog." },
  { q: "Kapan royalti dibayar?", a: "Setiap bulan, paling lambat tanggal 25, ke rekening yang terdaftar di akunmu." },
]

export default function AccordionDemo() {
  return (
    <Accordion className="w-full max-w-md">
      {questions.map(({ q, a }) => (
        <AccordionItem key={q} value={q}>
          <AccordionTrigger>{q}</AccordionTrigger>
          <AccordionContent>{a}</AccordionContent>
        </AccordionItem>
      ))}
    </Accordion>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "@/components/ui/accordion"

const questions = [
  { q: "Berapa lama clearance selesai?", a: "Biasanya 5–7 hari kerja setelah dokumenmu lengkap. Kamu dapat kabar di setiap langkah." },
  { q: "Lagu apa saja yang bisa kamu cover?", a: "Lagu yang ada di katalog kami. Cari judulnya di menu Katalog." },
  { q: "Kapan royalti dibayar?", a: "Setiap bulan, paling lambat tanggal 25, ke rekening yang terdaftar di akunmu." },
]
</script>

<template>
  <Accordion type="single" collapsible class="w-full max-w-md">
    <AccordionItem v-for="item in questions" :key="item.q" :value="item.q">
      <AccordionTrigger>{{ item.q }}</AccordionTrigger>
      <AccordionContent>{{ item.a }}</AccordionContent>
    </AccordionItem>
  </Accordion>
</template>
```

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

const questions = [
  ('Berapa lama clearance selesai?', 'Biasanya 5–7 hari kerja setelah dokumenmu lengkap. Kamu dapat kabar di setiap langkah.'),
  ('Lagu apa saja yang bisa kamu cover?', 'Lagu yang ada di katalog kami. Cari judulnya di menu Katalog.'),
  ('Kapan royalti dibayar?', 'Setiap bulan, paling lambat tanggal 25, ke rekening yang terdaftar di akunmu.'),
];

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

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(maxWidth: 448),
      child: ShadAccordion<int>(
        children: [
          for (var i = 0; i < questions.length; i++)
            ShadAccordionItem(value: i, title: Text(questions[i].$1), child: Text(questions[i].$2)),
        ],
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Setiap trigger berupa tombol dengan `aria-expanded` dan `aria-controls` yang menunjuk ke isinya.
- Enter dan Spasi membuka dan menutup bagian; Tab berpindah antartrigger.
- Tulis teks trigger sebagai pertanyaan atau judul utuh, supaya tetap jelas saat dibaca sendiri.
