Select
Select memilih satu nilai dari daftar pendek yang terbuka di popup.
Kapan dipakai
Section titled “Kapan dipakai”- Pakai untuk 4 sampai 15 pilihan.
- Pakai radio button untuk 2 atau 3 pilihan, supaya semuanya langsung terlihat.
- Pakai Combobox kalau daftarnya panjang atau perlu dicari.
Anatomi
Section titled “Anatomi”- 1Pemicu yang menampilkan nilai
- 2Chevron
- 3Daftar pilihan
- 4Pilihan 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
Section titled “Varian”Hanya ada satu gaya, dengan dua ukuran trigger: default dan sm.
| 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. |
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> )}<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>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
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/select.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/select.jsonAksesibilitas
Section titled “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-labelkalau tidak ada tempat untuk label yang terlihat.
