🚀 在 VS Code 中免費取得

通知

通知 會顯示來自 VS Code 右下角的簡短資訊。

Example of a notification

你可以發送三種類型的通知

為了尊重使用者注意力,限制發送通知的數量非常重要。為了幫助您決定是否應該顯示通知,請遵循我們的通知決策樹

Show a multi-step quick pick if multi step user input is immediately needed. If user input is immediately needed but it is not multi-step show a modal dialog. If you need to show progress that is low priority show the progress in the status bar. If the interaction is triggered by the user find the right moment to show the notification and only then show it. If you need to show multiple notifications try to combine them into one. If the user does not really need to be notified consider to not show anything and relax.

通知範例

Information notification

此通知在使用者執行「更新版本」命令後出現。請注意,沒有其他動作,純粹是資訊性的。

Warning notification

此範例突顯了需要使用者輸入的功能問題,並顯示了解決問題的動作。

Error notification

此範例顯示了失敗通知,並帶有解決問題的動作。

✔️ 應該

  • 僅在絕對必要時才發送通知,以尊重使用者的注意力
  • 為每個通知新增「不再顯示」選項
  • 一次顯示一個通知

❌ 不應該

  • 發送重複的通知
  • 用於促銷
  • 在首次安裝時要求回饋
  • 在沒有動作時顯示動作

進度通知

當需要顯示不確定時間範圍的進度時(例如,設定環境),您可以使用進度通知。這種全域進度通知應作為最後手段,因為進度最好保持在上下文內(在檢視或編輯器內)。

✔️ 應該

  • 顯示連結以查看更多詳細資訊(例如日誌)
  • 在設定進度時顯示資訊(正在初始化、正在建置等)
  • 提供取消操作的動作(如果適用)
  • 為逾時情境新增計時器

❌ 不應該

  • 讓通知在進度中運行

Progress notification

此範例使用進度通知來顯示遠端連線的設定過程,同時也提供輸出日誌的連結(詳細資訊)。

當您需要使用者立即輸入以執行動作時,您可以選擇顯示模式對話方塊。應謹慎使用此 UI 元素,因為模式對話方塊會封鎖對話方塊外部的使用者互動,直到它被關閉。

Modal dialog

此對話方塊在移動 JavaScript/TypeScript 檔案後出現,詢問是否更新其他檔案中的 import 語句。

✔️ 應該

  • 僅在您需要使用者立即互動時才使用模式對話方塊
  • 在適當情況下,提供動作以避免重複的使用者確認(總是/永不 動作)
  • 考慮使用核取方塊來記住使用者的選擇

❌ 不應該

  • 使用模式對話方塊來確認多個步驟
  • 使用模式對話方塊來顯示不需要使用者動作的訊息
  • 針對非使用者明確啟動的動作顯示模式對話方塊