chrome.clipboard

תיאור

ממשק ה-API של chrome.clipboard מאפשר למשתמשים לגשת לנתונים של לוח העריכה. זהו פתרון זמני לאפליקציות בפלטפורמת chromeos עד שרשת האינטרנט הפתוחה זמינה. הפתרון הזה יוצא משימוש ברגע שיהיה פתרון אינטרנט פתוח, שיכול להיות במהלך הרבעון הרביעי של 2017.

הרשאות

clipboard

זמינות

ערוץ פיתוח ChromeOS בלבד

סוגים

AdditionalDataItem

תכונות

  • נתונים

    מחרוזת

    התוכן של פריט הנתונים הנוסף. מחרוזת הטקסט הרגיל אם הערך של type הוא "textPlain", או מחרוזת הסימון אם הערך של type הוא "textHtml". נפח הנתונים לא יכול לחרוג מ-2MB.

  • סוג

    DataItemType

    הסוג של פריט הנתונים הנוסף.

DataItemType

טיפוסים בני מנייה (enum)

"textPlain"

"textHtml"

ImageType

סוגי תמונות נתמכים.

טיפוסים בני מנייה (enum)

"png"

"jpeg"

שיטות

setImageData()

Promise Chrome 57 ואילך 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

מגדיר את נתוני התמונה ללוח.

פרמטרים

  • imageData

    ArrayBuffer

    Chrome מגרסה 60 ואילך

    נתוני התמונה המקודדים.

  • סוג

    ImageType

    סוג התמונה שמועברת.

  • additionalItems

    AdditionalDataItem[] אופציונלי

    Chrome מגרסה 60 ואילך

    פריטי נתונים נוספים לתיאור נתוני תמונה. תתבצע קריאה חוזרת (callback) כאשר chrome.runtime.lastError מוגדר כקוד שגיאה אם יש שגיאה. נדרשות הרשאות ללוח העריכה וללוח העריכה.

  • קריאה חוזרת (callback)

    פונקציה אופציונלי

    הפרמטר callback נראה כך: 

    ()=>void

החזרות

  • Promise<void>

    Chrome 91 ומעלה

    הבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).

אירועים

onClipboardDataChanged

Chrome בגרסה 56 ומעלה 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

מופעל כשהנתונים שבלוח העריכה משתנים. נדרשות הרשאות ללוח העריכה וללוח העריכה כדי להוסיף האזנה לאירוע chrome.clipboard.onClipboardDataChanged. אחרי שהאירוע הזה יופעל, הנתונים שבלוח העריכה יהיו זמינים על ידי קריאה ל-document.execCommand('paste').

פרמטרים

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך: 

    ()=>void