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 Anfangsindex des ausgewählten Textes darstellt. Wenn nichts ausgewählt ist, gibt sie die Position des Texteingabe-Cursors (Karets) innerhalb des <input>-Elements zurück.
Hinweis:
Gemäß der WHATWG Formularspezifikation gilt die selectionStart-Eigenschaft nur für Eingaben der Typen Text, Suche, URL, Tel und Passwort. Bei anderen Eingabetypen gibt das Lesen von selectionStart null zurück, und beim Setzen wird ein InvalidStateError ausgelöst.
Wenn selectionStart größer ist als selectionEnd, werden beide als der 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