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

Hành động là những gì xảy ra khi người dùng nhấp vào biểu tượng trên thanh công cụ, thường được gọi là biểu tượng hành động cho tiện ích của bạn. Một thao tác gọi một tính năng của tiện ích bằng cách sử dụng Action API 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 của 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ý thao tác

Để sử dụng API chrome.action, hãy thêm khoá "action" vào tệp manifest của tiện ích. Hãy 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ý một trình xử lý onClicked cho trường hợp người dùng nhấp vào biểu tượng thao tác. Sự kiện này sẽ 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 có điều kiện

API chrome.declarativeContent cho phép bạn bật biểu tượng hành động của tiện ích 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 thao tác của một tiện ích bị tắt, biểu tượng đó sẽ chuyển sang màu xám. Nếu người dùng nhấp vào biểu tượng bị vô hiệu hoá, trình đơn theo bối cảnh của tiện ích sẽ xuất hiện.

Huy hiệu hoạt động

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

Đặt văn bản của huy hiệu bằng cách gọi chrome.action.setBadgeText() và 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" trong 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ẽ xuất hiện.