HTMLInputElement：setSelectionRange() 方法

基线广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

HTMLInputElement.setSelectionRange 方法用于设定 <input> 或 <textarea> 元素中当前选中文本的起始和结束位置。

该元素必须获得焦点才能使调用产生任何效果。

可选地，你可以指定选择应发生的方向。例如，这使你可以指示，选择是由用户从选定文本的末尾向开头处点击并拖动设置的。

该元素必须是以下输入类型之一：password、search、tel、text 或 url。否则，浏览器会抛出 InvalidStateError 异常。

如果你希望全选输入元素中的文本，你可以使用 HTMLInputElement.select() 方法。

本文内容

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

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

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

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

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

InvalidStateError DOMException

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

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

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

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

启用 JavaScript 以查看此浏览器兼容性表。

此页面对您有帮助吗？

是否

此页面最后更新于 2025年6月24日，由 MDN 贡献者更新。