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

یک اکشن اتفاقی است که وقتی کاربر روی آیکون نوار ابزار کلیک می‌کند، می‌افتد. این آیکون معمولاً آیکون اکشن افزونه شما نامیده می‌شود. یک اکشن با استفاده از Action API یک ویژگی افزونه را فراخوانی می‌کند یا یک پنجره بازشو (popup) را باز می‌کند. این صفحه نحوه فراخوانی یک ویژگی افزونه را نشان می‌دهد. برای استفاده از یک پنجره بازشو، به افزودن یک پنجره بازشو مراجعه کنید.

ثبت اقدام

برای استفاده از API chrome.action ، کلید "action" را به فایل مانیفست افزونه اضافه کنید. برای توضیحات کامل در مورد ویژگی‌های اختیاری این فیلد، به بخش مانیفست مرجع API مربوط به chrome.action مراجعه کنید.

مانیفست.json:

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

به عمل پاسخ دهید

یک هندلر onClicked برای زمانی که کاربر روی آیکون اکشن کلیک می‌کند، ثبت کنید. اگر یک پنجره‌ی پاپ‌آپ در فایل manifest.json ثبت شده باشد، این رویداد فعال نمی‌شود.

سرویس-ورکر.js:

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

فعال کردن عمل به صورت مشروط

API chrome.declarativeContent به شما امکان می‌دهد تا آیکون اکشن افزونه را بر اساس URL صفحه یا زمانی که انتخابگرهای CSS با عناصر موجود در صفحه مطابقت دارند، فعال کنید. وقتی آیکون اکشن یک افزونه غیرفعال است، آیکون به رنگ خاکستری در می‌آید. اگر کاربر روی آیکون غیرفعال کلیک کند، منوی زمینه افزونه ظاهر می‌شود.

یک آیکون اقدام غیرفعال.

نشان اکشن

نشان‌ها (badges) تکه‌هایی از متن قالب‌بندی‌شده هستند که در بالای آیکون عملیات قرار می‌گیرند تا مواردی مانند وضعیت افزونه یا اینکه کاربر به چه عملیاتی نیاز دارد را نشان دهند. برای نشان دادن این موضوع، نمونه Drink Water یک نشان با «روشن» را نمایش می‌دهد تا به کاربر نشان دهد که با موفقیت زنگ هشدار را تنظیم کرده است و وقتی افزونه غیرفعال است، چیزی نمایش نمی‌دهد. نشان‌ها می‌توانند تا چهار کاراکتر داشته باشند.

یک آیکون افزونه با نشان (چپ) و بدون نشان (راست).

متن نشان را با فراخوانی chrome.action.setBadgeText() و رنگ پس‌زمینه را با فراخوانی chrome.action.setBadgeBackgroundColor() تنظیم کنید.

سرویس-ورکر.js:

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

راهنمای ابزار

نکات راهنما را در فیلد "default_title" زیر کلید "action" در فایل manifest.json ثبت کنید.

مانیفست.json:

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

همچنین می‌توانید با فراخوانی action.setTitle() ‎، راهنماهای ابزار (tooltips) را تنظیم یا به‌روزرسانی کنید. اگر هیچ راهنمای ابزاری تنظیم نشده باشد، نام افزونه نمایش داده می‌شود.