当表单 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。离线整理了版式、链接和媒体显示。
