Skip to content
TallCraftUI

Select

By default, selection will look up for:
  • $object->id for option value.
  • $object->name or $object->title for option label.
  • $object->avatar or $object->image for option picture.
  • $object->description for option description.

Basic usage

Blade
@php
$users = App\Models\User::get(); // OR
// $users = App\Models\User::pluck('name', 'id');
@endphp
 
<x-select wire:model="user_id" :options="$users" />
<x-select wire:model="skills" :options="['PHP', 'Laravel', 'Livewire']" multiple clearable />

Multiple select

Blade
@php
$users = App\Models\User::all('id', 'name');
@endphp
 
<x-select wire:model="user_id" :options="$users" multiple />

Clearable

Blade
@php
$users = App\Models\User::all('id', 'name');
@endphp
 
<x-select wire:model="user_id" :options="$users" multiple clearable />

Searchable

Blade
@php
$users = App\Models\User::all('id', 'name');
@endphp
 
<x-select wire:model="user_id" :options="$users" multiple searchable />

Limit selection

Blade
@php
$users = App\Models\User::all('id', 'name');
@endphp
 
<x-select wire:model="user_id" :options="$users" limit="2" multiple />

With image

Blade
@php
$users = App\Models\User::all('id', 'name', 'email', 'avatar');
@endphp
 
<x-select wire:model="user_id" :options="$users" multiple />

With description

Blade
@php
$users = App\Models\User::all('id', 'name', 'bio as description');
@endphp
 
<x-select wire:model="user_id" :options="$users" multiple />

With enum class

Blade
@php
// enum UserRolesEnum: string
// {
// case Admin = 'admin';
// case User = 'user';
// case Moderator = 'moderator';
 
// public static function options(): array
// {
// return array_column(self::cases(), 'name', 'value');
// }
// }
@endphp
 
<x-select wire:model="role" :options="App\Enums\UserRolesEnum::options()" />

All property

Only 3 user can be select

Blade
@php
$options = [
[
'id' => 1,
'name' => 'Taylor Otwell',
'avatar' => 'https://avatars.githubusercontent.com/u/463230?s=160&v=4',
'description' => 'Creator of Laravel',
],
[
'id' => 2,
'name' => 'Caleb Porzio',
'avatar' => 'https://github.com/calebporzio.png?size=160',
'description' => 'Creator of Livewire and Alpine.js',
],
[
'id' => 3,
'name' => 'Nuno Maduro',
'avatar' => 'https://avatars.githubusercontent.com/u/5457236?v=4',
'description' => 'Creator of Pest PHP',
],
[
'id' => 4,
'name' => 'Jeffrey Way',
'avatar' => 'https://github.com/JeffreyWay.png?size=160',
'description' => 'Creator of Laracast',
],
];
@endphp
 
<x-select label="Users" :options="$options" limit="3" placeholder="Select user"
hint="Only 3 user can be select" multiple searchable clearable />

Size variants

Blade
<x-select xs />
<x-select sm />
<x-select md />
<x-select lg />
<x-select xl />

API reference

Props are read from the component classes in TallCraftUI 3.0.0-beta.1. Write them in kebab-case and pass booleans as bare attributes, for example <x-button outline />. Other attributes, such as class or wire:model, are passed to the component's element.

<x-select>

View source
Prop Type Default
label string null
options Illuminate\Support\Collection|array|null null
placeholder string null
hint string null
multiple bool false
searchable bool false
clearable bool false
limit int null
Sizes
xs sm md lg xl 2xl
Radius
rounded-none rounded-xs rounded-sm rounded-md rounded-lg rounded-xl rounded-2xl rounded-3xl rounded-full
Config
select.size = md Change defaults