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 فعلی در نمایه کاربر را فراهم می کند. برای استفاده از این شرط، مجوز «نشانک‌ها» باید در مانیفست پسوند اعلام شود.