HTMLTextAreaElement : mthode setRangeText()

Baseline Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis janvier 2020.

En savoir plus
Voir la compatibilit complte

La mthode setRangeText() de l'interface HTMLTextAreaElement remplace une plage de texte dans un lment HTML <textarea> par un nouveau texte pass en argument.

Des paramtres optionnels supplmentaires incluent le dbut de la section de texte modifier, la fin de la section, et un mot-cl dfinissant quelle partie du <textarea> doit tre slectionne aprs la mise jour du texte. Si les arguments startSelection et endSelection ne sont pas fournis, la plage correspond la slection.

Le dernier argument dtermine comment la slection sera dfinie aprs le remplacement du texte. Les valeurs possibles sont "select", qui slectionne le texte nouvellement insr, "start", qui place la slection juste avant le texte insr, "end", qui place la slection juste aprs le texte insr, ou la valeur par dfaut "preserve", qui tente de prserver la slection.

De plus, les vnements select et selectionchange sont dclenchs.

Syntaxe

setRangeText(replacement)
setRangeText(replacement, startSelection)
setRangeText(replacement, startSelection, endSelection)
setRangeText(replacement, startSelection, endSelection, selectMode)

Paramtres

replacement: La chane de caractres insrer.
selectionStart Facultatif: L'indice du premier caractre slectionn. Un indice suprieur la longueur de la valeur de l'lment est considr comme pointant la fin de la valeur.
selectionEnd Facultatif: L'indice du caractre aprs le dernier caractre slectionn. Un indice suprieur la longueur de la valeur de l'lment est considr comme pointant la fin de la valeur. Si selectionEnd est infrieur selectionStart, alors les deux sont considrs comme ayant la valeur de selectionEnd.
selectMode Facultatif: Un mot-cl, soit select, start, end ou la valeur par dfaut preserve, dfinissant comment la slection doit tre dfinie aprs le remplacement du texte.

<label for="ta">Exemple de saisie de texte&nbsp;:</label>
<textarea id="ta">
  Ce texte n'a PAS t mis  jour.
</textarea>
<button id="btn">Mettre  jour le texte</button>

JavaScript

const btn = document.getElementById("btn");

btn.addEventListener("click", () => {
  changeText();
});

function changeText() {
  const textarea = document.getElementById("ta");
  textarea.focus();
  textarea.setRangeText("ALREADY", 14, 17, "select");
}

Rsultat

Spcifications

Spcification
HTML # dom-textarea/input-setrangetext-dev

Compatibilit des navigateurs

Voir aussi

L'lment HTML <textarea>
L'interface HTMLTextAreaElement
La mthode HTMLTextAreaElement.select()
La mthode HTMLTextAreaElement.setSelectionRange()
La proprit HTMLTextAreaElement.textLength
L'API Selection
Le pseudo-lment CSS ::selection

Aider amliorer MDN

Cette page vous a-t-elle t utile ?

Oui Non

Apprendre contribuer

Cette page a t modifie le 20 janv. 2026 par les contributeurices du MDN.

Voir cette page sur GitHub Signaler un problme avec ce contenu