Choose a single option from a dropdown list.
<flux:select wire:model="industry" placeholder="Choose industry..."> <flux:select.option>Photography</flux:select.option> <flux:select.option>Design services</flux:select.option> <flux:select.option>Web development</flux:select.option> <flux:select.option>Accounting</flux:select.option> <flux:select.option>Legal services</flux:select.option> <flux:select.option>Consulting</flux:select.option> <flux:select.option>Other</flux:select.option></flux:select>
A smaller select element for more compact layouts.
<flux:select size="sm" placeholder="Choose industry..."> <flux:select.option>Photography</flux:select.option> <flux:select.option>Design services</flux:select.option> <flux:select.option>Web development</flux:select.option> <flux:select.option>Accounting</flux:select.option> <flux:select.option>Legal services</flux:select.option> <flux:select.option>Consulting</flux:select.option> <flux:select.option>Other</flux:select.option></flux:select>
An alternative to the browser's native select element. Typically used when you need custom option styling like icons, images, and other treatments.
<flux:select variant="listbox" placeholder="Choose industry..."> <flux:select.option>Photography</flux:select.option> <flux:select.option>Design services</flux:select.option> <flux:select.option>Web development</flux:select.option> <flux:select.option>Accounting</flux:select.option> <flux:select.option>Legal services</flux:select.option> <flux:select.option>Consulting</flux:select.option> <flux:select.option>Other</flux:select.option></flux:select>
<flux:select variant="listbox"> <x-slot name="button"> <flux:select.button class="rounded-full!" placeholder="Choose industry..." :invalid="$errors->has('...')" /> </x-slot> <flux:select.option>Photography</flux:select.option> ...</flux:select>
<flux:select variant="listbox" clearable> ...</flux:select>
<flux:select variant="listbox" placeholder="Select role..."> <flux:select.option> <div class="flex items-center gap-2"> <flux:icon.shield-check variant="mini" class="text-zinc-400" /> Owner </div> </flux:select.option> <flux:select.option> <div class="flex items-center gap-2"> <flux:icon.key variant="mini" class="text-zinc-400" /> Administrator </div> </flux:select.option> <flux:select.option> <div class="flex items-center gap-2"> <flux:icon.user variant="mini" class="text-zinc-400" /> Member </div> </flux:select.option> <flux:select.option> <div class="flex items-center gap-2"> <flux:icon.eye variant="mini" class="text-zinc-400" /> Viewer </div> </flux:select.option></flux:select>
The searchable select variant makes navigating large option lists easier for your users.
<flux:select variant="listbox" searchable placeholder="Choose industries..."> <flux:select.option>Photography</flux:select.option> <flux:select.option>Design services</flux:select.option> <flux:select.option>Web development</flux:select.option> <flux:select.option>Accounting</flux:select.option> <flux:select.option>Legal services</flux:select.option> <flux:select.option>Consulting</flux:select.option> <flux:select.option>Other</flux:select.option></flux:select>
<flux:select variant="listbox" searchable> <x-slot name="search"> <flux:select.search class="px-4" placeholder="Search industries..." /> </x-slot> ...</flux:select>
Allow your users to select multiple options from a list of options.
<flux:select variant="listbox" multiple placeholder="Choose industries..."> <flux:select.option>Photography</flux:select.option> <flux:select.option>Design services</flux:select.option> <flux:select.option>Web development</flux:select.option> <flux:select.option>Accounting</flux:select.option> <flux:select.option>Legal services</flux:select.option> <flux:select.option>Consulting</flux:select.option> <flux:select.option>Other</flux:select.option></flux:select>
<flux:select variant="listbox" selected-suffix="industries selected" multiple> ...</flux:select>
<flux:select variant="listbox" selected-suffix="{{ __('industries selected') }}" multiple> ...</flux:select>
<flux:select variant="listbox" indicator="checkbox" multiple> ...</flux:select>
<flux:select variant="listbox" searchable multiple clear="close"> ...</flux:select>
A versatile combobox that can be used for anything from basic autocomplete to complex multi-selects.
<flux:select variant="combobox" placeholder="Choose industry..."> <flux:select.option>Photography</flux:select.option> <flux:select.option>Design services</flux:select.option> <flux:select.option>Web development</flux:select.option> <flux:select.option>Accounting</flux:select.option> <flux:select.option>Legal services</flux:select.option> <flux:select.option>Consulting</flux:select.option> <flux:select.option>Other</flux:select.option></flux:select>
<flux:select variant="combobox"> <x-slot name="input"> <flux:select.input x-model="search" :invalid="$errors->has('...')" /> </x-slot> ...</flux:select>
If you want to dynamically generate options on the server, you can use the :filter="false" prop to disable client-side filtering.
<flux:select :filter="false"> @foreach ($options as $option) <flux:select.option value="{{ $option->value }}"> {{ $option->label }} </flux:select.option> @endforeach</flux:select>
Prop
|
Description
|
---|---|
wire:model |
Binds the select to a Livewire property. See the wire:model documentation for more information.
|
placeholder |
Text displayed when no option is selected.
|
label |
Label text displayed above the select. When provided, wraps the select in a flux:field component with an adjacent flux:label component. See the field component.
|
description |
Help text displayed below the select. When provided alongside label, appears between the label and select within the flux:field wrapper. See the field component.
|
description:trailing |
The description provided will be displayed below the select instead of above it.
|
badge |
Badge text displayed at the end of the flux:label component when the label prop is provided.
|
size |
Size of the select. Options: sm, xs.
|
variant |
Visual style of the select. Options: default (native select), listbox, combobox.
|
multiple |
Allows selecting multiple options (listbox and combobox variants only).
|
filter |
If false, disables client-side filtering.
|
searchable |
Adds a search input to filter options (listbox and combobox variants only).
|
clearable |
Displays a clear button when an option is selected (listbox and combobox variants only).
|
selected-suffix |
Text appended to the number of selected options in multiple mode (listbox variant only).
|
clear |
When to clear the search input. Options: select (default), close (listbox and combobox variants only).
|
disabled |
Prevents user interaction with the select.
|
invalid |
Applies error styling to the select.
|
Slot
|
Description
|
---|---|
default |
The select options.
|
trigger |
Custom trigger content. Typically the select.button or select.input component (listbox and combobox variants only).
|
Attribute
|
Description
|
---|---|
data-flux-select |
Applied to the root element for styling and identification.
|
Prop
|
Description
|
---|---|
value |
Value associated with the option.
|
disabled |
Prevents selecting the option.
|
Slot
|
Description
|
---|---|
default |
The option content (can include icons, images, etc. in listbox variant).
|
Prop
|
Description
|
---|---|
placeholder |
Text displayed when no option is selected.
|
invalid |
Applies error styling to the button.
|
size |
Size of the button. Options: sm, xs.
|
disabled |
Prevents selecting the option.
|
clearable |
Displays a clear button when an option is selected.
|
Prop
|
Description
|
---|---|
placeholder |
Text displayed when no option is selected.
|
invalid |
Applies error styling to the input.
|
size |
Size of the input. Options: sm, xs.
|