chrome.declarativeContent

Açıklama

İzinler

Kavramlar ve kullanım

Declarative Content API, barındırma izinleri eklemenize veya içerik komut dosyası eklemenize gerek kalmadan, uzantınızın işlemini bir web sayfasının URL'sine veya bir CSS seçicinin sayfadaki bir öğeyle eşleşmesine bağlı olarak etkinleştirmenize olanak tanır.

Kullanıcı uzantının işlemini tıkladıktan sonra bir sayfayla etkileşimde bulunmak için activeTab iznini kullanın.

Kurallar

Kurallar, koşullardan ve işlemlerden oluşur. Koşullardan herhangi biri karşılanırsa tüm işlemler yürütülür. İşlemler setIcon() ve showAction() şeklindedir.

PageStateMatcher, yalnızca listelenen tüm ölçütler karşılanırsa web sayfalarıyla eşleşir. Bir sayfa URL'si, CSS birleşik seçici veya bir sayfanın yer işareti eklenmiş durumu ile eşleşebilir. Aşağıdaki kural, şifre alanı bulunduğunda uzantının Google sayfalarındaki işlemini etkinleştirir:

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

Uzantı işleminin video içeren Google siteleri için de etkinleştirilmesi amacıyla ikinci bir koşul ekleyebilirsiniz. Belirtilen tüm işlemleri tetiklemek için her koşul yeterlidir:

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() ]
};

onPageChanged etkinliği, herhangi bir kuralın en az bir koşulu karşılayıp karşılamadığını test eder ve işlemleri yürütür. Kurallar, tarama oturumları boyunca devam eder. Bu nedenle, uzantı yükleme süresi boyunca önce önceden yüklenmiş kuralları temizlemek için removeRules'ı, ardından yenilerini kaydetmek için addRules'i kullanmanız gerekir.

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

activeTab izniyle uzantınız herhangi bir izin uyarısı göstermez ve kullanıcı uzantı işlemini tıkladığında yalnızca alakalı sayfalarda çalışır.

Sayfa URL'si eşleştirme

URL ölçütleri karşılandığında PageStateMatcher.pageurl eşleşir. En yaygın ölçütler, ana makine, yol veya URL'nin ardından İçerir, Eşittir, Önek veya Sonek'in geldiği bir dize birleştirmedir. Aşağıdaki tabloda birkaç örnek verilmiştir:

Ölçütler	Eşleşmeler
{ hostSuffix: 'google.com' }	Tüm Google URL'leri
{ pathPrefix: '/docs/extensions' }	Uzantı dokümanı URL'leri
{ urlContains: 'developer.chrome.com' }	Tüm Chrome geliştirici belgeleri URL'leri

Tüm ölçütler büyük/küçük harfe duyarlıdır. Ölçütlerin tam listesi için UrlFilter konusuna bakın.

CSS Eşleştirme

PageStateMatcher.css koşulları bileşik seçici olmalıdır. Yani seçicilerinize boşluk veya ">" gibi birleştiriciler ekleyemezsiniz. Bu, Chrome'un seçicileri daha verimli bir şekilde eşleştirmesine yardımcı olur.

Bileşik Seçiciler (Tamam)	Karmaşık Seçiciler (Tamam Değil)
a	div p
iframe.special[src^='http']	p>span.highlight
ns|*	p + ol
#abcd:checked	p::first-line

CSS koşulları yalnızca görüntülenen öğelerle eşleşir: Seçicinizle eşleşen bir öğe display:none ise veya üst öğelerinden biri display:none ise koşulun eşleşmesine neden olmaz. visibility:hidden ile biçimlendirilmiş, ekran dışında konumlandırılmış veya diğer öğeler tarafından gizlenmiş öğeler, durumunuzun eşleşmesine neden olabilir.

Yer işareti eklenmiş durum eşleştirme

PageStateMatcher.isBookmarked koşulu, kullanıcının profilindeki mevcut URL'nin yer işareti durumunun eşleştirilmesine olanak tanır. Bu koşuldan yararlanmak için "yer işaretleri" izninin uzantı manifest belirtilmesi gerekir.