Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

onselect — gérer la sélection de texte

L’attribut onselect définit du code JavaScript exécuté lorsqu’un événement select se produit, généralement quand du texte est sélectionné dans un contrôle input ou textarea. Il ne détecte pas la sélection d’une option dans un élément select.

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

Syntaxe

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

onselect est un attribut de gestion d’événement pour l’événement select. Il est disponible sur tous les éléments HTML, mais sa simple présence ne fait pas générer de tels événements par un élément. Il sert généralement à réagir à la sélection de texte dans les contrôles input qui la prennent en charge et dans textarea ; la sélection peut aussi être modifiée par programmation.

La valeur de l’attribut est du code JavaScript, et non une valeur booléenne ni simplement un nom de fonction. Dans un gestionnaire intégré à l’attribut, event représente l’événement et this désigne l’élément qui le gère. Les limites de la sélection se lisent avec selectionStart et selectionEnd ; le second index n’est pas inclus dans la sous-chaîne sélectionnée.

La propriété JavaScript correspondante, element.onselect, accepte une fonction ; en affecter une autre remplace le gestionnaire précédent à cet emplacement. Une autre possibilité est addEventListener('select', handler). Ne confondez pas l’événement select avec l’élément select : utilisez input ou change pour réagir au changement de l’option sélectionnée.

L’exemple définit la plage allant de l’index 1 à 5 dans Hello. Une fois l’événement traité, le résultat est Selected: ello. JavaScript et les gestionnaires d’événements intégrés doivent être activés ; une Content Security Policy peut bloquer ces gestionnaires intégrés.

Exemples

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

Résultat

Selected: ello

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources