TextEvent

已弃用：此特性不再推荐。虽然某些浏览器可能仍然支持它，但它可能已经从相关的网络标准中删除，可能正在删除过程中，或者可能仅为兼容性目的而保留。请避免使用它，如果可能，请更新现有代码；请参阅本页底部的兼容性表格以指导您的决策。请注意，此特性可能随时停止工作。

TextEvent 接口是一个已弃用的 UI 事件接口，用于报告文本 UI 元素的更改。

注意： TextEvent 事件已被 input、beforeinput、keypress、keyup 和 keydown 等事件取代。

实例属性

此接口还继承了其父级 UIEvent 的属性，以及间接继承自 Event 的属性。

TextEvent.data 只读已弃用: 表示与事件相关联的数据。

实例方法

TextEvent.initTextEvent() 已弃用: 使用给定的参数填充此（新的）TextEvent 的值。

事件列表

以下是所有 TextEvent 事件的列表

textinput

示例

监听文本输入事件

您可以使用 EventTarget.addEventListener() 注册一个文本输入事件的监听器，如下所示：

element.addEventListener("textInput", (event) => {
  // …
});

显示输入事件的简单日志记录器

此示例监听在输入框上触发的多个事件，包括 textInput。事件类型和事件数据将被记录下来，让您可以看到 textInput 相对于其他事件（例如键盘按键生成的事件）的触发位置。

HTML

html

<input placeholder="Enter some text" name="name" />

<pre id="log"></pre>

#log {
  height: 140px;
  overflow: scroll;
  padding: 0.5rem;
  border: 1px solid black;
}

JavaScript

const logElement = document.querySelector("#log");
function log(text) {
  logElement.innerText = `${logElement.innerText}${text}\n`;
  logElement.scrollTop = logElement.scrollHeight;
}

const input = document.querySelector("input");

input.addEventListener("keypress", updateValue);
input.addEventListener("keyup", updateValue);
input.addEventListener("keydown", updateValue);
input.addEventListener("input", updateValue);
input.addEventListener("beforeinput", updateValue);
input.addEventListener("textInput", updateValue);

function updateValue(e) {
  log(`${e.type}: ${e.data}`);
}

结果

规范

规范
UI 事件 # legacy-textevent-events

浏览器兼容性

帮助改进 MDN

了解如何贡献

此页面最后修改于 ⁨2025年9月18日⁩，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的问题