یک اقدام را اجرا کنید

یک کنش زمانی اتفاق می افتد که کاربر روی نماد نوار ابزار کلیک می کند که معمولاً نماد عمل برای برنامه افزودنی شما نامیده می شود. یک عمل با استفاده از 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() نکات ابزار را تنظیم یا به‌روزرسانی کنید. اگر راهنمای ابزار تنظیم نشده باشد، نام برنامه افزودنی نمایش داده می شود.