تنفيذ إجراء

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

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

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

manifest.json:

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

الاستجابة للإجراء

يمكنك تسجيل معالج onClicked عندما ينقر المستخدم على رمز الإجراء. لا يتم تشغيل هذا الحدث إذا تم تسجيل نافذة منبثقة في ملف البيان.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 مع العناصر في الصفحة. وعندما يتم إيقاف رمز إجراء الإضافة، يظهر الرمز باللون الرمادي. وإذا نقر المستخدم على الرمز غير المفعَّل، ستظهر قائمة سياق الإضافة.

شارة الإجراء

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

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

service-worker.js:

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

تلميح

يمكنك تسجيل تلميحات الأدوات في الحقل "default_title" ضمن المفتاح "action" في ملف ملف robots.json.

manifest.json:

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

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