إنشاء قائمة سياقات

ستظهر قائمة سياق للنقرة البديلة (التي يُطلق عليها غالبًا اسم النقر بزر الماوس الأيمن). توضّح هذه الصفحة كيفية تنفيذ قائمة سياق. للحصول على قائمة كاملة بأعضاء واجهات برمجة التطبيقات ذات الصلة، راجِع browser.contextMenu.

لإنشاء قائمة السياق، عليك أولاً إضافة "contextMenus" الإذن إلى ملف manifest.json.

manifest.json:

  "permissions": [
    "contextMenus"
  ],

يمكنك اختياريًا استخدام المفتاح "icons" إذا أردت عرض رمز بجانب أحد عناصر القائمة. في هذا المثال، يستخدم عنصر القائمة الخاص بالإضافة "بحث Google العالمي" رمزًا بحجم 16 × 16.

عنصر قائمة سياق يتضمّن رمزًا بحجم 16 × 16

تم أخذ بقية هذا المثال من نموذج قائمة السياق في "بحث Google" العالمي الذي يوفّر خيارات متعدّدة لقائمة السياق. عندما تحتوي إحدى الإضافات على أكثر من قائمة سياق واحدة، يقلّصها Chrome تلقائيًا في قائمة رئيسية واحدة كما هو موضّح هنا:

الشكل 4: قائمة سياقية وقائمة فرعية متداخلة.

يعرض المثال ذلك من خلال استدعاء contextMenus.create() في مشغّل خدمات الإضافة. يتم استيراد عناصر القائمة الفرعية من ملف locales.js. بعد ذلك، تتكرّر runtime.onInstalled على هذه القيم.

service-worker.js:

const tldLocales = {
  'com.au': 'Australia',
  'com.br': 'Brazil',
  ...
}

browser.runtime.onInstalled.addListener(async () => {
  for (let [tld, locale] of Object.entries(tldLocales)) {
    browser.contextMenus.create({
      id: tld,
      title: locale,
      type: 'normal',
      contexts: ['selection'],
    });
  }
});