# Collapsible

Satu bagian yang bisa dibuka dan ditutup memakai details dan summary native tanpa JavaScript. Cocok untuk konten tampilkan lebih banyak.

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

## Kapan dipakai

Menyembunyikan konten sekunder di balik satu tombol, misalnya detail tambahan, pengaturan lanjutan, atau deskripsi panjang.

- Pakai satu Collapsible per bagian mandiri; pakai Accordion untuk daftar bagian yang saling terkait
- Tulis judul sebagai label jelas dari isi yang tersembunyi, bukan sekadar "Lainnya"
- Jangan menyembunyikan field form wajib atau peringatan penting di dalam Collapsible yang tertutup

## Kode

### Blade

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

```blade
@props([
    'title' => '',
    'open' => false,
])

@php
    $root = 'group w-full';
    $summary = 'flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-2 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 = 'pt-2 pb-2 text-sm text-muted';
@endphp

<details wire:ignore.self {{ $attributes->class([$root]) }} @if ($open) 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 }}">{{ $slot }}</div>
</details>
```

```blade
<x-markas.collapsible title="Tampilkan detail pesanan">
    Dikirim dari Jakarta pada 4 November. Nomor resi JKT-2210-884.
</x-markas.collapsible>
```

Tidak butuh Alpine.js. Pakai slot `title` untuk isi kaya: `<x-slot:title>Tampilkan <strong>3</strong> lagi</x-slot:title>`.

### React

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

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

const root = "group w-full";
const summary =
  "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-2 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 = "pt-2 pb-2 text-sm text-muted";
const cx = (...c: (string | false | null | undefined)[]) =>
  c.filter(Boolean).join(" ");

export type CollapsibleProps = Omit<ComponentProps<"details">, "title"> & {
  title: ReactNode;
  open?: boolean;
};

export function Collapsible({
  title,
  open = false,
  className,
  children,
  ...props
}: CollapsibleProps) {
  return (
    <details className={cx(root, className)} open={open} {...props}>
      <summary className={summary}>
        <span>{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}>{children}</div>
    </details>
  );
}
```

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

<Collapsible title="Tampilkan detail pesanan" open>
  Dikirim dari Jakarta pada 4 November. Nomor resi JKT-2210-884.
</Collapsible>;
```

### Vue

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

```vue
<script setup lang="ts">
const props = withDefaults(
  defineProps<{
    title?: string;
    open?: boolean;
  }>(),
  { title: "", open: false },
);

const root = "group w-full";
const summary =
  "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-2 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 = "pt-2 pb-2 text-sm text-muted";
</script>

<template>
  <details :class="root" :open="props.open">
    <summary :class="summary">
      <span
        ><slot name="title">{{ props.title }}</slot></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 /></div>
  </details>
</template>
```

```vue
<template>
  <Collapsible title="Tampilkan detail pesanan">
    Dikirim dari Jakarta pada 4 November. Nomor resi JKT-2210-884.
  </Collapsible>
</template>
```

### Svelte

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

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

  const root = "group w-full";
  const summary =
    "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-2 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 = "pt-2 pb-2 text-sm text-muted";

  type Props = Omit<HTMLDetailsAttributes, "title" | "open"> & {
    /** Summary text, or a snippet for rich content. */
    title?: string | Snippet;
    open?: boolean;
    children?: Snippet;
  };

  let {
    title = "",
    open = $bindable(false),
    class: className,
    children,
    ...rest
  }: Props = $props();
</script>

