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 -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 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 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 alsselectionStart
, werden beide als der Wert vonselectionEnd
behandelt. Weitere Informationen finden Sie in derselectionEnd
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 derselectionDirection
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 |