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

HTMLFormElement: submit event

· 52CE 我爱测

注意 `submit` 事件只能作用于 `<form>` 元素本身,不能作用于 button 或者 input/submit。但 SubmitEvent 被用于表单提交时,会携带 SubmitEvent.submitter 属性,这是触发提交请求时会调用的按钮。

当表单 form 提交的时候触发 submit 事件。

<table class="properties"> <tbody> <tr> <th>是否冒泡</th> <td>是(虽然其通常被看作不冒泡的简单事件)</td> </tr> <tr> <th>是否可取消</th> <td>是</td> </tr> <tr> <th>接口</th> <td>SubmitEvent</td> </tr> <tr> <th>事件处理器属性</th> <td>GlobalEventHandlers.onsubmit</td> </tr> </tbody> </table>

注意 submit 事件只能作用于 <form> 元素本身,不能作用于 button 或者 input/submit。但 SubmitEvent 被用于表单提交时,会携带 SubmitEvent.submitter 属性,这是触发提交请求时会调用的按钮。

当用户点击提交按钮(button 或 input/submit),亦或是在表单里输入时(e.g. input/text)按下 <kbd>Enter</kbd> 键,submit 事件将会被触发。直接调用 HTMLFormElement.submit() 方法时,事件不会发送到表单。

[!NOTE] 当试图提交一个未通过验证的表单时,会触发 HTMLInputElement/invalid_event 事件。在这种情况下,表单提交将会被验证机制阻止。因此,sumbit 事件也就不存在了。

示例

这个示例使用 EventTarget.addEventListener() 去监听表单的提交。并记录当前的 Event.timeStamp,然后阻止提交表单的默认操作。

HTML

<form id="form">
  <label>Test field: <input type="text" /></label>
  <br /><br />
  <button type="submit">Submit form</button>
</form>
<p id="log"></p>

JavaScript

function logSubmit(event) {
  log.textContent = `Form Submitted! Time stamp: ${event.timeStamp}`;
  event.preventDefault();
}

const form = document.getElementById("form");
const log = document.getElementById("log");
form.addEventListener("submit", logSubmit);

结果

示例

规范

浏览器兼容性

参见

  • HTML form 元素
  • 相关事件:HTMLInputElement/invalid_event

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

资料来源与适用范围

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

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

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