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

HTML 元素:change 事件

· 52CE 我爱测

当用户更改 input、select 和 textarea 元素的值时,`change` 事件在这些元素上触发。和 Element/input_event 事件不同的是,并不是每次元素的 `value` 改变时都会触发 `change` 事件。

当用户更改 input、select 和 textarea 元素的值时,change 事件在这些元素上触发。和 Element/input_event 事件不同的是,并不是每次元素的 value 改变时都会触发 change 事件。

基于表单元素的类型和用户对元素的操作的不同,change 事件触发的时机也不同:

  • 当 input/checkbox 元素被选中或取消选中时(通过点击或使用键盘);
  • 当 input/radio 元素被选中时(但不是取消选中时);
  • 当用户显式提交改变时(例如:通过鼠标点击了 select 中的一个下拉选项,通过 input/date 元素选择了一个日期,通过 input/file 元素上传了一个文件等);
  • 当标签的值被修改并且失去焦点后,但未提交时(例如:对textarea、 input/text、input/search、input/url、input/tel、input/email 或 input/password 类型的 input 元素进行编辑后)。

HTML 标准列出了应该触发 change 事件的 <input> 类型。

语法

在方法(如 EventTarget.addEventListener)中使用事件的名称,或设置事件处理器属性。

addEventListener("change", (event) => {});

onchange = (event) => {};

事件类型

通用 Event。

示例

<select> 元素

HTML

<label>
  选择一种冰淇淋口味:
  <select class="ice-cream" name="ice-cream">
    <option value="">选择一个...</option>
    <option value="chocolate">巧克力</option>
    <option value="sardine">沙丁鱼</option>
    <option value="vanilla">香草</option>
  </select>
</label>

<div class="result"></div>
body {
  display: grid;
  grid-template-areas: "select result";
}

select {
  grid-area: select;
}

.result {
  grid-area: result;
}

JavaScript

const selectElement = document.querySelector(".ice-cream");

selectElement.addEventListener("change", (event) => {
  const result = document.querySelector(".result");
  result.textContent = `你喜欢 ${event.target.value}`;
});

结果

select_元素

文本输入元素

对于像 <input type="text"> 这样的元素,change 事件在控件失去焦点前都不会触发。试一下在下面的输入框输入一些文字,然后点击输入框外的地方来触发事件。

HTML

<input placeholder="输入一些文本" name="name" />
<p id="log"></p>

JavaScript

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

input.addEventListener("change", updateValue);

function updateValue(e) {
  log.textContent = e.target.value;
}

结果

文本输入元素

规范

浏览器兼容性

对于一些特定类型的交互是否要触发 change 事件,不同浏览器的意见并不总是一致的。例如,在 Gecko 的 select 元素中使用键盘导航,除非用户按下 Enter 键或将焦点从 <select> 上移走(参见 Firefox bug 126379),否则不会触发 change 事件。但从 Firefox 63(Quantum)开始,这个行为在已经在主流浏览器中达成一致。

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

资料来源与适用范围

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

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

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