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

InputEvent:getTargetRanges() 方法

· 52CE 我爱测

InputEvent 接口的 **`getTargetRanges()`** 方法返回一个 StaticRange 对象数组,如果不取消输入事件,该数组受到 DOM 更改的影响。

UI Events

InputEvent 接口的 getTargetRanges() 方法返回一个 StaticRange 对象数组,如果不取消输入事件,该数组受到 DOM 更改的影响。

这允许 web 应用程序在浏览器修改 DOM 树之前重写文本编辑行为,并提供更多控制输入事件的能力,以提高性能。

依据 inputType 值和当前的编辑宿主,此方法的返回值不同:

<table> <thead> <tr> <th>inputType</th> <th>编辑宿主</th> <th><code>getTargetRanges()</code>的响应</th> </tr> </thead> <tbody> <tr> <td><code>"historyUndo"</code> 或 <code>"historyRedo"</code></td> <td>Any</td> <td>空数组</td> </tr> <tr> <td>剩余的所有值</td> <td><code>contenteditable</code></td> <td> 一个与事件有关的 StaticRange 对象数组。 </td> </tr> <tr> <td>剩余的所有值</td> <td> <a href="/zh-CN/docs/Web/HTML/Reference/Elements/input"><code>input</code></a> 或者 <a href="/zh-CN/docs/Web/HTML/Reference/Elements/textarea"><code>textarea</code></a> </td> <td> 一个空数组 </td> </tr> </tbody> </table>

语法

getTargetRanges()

参数

无。

返回值

一个 StaticRange 对象数组。

示例

特征检测

如果浏览器支持 beforeinput 和 getTargetRanges,则下面的函数会返回 true。

function isBeforeInputEventAvailable() {
  return (
    window.InputEvent &&
    typeof InputEvent.prototype.getTargetRanges === "function"
  );
}

基本用法

下面的示例选择一个 contenteditable 元素,利用 beforeinput 事件输出 getTargetRanges() 的结果。

const editableElem = document.querySelector('[contenteditable="true"]');

editableElem.addEventListener("beforeinput", (e) => {
  const targetRanges = e.getTargetRanges();
  console.log(targetRanges);
});

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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