ใช้การดำเนินการ

การดําเนินการคือสิ่งที่เกิดขึ้นเมื่อผู้ใช้คลิกไอคอนแถบเครื่องมือ ซึ่งมักเรียกว่าไอคอนการดําเนินการสําหรับส่วนขยาย การดำเนินการจะเรียกใช้ฟีเจอร์ส่วนขยายโดยใช้ Action API หรือเปิดป๊อปอัป หน้านี้จะแสดงวิธีเรียกใช้ฟีเจอร์ส่วนขยาย หากต้องการใช้ป๊อปอัป โปรดดูหัวข้อเพิ่มป๊อปอัป

ลงทะเบียนการดําเนินการ

หากต้องการใช้ chrome.action API ให้เพิ่มคีย์ "action" ลงในไฟล์ Manifest ของส่วนขยาย ดูรายละเอียดทั้งหมดของพร็อพเพอร์ตี้ที่ไม่บังคับของช่องนี้ในส่วนส่วนไฟล์ Manifest ของเอกสารอ้างอิง 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 แสดงป้าย "เปิด" เพื่อแจ้งให้ผู้ใช้ทราบว่าตั้งปลุกเรียบร้อยแล้ว และจะไม่แสดงอะไรเลยเมื่อส่วนขยายไม่ได้ทำงาน โดยป้ายจะมีอักขระได้สูงสุด 4 ตัว

ไอคอนชิ้นงานที่ไม่มีป้ายและที่มีป้าย
ไอคอนส่วนขยายที่มีป้าย (ซ้าย) และไม่มีป้าย (ขวา)

ตั้งค่าข้อความของป้ายโดยเรียกใช้ 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()` หากไม่ได้ตั้งค่าเคล็ดลับเครื่องมือไว้ ชื่อของส่วนขยายจะแสดงขึ้น