Toggle Group
Toggle Group adalah deretan chip yang menyaring isi halaman, misalnya status rilis, atau mengganti cara isinya ditampilkan.
Kapan dipakai
Section titled “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 kalau setiap pilihan menampilkan isi yang berbeda, dan Select untuk lebih dari lima pilihan.
- Pakai mode beberapa aktif untuk filter yang bisa digabung, misalnya genre.
Anatomi
Section titled “Anatomi”- 1Chip terpilih
- 2Chip
- 3Grup, 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
Section titled “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.
| 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. |
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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/toggle-group.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/toggle-group.jsonAksesibilitas
Section titled “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.
