删除操作

简介

Filament 包含一个用于删除 Eloquent 记录的操作。点击触发按钮后，会弹出模态框要求用户确认。你可以这样使用：

use Filament\Actions\DeleteAction;

DeleteAction::make()

或者，若要将其添加为表格批量操作，以便用户选择要删除的行，请使用 Filament\Actions\DeleteBulkAction：

use Filament\Actions\DeleteBulkAction;
use Filament\Tables\Table;

public function table(Table $table): Table
{
    return $table
        ->toolbarActions([
            DeleteBulkAction::make(),
        ]);
}

删除后重定向

你可以使用 successRedirectUrl() 方法在记录删除后设置自定义重定向：

use Filament\Actions\DeleteAction;

DeleteAction::make()
    ->successRedirectUrl(route('posts.list'))

TIP

除了 $record 之外，successRedirectUrl() 函数还可以注入各种实用工具作为参数。

自定义删除通知

记录成功删除后，会向用户发送通知，提示操作成功。

若要自定义该通知的标题，请使用 successNotificationTitle() 方法：

use Filament\Actions\DeleteAction;

DeleteAction::make()
    ->successNotificationTitle('User deleted')

TIP

除了允许静态值外，successNotificationTitle() 方法也接受一个函数来动态计算值。你可以将各种实用工具作为参数注入该函数。

你可以使用 successNotification() 方法自定义整个通知：

use Filament\Actions\DeleteAction;
use Filament\Notifications\Notification;

DeleteAction::make()
    ->successNotification(
       Notification::make()
            ->success()
            ->title('User deleted')
            ->body('The user has been deleted successfully.'),
    )

TIP

除了允许静态值外，successNotification() 方法也接受一个函数来动态计算值。你可以将各种实用工具作为参数注入该函数。

若要完全禁用通知，请使用 successNotification(null) 方法：

use Filament\Actions\DeleteAction;

DeleteAction::make()
    ->successNotification(null)

生命周期钩子

你可以使用 before() 和 after() 方法在记录删除前后执行代码：

use Filament\Actions\DeleteAction;

DeleteAction::make()
    ->before(function () {
        // ...
    })
    ->after(function () {
        // ...
    })

TIP

这些钩子函数可以注入各种实用工具作为参数。

提升删除批量操作的性能

默认情况下，DeleteBulkAction 会先将所有 Eloquent 记录加载到内存中，再逐条循环删除。

若要删除大量记录，可使用 chunkSelectedRecords() 方法每次获取较少数量的记录，从而降低应用的内存占用：

use Filament\Actions\DeleteBulkAction;

DeleteBulkAction::make()
    ->chunkSelectedRecords(250)

Filament 在删除前将 Eloquent 记录加载到内存，有两个原因：

• 允许在删除前使用模型策略对集合中的单条记录进行授权（例如使用 `authorizeIndividualRecords('delete')`）。
• 确保删除记录时会触发模型事件，例如模型观察者中的 `deleting` 和 `deleted` 事件。

若不需要单条记录的策略授权和模型事件，可以使用 fetchSelectedRecords(false) 方法。这样在删除前不会将记录加载到内存，而是用单次查询删除：

use Filament\Actions\DeleteBulkAction;

DeleteBulkAction::make()
    ->fetchSelectedRecords(false)