HTMLTextAreaElement: Methode setRangeText()

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 setRangeText()-Methode der HTMLTextAreaElement-Schnittstelle ersetzt einen Textbereich in einem <textarea>-Element mit einem neuen Text, der als Argument übergeben wird.

Zusätzliche optionale Parameter umfassen den Beginn des zu ändernden Textabschnitts, das Ende des Abschnitts und ein Schlüsselwort, das definiert, welcher Teil des <textarea>-Elements nach dem Aktualisieren des Textes ausgewählt sein sollte. Wenn die Argumente startSelection und endSelection nicht angegeben sind, wird der Bereich als Auswahl angenommen.

Das letzte Argument bestimmt, wie die Auswahl gesetzt wird, nachdem der Text ersetzt wurde. Mögliche Werte sind "select", das den neu eingefügten Text auswählt, "start", das die Auswahl direkt vor den eingefügten Text verschiebt, "end", das die Auswahl direkt nach den eingefügten Text verschiebt, oder der Standardwert "preserve", der versucht, die Auswahl beizubehalten.

Zusätzlich werden die select und selectionchange Events ausgelöst.

In diesem Artikel

Syntax

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

Parameter

replacement

Der einzufügende String.

selectionStart Optional

Der Index des ersten ausgewählten Zeichens. Ein Index, der größer als die Länge des Werts des Elements ist, wird als Verweis auf das Ende des Werts behandelt.

selectionEnd Optional

Der Index des Zeichens nach dem letzten ausgewählten Zeichen. Ein Index, der größer als die Länge des Werts des Elements ist, wird als Verweis auf das Ende des Werts behandelt. Wenn selectionEnd kleiner als selectionStart ist, werden beide als der Wert von selectionEnd behandelt.

selectMode Optional

Ein Schlüsselwort, entweder select, start, end oder der Standardwert preserve, das definiert, wie die Auswahl gesetzt wird, nachdem der Text ersetzt wurde.

html
<label for="ta">Example text input:</label>
<textarea id="ta">
  This text has NOT been updated.
</textarea>
<button id="btn">Update text</button>

JavaScript

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

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

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

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
HTMLTextAreaElement
Instanzeigenschaften
Instanzmethoden
Events
1. select
2. selectionchange
Vererbung
Verwandte Seiten für HTML DOM
Anleitungen
1. Verwenden von Microtasks in JavaScript mit queueMicrotask()
2. Im Detail: Microtasks und die JavaScript-Laufzeitumgebung

HTMLTextAreaElement: Methode setRangeText()

In diesem Artikel

Syntax

Parameter

Rückgabewert

Beispiele

HTML

JavaScript

Ergebnis

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN