Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Clipboard: clipboardchange-Ereignis

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Das clipboardchange-Ereignis des Clipboard-Interfaces wird ausgelöst, wenn sich der Inhalt der Systemzwischenablage in irgendeiner Weise ändert, zum Beispiel durch einen Systemkopierbefehl oder durch eine API-Methode wie Clipboard.writeText().

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandlereigenschaft.

js
addEventListener("clipboardchange", (event) => { })

onclipboardchange = (event) => { }

Ereignistyp

Ein ClipboardChangeEvent. Erbt von Event.

Event ClipboardChangeEvent

Beispiele

Auf Systemkopierbefehle hören

Dieses Beispiel zeigt, wie Sie auf Systemkopierbefehle hören und den Inhalt anzeigen, der in die Zwischenablage kopiert wurde.

HTML

Das HTML besteht aus drei <p>-Elementen – eines, um den Inhalt der Zwischenablage anzuzeigen, und zwei, die Beispieltext zum Kopieren enthalten.

html
<p id="output">Copied text:</p>

<p>
  Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed a mattis purus.
  Donec at ipsum libero. Maecenas at dictum turpis. Vivamus eget aliquet augue.
  Aenean tempor dictum posuere. Vestibulum vehicula, nulla ac convallis feugiat,
  tortor velit lobortis est, vitae convallis velit libero vel urna. Suspendisse
  potenti. In bibendum ex et pellentesque gravida. Phasellus magna risus,
  euismod vitae sem in, viverra venenatis lacus. Sed dignissim risus eu congue
  consequat. Vestibulum nec feugiat libero. Maecenas quis sodales lorem, eu
  luctus nisl. Cras vel diam sed lacus finibus elementum sed sed nunc.
</p>

<p>
  Nam ac metus eget est bibendum pulvinar. Nunc a venenatis lorem. Lorem ipsum
  dolor sit amet, consectetur adipiscing elit. In dignissim, arcu ornare luctus
  pharetra, dui velit faucibus leo, ac posuere ipsum risus vel ligula. Morbi
  varius, felis et ornare efficitur, tortor erat imperdiet lacus, non rhoncus
  lectus sapien sit amet augue. Suspendisse potenti. Sed fringilla mi augue, at
  laoreet felis varius in. Donec venenatis gravida lacus ut rutrum. Donec
  suscipit egestas justo. Proin semper nibh tortor, sit amet elementum metus
  placerat quis. Sed consectetur leo sed lorem varius, sit amet ultrices sem
  tincidunt. Vivamus facilisis at velit eget commodo.
</p>

JavaScript

In unserem Skript holen wir zuerst eine Referenz auf das Ausgabe-<p>-Element. Dann definieren wir einen clipboardchange-Ereignishandler auf dem Clipboard-Objekt des Browsers. Wenn das Ereignis ausgelöst wird, rufen wir die Methode Clipboard.readText() auf, um den Text zu lesen, der gerade in die Zwischenablage kopiert wurde. Wenn das Ergebnis zurückgegeben wird, setzen wir es als Wert des textContent des Ausgabebereichs.

js
const outputPara = document.querySelector("#output");

navigator.clipboard.addEventListener("clipboardchange", (event) => {
  navigator.clipboard
    .readText()
    .then((text) => (outputPara.textContent = `Copied text: ${text}`));
});

Ergebnis

Das gerenderte Beispiel sieht wie folgt aus:

Versuchen Sie, etwas Text aus dem Beispiel auszuwählen und ihn dann mit Ctrl + C (oder Cmd + C, wenn Sie einen Mac verwenden) in die Zwischenablage zu kopieren. Beim ersten Versuch wird ein Berechtigungsdialogfeld angezeigt, in dem Sie um Erlaubnis gefragt werden, den Inhalt der Zwischenablage lesen zu dürfen. Danach (oder sofort bei nachfolgenden Versuchen) sollten Sie den Text sehen, den Sie in den Ausgabebereich oben in der Benutzeroberfläche kopiert haben.

Spezifikationen

Specification
Clipboard API and events
# eventdef-globaleventhandlers-clipboardchange

Browser-Kompatibilität

Siehe auch