HOWTO · JavaScript
如何在 JavaScript 中防止表单提交
使用 submit 事件监听器、内联 onsubmit 处理程序或 jQuery,防止表单在客户端验证失败时提交。
本页内容
若要防止表单在其数据未通过客户端验证时提交,请处理表单的 submit 事件,并且仅在检查失败时调用 event.preventDefault()。将监听器附加到表单,而不是其提交按钮:表单的 submit 事件也涵盖键盘提交。数据有效时,保持默认动作不变,让浏览器可以提交表单。
使用 submit 事件监听器防止表单提交
submit 监听器是新 JavaScript 代码的常用选择。这个独立的 Node.js 示例模拟了浏览器表单所使用的事件接口,并展示有效的电子邮件如何到达正常提交路径。在页面中,使用 form.addEventListener('submit', handleSubmit) 注册相同的处理程序。
const form = {
listener: null,
addEventListener(type, callback) {
if (type === 'submit') this.listener = callback;
},
submit(event) {
this.listener(event);
return !event.defaultPrevented;
}
};
const email = 'reader@example.com';
const handleSubmit = (event) => {
if (!email.includes('@')) event.preventDefault();
};
form.addEventListener('submit', handleSubmit);
const event = {
defaultPrevented: false,
preventDefault() {
this.defaultPrevented = true;
}
};
console.log(form.submit(event) ? 'Form may submit' : 'Submission prevented');
此示例的小型表单对象可让处理程序在 Node.js 中运行;在浏览器中,浏览器会提供表单和事件。在您的页面中,在处理程序内读取相关控件,并在检查失败时调用 event.preventDefault()。调用它会取消浏览器的默认提交动作;它不会导航到其他页面,也不会在历史记录中后退。点击提交按钮和在表单控件中按 Enter 都会导致表单的 submit 事件。
使用内联 onsubmit 处理程序
内联 onsubmit 处理程序是现有标记的替代方案。例如,<form onsubmit="return validateForm()"> 会在表单提交时调用函数。验证失败时返回 false 以取消提交;表单准备好提交时返回 true。让该函数可供页面使用,并确保它在每条路径上都返回值。对于新代码,监听器通常可让行为与 HTML 分离。
使用 jQuery 防止提交
如果项目已使用 jQuery,请使用 $('#myForm').on('submit', function (event) { ... }) 将处理程序附加到表单。在回调内检查表单值,并且仅在验证失败时调用 event.preventDefault()。不要从处理程序调用 $('#myForm').submit() 来防止提交:这会触发提交行为,而不是取消浏览器的默认动作。jQuery 是可选的;原生的 addEventListener 无需依赖即可提供相同的表单事件。
验证输入并提供反馈
检查失败时,请防止提交,并在需要注意的字段旁显示简洁的消息。将该消息与其控件关联,将错误公开给辅助技术,并在适当时将焦点移至第一个需要更正的字段。避免仅依靠警告作为唯一的反馈。当所有检查都通过时,允许提交继续,并让服务器也验证接收到的数据;客户端检查可改善交互,但本身并不能保护数据。
当符合表单需求时,可使用 required、type="email" 和 minlength 等 HTML 限制。浏览器可以在正常 submit 事件发送之前报告这些失败;自定义检查可以添加 HTML 限制无法表达的规则。不要禁用提交按钮来代替验证,因为用户仍然需要明确的途径来更正他们的输入。