本文探討了在 Laravel Nova 中處理長時任務(wù)后，默認(rèn)動作響應(yīng)消息（Toast）短暫顯示的問題。針對這一挑戰(zhàn)，我們將介紹如何利用 Laravel Nova 4 提供的 NovaNotification 功能，實現(xiàn)持久化的、帶有交互操作的通知，從而顯著提升用戶體驗，確保重要信息不會因消息瞬時消失而被遺漏，特別適用于需要用戶后續(xù)操作的場景。

Laravel Nova 動作響應(yīng)消息的局限性

在 Laravel Nova 中，我們經(jīng)常利用 Action::message() 或 Action::danger() 等方法在動作執(zhí)行后向用戶顯示反饋信息。這些消息通常以“Toast”的形式在屏幕上短暫顯示幾秒鐘后自動消失。對于快速完成的動作，這種即時反饋是高效且友好的。然而，當(dāng)面臨執(zhí)行時間較長（例如，5-8分鐘）的后臺任務(wù)時，這種短暫的消息機(jī)制便暴露出其局限性：

1. 信息易丟失： 用戶可能在消息消失前切換標(biāo)簽頁或離開電腦，導(dǎo)致無法看到任務(wù)完成的通知。
2. 缺乏持久性： 無法在用戶返回時再次顯示，也無法提供“確認(rèn)”或“查看詳情”等交互選項。
3. 用戶體驗下降： 對于關(guān)鍵性或耗時任務(wù)，用戶期待更明確、更持久的反饋。

引入 NovaNotification：持久化與交互式通知

為了解決上述問題，Laravel Nova 4 引入了強(qiáng)大的 NovaNotification 功能。它允許開發(fā)者發(fā)送持久化的、帶有圖標(biāo)和可點擊動作按鈕的通知，這些通知會顯示在 Nova 應(yīng)用的用戶界面中，直到用戶手動關(guān)閉或執(zhí)行了相關(guān)操作。這使得長時任務(wù)的完成狀態(tài)能夠被清晰、持久地傳達(dá)給用戶。

實現(xiàn)持久化通知

使用 NovaNotification 發(fā)送通知的步驟如下：

1. 構(gòu)建 NovaNotification 實例

首先，你需要創(chuàng)建一個 NovaNotification 實例。這通常在你的 Nova Action 的 handle 方法中完成，或者在任何你需要發(fā)送通知的地方。

use Laravel\Nova\Notifications\NovaNotification;
use Illuminate\Http\Request;

// ... 在你的 Nova Action 的 handle 方法或其他服務(wù)中

public function handle(ActionFields $fields, Collection $models)
{
    // 假設(shè)你正在處理一個模型或請求
    $request = app(Request::class); // 獲取當(dāng)前請求實例

    // 構(gòu)建通知
    $notification = NovaNotification::make()
        ->message('您的報告已準(zhǔn)備就緒，可以下載。') // 設(shè)置通知的主要文本內(nèi)容
        ->action('下載報告', 'https://example.com/report.pdf') // 添加一個可點擊的動作按鈕
        ->icon('download') // 設(shè)置通知的圖標(biāo)，例如 'download', 'check', 'exclamation' 等
        ->type('info'); // 設(shè)置通知的類型，可選 'info', 'success', 'warning', 'danger'

    // 發(fā)送通知
    $request->user()->notify($notification);

    return Action::message('報告生成任務(wù)已完成，請查看通知中心。');
}

2. 發(fā)送通知給用戶

通知是通過 Laravel 的 Notifiable trait 發(fā)送的。通常，你的 User 模型應(yīng)該已經(jīng)使用了此 trait。你可以通過當(dāng)前請求獲取認(rèn)證用戶，然后調(diào)用其 notify() 方法。

$request->user()->notify($notification);

注意事項：

• 確保你的用戶模型（通常是 App\Models\User）使用了 Illuminate\Notifications\Notifiable trait。
• NovaNotification 實例的 action() 方法接受兩個參數(shù)：按鈕文本和點擊后跳轉(zhuǎn)的 URL。這對于提供下載鏈接、查看詳情鏈接等非常有用。
• icon() 方法可以讓你選擇一個符合 Font Awesome 或 Heroicons 風(fēng)格的圖標(biāo)，增強(qiáng)視覺效果。
• type() 方法用于設(shè)置通知的顏色和樣式，以區(qū)分不同重要程度的通知。

NovaNotification 的優(yōu)勢與應(yīng)用場景

• 持久性： 通知會顯示在 Nova 的通知中心（通常在右上角），直到用戶手動關(guān)閉或點擊動作按鈕。即使刷新頁面或切換標(biāo)簽頁，通知依然存在。
• 交互性： action() 方法允許你為通知添加一個可點擊的按鈕，引導(dǎo)用戶進(jìn)行下一步操作，例如下載文件、跳轉(zhuǎn)到詳情頁等。
• 視覺提示： icon() 和 type() 方法提供了豐富的視覺定制選項，讓通知更具表現(xiàn)力。
• 適用于長時任務(wù)： 這是解決長時任務(wù)反饋問題的理想方案，用戶無需持續(xù)等待，可以在任務(wù)完成后收到明確的通知。
• 關(guān)鍵信息傳達(dá)： 對于需要用戶特別注意的重要信息，NovaNotification 比短暫的 Toast 消息更可靠。

總結(jié)

盡管 Laravel Nova 提供的 Action::message() 等 Toast 消息對于即時反饋非常方便，但它們在處理長時任務(wù)或需要用戶后續(xù)交互的場景下顯得力不從心。通過擁抱 Laravel Nova 4 的 NovaNotification 功能，開發(fā)者能夠構(gòu)建出更健壯、用戶體驗更佳的通知系統(tǒng)。它不僅能確保重要信息不會被遺漏，還能通過交互式按鈕引導(dǎo)用戶完成下一步操作，從而顯著提升 Nova 應(yīng)用的專業(yè)性和易用性。在設(shè)計你的 Nova Action 響應(yīng)時，請根據(jù)任務(wù)的性質(zhì)和重要性，明智地選擇 Toast 消息還是 NovaNotification。

以上是優(yōu)化 Laravel Nova 動作響應(yīng)消息的持久性與用戶體驗的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！