介面元件 深入了解 C · 業界慣例

Command Palette

指令面板

指令面板是以鍵盤操作為主的搜尋面板,可以開啟功能、頁面和最近使用的項目。

動手試試看
也有人這樣說 Command Palette快速指令命令列

動手試試看

Northstar已儲存
Launch workspaceFall campaign brief

指令面板是以鍵盤操作為主的搜尋面板,可以開啟功能、頁面和最近使用的項目。

試用
指令面板command-palette

生活中的例子

按下 Command-K,輸入「邀請夥伴」,再從清單執行這個操作。

主要部分

  1. 01目前位置
  2. 02目的地標籤
  3. 03焦點順序
  4. 04響應式行為

什麼時候用

產品有很多指令,而且使用者會常常回來操作時,就可以使用指令面板。

什麼時候不要用

重要操作不能只放在指令面板裡,還要有其他找得到的入口。

程式裡的名稱

Command-K / role="dialog"

上線前要檢查

發布前檢查頁面結構、鍵盤操作、清楚可見的焦點、對比與縮放。也要檢查載入、沒有內容、錯誤、成功、取消與減少動態效果。

可以直接複製的需求

預期成果:使用 指令面板 (Command Palette) 解決這項需求,同時保留使用者目前的操作脈絡。 使用者情境:按下 Command-K,輸入「邀請夥伴」,再從清單執行這個操作。 建議介面模式:指令面板 (Command Palette)。 適用理由:產品有很多指令,而且使用者會常常回來操作時,就可以使用指令面板。 不應使用的情況:重要操作不能只放在指令面板裡,還要有其他找得到的入口。 產品要求:定義預設、載入、沒有內容、錯誤、成功與復原狀態。保留使用者已輸入的內容,每個操作後都提供清楚回饋。 無障礙與韌性:使用結構正確的 HTML(語意化 HTML)和完整鍵盤操作。焦點要清楚可見,版面縮放後仍要好用。也要提供減少動態效果。遵守專案現有規則。除非專案已採用,否則不要新增介面元件庫。 驗收條件:主要任務可只用鍵盤完成,在 320px 寬度也能正常使用。焦點與狀態變化可被輔助工具讀出。載入、失敗、重試、取消與減少動態效果都已驗證。 證據與限制(證據邊界):沒有一份官方標準能管到全部內容。不同團隊、平台或框架的用法可能不同。 待確認:產品文字、資料來源、分析事件、支援裝置與語系,以及平台特有限制。

檢查這份需求

請 AI 程式助手檢查目前如何使用 指令面板 (Command Palette)。 定義:指令面板是以鍵盤操作為主的搜尋面板,可以開啟功能、頁面和最近使用的項目。 正式環境檢查:發布前檢查頁面結構、鍵盤操作、清楚可見的焦點、對比與縮放。也要檢查載入、沒有內容、錯誤、成功、取消與減少動態效果。 修改程式前,先列出看到的證據、缺口、嚴重程度,以及最小且安全的修正。

C
這個術語有多正式?

業界慣例

工作上常會用到這個術語。列出的來源可能說明用法或限制,但不會定義全部內容。

沒有一份官方標準能管到全部內容。不同團隊、平台或框架的用法可能不同。

適用範圍
只包含來源有說明的內容:正式名稱、定義、互動行為、鍵盤行為、無障礙、使用指南、避免事項
文件狀態
穩定
查證日期
2026-07-30

證據來源與適用範圍

正式來源 · W3C WAI · 穩定 ARIA Authoring Practices Guide 適用範圍: 正式名稱、定義、互動行為、鍵盤行為、無障礙 本頁用途: 提供背景,不是正式定義 來源涵蓋內容: 正式名稱, 定義, 互動行為, 鍵盤行為, 無障礙 正式來源 · W3C · 正式建議標準 Web Content Accessibility Guidelines (WCAG) 2.2 適用範圍: 無障礙、使用指南、避免事項 本頁用途: 提供背景,不是正式定義 來源涵蓋內容: 無障礙, 使用指南, 避免事項

自行複製

瀏覽器無法自動複製。請選取下方文字,再自行複製。