HTMLTextAreaElement: Methode setSelectionRange()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die setSelectionRange() Methode des HTMLTextAreaElement Interfaces legt die Start- und Endpositionen der aktuellen Textauswahl fest und optional die Richtung in einem <textarea> Element. Die Richtung gibt an, in welcher Auswahl sie als erfolgt angesehen werden soll; beispielsweise, dass die Auswahl durch Klicken und Ziehen des Benutzers vom Ende des markierten Textes zum Anfang festgelegt wurde. Zusätzlich werden die Ereignisse select und selectchange ausgelöst.

Diese Methode aktualisiert auch die Eigenschaften HTMLTextAreaElement.selectionStart, HTMLTextAreaElement.selectionEnd und HTMLTextAreaElement.selectionDirection.

Hinweis: Das <textarea> muss fokussiert sein, um die Auswahl eines Textunterabschnitts mit der Methode setSelectionRange() zu ermöglichen. Das Setzen des Fokus löst auch ein selectchange Ereignis aus.

Um den gesamten Text eines <textarea> Elements auszuwählen, verwenden Sie die Methode HTMLTextAreaElement.select().

Syntax

js
setSelectionRange(selectionStart, selectionEnd)
setSelectionRange(selectionStart, selectionEnd, selectionDirection)

Parameter

selectionStart

Der Index des ersten ausgewählten Zeichens. Ein Index, der größer ist als die Länge des Wertes des Elements, wird als zeigend auf das Ende des Wertes behandelt. Siehe die Eigenschaft selectionStart für weitere Informationen.

selectionEnd

Der Index des Zeichens nach dem letzten ausgewählten Zeichen. Ein Index, der größer ist als die Länge des Wertes des Elements, wird als zeigend auf das Ende des Wertes behandelt. Wenn selectionEnd kleiner ist als selectionStart, werden beide als Wert von selectionEnd behandelt. Siehe die Eigenschaft selectionEnd für weitere Informationen.

selectionDirection Optional

Das Schlüsselwort "forward", "backward" oder der Standardwert "none" — zeigt die Richtung an, in der die Auswahl erfolgt ist. Siehe die Eigenschaft selectionDirection für weitere Informationen.

Rückgabewert

Kein (undefined).

Beispiele

js
const textarea = document.getElementById("text-box");
const chars = textarea.textLength;
// if the value is more than 10 characters long
if (chars > 10) {
  // Element must be focused to select a range of text within it
  textarea.focus();
  // select the text between the fifth character from the start and
  // the fifth character from the end
  textarea.setSelectionRange(5, chars - 5);
} else {
  // otherwise select all the text
  textarea.select();
}

Spezifikationen

Specification
HTML Standard
# dom-textarea/input-setselectionrange-dev

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch