chrome.clipboard

คำอธิบาย

เรามี chrome.clipboard API เพื่อให้ผู้ใช้เข้าถึงข้อมูลในคลิปบอร์ดได้ นี่เป็นโซลูชันชั่วคราวสำหรับแอปแพลตฟอร์ม ChromeOS จนกว่าจะมีทางเลือกอื่นในเว็บแบบเปิด ระบบจะเลิกใช้เมื่อโซลูชันเว็บแบบเปิดพร้อมใช้งาน ซึ่งอาจเป็นช่วงไตรมาสที่ 4 ของปี 2017

สิทธิ์

clipboard

ความพร้อมใช้งาน

เวอร์ชันที่กำลังพัฒนา ChromeOS เท่านั้น

ประเภท

AdditionalDataItem

พร็อพเพอร์ตี้

  • เพิ่มเติม

    สตริง

    เนื้อหาของรายการข้อมูลเพิ่มเติม สตริงข้อความธรรมดาหาก type เป็น "textPlain" หรือสตริงมาร์กอัปหาก type เป็น "textHtml" ข้อมูลต้องมีขนาดไม่เกิน 2 MB

  • ประเภท

    DataItemType

    ประเภทของรายการข้อมูลเพิ่มเติม

DataItemType

ค่าแจกแจง

"textPlain"

"textHtml"

ImageType

ประเภทรูปภาพที่รองรับ

ค่าแจกแจง

"png"

"jpeg"

เมธอด

setImageData()

Promise Chrome 57 ขึ้นไป 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

ตั้งค่าข้อมูลรูปภาพไปยังคลิปบอร์ด

พารามิเตอร์

  • imageData

    ArrayBuffer

    Chrome 60 ขึ้นไป

    ข้อมูลรูปภาพที่เข้ารหัส

  • ประเภท

    ImageType

    ประเภทของรูปภาพที่ส่ง

  • additionalItems

    AdditionalDataItem[] ไม่บังคับ

    Chrome 60 ขึ้นไป

    รายการข้อมูลเพิ่มเติมสำหรับอธิบายข้อมูลรูปภาพ ระบบจะเรียกใช้การเรียกกลับโดยตั้งค่า chrome.runtime.lastError เป็นรหัสข้อผิดพลาดหากมีข้อผิดพลาด ต้องมีสิทธิ์เข้าถึงคลิปบอร์ดและสิทธิ์ clipboardWrite

  • callback

    ฟังก์ชัน ไม่บังคับ

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    () => void

การคืนสินค้า

  • Promise<void>

    Chrome 91 ขึ้นไป

    ระบบรองรับ Promise สำหรับไฟล์ Manifest V3 ขึ้นไปเท่านั้น แพลตฟอร์มอื่นๆ ต้องใช้การเรียกกลับ

กิจกรรม

onClipboardDataChanged

Chrome 56 ขึ้นไป 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

เริ่มทำงานเมื่อข้อมูลในคลิปบอร์ดเปลี่ยนแปลง ต้องมีสิทธิ์ clipboard และ clipboardRead สำหรับการเพิ่ม Listener ลงในเหตุการณ์ chrome.clipboard.onClipboardDataChanged หลังจากเหตุการณ์นี้เริ่มทำงาน ข้อมูลในคลิปบอร์ดจะพร้อมใช้งานโดยการเรียกใช้ document.execCommand('paste')

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    () => void