Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

onselect — gestionar la selección de texto

El atributo onselect define código JavaScript que se ejecuta cuando se produce un evento select, normalmente al seleccionar texto en un control input o textarea. No detecta la selección de opciones en un elemento select.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

onselect es un atributo de controlador de eventos para el evento select. Está disponible en todos los elementos HTML, pero añadirlo no hace que un elemento genere esos eventos. Su uso habitual es responder a la selección de texto en controles input compatibles y en textarea; la selección también puede cambiarse mediante programación.

El valor del atributo es código JavaScript, no un valor booleano ni simplemente el nombre de una función. En un controlador en línea, event representa el evento y this hace referencia al elemento que lo gestiona. Los límites de la selección se leen mediante selectionStart y selectionEnd; el segundo índice no se incluye en la subcadena seleccionada.

La propiedad JavaScript correspondiente, element.onselect, acepta una función; asignar otra reemplaza el controlador anterior en ese lugar. Una alternativa es addEventListener('select', handler). No confundas el evento select con el elemento select: usa input o change para responder a un cambio de la opción seleccionada.

El ejemplo establece el rango desde el índice 1 hasta el 5 en Hello. Una vez gestionado el evento, el resultado es Selected: ello. JavaScript y los controladores de eventos en línea deben estar habilitados; una Content Security Policy puede bloquearlos.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes