# Toggle Group

> Chip yang menyaring atau mengganti tampilan; satu atau beberapa bisa aktif.

Toggle Group adalah deretan chip yang menyaring isi halaman, misalnya status rilis, atau mengganti cara isinya ditampilkan.

## Kapan dipakai

- Pakai untuk filter cepat di atas daftar, dengan jumlah di setiap chip: "Terbit 12".
- Filter status **selalu punya satu nilai**: "Semua" sebagai bawaan, dan klik pada chip yang aktif tetap membuatnya aktif.
- Pakai [Tabs](https://design.sosialoka.tech/id/components/tabs/) kalau setiap pilihan menampilkan isi yang berbeda, dan [Select](https://design.sosialoka.tech/id/components/select/) untuk lebih dari lima pilihan.
- Pakai mode beberapa aktif untuk filter yang bisa digabung, misalnya genre.

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

## Anatomi

1. Chip terpilih
2. Chip
3. Grup, satu nilai sekaligus

Chip `h-8` dengan `radius-md` dan `border`, berjarak 8px, tidak pernah berbentuk pil. Chip aktif berwarna `primary-soft` dengan `primary-text` dan border bernuansa `primary`. Jumlah opsional ada setelah label, berwarna `muted-foreground`.

## Varian

| Mode | Pakai untuk |
| --- | --- |
| Satu aktif | Filter status, pengganti tampilan. |
| Beberapa aktif (`multiple`) | Filter yang bisa digabung. |

**Toggle** tunggal (satu tombol yang tetap tertekan) ikut terpasang bersama grupnya dan tidak punya halaman sendiri.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `multiple` | `type="single"` / `"multiple"` | `ShadToggleGroup` / `ShadToggleGroup.multiple` | mode | satu aktif | Berapa chip yang boleh aktif. |
| `value` (array) / `onValueChange` | `v-model` | `initialValue` / `onChanged` | nilai | tidak ada | Chip yang aktif. |
| jaga satu aktif: abaikan nilai kosong | jaga satu aktif: abaikan nilai kosong | `allowDeselection: false` | boolean | bisa dikosongkan | Mencegah filter status menjadi kosong. |
| `variant="outline"` | `variant="outline"` | `ShadToggleVariant.outline` | teks | `default` | Tampilan chip. |
| `spacing` | `spacing` | `spacing` | angka | `2` (React), `0` (Vue) | Jarak antarchip; `0` menyambungkannya. Pakai `2`. |

## Kode

**React**
```tsx
import { useState } from "react"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"

const statuses = [
  { value: "all", label: "Semua", count: 24 },
  { value: "published", label: "Terbit", count: 12 },
  { value: "pending", label: "Menunggu", count: 8 },
  { value: "rejected", label: "Ditolak", count: 4 },
]

export default function ToggleGroupDemo() {
  const [status, setStatus] = useState("all")
  return (
    <ToggleGroup
      variant="outline"
      spacing={2}
      aria-label="Filter status"
      value={[status]}
      // A status filter always has one value: clicking the active chip keeps it on.
      onValueChange={(value) => value.length > 0 && setStatus(value[value.length - 1])}
    >
      {statuses.map((s) => (
        <ToggleGroupItem key={s.value} value={s.value}>
          {s.label}
          <span className="tabular-nums text-muted-foreground">{s.count}</span>
        </ToggleGroupItem>
      ))}
    </ToggleGroup>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import { ref } from "vue"
import { ToggleGroup, ToggleGroupItem } from "@/components/ui/toggle-group"

const statuses = [
  { value: "all", label: "Semua", count: 24 },
  { value: "published", label: "Terbit", count: 12 },
  { value: "pending", label: "Menunggu", count: 8 },
  { value: "rejected", label: "Ditolak", count: 4 },
]
const status = ref("all")

// A status filter always has one value: clicking the active chip keeps it on.
function pick(value: unknown) {
  if (typeof value === "string" && value) status.value = value
}
</script>

<template>
  <ToggleGroup type="single" variant="outline" :spacing="2" aria-label="Filter status" :model-value="status" @update:model-value="pick">
    <ToggleGroupItem v-for="s in statuses" :key="s.value" :value="s.value">
      {{ s.label }}
      <span class="tabular-nums text-muted-foreground">{{ s.count }}</span>
    </ToggleGroupItem>
  </ToggleGroup>
</template>
```

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

const releaseStatuses = [('all', 'Semua', 24), ('published', 'Terbit', 12), ('pending', 'Menunggu', 8), ('rejected', 'Ditolak', 4)];

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

  @override
  Widget build(BuildContext context) {
    final theme = ShadTheme.of(context);
    // A status filter always has one value: allowDeselection keeps the active chip on.
    return ShadToggleGroup<String>(
      initialValue: 'all',
      allowDeselection: false,
      variant: ShadToggleVariant.outline,
      spacing: 8,
      items: [
        for (final (value, label, count) in releaseStatuses)
          ShadToggleGroupItem(
            value: value,
            child: Row(
              mainAxisSize: MainAxisSize.min,
              spacing: 6,
              children: [Text(label), Text('$count', style: theme.textTheme.muted)],
            ),
          ),
      ],
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Beri nama grupnya lewat `aria-label`, misalnya "Filter status".
- Setiap chip memberi tahu apakah sedang aktif lewat `aria-pressed`.
- Tombol panah berpindah antarchip; Spasi dan Enter mengaktifkannya.
- Taruh jumlah di dalam chip, supaya ikut dibacakan bersama labelnya.
