# Switch

> Menyalakan atau mematikan pengaturan saat itu juga.

Switch menyalakan atau mematikan satu pengaturan, dan perubahannya langsung berlaku tanpa tombol simpan.

## Kapan dipakai

- Pakai untuk pengaturan yang langsung berlaku, misalnya notifikasi email.
- Pakai [Checkbox](https://design.sosialoka.tech/id/components/checkbox/) untuk pilihan yang disimpan bersama form, atau untuk persetujuan syarat.
- Tulis labelnya sebagai pengaturan, bukan pertanyaan: "Kirim notifikasi email".

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

### Lakukan dan jangan

- **Lakukan:** Pakai switch untuk pengaturan yang langsung berlaku saat diubah.
- **Jangan:** Jangan taruh switch di form yang menunggu tombol simpan; pakai checkbox di sana.

## Anatomi

1. Track, primary saat aktif
2. Thumb
3. Label
4. Kondisi 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

Dua ukuran: `default` dan `sm`.

## Props

| 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. |

## Kode

**React**
```tsx
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>
  )
}
```

**Vue**
```vue
<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>
```

**Flutter**
```dart
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

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

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

## Aksesibilitas

- Punya `role="switch"` dan `aria-checked`.
- Spasi mengubah statusnya; klik label juga mengubahnya.
- Hubungkan deskripsi lewat `aria-describedby`.
