combobox

A searchable select, single or multiple. It stays a real select underneath, so it posts normally.

Example

Laravel

<x-admin::form-grid>
    <x-admin::combobox name="g_country" label="Country" placeholder="Search countries" value="nz"
        :options="['nz' => 'New Zealand', 'sg' => 'Singapore', 'gb' => 'United Kingdom', 'us' => 'United States']" />
    <x-admin::combobox name="g_platforms[]" label="Destinations" multiple placeholder="Add a destination" :value="['sf']"
        :options="['sf' => 'Salesforce', 'mc' => 'Mailchimp', 'gs' => 'Google Sheets']" />
</x-admin::form-grid>

Props

PropRequiredDefaultOptions
namenull
labelnull
hintnull
errornull
idnull
options[]
valuenull
placeholdernull
multiplefalse
optionalfalse
requiredfalse

Other attributes, such as wire:model or data-*, pass through to the element.

Other stacks

React and Vue: import { Combobox } from "@admiral/ui-kit/react" (or /vue). See the React and Vue guide.

HTML, for any stack
<div class="adm-form-grid"><div class="adm-field">
            <label class="adm-label" for="g_country">Country</label>
        <div class="adm-combobox" data-adm-combobox >
        <select
             name="g_country"              id="g_country"                                                             class="adm-select"
        >
            <option value="">Search countries</option>                                            <option value="nz" selected>New Zealand</option>
                                            <option value="sg" >Singapore</option>
                                            <option value="gb" >United Kingdom</option>
                                            <option value="us" >United States</option>
                    </select>
    </div>
        </div>
    <div class="adm-field">
            <label class="adm-label" for="g_platforms">Destinations</label>
        <div class="adm-combobox" data-adm-combobox >
        <select
             name="g_platforms[]"              id="g_platforms"              multiple data-placeholder="Add a destination"                                                 class="adm-select"
        >
                                                        <option value="sf" selected>Salesforce</option>
                                            <option value="mc" >Mailchimp</option>
                                            <option value="gs" >Google Sheets</option>
                    </select>
    </div>
        </div></div>