chroom.klembord

Beschrijving

De chrome.clipboard API is bedoeld om gebruikers toegang te geven tot gegevens op het klembord. Dit is een tijdelijke oplossing voor Chromeos-platform-apps totdat er een open-webalternatief beschikbaar is. Het wordt beëindigd zodra de open-weboplossing beschikbaar is, wat in het vierde kwartaal van 2017 zou kunnen zijn.

Machtigingen

clipboard

Beschikbaarheid

Alleen ontwikkelaarskanaal ChromeOS

Soorten

AdditionalDataItem

Eigenschappen

  • gegevens

    snaar

    Inhoud van het aanvullende gegevensitem. Ofwel de tekstreeks zonder opmaak als type "textPlain" is, of de opmaaktekenreeks als type "textHtml" is. De gegevens mogen niet groter zijn dan 2 MB.

  • Type van het aanvullende gegevensitem.

DataItemType

Enum

"tekstVlak"

"tekstHTML"

ImageType

Ondersteunde afbeeldingstypen.

Enum

"png"

"jpeg"

Methoden

setImageData()

BeloofChrome 57+
chrome.clipboard.setImageData(
  imageData: ArrayBuffer,
  type: ImageType,
  additionalItems?: AdditionalDataItem[],
  callback?: function,
)

Stelt afbeeldingsgegevens in op het klembord.

Parameters

  • afbeeldingGegevens

    ArrayBuffer

    Chroom 60+

    De gecodeerde beeldgegevens.

  • type

    Beeldtype

    Het type afbeelding dat wordt doorgegeven.

  • aanvullendeItems

    ExtraDataItem [] optioneel

    Chroom 60+

    Aanvullende gegevensitems voor het beschrijven van beeldgegevens. De callback wordt aangeroepen met chrome.runtime.lastError ingesteld op foutcode als er een fout is. Vereist machtigingen voor Klembord en KlembordSchrijven.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 91+

    Beloftes 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 veranderen. Vereist klembord- en clipboardRead-machtigingen voor het toevoegen van luisteraar aan chrome.clipboard.onClipboardDataChanged-gebeurtenis. Nadat deze gebeurtenis is geactiveerd, zijn de klembordgegevens beschikbaar door document.execCommand('paste') aan te roepen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    () => void