chrome.declarativeContent

توضیحات

مجوزها

استفاده

Declarative Content API به شما امکان می دهد تا عملکرد برنامه افزودنی خود را بسته به URL یک صفحه وب یا اگر انتخابگر CSS با عنصری در صفحه مطابقت دارد، بدون نیاز به اضافه کردن مجوزهای میزبان یا تزریق اسکریپت محتوا، فعال کنید.

پس از کلیک کاربر بر روی عملکرد برنامه افزودنی، از مجوز activeTab برای تعامل با یک صفحه استفاده کنید.

قوانین

قوانین شامل شرایط و اقدامات است. در صورت تحقق هر یک از شرایط، تمام اقدامات اجرا می شوند. اکشن‌ها setIcon و showAction هستند.

PageStateMatcher با صفحات وب منطبق است اگر و فقط در صورتی که تمام معیارهای فهرست شده برآورده شوند. می‌تواند با یک url صفحه ، یک انتخابگر ترکیبی css یا حالت نشانه‌گذاری شده یک صفحه مطابقت داشته باشد. قانون زیر در صورت وجود فیلد رمز عبور، عملکرد برنامه افزودنی را در صفحات Google فعال می کند:

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

برای فعال کردن عملکرد برنامه افزودنی برای سایت‌های Google با یک ویدیو، می‌توانید شرط دوم را اضافه کنید، زیرا هر شرط برای فعال کردن تمام اقدامات مشخص شده کافی است:

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 آزمایش می کند که آیا یک قانون حداقل یک شرط انجام شده دارد یا خیر و اقدامات را اجرا می کند. قوانین در سراسر جلسات مرور وجود دارند. بنابراین، در طول زمان نصب برنامه افزودنی، ابتدا باید removeRules برای پاک کردن قوانین نصب شده قبلی استفاده کنید و سپس از addRules برای ثبت قوانین جدید استفاده کنید.

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

با مجوز activeTab ، برنامه افزودنی شما هیچ اخطار مجوزی را نمایش نمی دهد و زمانی که کاربر روی عملکرد برنامه افزودنی کلیک می کند، فقط در صفحات مربوطه اجرا می شود.

مطابقت URL صفحه

PageStateMatcher.pageurl زمانی مطابقت دارد که معیارهای URL برآورده شوند. متداول ترین معیارها الحاق میزبان، مسیر یا url و به دنبال آن Contains، Equals، Prefix یا Suffix است. جدول زیر شامل چند نمونه است:

همه معیارها به حروف کوچک و بزرگ حساس هستند. برای فهرست کامل معیارها، UrlFilter را ببینید.

تطبیق CSS

شرایط PageStateMatcher.css باید انتخابگرهای ترکیبی باشند، به این معنی که نمی‌توانید ترکیب‌کننده‌هایی مانند فضای خالی یا " > " را در انتخابگرهای خود قرار دهید. این به Chrome کمک می‌کند تا انتخاب‌کننده‌ها را کارآمدتر مطابقت دهد.

شرایط CSS فقط با عناصر نمایش داده شده مطابقت دارد: اگر عنصری که با انتخابگر شما مطابقت دارد display:none یا یکی از عناصر اصلی آن display:none باشد، باعث مطابقت شرط نمی شود. عناصری که با visibility:hidden ، خارج از صفحه قرار گرفته یا توسط عناصر دیگر پنهان شده اند، همچنان می توانند شرایط شما را مطابقت دهند.

تطبیق حالت نشانه گذاری شده است

شرایط PageStateMatcher.isBookmarked امکان تطبیق وضعیت نشانک شده URL فعلی در نمایه کاربر را فراهم می کند. برای استفاده از این شرط، مجوز «نشانک‌ها» باید در مانیفست پسوند اعلام شود.