HTMLInputElement: Methode setSelectionRange()

Baseline Weitgehend verfgbar

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

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Die HTMLInputElement.setSelectionRange()-Methode legt die Start- und Endpositionen der aktuellen Textauswahl in einem <input>- oder <textarea>-Element fest. Dies aktualisiert den Auswahlzustand sofort, obwohl die visuelle Hervorhebung nur erscheint, wenn das Element fokussiert ist.

Optional knnen Sie die Richtung angeben, in der die Auswahl als erfolgt betrachtet werden soll. Damit knnen Sie zum Beispiel angeben, dass die Auswahl vom Benutzer durch Klicken und Ziehen vom Ende des ausgewhlten Textes zum Anfang durchgefhrt wurde.

Diese Methode aktualisiert die Eigenschaften HTMLInputElement.selectionStart, HTMLInputElement.selectionEnd und HTMLInputElement.selectionDirection in einem Aufruf, unabhngig davon, ob das Element fokussiert ist. Die visuelle Hervorhebung der Auswahl wird nur angezeigt, wenn das Element den Fokus hat.

Das Element muss einen der folgenden Eingabetypen haben: password, search, tel, text oder url. Andernfalls wirft der Browser eine InvalidStateError-Ausnahme.

Wenn Sie alle Texte eines Eingabeelements auswhlen mchten, knnen Sie stattdessen die Methode HTMLInputElement.select() verwenden.

Syntax

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

Parameter

selectionStart

Der 0-basierte Index des ersten ausgewhlten Zeichens. Ein Index, der grer als die Lnge des Werts des Elements ist, wird als Ende des Werts behandelt.

selectionEnd

Der 0-basierte Index des Zeichens nach dem letzten ausgewhlten Zeichen. Ein Index, der grer als die Lnge des Werts des Elements ist, wird als Ende des Werts behandelt. Wenn selectionEnd kleiner als selectionStart ist, werden beide als der Wert von selectionEnd behandelt.

selectionDirection Optional

Ein String, der die Richtung angibt, in der die Auswahl als erfolgt betrachtet wird. Mgliche Werte:

"forward"
"backward"
"none", wenn die Richtung unbekannt oder nicht relevant ist. Standardwert.

Rckgabewert

Keiner (undefined).

Ausnahmen

InvalidStateError DOMException: Wird ausgelst, wenn das Element nicht einer der folgenden Eingabetypen ist: password, search, tel, text oder url.

Beispiele

Klicken Sie auf die Schaltflche in diesem Beispiel, um das dritte, vierte und fnfte Zeichen im Textfeld auszuwhlen ("zil" im Wort "Mozilla").

HTML

html

<input type="text" id="text-box" size="20" value="Mozilla" />
<button>Select text</button>

JavaScript

function selectText() {
  const input = document.getElementById("text-box");
  input.focus();
  input.setSelectionRange(2, 5);
}

document.querySelector("button").addEventListener("click", selectText);

Ergebnis

Spezifikationen

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