优化 Laravel Nova 动作响应消息的持久性与交互性

默认动作响应消息的局限性

在 laravel nova 中，我们通常通过 action::message() 或 action::danger() 方法来向用户显示操作结果的即时反馈。这些方法会生成短暂的 toast 提示，在屏幕上停留数秒后自动消失，例如：

// 显示成功消息
return Action::message('操作成功完成！');

// 显示错误或危险消息
return Action::danger('操作过程中发生错误！');

这种即时提示对于快速完成的操作非常有效。然而，当一个 Nova 动作需要较长时间（例如，5-8分钟）才能执行完毕时，这种瞬时提示就显得力不从心。用户可能在操作执行期间切换到其他标签页或进行其他工作，当他们返回时，原有的 toast 提示早已消失，无法得知操作是否完成或结果如何，这极大地降低了用户体验。对于这类长时间运行的任务，我们需要一种更为持久且用户友好的反馈机制。

引入 Laravel Nova 4 通知机制

为了解决上述问题，Laravel Nova 4 引入了强大的通知（Notifications）功能，它允许开发者向用户发送持久化且可交互的通知，这些通知会保留在 Nova 界面中，直到用户明确处理。这为长时间运行的动作提供了理想的解决方案。

Nova 通知不仅可以显示消息，还可以包含：

• 动作按钮 (Action Buttons)：允许用户点击执行下一步操作，例如下载报告、查看详情等。
• 图标 (Icons)：通过视觉符号增强通知的表达力。
• 类型 (Types)：区分通知的紧急程度或性质（信息、成功、警告、危险）。

实现持久化通知

以下是如何在 Laravel Nova 动作中利用 Nova 4 通知功能发送持久化通知的示例代码：

千面视频动捕

千面视频动捕是一个AI视频动捕解决方案，专注于将视频中的人体关节二维信息转化为三维模型动作。

27

查看详情

<?php

namespace App\Nova\Actions;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Support\Collection;
use Laravel\Nova\Actions\Action;
use Laravel\Nova\Fields\ActionFields;
use Laravel\Nova\Notifications\NovaNotification; // 引入 NovaNotification 类
use Illuminate\Support\Facades\Log; // 用于日志记录，可选

class GenerateReport extends Action implements ShouldQueue
{
    use InteractsWithQueue, Queueable;

    /**
     * 执行动作。
     *
     * @param  \Laravel\Nova\Fields\ActionFields  $fields
     * @param  \Illuminate\Support\Collection  $models
     * @return mixed
     */
    public function handle(ActionFields $fields, Collection $models)
    {
        // 假设这是一个耗时较长的操作，例如生成报告
        Log::info('开始生成报告...');
        // 模拟长时间运行
        sleep(300); // 暂停 5 分钟

        // 获取当前请求的用户，用于发送通知
        $user = request()->user();

        // 检查用户是否存在且可通知
        if ($user && method_exists($user, 'notify')) {
            $user->notify(
                NovaNotification::make()
                    ->message('您的报告已准备就绪，可以下载。') // 通知消息
                    ->action('下载报告', 'https://example.com/report.pdf') // 添加一个下载按钮
                    ->icon('download') // 添加下载图标
                    ->type('info') // 设置通知类型为信息
            );
            return Action::message('报告生成请求已提交，请留意通知。');
        } else {
            // 如果无法发送通知，则回退到传统消息
            return Action::message('报告已生成。');
        }
    }

    /**
     * 定义动作的字段。
     *
     * @param  \Laravel\Nova\Http\Requests\NovaRequest  $request
     * @return array
     */
    public function fields(\Laravel\Nova\Http\Requests\NovaRequest $request)
    {
        return [];
    }
}

代码解析：

1. use Laravel\Nova\Notifications\NovaNotification;: 引入 NovaNotification 类。
2. $user = request()-youjiankuohaophpcnuser();: 获取当前执行动作的用户。通知通常是针对特定用户发送的。
3. $user->notify(...): 这是 Laravel 提供的通知发送机制。请确保你的用户模型（例如 App\Models\User）使用了 Illuminate\Notifications\Notifiable trait。
4. NovaNotification::make(): 创建一个 Nova 通知实例。
5. ->message('您的报告已准备就绪，可以下载。'): 设置通知显示的主要文本内容。
6. ->action('下载报告', 'https://example.com/report.pdf'): 添加一个可点击的动作按钮。第一个参数是按钮文本，第二个参数是点击后跳转的 URL。这完美解决了用户希望有“OK”按钮的需求，甚至提供了更强大的交互性。
7. ->icon('download'): 设置通知的图标。Nova 支持多种内置图标，你可以根据需要选择。
8. ->type('info'): 设置通知的类型。可选值包括 info (信息), success (成功), warning (警告), danger (危险)。不同类型通常会显示不同的颜色或样式，以区分重要性。
9. return Action::message('报告生成请求已提交，请留意通知。');: 即使发送了持久通知，你仍然可以在动作执行完毕后返回一个短暂的 Action::message()，告知用户请求已提交，并提醒他们查看通知。

通知与传统提示的对比

使用 Nova 4 通知相对于传统的 Action::message() 提示具有显著优势：

• 持久性： 通知不会自动消失，它们会保留在 Nova 仪表板的通知区域，直到用户手动关闭或处理。这意味着即使是长时间运行的后台任务，用户也能在任何时候返回并查看其结果。
• 交互性： 通过 ->action() 方法，通知可以包含可点击的按钮，引导用户进行下一步操作（如下载文件、查看详情、确认操作等），极大地提升了用户体验和工作流效率。
• 信息丰富性： 支持图标和类型，使得通知能够更清晰、更直观地传达信息，例如用“下载”图标表示文件已准备就绪。
• 异步处理： 对于耗时操作，通常会配合队列（ShouldQueue）使用。当队列任务完成后，再发送通知，用户无需等待页面响应。

注意事项

1. Nova 版本要求： NovaNotification 功能是 Laravel Nova 4 及更高版本才提供的。如果你的项目仍在使用 Nova 3 或更早版本，则无法直接使用此功能。
2. 用户模型配置： 确保你的 User 模型（或其他需要接收通知的模型）使用了 Illuminate\Notifications\Notifiable trait，这是 Laravel 通知系统的基础。
3. 通知存储： Nova 通知通常会存储在数据库中，以便在用户界面中持久显示。你需要运行 php artisan notifications:table 和 php artisan migrate 来创建相应的数据库表。
4. 用户体验： 尽管通知是持久的，但也应避免发送过多不必要的通知，以免造成用户界面的混乱。

总结

通过利用 Laravel Nova 4 提供的通知功能，我们可以有效解决默认动作响应消息持续时间短的痛点，尤其对于耗时较长的后台操作。持久化、可交互的通知机制不仅能确保用户及时获取操作结果，还能通过动作按钮引导用户进行下一步操作，从而显著提升 Nova 应用的用户体验和工作效率。在设计 Nova 动作的用户反馈时，应优先考虑使用 NovaNotification 来处理需要更长时间可见性或更复杂交互的场景。

以上就是优化 Laravel Nova 动作响应消息的持久性与交互性的详细内容，更多请关注php中文网其它相关文章！