Lewati ke konten

Toggle Group

Unduh .md

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

  • 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.
React
Vue
123
  1. 1Chip terpilih
  2. 2Chip
  3. 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.

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>
)
}
Terminal window
npx shadcn@latest add https://design.sosialoka.tech/r/react/toggle-group.json
  • 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.