Skip to content
TallCraftUI

Native Select

By default, selection will look up for:
  • $object->id for option value.
  • $object->name for option label.

Basic usage

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

Customize option attributes New

Blade
@php
$users = App\Models\User::all('id', 'bio')->take(5);
@endphp
 
<x-native-select
wire:model="user_id"
:options="$users"
option-value="id"
option-label="bio"
/>

Custom placeholder

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

Without placeholder New

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

Custom slot

Blade
@php
$users = App\Models\User::all('id', 'name');
@endphp
 
<x-native-select label="Select user">
<option value="">Choose user</option>
 
@foreach ($users as $user)
<option value="{{ $user->id }}"> {{ $user->name }} </option>
@endforeach
</x-native-select>

With hint

Only one user can be select

Blade
@php
$users = App\Models\User::all('id', 'name');
@endphp
 
<x-native-select wire:model="user_id" :options="$users" hint="Only one user can be select" />

Size variants

Blade
@php
$users = App\Models\User::all('id', 'name');
@endphp
 
<x-native-select placeholder="Default" :options="$users" xs />
<x-native-select placeholder="Small" :options="$users" sm />
<x-native-select placeholder="Medium" :options="$users" md />
<x-native-select placeholder="Large" :options="$users" lg />
<x-native-select placeholder="Extra large" :options="$users" xl />

With enum class New

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-native-select wire:model="role" :options="App\Enums\UserRolesEnum::options()" />

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-native-select>

View source
Prop Type Default
label string null
options Illuminate\Support\Collection|array []
option-value string 'id'
option-label string 'name'
placeholder string null
without-placeholder bool false
hint string 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
native-select.size = md native-select.border-radius = rounded-sm Change defaults