HTMLInputElement: setRangeText() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.

Die HTMLInputElement.setRangeText() Methode ersetzt einen Textbereich in einem <input> oder <textarea> Element mit einem neuen String.

In diesem Artikel

Syntax

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

Parameter

replacement

Der einzufügende String.

start Optional

Der 0-basierte Index des ersten Zeichens, das ersetzt werden soll. Standardmäßig der aktuelle Wert von selectionStart (der Beginn der aktuellen Benutzerauswahl).

end Optional

Der 0-basierte Index des Zeichens nach dem letzten zu ersetzenden Zeichen. Standardmäßig der aktuelle Wert von selectionEnd (das Ende der aktuellen Benutzerauswahl).

selectMode Optional

Ein String, der definiert, wie die Auswahl nach dem Ersetzen des Textes gesetzt werden soll. Mögliche Werte:

"select" wählt den neu eingefügten Text aus.
"start" verschiebt die Auswahl direkt vor den eingefügten Text.
"end" verschiebt die Auswahl direkt hinter den eingefügten Text.
"preserve" versucht, die Auswahl beizubehalten. Dies ist der Standardwert.

html
<input
  type="text"
  id="text-box"
  size="30"
  value="This text has NOT been updated." />
<button>Update text</button>

JavaScript

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

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

HTML DOM API
HTMLInputElement
Instanzeigenschaften
Instanzmethoden
Events
Vererbung
Verwandte Seiten für HTML DOM
Anleitungen
1. Verwenden von Microtasks in JavaScript mit queueMicrotask()
2. Im Detail: Microtasks und die JavaScript-Laufzeitumgebung

HTMLInputElement: setRangeText() Methode

In diesem Artikel

Syntax

Parameter

Rückgabewert

Beispiele

HTML

JavaScript

Ergebnis

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN