复制操作

简介

Filament 包含一个用于 复制 Eloquent 记录的操作。你可以这样使用：

use Filament\Actions\ReplicateAction;

ReplicateAction::make()

排除属性

使用 excludeAttributes() 方法可指定复制时要排除哪些列：

use Filament\Actions\ReplicateAction;

ReplicateAction::make()
    ->excludeAttributes(['slug'])

在填充表单前自定义数据

你可能希望在将记录数据填入表单之前先进行修改。为此，可使用 mutateRecordDataUsing() 方法修改 $data 数组，并返回修改后的版本，再填充到表单中：

use Filament\Actions\ReplicateAction;

ReplicateAction::make()
    ->mutateRecordDataUsing(function (array $data): array {
        $data['user_id'] = auth()->id();

        return $data;
    })

复制后重定向

你可以使用 successRedirectUrl() 方法在表单提交后设置自定义重定向：

use Filament\Actions\ReplicateAction;

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

TIP

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

自定义复制通知

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

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

use Filament\Actions\ReplicateAction;

ReplicateAction::make()
    ->successNotificationTitle('Category replicated')

TIP

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

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

use Filament\Actions\ReplicateAction;
use Filament\Notifications\Notification;

ReplicateAction::make()
    ->successNotification(
       Notification::make()
            ->success()
            ->title('Category replicated')
            ->body('The category has been replicated successfully.'),
    )

TIP

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

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

use Filament\Actions\ReplicateAction;

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

生命周期钩子

可以使用钩子在操作生命周期的不同节点执行代码，例如在副本保存之前。

use Filament\Actions\ReplicateAction;
use Illuminate\Database\Eloquent\Model;

ReplicateAction::make()
    ->before(function () {
        // Runs before the record has been replicated.
    })
    ->beforeReplicaSaved(function (Model $replica): void {
        // Runs after the record has been replicated but before it is saved to the database.
    })
    ->after(function (Model $replica): void {
        // Runs after the replica has been saved to the database.
    })

TIP

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

中止复制过程

你可以随时在生命周期钩子中调用 $action->halt()，这将中止整个复制过程：

use App\Models\Post;
use Filament\Actions\Action;
use Filament\Actions\ReplicateAction;
use Filament\Notifications\Notification;

ReplicateAction::make()
    ->before(function (ReplicateAction $action, Post $record) {
        if (! $record->team->subscribed()) {
            Notification::make()
                ->warning()
                ->title('You don\'t have an active subscription!')
                ->body('Choose a plan to continue.')
                ->persistent()
                ->actions([
                    Action::make('subscribe')
                        ->button()
                        ->url(route('subscribe'), shouldOpenInNewTab: true),
                ])
                ->send();
        
            $action->halt();
        }
    })

若还希望关闭操作模态框，可以改用 cancel() 完全取消操作，而不是仅中止：

$action->cancel();