[테이블.필터] SelectFilter

개요

종종 선택 필드를 체크박스 대신 사용하고 싶을 때가 있습니다. 이는 특히 사용자가 선택할 수 있는 미리 정의된 옵션 집합을 기반으로 열을 필터링하고자 할 때 유용합니다. 이를 위해 SelectFilter 클래스를 사용하여 필터를 생성할 수 있습니다:

use Filament\Tables\Filters\SelectFilter;

SelectFilter::make('status')
    ->options([
        'draft' => '임시 저장',
        'reviewing' => '검토 중',
        'published' => '게시됨',
    ])

필터에 전달되는 options()는 선택 필드에 전달되는 것과 동일합니다.

선택 필터에서 사용되는 열 커스터마이징

선택 필터는 커스텀 query() 메서드를 필요로 하지 않습니다. 쿼리 범위에 사용되는 열 이름은 필터의 이름입니다. 이를 커스터마이즈하려면 attribute() 메서드를 사용할 수 있습니다:

use Filament\Tables\Filters\SelectFilter;

SelectFilter::make('status')
    ->options([
        'draft' => '임시 저장',
        'reviewing' => '검토 중',
        'published' => '게시됨',
    ])
    ->attribute('status_id')

다중 선택 필터

이 기능을 사용하면 사용자가 여러 옵션을 선택하여 테이블에 필터를 적용할 수 있습니다. 예를 들어, 상태 필터는 사용자가 몇 가지 상태 옵션 중에서 선택하여 테이블을 필터링할 수 있도록 합니다. 사용자가 여러 옵션을 선택하면, 테이블은 선택된 옵션 중 하나라도 일치하는 레코드만 표시합니다. 이 동작은 multiple() 메서드를 사용하여 활성화할 수 있습니다:

use Filament\Tables\Filters\SelectFilter;

SelectFilter::make('status')
    ->multiple()
    ->options([
        'draft' => '임시 저장',
        'reviewing' => '검토 중',
        'published' => '게시됨',
    ])

관계형 선택 필터

선택 필터는 관계를 기반으로 자동으로 옵션을 채울 수도 있습니다. 예를 들어, 테이블에 author 관계와 name 열이 있다면, relationship()을 사용하여 해당 저자에 속하는 레코드를 필터링할 수 있습니다:

use Filament\Tables\Filters\SelectFilter;

SelectFilter::make('author')
    ->relationship('author', 'name')

선택 필터 관계 옵션 미리 불러오기

페이지가 로드될 때 데이터베이스에서 검색 가능한 옵션을 미리 불러오고 싶다면, preload() 메서드를 사용할 수 있습니다:

use Filament\Tables\Filters\SelectFilter;

SelectFilter::make('author')
    ->relationship('author', 'name')
    ->searchable()
    ->preload()

선택 필터 관계 쿼리 커스터마이징

relationship() 메서드의 세 번째 매개변수를 사용하여 옵션을 가져오는 데이터베이스 쿼리를 커스터마이즈할 수 있습니다:

use Filament\Tables\Filters\SelectFilter;
use Illuminate\Database\Eloquent\Builder;

SelectFilter::make('author')
    ->relationship('author', 'name', fn (Builder $query) => $query->withTrashed())

선택 필터 옵션 검색

searchable() 메서드를 사용하여 많은 옵션에 더 쉽게 접근할 수 있도록 검색 입력을 활성화할 수 있습니다:

use Filament\Tables\Filters\SelectFilter;

SelectFilter::make('author')
    ->relationship('author', 'name')
    ->searchable()

플레이스홀더 선택 비활성화

플레이스홀더(null 옵션)를 제거하여, 필터가 비활성화되어 모든 옵션이 적용되는 것을 방지할 수 있습니다. 이를 위해 selectablePlaceholder() 메서드를 사용할 수 있습니다:

use Filament\Tables\Filters\SelectFilter;

SelectFilter::make('status')
    ->options([
        'draft' => '임시 저장',
        'reviewing' => '검토 중',
        'published' => '게시됨',
    ])
    ->default('draft')
    ->selectablePlaceholder(false)

기본적으로 선택 필터 적용하기

default() 메서드를 사용하여 선택 필터를 기본적으로 활성화할 수 있습니다. 단일 선택 필터를 사용하는 경우, default() 메서드는 단일 옵션 값을 받습니다. multiple() 선택 필터를 사용하는 경우, default() 메서드는 옵션 값의 배열을 받습니다:

use Filament\Tables\Filters\SelectFilter;

SelectFilter::make('status')
    ->options([
        'draft' => '임시 저장',
        'reviewing' => '검토 중',
        'published' => '게시됨',
    ])
    ->default('draft')

SelectFilter::make('status')
    ->options([
        'draft' => '임시 저장',
        'reviewing' => '검토 중',
        'published' => '게시됨',
    ])
    ->multiple()
    ->default(['draft', 'reviewing'])