Laravel Nova 4 动作响应持久化：告别短暂Toast，拥抱长效通知

在Laravel Nova中，开发者通常使用 Action::message() 或 Action::danger() 等方法来向用户提供动作执行结果的即时反馈。这些消息以Toast的形式短暂显示在屏幕上，对于快速完成的操作而言，这种反馈机制简洁高效。然而，当面临需要数分钟甚至更长时间才能完成的后台任务时，例如生成复杂的报告或处理大量数据，这种短暂的Toast消息便显得力不从心。用户可能在任务执行期间切换页面或标签页，导致他们错过重要的成功或失败通知，从而影响用户体验和工作流程的连贯性。

为了解决这一问题，Laravel Nova 4引入了功能更为强大的通知系统，即 NovaNotification。与短暂的Toast消息不同，NovaNotification 提供了持久化的通知机制，并且支持添加交互式按钮和自定义图标，极大地提升了用户接收和处理信息的能力。

利用 NovaNotification 实现持久化通知

NovaNotification 允许我们将通知直接发送给特定的用户，这些通知会显示在Nova界面的通知中心，并且可以持续存在，直到用户主动处理或清除它们。这对于需要长时间等待结果的异步操作尤为关键。

以下是如何在您的Nova动作中利用 NovaNotification 发送持久化通知的示例。此示例假设您的动作本身是耗时操作，并且已经实现了 ShouldQueue 接口以在后台执行：

知我AI

一款多端AI知识助理，通过一键生成播客/视频/文档/网页文章摘要、思维导图，提高个人知识获取效率；自动存储知识，通过与知识库聊天，提高知识利用效率。

26

查看详情

use Laravel\Nova\Notifications\NovaNotification;
use Laravel\Nova\Actions\Action;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Support\Collection;
use Laravel\Nova\Fields\ActionFields;
use Illuminate\Http\Request; // 引入 Request 类

class GenerateLongReport 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)
    {
        // 模拟一个耗时5-8分钟的报告生成过程
        // 在实际应用中，这部分逻辑会执行您的业务代码
        sleep(300); // 模拟5分钟的执行时间

        // 假设报告已成功生成，并提供下载链接
        $reportUrl = 'https://example.com/reports/generated_report_' . uniqid() . '.pdf';

        // 获取当前请求的用户实例
        $request = app(Request::class); // 在队列化动作中获取请求对象可能需要特殊处理，这里简化示例
        $user = $request->user();

        if ($user) {
            // 通过NovaNotification发送持久化通知给当前用户
            $user->notify(
                NovaNotification::make()
                    ->message('您的报告已准备好下载。') // 通知消息内容
                    ->action('下载报告', $reportUrl) // 添加一个可点击的动作按钮
                    ->icon('download') // 设置通知图标，例如下载图标
                    ->type('info') // 设置通知类型，如 'info', 'success', 'warning', 'danger'
            );
        }

        // 返回一个简单的Action::message()，告知用户任务已完成并引导他们查看通知中心。
        // 这个Toast消息可以短暂显示，但核心结果通过持久通知传达。
        return Action::message('报告生成任务已完成，请查看通知中心获取下载链接。');
    }
}

在上述代码中：

• class GenerateLongReport extends Action implements ShouldQueue：表明这是一个队列化的Nova动作，其 handle 方法将在后台执行，避免阻塞用户界面。
• sleep(300);：用于模拟耗时操作。在真实场景中，这里将是您的业务逻辑代码。
• $user->notify(...)：这是发送通知的关键。它利用 Laravel 的通知系统将 NovaNotification 实例发送给当前登录用户。
• NovaNotification::make()：用于创建一个新的 Nova 通知实例。
• ->message('您的报告已准备好下载。')：设置通知的主体文本内容。
• ->action('下载报告', $reportUrl)：这是 NovaNotification 的一个强大功能。它允许您添加一个带有自定义文本和URL的按钮。用户点击此按钮后，将被重定向到指定的URL，例如直接下载报告。
• ->icon('download')：为通知设置一个图标，提升视觉识别度。Nova 4 支持多种内置图标。
• ->type('info')：设置通知的类型。Nova 会根据类型应用不同的样式（例如，info 为蓝色，success 为绿色，warning 为黄色，danger 为红色），帮助用户快速区分通知的紧急程度或性质。

NovaNotification 的优势与应用场景

使用 NovaNotification 相比传统的 Action::message() 具有显著优势：

1. 持久性与可见性： 通知不会自动消失，用户可以在方便时随时查看，即使他们离开了最初触发动作的页面。所有通知都汇集在Nova界面的通知中心，方便用户统一管理和查阅。
2. 交互性： action() 方法允许您在通知中嵌入可点击的链接或按钮，使用户能够直接从通知中执行下一步操作，如下载文件、查看详情或跳转到相关资源。
3. 用户体验优化： 对于耗时操作，NovaNotification 提供了一个更清晰、更可靠的反馈机制，减少了用户因信息丢失而产生的焦虑，提升了管理界面的专业度。
4. 状态更新： 可以在后台任务的不同阶段发送不同类型的通知，例如“任务已启动”、“任务进行中”和“任务完成”，为用户提供更精细的进度反馈。

注意事项与最佳实践

• 选择合适的通知机制： 对于即时、短暂的反馈（如表单验证成功、快速数据更新），Action::message() 依然是更轻量级的选择。而对于异步任务、耗时操作或需要用户后续交互的场景，NovaNotification 则是更优解。
• 队列化动作是前提： 对于任何耗时操作，强烈建议将Nova动作队列化（实现 ShouldQueue 接口），以避免阻塞HTTP请求，提升用户界面的响应速度。在队列化动作中，当任务完成后再发送 NovaNotification。
• 用户上下文： 在队列化的动作或任务中发送通知时，需要确保能够正确获取到当前用户的实例。通常的做法是在调度队列任务时，将用户的ID作为参数传递给任务，然后在任务中通过用户ID检索用户实例。
• 通知内容清晰明了： 通知消息应简洁明了地传达信息，避免冗余。如果需要详细信息，可以通过 action() 链接到相关页面。
• 错误处理： 对于耗时操作，不仅要发送成功通知，也应考虑在任务失败时发送 type('danger') 的通知，并提供错误详情或解决方案。

总结

通过采纳Laravel Nova 4的 NovaNotification 功能，开发者可以显著提升处理耗时动作时的用户体验。它提供了一种持久、可交互且高度可定制的通知机制，确保用户即使在复杂的后台操作流程中也能保持信息同步，并能够方便地进行后续操作。将 NovaNotification 融入您的Nova动作设计中，将使您的管理界面更加健壮和用户友好，真正告别短暂Toast带来的信息遗漏困扰。

以上就是Laravel Nova 4 动作响应持久化：告别短暂Toast，拥抱长效通知的详细内容，更多请关注php中文网其它相关文章！