HTMLInputElement: selectionStart-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die selectionStart-Eigenschaft des HTMLInputElement-Interfaces ist eine Zahl, die den Beginn des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, wird die Position des Textcursor (Caret) innerhalb des <input>-Elements zurückgegeben.
Hinweis:
Gemäß der WHATWG-Formularspezifikation gilt die selectionStart-Eigenschaft nur für Eingaben der Typen Text, Suche, URL, Telefon und Passwort. In modernen Browsern wird eine Ausnahme ausgelöst, wenn die selectionStart-Eigenschaft für andere Eingabetypen festgelegt wird. Zusätzlich gibt diese Eigenschaft null zurück, wenn auf die selectionStart-Eigenschaft bei nicht-texteingabetypen zugegriffen wird.
Wenn selectionStart größer ist als selectionEnd, werden beide als Wert von selectionEnd behandelt.
Wert
Eine nicht-negative Zahl.
Beispiele
HTML
<!-- use selectionStart on non text input element -->
<label for="color">selectionStart property on type=color</label>
<input id="color" type="color" />
<!-- use selectionStart on text input element -->
<fieldset>
<legend>selectionStart property on type=text</legend>
<label for="statement">Select 'mdn' word from the text : </label>
<input
type="text"
id="statement"
value="The mdn is a documentation repository." />
<button id="statement-btn">Select mdn text</button>
</fieldset>
JavaScript
const inputElement = document.getElementById("statement");
const statementBtn = document.getElementById("statement-btn");
const colorStart = document.getElementById("color");
statementBtn.addEventListener("click", () => {
inputElement.selectionStart = 4;
inputElement.selectionEnd = 7;
inputElement.focus();
});
// open browser console to verify output
console.log(colorStart.selectionStart); // Output : null
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-textarea/input-selectionstart |
Browser-Kompatibilität
Siehe auch
HTMLTextAreaElement.selectionStart-EigenschaftHTMLInputElement.selectionEnd-EigenschaftHTMLInputElement.setSelectionRange-Methode