HTMLInputElement : méthode 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.

La méthode setRangeText() de l'interface HTMLInputElement remplace une plage de texte dans un élément <input> ou <textarea> par une nouvelle chaîne de caractères.

Dans cet article

Syntaxe

js
setRangeText(replacement)
setRangeText(replacement, start)
setRangeText(replacement, start, end)
setRangeText(replacement, start, end, selectMode)

Paramètres

replacement

La chaîne de caractères à insérer.

start Facultatif

L'indice (à partir de 0) du premier caractère à remplacer. Par défaut, la valeur actuelle de selectionStart (le début de la sélection de l'utilisateur·ice).

end Facultatif

L'indice (à partir de 0) du caractère après le dernier caractère à remplacer. Par défaut, la valeur actuelle de selectionEnd (la fin de la sélection de l'utilisateur·ice).

selectMode Facultatif

Une chaîne de caractères définissant la façon dont la sélection doit être réglée après le remplacement du texte. Valeurs possibles :

"select" sélectionne le texte nouvellement inséré.
"start" déplace la sélection juste avant le texte inséré.
"end" déplace la sélection juste après le texte inséré.
"preserve" tente de préserver la sélection. C'est la valeur par défaut.

html
<input
  type="text"
  id="text-box"
  size="30"
  value="Ce texte n'a PAS été mis à jour." />
<button>Mettre à jour le texte</button>

JavaScript

js
function selectText() {
  const input = document.getElementById("text-box");
  input.focus();
  input.setRangeText("DÉJÀ", 14, 17, "select");
}

document.querySelector("button").addEventListener("click", selectText);

L'élément HTML <input>
L'élément HTML <textarea>
L'interface HTMLInputElement
L'interface Selection

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 9 déc. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

API HTML DOM
HTMLInputElement
Propriétés d'instance
Méthodes d'instance
Évènements
Héritage
Pages liées à HTML DOM
Guides
1. Utiliser les microtâches en JavaScript avec queueMicrotask()
2. Aller plus loin : Les microtâches et l'environnement d'exécution JavaScript

HTMLInputElement : méthode setRangeText()

Dans cet article

Syntaxe

Paramètres

Valeur de retour

Exemples

HTML

JavaScript

Résultat

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN