chrome.clipboard

Açıklama

Kullanıcıların pano verilerine erişebilmesi için chrome.clipboard API'si sağlanır. Bu, açık web alternatifi kullanıma sunulana kadar ChromeOS platform uygulamaları için geçici bir çözümdür. Bu özellik, açık web çözümü kullanıma sunulduğunda (2017'nin 4. çeyreğinde) kullanımdan kaldırılacaktır.

İzinler

clipboard

Kullanılabilirlik

Yeni geliştirilenler kanalı Yalnızca ChromeOS

Türler

AdditionalDataItem

Özellikler

  • aktarma

    dize

    Ek veri öğesinin içeriği. type "textPlain" ise düz metin dizesi, type "textHtml" ise işaretleme dizesi. Veriler 2 MB'ı aşamaz.

  • Ek veri öğesinin türü.

DataItemType

Enum

"textPlain"

"textHtml"

ImageType

Desteklenen resim türleri.

Enum

"png"

"jpeg"

Yöntemler

setImageData()

Promise Chrome 57 ve sonraki sürümler 
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

Resim verilerini panoya ayarlar.

Parametreler

  • imageData

    ArrayBuffer

    Chrome 60 veya daha yeni bir sürüm

    Kodlanmış resim verileri.

  • tür

    ImageType

    Aktarılan resmin türü.

  • additionalItems

    AdditionalDataItem[] isteğe bağlı

    Chrome 60 veya daha yeni bir sürüm

    Resim verilerini açıklamak için ek veri öğeleri. Geri çağırma, hata varsa chrome.runtime.lastError hata koduna ayarlanarak çağrılır. Pano ve pano yazma izinleri gerektirir.

  • callback

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 91 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onClipboardDataChanged

Chrome 56 veya daha yeni bir sürüm 
chrome.clipboard.onClipboardDataChanged.addListener(
  callback: function,
)

Pano verileri değiştiğinde tetiklenir. chrome.clipboard.onClipboardDataChanged etkinliğine dinleyici eklemek için pano ve clipboardRead izinleri gerekir. Bu etkinlik etkinleştirildikten sonra, document.execCommand('paste') çağrılarak pano verilerine erişilebilir.

Parametreler

  • callback

    işlev

    callback parametresi şu şekilde görünür: 

    () => void