CKTIS / HTML
onchange — een change-gebeurtenis afhandelen
Het onchange-attribuut bevat JavaScript dat wordt uitgevoerd bij een change-gebeurtenis. Bij formulierbesturingselementen staat deze gebeurtenis voor een door de gebruiker bevestigde wijziging, niet noodzakelijk voor elke bewerking van de waarde.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onchange="JavaScript statements"onchange is een contentattribuut voor een event-handler van change. De waarde is de inhoud van een JavaScript-functie, geen script-URL. Het attribuut is beschikbaar op alle HTML-elementen, maar door het toe te voegen gaat een element niet vanzelf change genereren.
Wanneer de gebeurtenis optreedt, hangt af van het besturingselement. Een selectievakje genereert change wanneer de gebruiker het omschakelt; een tekstveld doet dit meestal wanneer de gewijzigde waarde wordt bevestigd door het veld te verlaten. Gebruik input om op doorlopende bewerkingen te reageren. Een toewijzing aan .value of .checked in JavaScript genereert niet automatisch change.
In de attribuutcode verwijst this naar het element dat de gebeurtenis afhandelt, en event geeft het gebeurtenisobject. Het JavaScript-equivalent is de eigenschap element.onchange; een volgende toewijzing vervangt de eerdere functie van dit mechanisme. Met element.addEventListener('change', handler) registreer je onafhankelijke listeners. Een Content Security Policy kan attribuutcode blokkeren. Gebruik in die omgeving daarom een toegestaan script met addEventListener().
Voorbeelden
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onchange example</title>
<label>
<input type="checkbox" onchange="document.getElementById('state').textContent = this.checked ? 'ON' : 'OFF'">
Enabled
</label>
<p id="state" role="status">OFF</p>
</html>Resultaat
OFF → ON → OFF
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.