CKTIS / HTML
onselect — tratar a seleção de texto
O atributo onselect define código JavaScript executado quando ocorre um evento select, normalmente quando é selecionado texto num controlo input ou textarea. Não deteta a seleção de opções num elemento select.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onselect="JavaScript statements"
element.onselect = function (event) { /* handler */ }onselect é um atributo de tratamento do evento select. Está disponível em todos os elementos HTML, mas a sua simples adição não faz com que um elemento gere esses eventos. É normalmente utilizado para reagir à seleção de texto em controlos input que a suportem e em textarea; a seleção também pode ser alterada por programação.
O valor do atributo é código JavaScript, não um valor booleano nem apenas o nome de uma função. Num controlador inline, event representa o evento e this refere-se ao elemento que o trata. Os limites da seleção podem ser consultados através de selectionStart e selectionEnd; o segundo índice não está incluído na substring selecionada.
A propriedade JavaScript correspondente, element.onselect, aceita uma função; atribuir outra substitui o controlador anterior nesse local. Uma alternativa é addEventListener('select', handler). Não confunda o evento select com o elemento select: utilize input ou change para reagir a uma alteração da opção selecionada.
O exemplo define o intervalo do índice 1 ao 5 em Hello. Depois de o evento ser tratado, o resultado é Selected: ello. O JavaScript e os controladores de eventos inline têm de estar ativados; uma Content Security Policy pode bloquear os controladores inline.
Exemplos
<!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>Resultado
Selected: ello
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.