HTMLTextAreaElement: Methode setRangeText()

Baseline Weitgehend verfgbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit Januar 2020 browserbergreifend verfgbar.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Die setRangeText()-Methode der HTMLTextAreaElement-Schnittstelle ersetzt einen Textbereich in einem <textarea>-Element mit einem neuen Text, der als Argument bergeben wird.

Zustzliche optionale Parameter umfassen den Beginn des zu ndernden Textabschnitts, das Ende des Abschnitts und ein Schlsselwort, das definiert, welcher Teil des <textarea>-Elements nach dem Aktualisieren des Textes ausgewhlt 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. Mgliche Werte sind "select", das den neu eingefgten Text auswhlt, "start", das die Auswahl direkt vor den eingefgten Text verschiebt, "end", das die Auswahl direkt nach den eingefgten Text verschiebt, oder der Standardwert "preserve", der versucht, die Auswahl beizubehalten.

Zustzlich werden die select und selectionchange Events ausgelst.

Syntax

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

Parameter

replacement: Der einzufgende String.
selectionStart Optional: Der Index des ersten ausgewhlten Zeichens. Ein Index, der grer als die Lnge des Werts des Elements ist, wird als Verweis auf das Ende des Werts behandelt.
selectionEnd Optional: Der Index des Zeichens nach dem letzten ausgewhlten Zeichen. Ein Index, der grer als die Lnge 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 Schlsselwort, entweder select, start, end oder der Standardwert preserve, das definiert, wie die Auswahl gesetzt wird, nachdem der Text ersetzt wurde.

<label for="ta">Example text input:</label>
<textarea id="ta">
  This text has NOT been updated.
</textarea>
<button id="btn">Update text</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");
}

Ergebnis

Spezifikationen

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

Browser-Kompatibilitt

Siehe auch

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden