CKTIS / HTML
onpaste — Handler für das Einfügeereignis
Das Attribut onpaste weist JavaScript-Code zur Verarbeitung des paste-Ereignisses zu. Es ist für alle HTML-Elemente verfügbar, macht ein Element durch das Hinzufügen des Attributs aber nicht bearbeitbar.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onpaste="JavaScript function body"onpaste ist ein globales HTML-Ereignisbehandlungsattribut, das dem Ereignis paste zugeordnet ist. Sein Wert enthält JavaScript-Anweisungen, die den Funktionskörper bilden, und keinen Ereignistypnamen. Das Attribut selbst macht ein Element nicht bearbeitbar.
Im Attributcode ist event das Ereignisobjekt und this das Element, das das Ereignis verarbeitet. return false bricht die Standardaktion des Ereignisses ab, sofern es abgebrochen werden kann; bei einem gewöhnlichen Einfügen in ein bearbeitbares Feld verhindert dies das Einfügen von Text. Die Ereignisausbreitung wird dadurch nicht gestoppt.
Das HTML-Attribut onpaste und die JavaScript-Eigenschaft element.onpaste richten denselben Handlermechanismus ein: Das Attribut enthält Code, der Eigenschaft wird dagegen eine Funktion oder null zugewiesen. Eine erneute Zuweisung der Eigenschaft ersetzt die vorherige Funktion. addEventListener('paste', handler) registriert Listener separat; dabei wird paste ohne das Präfix on verwendet.
Das Beispiel aktualisiert eine Statusmeldung und verhindert das standardmäßige Einfügen. Es setzt aktiviertes JavaScript und die Erlaubnis für Inline-Ereignisbehandler voraus; eine Content Security Policy kann diese blockieren. Erzeuge diesen Code nicht aus nicht vertrauenswürdigen Daten.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onpaste demo</title>
<label>Paste here: <textarea onpaste="document.getElementById('status').textContent = 'paste handled'; return false;"></textarea></label>
<p id="status" role="status">waiting</p>
</html>Ergebnis
paste handled
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.