Triển khai một hành động

Hành động là hành động sẽ xảy ra khi người dùng nhấp vào biểu tượng thanh công cụ, thường được gọi là biểu tượng hành động cho tiện ích. Một hành động gọi một tính năng tiện ích bằng API Thao tác hoặc mở một cửa sổ bật lên. Trang này cho biết cách gọi một tính năng tiện ích. Để sử dụng cửa sổ bật lên, hãy xem phần Thêm cửa sổ bật lên.

Đăng ký hành động

Để sử dụng API chrome.action, hãy thêm khoá "action" vào tệp tệp kê khai của tiện ích. Xem phần tệp kê khai trong tài liệu tham khảo API chrome.action để biết nội dung mô tả đầy đủ về các thuộc tính không bắt buộc của trường này.

manifest.json:

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

Phản hồi hành động

Đăng ký trình xử lý onClicked khi người dùng nhấp vào biểu tượng hành động. Sự kiện này không được kích hoạt nếu một cửa sổ bật lên được đăng ký trong tệp manifest.json.

service-worker.js:

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

Kích hoạt hành động này theo điều kiện

API chrome.declarativeContent cho phép bạn bật biểu tượng hành động của phần mở rộng dựa trên URL của trang hoặc khi bộ chọn CSS khớp với các phần tử trên trang. Khi biểu tượng hành động của tiện ích bị tắt, biểu tượng này sẽ chuyển sang màu xám. Nếu người dùng nhấp vào biểu tượng đã tắt, trình đơn theo bối cảnh của tiện ích sẽ xuất hiện.

Huy hiệu hành động

Huy hiệu là các đoạn văn bản được định dạng được đặt phía trên biểu tượng hành động để cho biết những thông tin như trạng thái tiện ích hoặc người dùng cần thực hiện hành động nào. Để chứng minh điều này, mẫu Drink Water sẽ cho thấy một huy hiệu có trạng thái "BẬT" để cho người dùng biết rằng họ đã đặt chuông báo thành công và không hiện gì khi tiện ích ở trạng thái rảnh. Huy hiệu có thể chứa tối đa bốn ký tự.

Đặt văn bản của huy hiệu bằng cách gọi chrome.action.setBadgeText() và chọn màu nền bằng cách gọi chrome.action.setBadgeBackgroundColor()`.

service-worker.js:

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

Chú giải công cụ

Đăng ký chú thích trong trường "default_title" bằng khoá "action" trong tệp manifest.json.

manifest.json:

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

Bạn cũng có thể đặt hoặc cập nhật chú thích bằng cách gọi action.setTitle()`. Nếu bạn không đặt chú thích, tên của tiện ích sẽ hiển thị.