Lewati ke konten
MarkasUI
Ketik untuk mencari

    Panduan

    MarkasUI

    Form

    Feedback

    Overlay

    Navigasi

    Data

    Section

    Animasi

    Latar

    Tombol

    Template

    Halaman

    Combobox

    Input teks dengan daftar saran terfilter di popover, mengikuti pola WAI-ARIA Combobox dengan autocomplete list.

    • Australia
    • Indonesia
    • Japan
    • Malaysia
    • Philippines
    • Singapore
    • Thailand
    • Vietnam

    Start typing to filter the list.

    • Australia
    • Indonesia
    • Japan
    • Malaysia
    • Philippines
    • Singapore
    • Thailand
    • Vietnam

    Start typing to filter the list.

    • Australia
    • Indonesia
    • Japan
    • Malaysia
    • Philippines
    • Singapore
    • Thailand
    • Vietnam

    Start typing to filter the list.

    • Australia
    • Indonesia
    • Japan
    • Malaysia
    • Philippines
    • Singapore
    • Thailand
    • Vietnam

    Start typing to filter the list.

    • Australia
    • Indonesia
    • Japan
    • Malaysia
    • Philippines
    • Singapore
    • Thailand
    • Vietnam

    Start typing to filter the list.

    <x-markas.combobox
        name="country"
        label="Country"
        placeholder="Search countries"
        hint="Start typing to filter the list."
        :options="[
            ['value' => 'au', 'label' => 'Australia'],
            ['value' => 'id', 'label' => 'Indonesia'],
            ['value' => 'jp', 'label' => 'Japan'],
            ['value' => 'my', 'label' => 'Malaysia'],
            ['value' => 'ph', 'label' => 'Philippines'],
            ['value' => 'sg', 'label' => 'Singapore'],
            ['value' => 'th', 'label' => 'Thailand'],
            ['value' => 'vn', 'label' => 'Vietnam'],
        ]"
    />
    import { Combobox } from "@/components/markas/Combobox";
    
    const countries = [
      { value: "au", label: "Australia" },
      { value: "id", label: "Indonesia" },
      { value: "jp", label: "Japan" },
      { value: "my", label: "Malaysia" },
      { value: "ph", label: "Philippines" },
      { value: "sg", label: "Singapore" },
      { value: "th", label: "Thailand" },
      { value: "vn", label: "Vietnam" },
    ];
    
    export default function ComboboxExample() {
      return (
        <Combobox
          name="country"
          label="Country"
          placeholder="Search countries"
          hint="Start typing to filter the list."
          options={countries}
        />
      );
    }
    <script setup lang="ts">
    import { ref } from "vue";
    import Combobox from "@/components/markas/Combobox.vue";
    
    const countries = [
      { value: "au", label: "Australia" },
      { value: "id", label: "Indonesia" },
      { value: "jp", label: "Japan" },
      { value: "my", label: "Malaysia" },
      { value: "ph", label: "Philippines" },
      { value: "sg", label: "Singapore" },
      { value: "th", label: "Thailand" },
      { value: "vn", label: "Vietnam" },
    ];
    const country = ref("");
    </script>
    
    <template>
      <Combobox
        v-model="country"
        name="country"
        label="Country"
        placeholder="Search countries"
        hint="Start typing to filter the list."
        :options="countries"
      />
    </template>
    <script lang="ts">
      import Combobox from "$lib/components/markas/Combobox.svelte";
    
      const countries = [
        { value: "au", label: "Australia" },
        { value: "id", label: "Indonesia" },
        { value: "jp", label: "Japan" },
        { value: "my", label: "Malaysia" },
        { value: "ph", label: "Philippines" },
        { value: "sg", label: "Singapore" },
        { value: "th", label: "Thailand" },
        { value: "vn", label: "Vietnam" },
      ];
    </script>
    
    <Combobox
      name="country"
      label="Country"
      placeholder="Search countries"
      hint="Start typing to filter the list."
      options={countries}
    />
    ---
    import Combobox from "@/components/markas/Combobox.astro";
    
    const countries = [
      { value: "au", label: "Australia" },
      { value: "id", label: "Indonesia" },
      { value: "jp", label: "Japan" },
      { value: "my", label: "Malaysia" },
      { value: "ph", label: "Philippines" },
      { value: "sg", label: "Singapore" },
      { value: "th", label: "Thailand" },
      { value: "vn", label: "Vietnam" },
    ];
    ---
    
    <Combobox
      name="country"
      label="Country"
      placeholder="Search countries"
      hint="Start typing to filter the list."
      options={countries}
    />
    import { Component } from "@angular/core";
    import { Combobox } from "./markas/combobox.component";
    
    @Component({
      selector: "markas-example",
      imports: [Combobox],
      template: `
        <markas-combobox
          name="country"
          label="Country"
          placeholder="Search countries"
          hint="Start typing to filter the list."
          [options]="countries"
        />
      `,
    })
    export default class ComboboxExample {
      protected readonly countries = [
        { value: "au", label: "Australia" },
        { value: "id", label: "Indonesia" },
        { value: "jp", label: "Japan" },
        { value: "my", label: "Malaysia" },
        { value: "ph", label: "Philippines" },
        { value: "sg", label: "Singapore" },
        { value: "th", label: "Thailand" },
        { value: "vn", label: "Vietnam" },
      ];
    }

    Contoh

    Status

    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Only members of this project are listed.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Choose a reviewer before submitting.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari
    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Only members of this project are listed.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Choose a reviewer before submitting.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari
    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Only members of this project are listed.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Choose a reviewer before submitting.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari
    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Only members of this project are listed.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Choose a reviewer before submitting.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari
    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Only members of this project are listed.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Choose a reviewer before submitting.

    • Ana Putri
    • Budi Santoso
    • Citra Lestari

    Nilai terpilih

    • Asia/Jakarta (UTC+7)
    • Asia/Makassar (UTC+8)
    • Asia/Jayapura (UTC+9)
    • Asia/Singapore (UTC+8)
    • Europe/London (UTC+0)
    • America/New_York (UTC-5)

    Used for reminders and report schedules.

    • Asia/Jakarta (UTC+7)
    • Asia/Makassar (UTC+8)
    • Asia/Jayapura (UTC+9)
    • Asia/Singapore (UTC+8)
    • Europe/London (UTC+0)
    • America/New_York (UTC-5)

    Used for reminders and report schedules.

    • Asia/Jakarta (UTC+7)
    • Asia/Makassar (UTC+8)
    • Asia/Jayapura (UTC+9)
    • Asia/Singapore (UTC+8)
    • Europe/London (UTC+0)
    • America/New_York (UTC-5)

    Used for reminders and report schedules.

    • Asia/Jakarta (UTC+7)
    • Asia/Makassar (UTC+8)
    • Asia/Jayapura (UTC+9)
    • Asia/Singapore (UTC+8)
    • Europe/London (UTC+0)
    • America/New_York (UTC-5)

    Used for reminders and report schedules.

    • Asia/Jakarta (UTC+7)
    • Asia/Makassar (UTC+8)
    • Asia/Jayapura (UTC+9)
    • Asia/Singapore (UTC+8)
    • Europe/London (UTC+0)
    • America/New_York (UTC-5)

    Used for reminders and report schedules.

    Dalam form

    Shipping address

    We deliver to most cities in Southeast Asia.

    • Bandung
    • Jakarta
    • Kuala Lumpur
    • Singapore
    • Surabaya

    Shipping address

    We deliver to most cities in Southeast Asia.

    • Bandung
    • Jakarta
    • Kuala Lumpur
    • Singapore
    • Surabaya

    Shipping address

    We deliver to most cities in Southeast Asia.

    • Bandung
    • Jakarta
    • Kuala Lumpur
    • Singapore
    • Surabaya

    Shipping address

    We deliver to most cities in Southeast Asia.

    • Bandung
    • Jakarta
    • Kuala Lumpur
    • Singapore
    • Surabaya

    Shipping address

    We deliver to most cities in Southeast Asia.

    • Bandung
    • Jakarta
    • Kuala Lumpur
    • Singapore
    • Surabaya

    Instalasi

    npx markasui@latest add combobox

    Pemakaian

    <x-markas.combobox
        name="country"
        label="Negara"
        placeholder="Cari negara"
        empty-label="Tidak ada hasil"
        :value="old('country', 'id')"
        :options="[
            ['value' => 'au', 'label' => 'Australia'],
            ['value' => 'id', 'label' => 'Indonesia'],
            ['value' => 'jp', 'label' => 'Jepang'],
        ]"
        :error="$errors->first('country')"
        x-on:markas-change="console.log($event.detail)"
    />

    Butuh Alpine.js. Mengubah pilihan memancarkan event markas-change dengan value di $event.detail (string kosong saat dikosongkan).

    Livewire

    <x-markas.combobox label="Country" wire:model.live="country" :options="$countries" />

    wire:model terhubung ke value terpilih (bukan teks ketikan) lewat x-modelable. Mengubah properti di server menampilkan label yang cocok. .live mengirim request hanya saat opsi dipilih atau dikosongkan, bukan setiap ketikan.

    import { useState } from "react";
    import { Combobox } from "@/components/markas/Combobox";
    
    const [country, setCountry] = useState("id");
    
    <Combobox
      name="country"
      label="Negara"
      placeholder="Cari negara"
      emptyLabel="Tidak ada hasil"
      options={[
        { value: "au", label: "Australia" },
        { value: "id", label: "Indonesia" },
        { value: "jp", label: "Jepang" },
      ]}
      value={country}
      onValueChange={setCountry}
    />;
    <script setup lang="ts">
    import { ref } from "vue";
    import Combobox from "@/components/markas/Combobox.vue";
    
    const country = ref("id");
    const countries = [
      { value: "au", label: "Australia" },
      { value: "id", label: "Indonesia" },
      { value: "jp", label: "Jepang" },
    ];
    </script>
    
    <template>
      <Combobox
        v-model="country"
        name="country"
        label="Negara"
        placeholder="Cari negara"
        empty-label="Tidak ada hasil"
        :options="countries"
      />
    </template>
    <script lang="ts">
      import Combobox from "$lib/components/markas/Combobox.svelte";
    
      let country = $state("id");
      const countries = [
        { value: "au", label: "Australia" },
        { value: "id", label: "Indonesia" },
        { value: "jp", label: "Jepang" },
      ];
    </script>
    
    <Combobox
      bind:value={country}
      name="country"
      label="Negara"
      placeholder="Cari negara"
      emptyLabel="Tidak ada hasil"
      options={countries}
    />
    ---
    import Combobox from "@/components/markas/Combobox.astro";
    
    const countries = [
      { value: "au", label: "Australia" },
      { value: "id", label: "Indonesia" },
      { value: "jp", label: "Jepang" },
    ];
    ---
    
    <Combobox
      name="country"
      label="Negara"
      placeholder="Cari negara"
      emptyLabel="Tidak ada hasil"
      value="id"
      options={countries}
    />

    Opsi dirender di server. Script kecil yang dibundel (satu custom element per combobox) memfilter, menyorot, dan menempatkan daftar. Mengganti pilihan memancarkan event markas-change yang menggelembung dengan value di event.detail.

    import { Component, signal } from "@angular/core";
    import { Combobox } from "./markas/combobox.component";
    
    @Component({
      selector: "app-address",
      imports: [Combobox],
      template: `
        <markas-combobox
          [(value)]="country"
          name="country"
          label="Negara"
          placeholder="Cari negara"
          emptyLabel="Tidak ada hasil"
          [options]="countries"
        />
      `,
    })
    export class Address {
      readonly country = signal("id");
      readonly countries = [
        { value: "au", label: "Australia" },
        { value: "id", label: "Indonesia" },
        { value: "jp", label: "Jepang" },
      ];
    }
    • Atribut tambahan (placeholder, required, disabled, class) jatuh ke input teks yang terlihat. name dipasang di input tersembunyi berisi value terpilih, jadi form mengirim country=id, bukan labelnya.
    • Mengetik memfilter opsi berdasarkan label dan mengosongkan value terpilih sampai opsi dipilih lagi.
    • Daftar dirender di top layer lewat Popover API, jadi parent dengan overflow: hidden tidak memotongnya.
    • Teks daftar kosong bawaan berbahasa Inggris (“No results”). Terjemahkan lewat emptyLabel.

    Props

    NamaTipeDefaultKeterangan
    options{ value: string, label: string }[][]Daftar saran. Mengetik memfilter berdasarkan label, tanpa membedakan huruf besar kecil.
    labelstring-Teks label, terhubung ke input dan dipakai sebagai nama listbox.
    hintstring-Teks petunjuk di bawah input. Disembunyikan saat ada error.
    errorstring-Pesan error. Mengaktifkan aria-invalid dan border danger.
    namestring-Nama input tersembunyi yang berisi value terpilih untuk submit form.
    value / defaultValue / v-model / bind:valuestring""Value opsi terpilih. React menerima value dengan onValueChange atau defaultValue; Vue memakai v-model; Svelte bind:value; Angular value atau [(value)]; Blade dan Astro memakai value.
    onValueChange / onvaluechange / markas-change(value: string) => void-Dipanggil saat value terpilih berubah, berisi string kosong saat dikosongkan (React onValueChange, Svelte onvaluechange). Blade dan Astro memancarkan event markas-change yang menggelembung; Angular memancarkan valueChange.
    emptyLabelstringNo resultsTeks saat tidak ada opsi yang cocok. Isi misalnya "Tidak ada hasil".
    idstringautoId input. Listbox dan opsi memakainya sebagai awalan.

    Aksesibilitas

    • Input memakai role=combobox, aria-autocomplete=list, aria-expanded, dan aria-controls ke role=listbox.
    • Panah bawah dan atas membuka daftar dan berpindah di antara opsi yang cocok (berputar di ujung); aria-activedescendant mengikuti opsi yang disorot sehingga fokus tetap di input.
    • Enter memilih opsi yang disorot dan menutup daftar. Escape menutup daftar; Escape kedua mengosongkan input.
    • Klik opsi memilihnya. Meninggalkan input menutup daftar.

    Komponen terkait

    Komponen form lain dengan class yang sama di setiap framework.