Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onselect — zpracování výběru textu

Atribut onselect definuje JavaScriptový kód, který se spustí při události select, obvykle při výběru textu v ovládacím prvku input nebo textarea. Nezjišťuje výběr možnosti v prvku select.

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

Syntaxe

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

onselect je atribut obsluhy události select. Je dostupný na všech elementech HTML, ale jeho přidání samo o sobě nezpůsobí, že element začne takové události generovat. Obvykle se používá k reakci na výběr textu v podporujících ovládacích prvcích input a v textarea; výběr lze změnit také programově.

Hodnotou atributu je JavaScriptový kód, nikoli logická hodnota ani pouhý název funkce. V obsluze zapsané přímo v atributu označuje event událost a this odkazuje na element, který ji obsluhuje. Hranice výběru lze zjistit pomocí selectionStart a selectionEnd; druhý index do vybraného podřetězce nepatří.

Odpovídající JavaScriptová vlastnost element.onselect přijímá funkci; přiřazením jiné funkce se předchozí obsluha na tomto místě nahradí. Alternativou je addEventListener('select', handler). Nezaměňujte událost select s elementem select: na změnu vybrané možnosti reagujte pomocí input nebo change.

Příklad nastaví rozsah od indexu 1 do 5 v textu Hello. Po zpracování události je výsledkem Selected: ello. JavaScript a obsluhy událostí zapsané přímo v HTML musí být povoleny; Content Security Policy může inline obsluhy blokovat.

Příklady

<!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>

Výsledek

Selected: ello

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje