實作動作

當使用者點選擴充功能的工具列圖示 (通常稱為「動作圖示」) 時，就會觸發動作。動作會使用 Action API 叫用擴充功能，或開啟快顯視窗。本頁說明如何叫用擴充功能。如要使用彈出式視窗，請參閱「新增彈出式視窗」。

註冊動作

如要使用 chrome.action API，請將 "action" 金鑰新增至擴充功能的資訊清單檔案。如需這個欄位選用屬性的完整說明，請參閱 chrome.action API 參考資料的資訊清單部分。

manifest.json:

{
  "name": "My Awesome action Extension",
 ...
  "action": {
   ...
  }
 ...
}

回應動作

針對使用者點選動作圖示時，註冊 onClicked 處理常式。如果在 manifest.json 檔案中註冊彈出式視窗，系統就不會觸發這個事件。

service-worker.js：

chrome.action.onClicked.addListener((tab) => {
  chrome.action.setTitle({
    tabId: tab.id,
    title: `You are on tab: ${tab.id}`});
});

有條件地啟用動作

您可以透過 chrome.declarativeContent API 根據網頁網址啟用擴充功能的動作圖示，或在 CSS 選取器與網頁上的元素相符時啟用。如果擴充功能的操作圖示已停用，圖示會顯示為灰色。如果使用者點選已停用圖示，系統會顯示擴充功能的內容選單。

動作徽章

徽章是格式化文字片段，會放在動作圖示上方，用來表示擴充功能狀態或使用者必須執行的動作等。為說明這點，「Drink Water」範例會顯示「開啟」徽章，表示使用者已成功設定鬧鐘，擴充功能閒置時則不會顯示任何內容。徽章最多可包含四個字元。

呼叫 chrome.action.setBadgeText() 設定徽章文字，呼叫 chrome.action.setBadgeBackgroundColor() 設定背景顏色。

service-worker.js：

chrome.action.setBadgeText({text: 'ON'});
chrome.action.setBadgeBackgroundColor({color: '#4688F1'});

工具提示

在 manifest.json 檔案的 "action" 鍵下，於 "default_title" 欄位中註冊工具提示。

manifest.json:

{
  "name": "Tab Flipper",
 ...
  "action": {
    "default_title": "Press Ctrl(Win)/Command(Mac)+Shift+Right/Left to flip tabs"
  }
...
}

您也可以呼叫 action.setTitle() 設定或更新工具提示。如果未設定工具提示，系統會顯示擴充功能的名稱。