CKTIS / HTML
onpaste — handler voor de plakgebeurtenis
Het attribuut onpaste koppelt JavaScript-code aan de verwerking van de paste-gebeurtenis. Het is beschikbaar op alle HTML-elementen, maar door het toe te voegen wordt een element niet bewerkbaar.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onpaste="JavaScript function body"onpaste is een globaal HTML-attribuut voor gebeurtenisafhandeling dat hoort bij de gebeurtenis paste. De waarde bevat JavaScript-instructies die samen een functiebody vormen, geen naam van een gebeurtenistype. Het attribuut zelf maakt een element niet bewerkbaar.
In de attribuutcode is event het gebeurtenisobject en this het element dat de gebeurtenis afhandelt. return false annuleert de standaardactie van de gebeurtenis als die annuleerbaar is; bij normaal plakken in een bewerkbaar veld voorkomt dit dat tekst wordt ingevoegd. Het stopt de gebeurtenispropagatie niet.
Het HTML-attribuut onpaste en de JavaScript-eigenschap element.onpaste stellen hetzelfde afhandelingsmechanisme in: het attribuut bevat code, terwijl aan de eigenschap een functie of null wordt toegewezen. Een nieuwe toewijzing aan de eigenschap vervangt de vorige functie. addEventListener('paste', handler) registreert afzonderlijk luisteraars; daarbij wordt paste gebruikt, zonder het voorvoegsel on.
Het voorbeeld werkt een statusbericht bij en blokkeert het standaard plakken. JavaScript moet zijn ingeschakeld en inline gebeurtenisafhandelaars moeten zijn toegestaan; een Content Security Policy kan ze blokkeren. Stel deze code niet samen op basis van niet-vertrouwde gegevens.
Voorbeelden
<!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>Resultaat
paste handled
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.