CKTIS / HTML
onselect — Textauswahl behandeln
Das Attribut onselect definiert JavaScript-Code, der bei einem select-Ereignis ausgeführt wird, typischerweise wenn Text in einem input- oder textarea-Steuerelement ausgewählt wird. Es erkennt nicht die Auswahl einer Option in einem select-Element.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onselect="JavaScript statements"
element.onselect = function (event) { /* handler */ }onselect ist ein Ereignisbehandlungsattribut für das select-Ereignis. Es ist auf allen HTML-Elementen verfügbar, aber allein durch das Hinzufügen wird ein Element nicht dazu gebracht, solche Ereignisse auszulösen. Typischerweise reagiert man damit auf eine Textauswahl in unterstützenden input-Steuerelementen und in textarea; die Auswahl kann auch programmatisch geändert werden.
Der Attributwert ist JavaScript-Code, kein boolescher Wert und auch nicht einfach nur ein Funktionsname. In einem Inline-Handler bezeichnet event das Ereignis und this das Element, das es behandelt. Die Auswahlgrenzen lassen sich über selectionStart und selectionEnd auslesen; der zweite Index gehört nicht zum ausgewählten Teilstring.
Die entsprechende JavaScript-Eigenschaft element.onselect nimmt eine Funktion entgegen. Eine weitere Zuweisung ersetzt den zuvor an dieser Stelle festgelegten Handler. Eine Alternative ist addEventListener('select', handler). Verwechsle das select-Ereignis nicht mit dem select-Element: Verwende input oder change, um auf eine Änderung der ausgewählten Option zu reagieren.
Das Beispiel setzt den Bereich in Hello von Index 1 bis 5. Nach der Behandlung des Ereignisses lautet das Ergebnis Selected: ello. JavaScript und Inline-Ereignisbehandler müssen aktiviert sein; eine Content Security Policy kann Inline-Handler blockieren.
Beispiele
<!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>Ergebnis
Selected: ello
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.