浏览器与 Web API / 系统课时

约束验证与自定义错误

约束验证与自定义错误

浏览器原生约束验证可以在不引入表单库的情况下处理必填、格式和字段间一致性。本课将把 HTML 约束、ValidityState、checkValidity() 与 setCustomValidity() 串成一套可运行流程,并说明怎样避免自定义错误无法清除的问题。

学习目标

  • 使用 required、type 和 pattern 声明字段约束
  • 读取 ValidityState 并区分常见失败原因
  • 使用 checkValidity()、reportValidity() 和 setCustomValidity() 完成自定义验证

浏览器如何生成验证状态

表单控件会把声明式约束转换为一个只读的 validity 对象。valueMissing 表示必填值为空,typeMismatch 表示邮箱等内置类型不匹配,patternMismatch 表示未通过正则约束,customError 则来自 setCustomValidity()。只有所有失败标记都为 false 时,validity.valid 才为 true。

约束验证与自定义错误处理流程

checkValidity() 只返回布尔结果,并会让无效控件触发 invalid 事件;reportValidity() 还会请求浏览器显示原生错误提示。提示文案和样式由浏览器决定,因此业务上需要固定文案时,应使用 setCustomValidity(),再配合页面中的错误区域呈现。

完整示例:组合原生约束与字段间验证

下面的页面同时验证邮箱、订单编码和两次密码。订单编码要求三个大写字母、一个短横线和四位数字;确认密码属于跨字段规则,无法只靠 HTML 属性表达,因此由 JavaScript 设置自定义错误。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="utf-8">
  <title>约束验证示例</title>
</head>
<body>
  <form id="signupForm" novalidate>
    <label>
      邮箱
      <input name="email" type="email" required>
    </label>

    <label>
      订单编码
      <input name="orderCode" required pattern="[A-Z]{3}-[0-9]{4}">
    </label>

    <label>
      密码
      <input id="password" name="password" type="password" required minlength="8">
    </label>

    <label>
      确认密码
      <input id="confirmPassword" type="password" required>
    </label>

    <button type="submit">验证并提交</button>
  </form>

  <p id="result" aria-live="polite"></p>

  <script>
    const form = document.querySelector('#signupForm');
    const password = document.querySelector('#password');
    const confirmPassword = document.querySelector('#confirmPassword');
    const result = document.querySelector('#result');

    function syncPasswordError() {
      const hasMismatch =
        confirmPassword.value !== '' &&
        confirmPassword.value !== password.value;
      // 空字符串会清除上一次设置的 customError。
      confirmPassword.setCustomValidity(
        hasMismatch ? '两次输入的密码不一致' : ''
      );
    }

    password.addEventListener('input', syncPasswordError);
    confirmPassword.addEventListener('input', syncPasswordError);

    form.addEventListener('submit', (event) => {
      event.preventDefault();
      syncPasswordError();

      if (!form.checkValidity()) {
        form.reportValidity();
        result.textContent = '验证失败:请修正表单中的错误';
        return;
      }

      result.textContent = '验证通过:可以进入实际提交逻辑';
    });
  </script>
</body>
</html>

预期结果

text
输入 abc@example.com、ABC-2026 和两次相同的八位以上密码:
验证通过:可以进入实际提交逻辑

订单编码填写 abc-26,或两次密码不同:
验证失败:请修正表单中的错误

把代码保存为 validation.html 后直接用浏览器打开即可。不同浏览器展示的气泡样式可能不同,但页面中的结果文本应与上述分支一致。

读取 ValidityState 定位错误

同一控件可能同时受多条规则影响,页面自定义提示应按“空值、内置类型、格式、业务规则”的顺序选择,避免字段为空时先显示格式错误。常用状态可以直接从 input.validity 读取。

状态 含义 适合的提示
valueMissing 必填控件没有值 此项不能为空
typeMismatch 值不符合 email 等内置类型 请输入有效的邮箱地址
patternMismatch 值不符合 pattern 订单编码格式应为 ABC-1234
customError 存在自定义错误文本 使用 validationMessage 读取

当所有状态都未失败时,validity.valid 为 true。错误区域应在字段恢复有效后同步清空,不能只更新控件状态而保留旧提示。

关键边界与常见错误

pattern 会对整个输入值进行匹配,不需要再手动添加 ^ 和 $。隐藏字段如果仍启用且带有 required,依然可能阻止提交;不参与当前流程的字段应移除约束或设置为 disabled。最常见的错误是只调用一次 setCustomValidity('错误'),却在值恢复正确后没有调用 setCustomValidity(''),导致控件永久无效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

约束验证与自定义错误

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通