HTMLInputElement: selectionStart-Eigenschaft

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 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

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

js
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

Specification
HTML Standard
# dom-textarea/input-selectionstart

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch