HTMLInputElement.setSelectionRange()

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

HTMLInputElement.setSelectionRange() method sets the start and end positions of the current text selection in an <input> or <textarea> 元素。

Optionally, in newer browser versions, you can specify the direction in which selection should be considered to have occurred. This lets you indicate, for example, that the selection was set by the user clicking and dragging from the end of the selected text toward the beginning.

This method updates the HTMLInputElement.selectionStart , selectionEnd ，和 selectionDirection properties in one call.

Note that accordingly to the WHATWG forms spec selectionStart , selectionEnd properties and setSelectionRange method apply only to inputs of types text, search, URL, tel and password. Chrome, starting from version 33, throws an exception while accessing those properties and method on the rest of input types. For example, on input of type number: "Failed to read the 'selectionStart' property from 'HTMLInputElement': The input element's type ('number') does not support selection".

If you wish to select all text of an input element, you can use the HTMLInputElement.select() method instead.

句法

element.setSelectionRange(selectionStart, selectionEnd [, selectionDirection]);

参数

若 selectionEnd 小于 selectionStart , then both are treated as the value of selectionEnd .

selectionStart

The 0-based index of the first selected character. An index greater than the length of the element's value is treated as pointing to the end of the value.

selectionEnd

The 0-based index of the character after the last selected character. An index greater than the length of the element's value is treated as pointing to the end of the value.

selectionDirection 可选

A string indicating the direction in which the selection is considered to have been performed. Possible values:

"forward"
"backward"
"none" if the direction is unknown or irrelevant. Default value.

范例

Click the button in this example to select the third, fourth, and fifth characters in the text box ("zil" in the word "Mozilla").

HTML

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

JavaScript

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

结果

规范

规范	状态	注释
HTML 实时标准 The definition of 'HTMLInputElement.setSelectionRange()' in that specification.	实时标准	无变化
HTML 5.1 The definition of 'HTMLInputElement.setSelectionRange()' in that specification.	推荐	无变化
HTML5 The definition of 'HTMLInputElement.setSelectionRange()' in that specification.	推荐	初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`setSelectionRange`	Chrome 1	Edge 12	Firefox 1	IE 9	Opera 8	Safari 3	WebView Android 1	Chrome Android 18	Firefox Android 4	Opera Android 10.1	Safari iOS 1	Samsung Internet Android 1.0

在此页

句法

参数

范例

HTML

JavaScript

结果

规范

浏览器兼容性

图例

另请参阅

元数据

相关话题