[액션] 액션 그룹화

개요

ActionGroup 객체를 사용하여 여러 액션을 드롭다운 메뉴로 그룹화할 수 있습니다. 그룹에는 여러 액션이나 다른 그룹을 포함할 수 있습니다:

ActionGroup::make([
    Action::make('view'),
    Action::make('edit'),
    Action::make('delete'),
])

이 페이지는 그룹의 트리거 버튼과 드롭다운의 모양을 커스터마이즈하는 방법에 대해 설명합니다.

그룹 트리거 스타일 커스터마이징

드롭다운을 여는 버튼은 일반 액션과 동일한 방식으로 커스터마이즈할 수 있습니다. 트리거 버튼에 사용할 수 있는 모든 메서드를 사용하여 그룹 트리거 버튼을 커스터마이즈할 수 있습니다:

use Filament\Support\Enums\ActionSize;

ActionGroup::make([
    // 액션 배열
])
    ->label('추가 작업')
    ->icon('heroicon-m-ellipsis-vertical')
    ->size(ActionSize::Small)
    ->color('primary')
    ->button()

드롭다운 위치 설정

dropdownPlacement() 메서드를 사용하여 드롭다운을 트리거 버튼에 상대적으로 위치시킬 수 있습니다:

ActionGroup::make([
    // 액션 배열
])
    ->dropdownPlacement('top-start')

액션 사이에 구분선 추가

중첩된 ActionGroup 객체를 사용하여 액션 그룹 사이에 구분선을 추가할 수 있습니다:

ActionGroup::make([
    ActionGroup::make([
        // 액션 배열
    ])->dropdown(false),
    // 액션 배열
])

dropdown(false) 메서드는 액션을 새로운 중첩 드롭다운 대신 부모 드롭다운 안에 넣습니다.

드롭다운 너비 설정

dropdownWidth() 메서드를 사용하여 드롭다운의 너비를 설정할 수 있습니다. 옵션은 Tailwind의 max-width scale에 해당합니다. 옵션에는 ExtraSmall, Small, Medium, Large, ExtraLarge, TwoExtraLarge, ThreeExtraLarge, FourExtraLarge, FiveExtraLarge, SixExtraLarge, SevenExtraLarge가 있습니다:

use Filament\Support\Enums\MaxWidth;

ActionGroup::make([
    // 액션 배열
])
    ->dropdownWidth(MaxWidth::ExtraSmall)

드롭다운의 최대 높이 제어

maxHeight() 메서드를 사용하여 드롭다운 콘텐츠의 최대 높이를 지정할 수 있으며, 이로 인해 스크롤이 가능합니다. CSS 길이를 전달할 수 있습니다:

ActionGroup::make([
    // 액션 배열
])
    ->maxHeight('400px')

드롭다운 오프셋 제어

dropdownOffset() 메서드를 사용하여 드롭다운의 오프셋을 제어할 수 있습니다. 기본적으로 오프셋은 8로 설정되어 있습니다.

ActionGroup::make([
    // 액션 배열
])
    ->dropdownOffset(16)