chrome.declarativeContent

Mô tả

Quyền

Khái niệm và cách sử dụng

API Nội dung khai báo cho phép bạn bật hành động của tiện ích tuỳ thuộc vào URL của trang web hoặc nếu bộ chọn CSS khớp với một phần tử trên trang mà không cần thêm quyền lưu trữ hoặc chèn tập lệnh nội dung.

Sử dụng quyền activeTab để tương tác với một trang sau khi người dùng nhấp vào thao tác của tiện ích.

Quy tắc

Quy tắc bao gồm các điều kiện và hành động. Nếu bất kỳ điều kiện nào được đáp ứng, tất cả hành động sẽ được thực thi. Các thao tác này là setIcon() và showAction().

PageStateMatcher khớp với các trang web nếu và chỉ khi đáp ứng tất cả tiêu chí được liệt kê. Giá trị này có thể khớp với url trang, bộ chọn hợp chất css hoặc trạng thái đánh dấu trang của một trang. Quy tắc sau đây cho phép hành động của tiện ích trên các trang của Google khi có trường mật khẩu:

let rule1 = {
  conditions: [
    new chrome.declarativeContent.PageStateMatcher({
      pageUrl: { hostSuffix: '.google.com', schemes: ['https'] },
      css: ["input[type='password']"]
    })
  ],
  actions: [ new chrome.declarativeContent.ShowAction() ]
};

Để cũng bật thao tác của tiện ích cho các trang web của Google có video, bạn có thể thêm một điều kiện thứ hai, vì mỗi điều kiện là đủ để kích hoạt tất cả thao tác đã chỉ định:

let rule2 = {
  conditions: [
    new chrome.declarativeContent.PageStateMatcher({
      pageUrl: { hostSuffix: '.google.com', schemes: ['https'] },
      css: ["input[type='password']"]
    }),
    new chrome.declarativeContent.PageStateMatcher({
      css: ["video"]
    })
  ],
  actions: [ new chrome.declarativeContent.ShowAction() ]
};

Sự kiện onPageChanged kiểm tra xem có quy tắc nào có ít nhất một điều kiện được thực hiện hay không và thực thi các hành động. Các quy tắc vẫn tồn tại trong các phiên duyệt web; do đó, trong thời gian cài đặt tiện ích, trước tiên, bạn nên sử dụng removeRules để xoá các quy tắc đã cài đặt trước đó, sau đó sử dụng addRules để đăng ký các quy tắc mới.

chrome.runtime.onInstalled.addListener(function(details) {
  chrome.declarativeContent.onPageChanged.removeRules(undefined, function() {
    chrome.declarativeContent.onPageChanged.addRules([rule2]);
  });
});

Với quyền activeTab, tiện ích của bạn sẽ không hiển thị bất kỳ cảnh báo quyền nào và khi người dùng nhấp vào thao tác của tiện ích, thao tác đó sẽ chỉ chạy trên các trang có liên quan.

So khớp URL của trang

PageStateMatcher.pageurl khớp khi đáp ứng các tiêu chí về URL. Các tiêu chí phổ biến nhất là chuỗi kết hợp của máy chủ lưu trữ, đường dẫn hoặc URL, theo sau là Có chứa, Bằng, Tiền tố hoặc Hậu tố. Bảng sau đây chứa một số ví dụ:

Tiêu chí	Liên kết
{ hostSuffix: 'google.com' }	Tất cả URL của Google
{ pathPrefix: '/docs/extensions' }	URL của tài liệu về tiện ích
{ urlContains: 'developer.chrome.com' }	Tất cả URL tài liệu dành cho nhà phát triển Chrome

Tất cả tiêu chí đều có phân biệt chữ hoa chữ thường. Để biết danh sách đầy đủ các tiêu chí, hãy xem UrlFilter.

So khớp CSS

Điều kiện PageStateMatcher.css phải là bộ chọn phức hợp, nghĩa là bạn không thể đưa toán tử kết hợp như khoảng trắng hoặc ">" vào bộ chọn. Điều này giúp Chrome so khớp bộ chọn hiệu quả hơn.

Bộ chọn phức hợp (OK)	Bộ chọn phức tạp (Không được)
a	div p
iframe.special[src^='http']	p>span.highlight
ns|*	p + ol
#abcd:checked	p::first-line

Các điều kiện CSS chỉ khớp với các phần tử hiển thị: nếu một phần tử khớp với bộ chọn của bạn là display:none hoặc một trong các phần tử mẹ của phần tử đó là display:none, thì điều kiện này sẽ không khớp. Các phần tử được tạo kiểu bằng visibility:hidden, được đặt ngoài màn hình hoặc bị các phần tử khác ẩn vẫn có thể giúp điều kiện của bạn khớp.

So khớp trạng thái đã đánh dấu

Điều kiện PageStateMatcher.isBookmarked cho phép so khớp trạng thái đã đánh dấu của URL hiện tại trong hồ sơ của người dùng. Để sử dụng điều kiện này, bạn phải khai báo quyền "dấu trang" trong manifest của tiện ích.