大网数据广告活动
Web 标准与前端开发

HTMLInputElement:setSelectionRange() 方法

· 52CE 我爱测

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

HTML DOM

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

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

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

每次调用这个这个方法都会更新 HTMLInputElement.selectionStart、HTMLInputElement.selectionEnd 和 HTMLInputElement.selectionDirection 属性。

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

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

语法

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

示例

在这个示例中,按下按钮以选择文本框中第三、四、五个字符(即“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

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。