KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onselect — tekstselectie afhandelen

Het attribuut onselect definieert JavaScript-code die wordt uitgevoerd wanneer een select-gebeurtenis plaatsvindt, meestal wanneer tekst in een input- of textarea-besturingselement wordt geselecteerd. Het detecteert geen selectie van opties in een select-element.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

onselect="JavaScript statements"
element.onselect = function (event) { /* handler */ }

onselect is een gebeurtenisafhandelingsattribuut voor de select-gebeurtenis. Het is beschikbaar op alle HTML-elementen, maar door het toe te voegen gaat een element niet vanzelf zulke gebeurtenissen genereren. Het wordt meestal gebruikt om te reageren op tekstselectie in daarvoor geschikte input-besturingselementen en in textarea; de selectie kan ook programmatisch worden gewijzigd.

De attribuutwaarde is JavaScript-code, geen Booleaanse waarde en ook niet alleen een functienaam. In een inline-handler staat event voor de gebeurtenis en verwijst this naar het element dat de gebeurtenis afhandelt. De grenzen van de selectie lees je uit via selectionStart en selectionEnd; de tweede index hoort niet bij de geselecteerde substring.

De overeenkomstige JavaScript-eigenschap element.onselect accepteert een functie; een nieuwe toewijzing vervangt de vorige handler op die plek. Een alternatief is addEventListener('select', handler). Verwar de select-gebeurtenis niet met het select-element: gebruik input of change om op een wijziging van de geselecteerde optie te reageren.

Het voorbeeld stelt het bereik in Hello in van index 1 tot 5. Nadat de gebeurtenis is afgehandeld, is het resultaat Selected: ello. JavaScript en inline gebeurtenishandlers moeten zijn ingeschakeld; een Content Security Policy kan inline handlers blokkeren.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>onselect demo</title>
<label>Text: <input id="text" type="text" value="Hello" onselect="document.getElementById('result').textContent = this.value.slice(this.selectionStart, this.selectionEnd)"></label>
<p>Selected: <output id="result"></output></p>
<script>
  document.getElementById('text').setSelectionRange(1, 5);
</script>

Resultaat

Selected: ello

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.

Bronnen