תיאור
ממשק ה-API של chrome.clipboard
מאפשר למשתמשים לגשת לנתונים של לוח העריכה. זהו פתרון זמני לאפליקציות בפלטפורמת chromeos עד שרשת האינטרנט הפתוחה זמינה. הפתרון הזה יוצא משימוש ברגע שיהיה פתרון אינטרנט פתוח, שיכול להיות במהלך הרבעון הרביעי של 2017.
הרשאות
clipboard
זמינות
סוגים
AdditionalDataItem
תכונות
-
נתונים
מחרוזת
התוכן של פריט הנתונים הנוסף. מחרוזת הטקסט הרגיל אם הערך של
type
הוא "textPlain", או מחרוזת הסימון אם הערך שלtype
הוא "textHtml". נפח הנתונים לא יכול לחרוג מ-2MB. -
סוג
הסוג של פריט הנתונים הנוסף.
DataItemType
טיפוסים בני מנייה (enum)
"textPlain"
"textHtml"
ImageType
סוגי תמונות נתמכים.
טיפוסים בני מנייה (enum)
"png"
"jpeg"
שיטות
setImageData()
chrome.clipboard.setImageData(
imageData: ArrayBuffer,
type: ImageType,
additionalItems?: AdditionalDataItem[],
callback?: function,
)
מגדיר את נתוני התמונה ללוח.
פרמטרים
-
imageData
ArrayBuffer
Chrome מגרסה 60 ואילךנתוני התמונה המקודדים.
-
סוג
סוג התמונה שמועברת.
-
additionalItems
AdditionalDataItem[] אופציונלי
Chrome מגרסה 60 ואילךפריטי נתונים נוספים לתיאור נתוני תמונה. תתבצע קריאה חוזרת (callback) כאשר
chrome.runtime.lastError
מוגדר כקוד שגיאה אם יש שגיאה. נדרשות הרשאות ללוח העריכה וללוח העריכה. -
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:() => void
החזרות
-
Promise<void>
Chrome 91 ומעלההבטחות נתמכות רק במניפסט מגרסה V3 ואילך. בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callback).
אירועים
onClipboardDataChanged
chrome.clipboard.onClipboardDataChanged.addListener(
callback: function,
)
מופעל כשהנתונים שבלוח העריכה משתנים. נדרשות הרשאות ללוח העריכה וללוח העריכה כדי להוסיף האזנה לאירוע chrome.clipboard.onClipboardDataChanged. אחרי שהאירוע הזה יופעל, הנתונים שבלוח העריכה יהיו זמינים על ידי קריאה ל-document.execCommand('paste').
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:() => void