Hành động là những gì 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 của bạn. Một tác vụ gọi một tính năng tiện ích bằng cách sử dụng API Tác vụ 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. Hãy xem phần tệp kê khai của 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 thời điểm 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 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 thao tác 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 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 bị 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 đã định dạng được đặt ở đầu biểu tượng hành động để cho biết những thông tin như trạng thái của tiện ích hoặc người dùng cần thực hiện hành động. Để minh hoạ điều này, mẫu Drink Water (Uống nước) sẽ hiển thị 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 này ở trạng thái rảnh. Huy hiệu có thể chứa tối đa 4 ký tự.
Đặt nội dung 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ú giải công cụ trong trường "default_title" bên dưới khoá "action" của 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ú giải công cụ bằng cách gọi action.setTitle()`. Nếu bạn chưa đặt chú giải công cụ nào, thì tên của tiện ích sẽ hiển thị.