Proyek komunitas. Ini bukan situs resmi pemerintah.

Dikelola sukarelawan. Lampung Design System dibangun oleh komunitas open source. Tidak ada instansi pemerintah yang mengelola atau mendukungnya secara resmi.

Layanan resmi memakai go.id. Situs pemerintah Indonesia berakhiran .go.id. Jangan masukkan NIK di situs yang Anda ragukan.

Combobox

Combobox

Text field yang menyaring daftar opsi saat Anda mengetik dan menyimpan satu yang dipilih. Untuk daftar panjang dan opsi dari server; ia memberi tahu saat tidak ada yang cocok.

Penggunaan

Pakai saat

  • Satu nilai dari daftar panjang yang dikenal orang lewat namanya: provinsi, kota, sekolah, kelurahan, jurusan.
  • Opsi datang dari server saat mengetik (React Combobox dengan loadOptions).
  • Orang tahu yang mereka mau dan mengetik tiga huruf lebih cepat daripada menggulir.

Pakai yang lain saat

  • Daftar tetap yang pendek (kurang dari sekitar 30 opsi): pakai Select.
  • Mencari untuk menyaring halaman atau daftar, tanpa menyimpan pilihan: pakai Search field.
  • Beberapa nilai, termasuk nilai baru yang dibuat orang: pakai Tag input.
  • Melompat ke halaman atau perintah apa pun di aplikasi: pakai Command palette.
  • Dua sampai lima opsi: pakai Radio.

Letaknya. Di formulir seperti text field, atau di bilah filter pada layar lebar. Daftar terbuka di bawah kolom, selebar kolom, dan menggulir di dalamnya (sampai 320 px atau setengah viewport).

Contoh

ProvinsiFokus memilih teks dan membuka daftar; mengetik menyaring bagian mana pun dari nama; Enter memilih baris yang disorot. Coba "jawa" atau "kal".
<div class="field" style="max-width: 360px; width: 100%;">
  <label class="field__label" for="cb-prov">Provinsi</label>
  <div class="select combobox" data-lds-combobox>
    <div class="control combobox__control"><span class="ic" aria-hidden="true">location_on</span><input id="cb-prov" role="combobox" placeholder="Semua provinsi"><span class="control__btn combobox__arrow" aria-hidden="true"><span class="ic">expand_more</span></span></div>
    <ul class="menu select__menu" role="listbox" aria-label="Provinsi">
      <li class="menu__item" role="option" data-value="jabar">Jawa Barat</li>
      <li class="menu__item" role="option" data-value="jateng">Jawa Tengah</li>
      <li class="menu__item" role="option" data-value="jatim">Jawa Timur</li>
      <li class="menu__item" role="option" data-value="bali">Bali</li>
      <li class="menu__item" role="option" data-value="kalbar">Kalimantan Barat</li>
      <li class="menu__item" role="option" data-value="kaltim">Kalimantan Timur</li>
      <li class="menu__item" role="option" data-value="sulsel">Sulawesi Selatan</li>
      <li class="menu__item" role="option" data-value="papua">Papua</li>
      <li class="select__empty" role="presentation" hidden>Tidak ada yang cocok. Coba kata lain.</li>
    </ul>
  </div>
</div>
Opsi dari server (React)Dengan loadOptions kueri ditunda (debounce 180 ms) dan permintaan sebelumnya dibatalkan saat teks berubah; spinner tampil di kolom selama memuat. minChars menunggu sampai hurufnya cukup.
<Combobox
  label="Sekolah"
  icon="school"
  value={uni}
  onChange={setUni}
  minChars={3}
  loadOptions={(q, signal) =>
    fetch(`/api/universities?q=${encodeURIComponent(q)}`, { signal }).then((r) => r.json())
  }
/>

Anatomi

