تنفيذ إجراء

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

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

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

manifest.json:

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

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

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

service-factor.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-factor.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()`. وإذا لم يتم ضبط تلميح، سيظهر اسم الإضافة.