# Select

> Memilih satu nilai dari daftar pendek.

Select memilih satu nilai dari daftar pendek yang terbuka di popup.

## Kapan dipakai

- Pakai untuk 4 sampai 15 pilihan.
- Pakai radio button untuk 2 atau 3 pilihan, supaya semuanya langsung terlihat.
- Pakai [Combobox](https://design.sosialoka.tech/id/components/combobox/) kalau daftarnya panjang atau perlu dicari.

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

## Anatomi

1. Pemicu yang menampilkan nilai
2. Chevron
3. Daftar pilihan
4. Pilihan terpilih dengan centang

Trigger dengan `radius-md` yang menampilkan nilai terpilih atau placeholder, dan popup berlatar `popover` dengan `radius-lg` dan bayangan `shadow-md`. Popup dirender di luar alur halaman, jadi tidak pernah terpotong oleh kartu.

## Varian

Hanya ada satu gaya, dengan dua ukuran trigger: `default` dan `sm`.

## Props

| React | Vue | Flutter | Tipe | Default | Kegunaan |
| --- | --- | --- | --- | --- | --- |
| `items` | children (`SelectItem`) | `options` | list | tidak ada | Pilihan. Di React, Base UI butuh `items` di root. |
| `value` / `defaultValue` | `v-model` / `default-value` | `initialValue` | string | tidak ada | Nilai terpilih. |
| `onValueChange` | `@update:model-value` | `onChanged` | function | tidak ada | Jalan saat nilai berubah. |
| item placeholder (`value: null`) | `placeholder` di `SelectValue` | `placeholder` | teks | tidak ada | Tampil sebelum ada pilihan. |
| `disabled` | `disabled` | `enabled: false` | boolean | `false` | Mencegah popup terbuka. |

## Kode

**React**
```tsx
import {
  Select,
  SelectContent,
  SelectGroup,
  SelectItem,
  SelectTrigger,
  SelectValue,
} from "@/components/ui/select"

const products = [
  { label: "Pilih produk", value: null },
  { label: "Loka Musik", value: "lokamusik" },
  { label: "Cover Clearance", value: "coverclearance" },
  { label: "Lokasign", value: "lokasign" },
  { label: "My Loka Link", value: "mylokalink" },
]

export default function SelectDemo() {
  return (
    <Select items={products}>
      <SelectTrigger className="w-56" aria-label="Produk">
        <SelectValue />
      </SelectTrigger>
      <SelectContent>
        <SelectGroup>
          {products
            .filter((p) => p.value !== null)
            .map((p) => (
              <SelectItem key={p.value} value={p.value}>
                {p.label}
              </SelectItem>
            ))}
        </SelectGroup>
      </SelectContent>
    </Select>
  )
}
```

**Vue**
```vue
<script setup lang="ts">
import {
  Select,
  SelectContent,
  SelectGroup,
  SelectItem,
  SelectTrigger,
  SelectValue,
} from "@/components/ui/select"

const products = [
  { label: "Loka Musik", value: "lokamusik" },
  { label: "Cover Clearance", value: "coverclearance" },
  { label: "Lokasign", value: "lokasign" },
  { label: "My Loka Link", value: "mylokalink" },
]
</script>

<template>
  <Select>
    <SelectTrigger class="w-56" aria-label="Produk">
      <SelectValue placeholder="Pilih produk" />
    </SelectTrigger>
    <SelectContent>
      <SelectGroup>
        <SelectItem v-for="p in products" :key="p.value" :value="p.value">
          {{ p.label }}
        </SelectItem>
      </SelectGroup>
    </SelectContent>
  </Select>
</template>
```

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

const products = {
  'lokamusik': 'Loka Musik',
  'coverclearance': 'Cover Clearance',
  'lokasign': 'Lokasign',
  'mylokalink': 'My Loka Link',
};

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

  @override
  Widget build(BuildContext context) {
    return ConstrainedBox(
      constraints: const BoxConstraints(minWidth: 224),
      child: ShadSelect<String>(
        placeholder: const Text('Pilih produk'),
        options: products.entries
            .map((e) => ShadOption(value: e.key, child: Text(e.value)))
            .toList(),
        selectedOptionBuilder: (context, value) => Text(products[value]!),
        onChanged: (value) {},
      ),
    );
  }
}
```

## Pasang

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

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

## Aksesibilitas

- Trigger punya `role="combobox"` dan terbuka dengan Enter, Spasi, atau tombol panah.
- Tombol panah berpindah antarpilihan, mengetik melompat ke pilihan yang cocok, dan Escape menutup.
- Beri trigger label, atau `aria-label` kalau tidak ada tempat untuk label yang terlihat.
