تنفيذ إجراء

الإجراء هو ما يحدث عندما ينقر المستخدم على رمز شريط الأدوات، الذي يُعرف عادةً باسم الـ رمز الإجراء للإضافة. يستدعي الإجراء ميزة إضافة باستخدام Action API أو يفتح نافذة منبثقة. توضّح هذه الصفحة كيفية استدعاء ميزة إضافة. لاستخدام نافذة منبثقة، يُرجى الاطّلاع على مقالة إضافة نافذة منبثقة.

تسجيل الإجراء

لاستخدام chrome.action API، أضِف المفتاح "action" إلى ملف بيان الإضافة. راجِع قسم البيان في مرجع chrome.action API للحصول على وصف كامل للخصائص الاختيارية لهذا الحقل.

manifest.json:

{
  "name": "My Awesome action Extension",
 ...
  "action": {
   ...
  }
 ...
}

الردّ على الإجراء

سجِّل معالج onClicked عندما ينقر المستخدم على رمز الإجراء. لا يتم تشغيل هذا الحدث إذا تم تسجيل نافذة منبثقة في ملف manifest.json.

service-worker.js:

chrome.action.onClicked.addListener((tab) => {
  chrome.action.setTitle({
    tabId: tab.id,
    title: `You are on tab: ${tab.id}`});
});

تفعيل الإجراء بشكل مشروط

تتيح لك chrome.declarativeContent API تفعيل رمز إجراء الإضافة استنادًا إلى عنوان URL للصفحة أو عندما تتطابق محدّدات CSS مع العناصر على الصفحة. عندما يكون رمز إجراء الإضافة غير مفعَّل، يظهر باللون الرمادي. إذا نقر المستخدم على الرمز غير المفعَّل، ستظهر قائمة السياق الخاصة بالإضافة.

شارة الإجراء

الشارات هي أجزاء من النص المنسّق يتم وضعها أعلى رمز الإجراء للإشارة إلى أمور مثل حالة الإضافة أو الإجراءات المطلوبة من المستخدم. لتوضيح ذلك، يعرض نموذج Drink Water شارة تتضمّن "مفعَّل" لإظهار أنّ المستخدم قد ضبط منبّهًا بنجاح، ولا يعرض أي شيء عندما تكون الإضافة غير نشطة. يمكن أن تحتوي الشارات على ما يصل إلى أربعة أحرف.

اضبط نص الشارة من خلال استدعاء chrome.action.setBadgeText() ولون الخلفية من خلال استدعاء chrome.action.setBadgeBackgroundColor().

service-worker.js:

chrome.action.setBadgeText({text: 'ON'});
chrome.action.setBadgeBackgroundColor({color: '#4688F1'});

تلميح

سجِّل التلميحات في الحقل "default_title" ضمن المفتاح "action" في ملف manifest.json.

manifest.json:

{
  "name": "Tab Flipper",
 ...
  "action": {
    "default_title": "Press Ctrl(Win)/Command(Mac)+Shift+Right/Left to flip tabs"
  }
...
}

يمكنك أيضًا ضبط التلميحات أو تعديلها من خلال استدعاء action.setTitle(). إذا لم يتم ضبط أي تلميح، سيظهر اسم الإضافة.