SelectFilter

Dropdown filter for predefined options. The most common filter type.

Renders through the same combobox as the forms Select field, so an open filter looks identical to an open form select. Opt into a browser-native <select> with ->native().

use NyonCode\WireTable\Filters\SelectFilter;

Basic Usage

SelectFilter::make('status')
    ->options([
        'active' => 'Active',
        'inactive' => 'Inactive',
        'banned' => 'Banned',
    ])

With Placeholder

The first item is always an empty "All" option. To customize:

SelectFilter::make('role')
    ->options([
        '' => 'All Roles',           // explicit placeholder
        'admin' => 'Admin',
        'editor' => 'Editor',
        'viewer' => 'Viewer',
    ])

Multiple Selection

SelectFilter::make('tags')
    ->options(Tag::pluck('name', 'id')->toArray())
    ->multiple()
    ->label('Tags')

When multiple(), applies whereIn() instead of where().

Searchable Dropdown

SelectFilter::make('country')
    ->options(Country::pluck('name', 'code')->toArray())
    ->searchable()
    ->label('Country')

Adds a search input to the dropdown. The surface is the same combobox as a non-searchable filter — only the search input is added.

Native HTML Select

SelectFilter::make('type')
    ->options([...])
    ->native()                       // browser-native <select> element (faster render)

Opts out of the shared combobox, so the filter no longer matches the form select. Prefer it only where render cost matters more than a consistent look.

From Database

SelectFilter::make('department')
    ->options(fn () => Department::orderBy('name')->pluck('name', 'id')->toArray())

Options can be a Closure — evaluated lazily on render.

From an Enum

Pass a PHP enum class instead of an array — its cases expand to value => label options. Labels come from getLabel() when the enum implements Foundation\Contracts\Enum\HasLabel, otherwise the case name is headlined.

SelectFilter::make('status')->options(OrderStatus::class)

When a column's model attribute is cast to an enum, a SelectFilter on that column auto-populates its options from the enum even without calling ->options(). This shorthand is for the cases where you set the filter up explicitly.

Custom Query

SelectFilter::make('has_avatar')
    ->options([
        'yes' => 'With Avatar',
        'no' => 'Without Avatar',
    ])
    ->query(fn (Builder $query, string $value) => match($value) {
        'yes' => $query->whereNotNull('avatar_url'),
        'no' => $query->whereNull('avatar_url'),
    })

SelectFilter API

->options(array|string|Closure $options) // ['value' => 'Label', ...] or an enum class
->multiple(bool $multiple = true)    // multi-select mode
->searchable(bool $searchable = true) // add a search input to the dropdown
->native(bool $native = true)        // opt into a browser-native <select> (default: false)