CKTIS / HTML
onselect — obravnavanje izbire besedila
Atribut onselect določa kodo JavaScript, ki se izvede ob dogodku select, običajno kadar je besedilo izbrano v kontrolniku input ali textarea. Ne zazna izbire možnosti v elementu select.
Različica: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onselect="JavaScript statements"
element.onselect = function (event) { /* handler */ }onselect je atribut za obravnavo dogodka select. Na voljo je na vseh elementih HTML, vendar samo dodajanje ne povzroči, da bi element začel ustvarjati take dogodke. Običajno se uporablja za odziv na izbiro besedila v podprtih kontrolnikih input in v textarea; izbiro je mogoče spremeniti tudi programsko.
Vrednost atributa je koda JavaScript, ne logična vrednost ali zgolj ime funkcije. V vgrajenem obravnavalniku event predstavlja dogodek, this pa se nanaša na element, ki ga obravnava. Meje izbire lahko preberete prek selectionStart in selectionEnd; drugi indeks ni vključen v izbrani podniz.
Ustrezna lastnost JavaScript, element.onselect, sprejme funkcijo; dodelitev druge funkcije zamenja prejšnji obravnavalnik na tem mestu. Druga možnost je addEventListener('select', handler). Ne zamenjujte dogodka select z elementom select: za odziv na spremembo izbrane možnosti uporabite input ali change.
Primer nastavi obseg od indeksa 1 do 5 v besedilu Hello. Po obravnavi dogodka je rezultat Selected: ello. JavaScript in vgrajeni obravnavalniki dogodkov morajo biti omogočeni; Content Security Policy lahko blokira vgrajene obravnavalnike.
Primeri
<!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>Rezultat
Selected: ello
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.