HTML DOM
The selectionStart property of the HTMLInputElement interface specifies the start position of the current text selection in an input element.
Value
A non-negative number, representing the zero-based index of the first selected character in a text <input>. When nothing is selected, the value of both selectionStart and HTMLInputElement.selectionEnd is the position of the cursor (caret) inside the <input> element.
Setting selectionStart to a value greater than the current value of selectionEnd updates both properties to the new value. Values greater than the length of the input's value are treated as the end of the value. Setting selectionStart to a new value fires the HTMLInputElement.selectionchange_event and HTMLInputElement.select_event events.
The property value can be retrieved and set without the <input> having focus, but the element must have focus for the ::selection pseudo-element to match the selected text.
The selectionStart property applies only to inputs of types text, search, url, tel, and password. On other input types, reading the property returns null, and setting it throws an InvalidStateError DOMException.
Examples
Basic usage
This example reports the selected text and its start and end positions. Select some text in the input, and then click the button.
HTML
<label for="text-box">Select some text:</label>
<input id="text-box" type="text" value="The quick brown fox." />
<button id="show-selection" type="button">Show selection</button>
<p id="output">No selection reported yet.</p>
JavaScript
const textBox = document.querySelector("#text-box");
const output = document.querySelector("#output");
document.querySelector("#show-selection").addEventListener("click", () => {
const start = textBox.selectionStart;
const end = textBox.selectionEnd;
const selectedText = textBox.value.substring(start, end);
output.textContent = `You selected "${selectedText}" (start: ${start}, end: ${end}).`;
});
Result
Examples
Specifications
Browser compatibility
See also
- input
- HTMLInputElement
- HTMLInputElement.selectionEnd
- HTMLInputElement.selectionDirection
- HTMLInputElement.selectionchange_event event
- HTMLInputElement.select()
- HTMLInputElement.setSelectionRange()
- HTMLInputElement.setRangeText()
- HTMLTextAreaElement.selectionStart
- Selection
- ::selection pseudo-element
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
