HTMLInputElement：setSelectionRange() 方法

语法

setSelectionRange(selectionStart, selectionEnd)
setSelectionRange(selectionStart, selectionEnd, selectionDirection)

参数

如果 selectionEnd 小于 selectionStart，则二者都会被看作 selectionEnd。

selectionStart

被选中的第一个字符的位置索引，从 0 开始。如果这个值比元素的 value 长度还大，则会被看作 value 最后一个位置的索引。

selectionEnd

被选中的最后一个字符的下一个位置索引，从 0 开始。如果这个值比元素的 value 长度还大，则会被看作 value 最后一个位置的索引。

selectionDirection 可选

一个表示选择方向的字符串，可能的值有：

• "forward"
• "backward"
• "none" 默认值，表示方向未知或不相关。

返回值

无 (undefined)。

异常

InvalidStateError DOMException

如果元素不是以下输入类型之一：password、search、tel、text 或 url，则抛出该异常。

示例

在这个示例中，按下按钮以选择文本框中第三、四、五个字符（即“Mozilla”中的“zil”）。

HTML

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

JavaScript

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

结果

规范

浏览器兼容性

相关内容

• <input>
• <textarea>
• HTMLInputElement
• Selection