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()

הבטחה 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

החזרות

  • הבטחה<Empty>

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

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

אירועים

onClipboardDataChanged

Chrome 56+ 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

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

פרמטרים

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

    פונקציה

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

    () => void