chroom.klembord

Beschrijving

De chrome.clipboard API is bedoeld om gebruikers toegang te geven tot gegevens in het klembord. Dit is een tijdelijke oplossing voor ChromeOS-platformapps totdat er een open-webalternatief beschikbaar is. Deze oplossing wordt niet meer ondersteund zodra er een open-weboplossing beschikbaar is, wat mogelijk in het vierde kwartaal van 2017 zal zijn.

Machtigingen

clipboard

Beschikbaarheid

Dev-kanaal alleen ChromeOS

Typen

AdditionalDataItem

Eigenschappen

  • gegevens

    snaar

    Inhoud van het aanvullende gegevensitem. De platte tekststring als type "textPlain" is, of de markupstring als type "textHtml" is. De data mag niet groter zijn dan 2 MB.

  • Type van het aanvullende gegevensitem.

DataItemType

Enum

"tekstPlain"

"tekstHtml"

ImageType

Ondersteunde afbeeldingstypen.

Enum

"png"

"jpeg"

Methoden

setImageData()

BelofteChrome 57+
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
): Promise<void>

Zet afbeeldingsgegevens op het klembord.

Parameters

  • beeldgegevens

    ArrayBuffer

    Chroom 60+

    De gecodeerde beeldgegevens.

  • Het type afbeelding dat wordt doorgegeven.

  • extra artikelen

    AdditionalDataItem [] optioneel

    Chroom 60+

    Aanvullende gegevensitems voor het beschrijven van afbeeldingsgegevens. De callback wordt aangeroepen met chrome.runtime.lastError ingesteld op foutcode als er een fout optreedt. Vereist klembord- en clipboardWrite-rechten.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 91+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onClipboardDataChanged

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

Wordt geactiveerd wanneer klembordgegevens worden gewijzigd. Vereist klembord- en clipboardRead-rechten om een listener toe te voegen aan de gebeurtenis chrome.clipboard.onClipboardDataChanged. Nadat deze gebeurtenis is geactiveerd, zijn de klembordgegevens beschikbaar door document.execCommand('paste') aan te roepen.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    () => void