[폼.필드] Toggle

개요

토글 컴포넌트는 체크박스와 유사하게 불리언 값을 조작할 수 있게 해줍니다.

use Filament\Forms\Components\Toggle;

Toggle::make('is_admin')

불리언 값을 Eloquent를 사용하여 저장하는 경우, 모델 속성에 boolean 캐스트를 추가해야 합니다:

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    protected $casts = [
        'is_admin' => 'boolean',
    ];

    // ...
}

토글 버튼에 아이콘 추가하기

토글은 버튼의 "켜짐"과 "꺼짐" 상태를 나타내기 위해 아이콘을 사용할 수도 있습니다. "켜짐" 상태에 아이콘을 추가하려면 onIcon() 메서드를 사용하세요. "꺼짐" 상태에 아이콘을 추가하려면 offIcon() 메서드를 사용하세요:

use Filament\Forms\Components\Toggle;

Toggle::make('is_admin')
    ->onIcon('heroicon-m-bolt')
    ->offIcon('heroicon-m-user')

토글 버튼 색상 커스터마이징

토글의 "켜짐" 또는 "꺼짐" 상태를 나타내는 색상을 커스터마이징할 수도 있습니다. 색상은 danger, gray, info, primary, success, warning 중 하나일 수 있습니다. "켜짐" 상태에 색상을 추가하려면 onColor() 메서드를 사용하세요. "꺼짐" 상태에 색상을 추가하려면 offColor() 메서드를 사용하세요:

use Filament\Forms\Components\Toggle;

Toggle::make('is_admin')
    ->onColor('success')
    ->offColor('danger')

라벨을 위에 배치하기

토글 필드는 인라인과 스택 두 가지 레이아웃 모드를 가집니다. 기본적으로 인라인입니다.

토글이 인라인일 때, 라벨은 토글 옆에 위치합니다:

use Filament\Forms\Components\Toggle;

Toggle::make('is_admin')
    ->inline()

토글이 스택일 때, 라벨은 토글 위에 위치합니다:

use Filament\Forms\Components\Toggle;

Toggle::make('is_admin')
    ->inline(false)

토글 검증

검증 페이지에 나열된 모든 규칙 외에도, 토글에만 적용되는 추가 규칙이 있습니다.

Accepted 검증

토글이 "켜짐" 상태임을 보장하려면 accepted() 메서드를 사용할 수 있습니다:

use Filament\Forms\Components\Toggle;

Toggle::make('terms_of_service')
    ->accepted()

Declined 검증

토글이 "꺼짐" 상태임을 보장하려면 declined() 메서드를 사용할 수 있습니다:

use Filament\Forms\Components\Toggle;

Toggle::make('is_under_18')
    ->declined()