BagianFungsinya
.select.comboboxWajib. Pembungkus berposisi. data-lds-combobox untuk perilaku HTML biasa.
.control.combobox__controlWajib. Kolom 44 px; .is-open selama daftar tampil. .ic di depan opsional.
input[role=combobox]Wajib. Input teks, dinamai oleh <label for> atau aria-label. JS menyetel aria-expanded, aria-controls, aria-autocomplete="list", dan autocomplete="off".
.control__btn.combobox__arrowChevron opsional (aria-hidden), berputar saat terbuka. Di React tombol hapus menggantikannya setelah nilai dipilih.
ul.menu.select__menu[role=listbox]Wajib. Opsi-opsinya; li.menu__item[role=option] dengan data-value.
.select__emptyWajib. Baris tanpa hasil, role="presentation", hidden sampai tidak ada yang cocok.

Status

StatusCaranya
closedTampak seperti text field dengan chevron.
open (.is-open on the control, aria-expanded="true")Tepi aksen dan halo tetap menyala; chevron menunjuk ke atas; daftar tumbuh masuk.
filteringBaris yang tidak mengandung teks diberi hidden; baris pertama yang terlihat disorot.
no match.select__empty menampilkan "Tidak ada yang cocok. Coba kata lain."
loading (React)Spinner di kolom menggantikan chevron.
chosen (React)Tombol hapus .control__btn (ikon tutup, berlabel "Hapus Provinsi") menggantikan chevron.

Gerak dan mikrointeraksi

  • Daftar memakai gerak menu: masuk dengan --spring-smooth (560 ms) dari scale(0.96) translateY(-4px) dengan opacity dalam --d-fast; keluar dalam --d-exit (180 ms) dengan --ease-exit.
  • Penyaringan langsung menyembunyikan baris; jangan menganimasikan baris masuk dan keluar di setiap ketukan, daftar jadi terasa lambat.
  • Chevron berputar dengan --spring-smooth. Sorotan mengikuti pointer dalam 60 ms linear.
  • Reduced motion: menu memudar masuk 120 ms linear tanpa skala.

Aksesibilitas

  • Input punya role="combobox", aria-expanded, aria-controls, dan aria-autocomplete="list"; aria-activedescendant menunjuk ke opsi yang disorot sementara fokus tetap di input.
  • Tombol: Bawah membuka dan berpindah, Atas berpindah, Enter memilih, Escape menutup (React juga memulihkan label terpilih), Tab menutup.
  • Baris kosong adalah role="presentation"; pertimbangkan hitungan aria-live="polite" jika hasil sering berubah banyak.
  • Penyaringan mencocokkan bagian mana pun dari label (dan baris kedua di React), tanpa membedakan huruf besar kecil.

Lakukan dan hindari

Lakukan

  • Taruh opsi yang paling mungkin di awal saat kolom kosong.
  • Setel minChars (2 atau 3) untuk daftar dari server agar permintaan pertama berguna.
  • Tampilkan baris kedua (sub) saat dua opsi punya nama yang sama.

Hindari

  • Menerima teks bebas yang tidak cocok dengan opsi mana pun sebagai nilai; combobox menyimpan salah satu opsinya.
  • Memakai combobox untuk daftar pendek hanya agar tampak bisa dicari.

Perilaku dan kode

HTML biasa. data-lds-combobox pada .select.combobox: fokus memilih teks dan membuka daftar; mengetik menyaring opsi dan menyalakan atau mematikan .select__empty; tombol seperti di atas; pilihan menulis label ke input dan memicu lds:change dengan { value, label }. Pemuatan dari server dan tombol hapus hanya ada di binding React.

React. Dari lampung-design-system/react.

import { Combobox } from 'lampung-design-system/react';

// Local options, filtered in the browser
<Combobox label="Provinsi" icon="location_on" value={prov} onChange={setProv}
  options={[{ value: 'jabar', label: 'Jawa Barat' }, { value: 'bali', label: 'Bali' }]} />

// From a server: debounced 180 ms, aborted when the query changes
<Combobox label="Sekolah" icon="school" value={uni} onChange={setUni} minChars={3}
  loadOptions={(q, signal) => fetch(`/api/universities?q=${q}`, { signal }).then((r) => r.json())}
  emptyText="Tidak ada sekolah dengan nama itu. Periksa ejaannya." />