Switch
Switch menyalakan atau mematikan satu pengaturan, dan perubahannya langsung berlaku tanpa tombol simpan.
Kapan dipakai
Section titled “Kapan dipakai”- Pakai untuk pengaturan yang langsung berlaku, misalnya notifikasi email.
- Pakai Checkbox untuk pilihan yang disimpan bersama form, atau untuk persetujuan syarat.
- Tulis labelnya sebagai pengaturan, bukan pertanyaan: “Kirim notifikasi email”.
Kabar rilis dan royalti masuk ke inbox kamu.
Kabar rilis dan royalti masuk ke inbox kamu.
Lakukan dan jangan
Section titled “Lakukan dan jangan”Anatomi
Section titled “Anatomi”- 1Track, primary saat aktif
- 2Thumb
- 3Label
- 4Kondisi mati
Track berbentuk pil yang berwarna input saat mati dan primary saat menyala, dengan thumb background. Letaknya di depan label dan deskripsi satu kalimat, di dalam Field berorientasi horizontal.
Varian
Section titled “Varian”Dua ukuran: default dan sm.
| React | Vue | Flutter | Tipe | Default | Kegunaan |
|---|---|---|---|---|---|
checked / defaultChecked |
v-model / default-value |
value |
boolean | false |
Menyala atau mati. |
onCheckedChange |
@update:model-value |
onChanged |
function | tidak ada | Jalan saat berubah. |
size |
size |
width / height |
default, sm |
default |
Ukuran. |
disabled |
disabled |
enabled: false |
boolean | false |
Mencegah perubahan. |
label di FieldLabel |
label di FieldLabel |
label, sublabel |
teks | tidak ada | Nama pengaturan. |
import { useId } from "react"import { Field, FieldContent, FieldDescription, FieldLabel } from "@/components/ui/field"import { Switch } from "@/components/ui/switch"
export default function SwitchDemo() { const id = useId() return ( <Field orientation="horizontal" className="w-full max-w-sm"> <Switch id={`${id}-email`} aria-describedby={`${id}-email-hint`} /> <FieldContent> <FieldLabel htmlFor={`${id}-email`}>Kirim notifikasi email</FieldLabel> <FieldDescription id={`${id}-email-hint`}>Kabar rilis dan royalti masuk ke inbox kamu.</FieldDescription> </FieldContent> </Field> )}<script setup lang="ts">import { useId } from "vue"import { Field, FieldContent, FieldDescription, FieldLabel } from "@/components/ui/field"import { Switch } from "@/components/ui/switch"
const id = useId()</script>
<template> <Field orientation="horizontal" class="w-full max-w-sm"> <Switch :id="`${id}-email`" :aria-describedby="`${id}-email-hint`" /> <FieldContent> <FieldLabel :for="`${id}-email`">Kirim notifikasi email</FieldLabel> <FieldDescription :id="`${id}-email-hint`">Kabar rilis dan royalti masuk ke inbox kamu.</FieldDescription> </FieldContent> </Field></template>import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';
class SwitchDemo extends StatefulWidget { const SwitchDemo({super.key});
@override State<SwitchDemo> createState() => _SwitchDemoState();}
class _SwitchDemoState extends State<SwitchDemo> { bool email = false;
@override Widget build(BuildContext context) { return ShadSwitch( value: email, onChanged: (value) => setState(() => email = value), label: const Text('Kirim notifikasi email'), sublabel: const Text('Kabar rilis dan royalti masuk ke inbox kamu.'), ); }}Pasang
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/switch.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/switch.jsonAksesibilitas
Section titled “Aksesibilitas”- Punya
role="switch"danaria-checked. - Spasi mengubah statusnya; klik label juga mengubahnya.
- Hubungkan deskripsi lewat
aria-describedby.
