HTMLTextAreaElement: setSelectionRange() Methode

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 setzt die Start- und Endpositionen der aktuellen Textauswahl und optional die Richtung in einem <textarea>-Element. Die Richtung gibt an, in welcher die Auswahl erfolgt sein soll, zum Beispiel, dass die Auswahl durch Klicken und Ziehen des Benutzers vom Ende des ausgewählten Textes zum Anfang gesetzt wurde. Zusätzlich werden die select und selectchange Ereignisse ausgelöst.

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

Hinweis: Der <textarea> muss fokussiert sein, um eine Untersektion des Textes mit der setSelectionRange() Methode auszuwählen. Das Setzen des Fokus löst ebenfalls ein selectchange Ereignis aus.

Um alle Texte eines <textarea> Elements auszuwählen, verwenden Sie die HTMLTextAreaElement.select() Methode.

Syntax

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 Zeiger auf das Ende des Wertes behandelt. Weitere Informationen finden Sie in der selectionStart Eigenschaft.
selectionEnd: Der Index des Zeichens nach dem zuletzt ausgewählten Zeichen. Ein Index, der größer ist als die Länge des Wertes des Elements, wird als Zeiger auf das Ende des Wertes behandelt. Wenn selectionEnd kleiner ist als selectionStart, werden beide als der Wert von selectionEnd behandelt. Weitere Informationen finden Sie in der selectionEnd Eigenschaft.
selectionDirection Optional: Das Schlüsselwort "forward", "backward" oder der Standardwert "none" — dies gibt die Richtung an, in der die Auswahl als durchgeführt betrachtet wird. Weitere Informationen finden Sie in der selectionDirection Eigenschaft.

Rückgabewert

Keiner (undefined).

Beispiele

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 # dom-textarea/input-setselectionrange-dev