通知
通知 會顯示來自 VS Code 右下角的簡短資訊。
你可以發送三種類型的通知
為了尊重使用者注意力,限制發送通知的數量非常重要。為了幫助您決定是否應該顯示通知,請遵循我們的通知決策樹。
通知範例
此通知在使用者執行「更新版本」命令後出現。請注意,沒有其他動作,純粹是資訊性的。
此範例突顯了需要使用者輸入的功能問題,並顯示了解決問題的動作。
此範例顯示了失敗通知,並帶有解決問題的動作。
✔️ 應該
- 僅在絕對必要時才發送通知,以尊重使用者的注意力
- 為每個通知新增「不再顯示」選項
- 一次顯示一個通知
❌ 不應該
- 發送重複的通知
- 用於促銷
- 在首次安裝時要求回饋
- 在沒有動作時顯示動作
進度通知
當需要顯示不確定時間範圍的進度時(例如,設定環境),您可以使用進度通知。這種全域進度通知應作為最後手段,因為進度最好保持在上下文內(在檢視或編輯器內)。
✔️ 應該
- 顯示連結以查看更多詳細資訊(例如日誌)
- 在設定進度時顯示資訊(正在初始化、正在建置等)
- 提供取消操作的動作(如果適用)
- 為逾時情境新增計時器
❌ 不應該
- 讓通知在進度中運行
此範例使用進度通知來顯示遠端連線的設定過程,同時也提供輸出日誌的連結(詳細資訊)。
模式對話方塊
當您需要使用者立即輸入以執行動作時,您可以選擇顯示模式對話方塊。應謹慎使用此 UI 元素,因為模式對話方塊會封鎖對話方塊外部的使用者互動,直到它被關閉。
此對話方塊在移動 JavaScript/TypeScript 檔案後出現,詢問是否更新其他檔案中的 import 語句。
✔️ 應該
- 僅在您需要使用者立即互動時才使用模式對話方塊
- 在適當情況下,提供動作以避免重複的使用者確認(總是/永不 動作)
- 考慮使用核取方塊來記住使用者的選擇
❌ 不應該
- 使用模式對話方塊來確認多個步驟
- 使用模式對話方塊來顯示不需要使用者動作的訊息
- 針對非使用者明確啟動的動作顯示模式對話方塊