<details class={[root, className]} bind:open {...rest}>
  <summary class={summary}>
    <span
      >{#if typeof title === "function"}{@render title()}{:else}{title}{/if}</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}>{@render children?.()}</div>
</details>
```

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

  let open = $state(false);
</script>

<Collapsible title="Tampilkan detail pesanan" bind:open>
  Dikirim dari Jakarta pada 4 November. Nomor resi JKT-2210-884.
</Collapsible>
```

Untuk isi kaya, kirim snippet sebagai ganti string: `{#snippet title()}Tampilkan <strong>3</strong> lagi{/snippet}`.

### Astro

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

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

type Props = Omit<HTMLAttributes<"details">, "title"> & {
  /** Summary text. A title slot overrides it for rich content. */
  title?: string;
  open?: boolean;
};

const root = "group w-full";
const summary =
  "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-2 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 = "pt-2 pb-2 text-sm text-muted";

const { title = "", open = false, class: className, ...rest } = Astro.props;
---

<details class:list={[root, className]} open={open} {...rest}>
  <summary class={summary}>
    <span><slot name="title">{title}</slot></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"></path>
    </svg>
  </summary>
  <div class={content}><slot /></div>
</details>
```

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

<Collapsible title="Tampilkan detail pesanan">
  Dikirim dari Jakarta pada 4 November. Nomor resi JKT-2210-884.
</Collapsible>
```

Tidak ada JavaScript yang dikirim. Pakai slot `title` untuk isi kaya: `<Fragment slot="title">Tampilkan <strong>3</strong> lagi</Fragment>`.

### Angular

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

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

const root = "group w-full";
const summary =
  "flex cursor-pointer list-none items-center justify-between gap-4 rounded-md py-2 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 = "pt-2 pb-2 text-sm text-muted";

/**
 * Attribute selector on the native details: id, class, and the toggle event stay on the
 * element itself. The title input is cleared from the host so it does not become a tooltip.
 * An element with the `title` attribute (ng-container works) replaces the title text.
 */
@Component({
  selector: "details[markas-collapsible]",
  changeDetection: ChangeDetectionStrategy.OnPush,
  host: { "[class]": "root", "[attr.title]": "null", "[open]": "open()" },
  template: `
    <summary [class]="summary">
      <span
        ><ng-content select="[title]">{{ title() }}</ng-content></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"><ng-content /></div>
  `,
})
export class Collapsible {
  readonly title = input("");
  /** Starting state. Listen to the native (toggle) event for changes. */
  readonly open = input(false, { transform: booleanAttribute });

  protected readonly root = root;
  protected readonly summary = summary;
  protected readonly icon = icon;
  protected readonly content = content;
}
```

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

@Component({
  selector: "app-pesanan",
  imports: [Collapsible],
  template: `
    <details markas-collapsible title="Tampilkan detail pesanan">
      Dikirim dari Jakarta pada 4 November. Nomor resi JKT-2210-884.
    </details>
  `,
})
export class Pesanan {}
```

Komponen dipasang langsung di `details` native, jadi `open`, `class`, dan `(toggle)` langsung berlaku. Untuk isi kaya tambahkan `<ng-container title>Tampilkan <strong>3</strong> lagi</ng-container>`.

## Props

| Nama | Tipe | Default | Keterangan |
| --- | --- | --- | --- |
| `title` | `string / slot / ReactNode / snippet` | - | Teks baris ringkasan. Blade, Vue, dan Astro juga menerima slot title, Svelte snippet title, dan Angular elemen dengan atribut title (ng-container bisa) untuk isi kaya. |
| `open` | `boolean` | false | Bagian dimulai dalam keadaan terbuka. Svelte mendukung bind:open. |
| `children / slot` | `ReactNode / slot` | - | Isi yang tampil saat bagian terbuka. |

## Aksesibilitas

- Memakai details dan summary native, jadi summary adalah tombol disclosure yang bisa difokus dan diumumkan terbuka atau tertutup.
- Enter dan Spasi membuka atau menutup bagian; tidak butuh JavaScript.
- Ikon chevron bersifat dekoratif dan disembunyikan dari teknologi bantu.

## Catatan

- Dibangun di atas `details` dan `summary`, jadi berfungsi tanpa JavaScript dan browser yang menangani keyboard serta status pembaca layar.
- `open` hanya mengatur keadaan awal. Dengarkan event native `toggle` untuk menanggapi perubahan.
- Untuk beberapa bagian terkait yang hanya boleh terbuka satu, pakai Accordion.
