验证 - 光年(Light Year Admin V5)后台管理系统模板

验证

通过 HTML5 表单验证，通过浏览器默认行为或自定义样式和 JavaScript，为您的用户提供有价值的、可操作的反馈。

我们知道目前无法访问客户端自定义验证样式和工具提示，因为它们没有暴露于辅助技术。在我们研究解决方案时，我们建议使用服务器端选项或默认浏览器验证方法。

怎么运行的

下面是表单验证如何与 Bootstrap 一起工作：

HTML 表单验证通过 CSS 的两个伪类 :invalid 和 :valid 应用。它适用于 <input>、<select> 和 <textarea> 元素。
Bootstrap 将 :invalid 和 :valid 样式限定为父 .was-validated 类，通常应用于 <form>。否则，任何没有值的必填字段在页面加载时显示为无效。这样，您可以选择何时激活它们（通常在尝试提交表单之后）。
要重置表单的外观（例如，在使用 AJAX 进行动态表单提交的情况下），请在提交后再次从 <form> 中删除 .was-validated 类。
作为后备，可以使用 .is-invalid 和 .is-valid 类代替伪类进行服务器端验证。它们不需要 .was-validated 父类。
由于 CSS 工作方式的限制，如果没有自定义 JavaScript 的帮助，我们（目前）无法将样式应用于 DOM 中表单控件之前的 <label>。
所有现代浏览器都支持约束验证 API，这是一系列用于验证表单控件的 JavaScript 方法。
反馈消息可以使用浏览器默认设置（每个浏览器不同，并且无法通过 CSS 设置样式）或我们的自定义反馈样式以及额外的 HTML 和 CSS。
您可以在 JavaScript 中使用 setCustomValidity 提供自定义有效性消息。

考虑到这一点，请考虑以下演示，了解我们的自定义表单验证样式、可选的服务器端类和浏览器默认设置。

自定义样式

对于自定义 Bootstrap 表单验证消息，您需要将 novalidate 布尔属性添加到您的 <form>。这将禁用浏览器默认反馈工具提示，但仍提供对 JavaScript 中表单验证 API 的访问。尝试提交以下表格；我们的 JavaScript 将拦截提交按钮并将反馈转发给您。尝试提交时，您会看到应用于表单控件的 :invalid 和 :valid 样式。

自定义反馈样式应用自定义颜色、边框、焦点样式和背景图标以更好地传达反馈。 <select> 的背景图标仅适用于 .form-select，不适用于 .form-control。

姓名

正确

字

正确

用户名

请选择一个用户名。

城市

请提供一个正确的城市。

武器

请选择你日常使用的武器。

邮编

请填写正确的邮编。

同意条款和条件

你必须在提交前同意。

<form class="row g-3 needs-validation" novalidate>
  <div class="col-md-4">
    <label for="validationCustom01" class="form-label">姓名</label>
    <input type="text" class="form-control" id="validationCustom01" value="张辽" required>
    <div class="valid-feedback">
      正确
    </div>
  </div>
  <div class="col-md-4">
    <label for="validationCustom02" class="form-label">字</label>
    <input type="text" class="form-control" id="validationCustom02" value="文远" required>
    <div class="valid-feedback">
      正确
    </div>
  </div>
  <div class="col-md-4">
    <label for="validationCustomUsername" class="form-label">用户名</label>
    <div class="input-group has-validation">
      <span class="input-group-text" id="inputGroupPrepend">@</span>
      <input type="text" class="form-control" id="validationCustomUsername" aria-describedby="inputGroupPrepend" required>
      <div class="invalid-feedback">
        请选择一个用户名。
      </div>
    </div>
  </div>
  <div class="col-md-6">
    <label for="validationCustom03" class="form-label">城市</label>
    <input type="text" class="form-control" id="validationCustom03" required>
    <div class="invalid-feedback">
      请提供一个正确的城市。
    </div>
  </div>
  <div class="col-md-3">
    <label for="validationCustom04" class="form-label">武器</label>
    <select class="form-select" id="validationCustom04" required>
      <option selected disabled value="">请选择...</option>
      <option>...</option>
    </select>
    <div class="invalid-feedback">
      请选择你日常使用的武器。
    </div>
  </div>
  <div class="col-md-3">
    <label for="validationCustom05" class="form-label">邮编</label>
    <input type="text" class="form-control" id="validationCustom05" required>
    <div class="invalid-feedback">
      请填写正确的邮编。
    </div>
  </div>
  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" value="" id="invalidCheck" required>
      <label class="form-check-label" for="invalidCheck">
        同意条款和条件
      </label>
      <div class="invalid-feedback">
        你必须在提交前同意。
      </div>
    </div>
  </div>
  <div class="col-12">
    <button class="btn btn-primary" type="submit">提交表单</button>
  </div>
</form>

使用到的JS

// Example starter JavaScript for disabling form submissions if there are invalid fields
(function () {
  'use strict'

  // Fetch all the forms we want to apply custom Bootstrap validation styles to
  var forms = document.querySelectorAll('.needs-validation')

  // Loop over them and prevent submission
  Array.prototype.slice.call(forms)
    .forEach(function (form) {
      form.addEventListener('submit', function (event) {
        if (!form.checkValidity()) {
          event.preventDefault()
          event.stopPropagation()
        }

        form.classList.add('was-validated')
      }, false)
    })
})()

浏览器默认值

对自定义验证反馈消息或编写 JavaScript 来更改表单行为不感兴趣？一切都好，您可以使用浏览器默认设置。尝试提交下面的表格。根据您的浏览器和操作系统，您会看到略有不同的反馈风格。

虽然这些反馈样式无法使用 CSS 设置样式，但您仍然可以通过 JavaScript 自定义反馈文本。

<form class="row g-3">
  <div class="col-md-4">
    <label for="validationDefault01" class="form-label">姓名</label>
    <input type="text" class="form-control" id="validationDefault01" value="张辽" required>
  </div>
  <div class="col-md-4">
    <label for="validationDefault02" class="form-label">字</label>
    <input type="text" class="form-control" id="validationDefault02" value="文远" required>
  </div>
  <div class="col-md-4">
    <label for="validationDefaultUsername" class="form-label">用户名</label>
    <div class="input-group">
      <span class="input-group-text" id="inputGroupPrepend2">@</span>
      <input type="text" class="form-control" id="validationDefaultUsername"  aria-describedby="inputGroupPrepend2" required>
    </div>
  </div>
  <div class="col-md-6">
    <label for="validationDefault03" class="form-label">城市</label>
    <input type="text" class="form-control" id="validationDefault03" required>
  </div>
  <div class="col-md-3">
    <label for="validationDefault04" class="form-label">武器</label>
    <select class="form-select" id="validationDefault04" required>
      <option selected disabled value="">请选择...</option>
      <option>...</option>
    </select>
  </div>
  <div class="col-md-3">
    <label for="validationDefault05" class="form-label">邮编</label>
    <input type="text" class="form-control" id="validationDefault05" required>
  </div>
  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input" type="checkbox" value="" id="invalidCheck2" required>
      <label class="form-check-label" for="invalidCheck2">
        同意条款和条件
      </label>
    </div>
  </div>
  <div class="col-12">
    <button class="btn btn-primary" type="submit">提交表单</button>
  </div>
</form>

服务器端

我们建议使用客户端验证，但如果您需要服务器端验证，您可以使用 .is-invalid 和 .is-valid 指示无效和有效的表单字段。请注意，这些类也支持 .invalid-feedback。

对于无效字段，使用 aria-describeby 确保无效的反馈/错误消息与相关表单字段相关联（注意此属性允许引用多个 id，以防字段已指向其他表单文本）。

要解决边框半径问题，输入组需要额外的 .has-validation 类。

姓名

正确

字

正确

用户名

请选择一个用户名。

城市

请提供一个正确的城市。

武器

请选择你日常使用的武器。

邮编

请填写正确的邮编。

同意条款和条件

你必须在提交前同意。

<form class="row g-3">
  <div class="col-md-4">
    <label for="validationServer01" class="form-label">姓名</label>
    <input type="text" class="form-control is-valid" id="validationServer01" value="张辽" required>
    <div class="valid-feedback">
      正确
    </div>
  </div>
  <div class="col-md-4">
    <label for="validationServer02" class="form-label">字</label>
    <input type="text" class="form-control is-valid" id="validationServer02" value="文远" required>
    <div class="valid-feedback">
      正确
    </div>
  </div>
  <div class="col-md-4">
    <label for="validationServerUsername" class="form-label">用户名</label>
    <div class="input-group has-validation">
      <span class="input-group-text" id="inputGroupPrepend3">@</span>
      <input type="text" class="form-control is-invalid" id="validationServerUsername" aria-describedby="inputGroupPrepend3 validationServerUsernameFeedback" required>
      <div id="validationServerUsernameFeedback" class="invalid-feedback">
        请选择一个用户名。
      </div>
    </div>
  </div>
  <div class="col-md-6">
    <label for="validationServer03" class="form-label">城市</label>
    <input type="text" class="form-control is-invalid" id="validationServer03" aria-describedby="validationServer03Feedback" required>
    <div id="validationServer03Feedback" class="invalid-feedback">
      请提供一个正确的城市。
    </div>
  </div>
  <div class="col-md-3">
    <label for="validationServer04" class="form-label">武器</label>
    <select class="form-select is-invalid" id="validationServer04" aria-describedby="validationServer04Feedback" required>
      <option selected disabled value="">请选择...</option>
      <option>...</option>
    </select>
    <div id="validationServer04Feedback" class="invalid-feedback">
      请选择你日常使用的武器。
    </div>
  </div>
  <div class="col-md-3">
    <label for="validationServer05" class="form-label">邮编</label>
    <input type="text" class="form-control is-invalid" id="validationServer05" aria-describedby="validationServer05Feedback" required>
    <div id="validationServer05Feedback" class="invalid-feedback">
      请填写正确的邮编。
    </div>
  </div>
  <div class="col-12">
    <div class="form-check">
      <input class="form-check-input is-invalid" type="checkbox" value="" id="invalidCheck3" aria-describedby="invalidCheck3Feedback" required>
      <label class="form-check-label" for="invalidCheck3">
        同意条款和条件
      </label>
      <div id="invalidCheck3Feedback" class="invalid-feedback">
        你必须在提交前同意。
      </div>
    </div>
  </div>
  <div class="col-12">
    <button class="btn btn-primary" type="submit">提交表单</button>
  </div>
</form>

支持的元素

验证样式可用于以下表单控件和组件：

<input>s 和 <textarea>s 带有 .form-control（在输入组中最多包括一个 .form-control）
<select>s 与 .form-select
.form-checks

文本域

请在文本区输入消息。

选中此复选框

无效反馈文本示例

切换此单选框

或切换其他单选框

更多示例无效反馈文本

示例无效的选择反馈

无效的表单文件反馈示例

<form class="was-validated">
  <div class="mb-3">
    <label for="validationTextarea" class="form-label">文本域</label>
    <textarea class="form-control is-invalid" id="validationTextarea" placeholder="必填示例文本区域" required></textarea>
    <div class="invalid-feedback">
      请在文本区输入消息。
    </div>
  </div>

  <div class="form-check mb-3">
    <input type="checkbox" class="form-check-input" id="validationFormCheck1" required>
    <label class="form-check-label" for="validationFormCheck1">选中此复选框</label>
    <div class="invalid-feedback">无效反馈文本示例</div>
  </div>

  <div class="form-check">
    <input type="radio" class="form-check-input" id="validationFormCheck2" name="radio-stacked" required>
    <label class="form-check-label" for="validationFormCheck2">切换此单选框</label>
  </div>
  <div class="form-check mb-3">
    <input type="radio" class="form-check-input" id="validationFormCheck3" name="radio-stacked" required>
    <label class="form-check-label" for="validationFormCheck3">或切换其他单选框</label>
    <div class="invalid-feedback">更多示例无效反馈文本</div>
  </div>

  <div class="mb-3">
    <select class="form-select" required aria-label="下拉选择示例">
      <option value="">打开此选择菜单</option>
      <option value="1">三宝太监西洋记</option>
      <option value="2">三略</option>
      <option value="3">上古神话演义</option>
    </select>
    <div class="invalid-feedback">示例无效的选择反馈</div>
  </div>

  <div class="mb-3">
    <input type="file" class="form-control" aria-label="上传示例" required>
    <div class="invalid-feedback">无效的表单文件反馈示例</div>
  </div>

  <div class="mb-3">
    <button class="btn btn-primary" type="submit" disabled>提交表单</button>
  </div>
</form>

工具提示

如果您的表单布局允许，您可以将 .{valid|invalid}-feedback 类交换为 .{valid|invalid}-tooltip 类，以在样式化的工具提示中显示验证反馈。确保有一个带有 position: relative 的父级用于工具提示定位。在下面的示例中，我们的列类已经具有此功能，但您的项目可能需要其他设置。

姓名

字

用户名

城市

武器

邮编

<form class="row g-3 needs-validation" novalidate>
  <div class="col-md-4 position-relative">
    <label for="validationTooltip01" class="form-label">姓名</label>
    <input type="text" class="form-control" id="validationTooltip01" value="张辽" required>
    <div class="valid-tooltip">
      正确
    </div>
  </div>
  <div class="col-md-4 position-relative">
    <label for="validationTooltip02" class="form-label">字</label>
    <input type="text" class="form-control" id="validationTooltip02" value="文远" required>
    <div class="valid-tooltip">
      正确
    </div>
  </div>
  <div class="col-md-4 position-relative">
    <label for="validationTooltipUsername" class="form-label">用户名</label>
    <div class="input-group has-validation">
      <span class="input-group-text" id="validationTooltipUsernamePrepend">@</span>
      <input type="text" class="form-control" id="validationTooltipUsername" aria-describedby="validationTooltipUsernamePrepend" required>
      <div class="invalid-tooltip">
        请选择一个用户名。
      </div>
    </div>
  </div>
  <div class="col-md-6 position-relative">
    <label for="validationTooltip03" class="form-label">城市</label>
    <input type="text" class="form-control" id="validationTooltip03" required>
    <div class="invalid-tooltip">
      请提供一个正确的城市。
    </div>
  </div>
  <div class="col-md-3 position-relative">
    <label for="validationTooltip04" class="form-label">武器</label>
    <select class="form-select" id="validationTooltip04" required>
      <option selected disabled value="">请选择...</option>
      <option>...</option>
    </select>
    <div class="invalid-tooltip">
      请选择你日常使用的武器。
    </div>
  </div>
  <div class="col-md-3 position-relative">
    <label for="validationTooltip05" class="form-label">邮编</label>
    <input type="text" class="form-control" id="validationTooltip05" required>
    <div class="invalid-tooltip">
      请填写正确的邮编。
    </div>
  </div>
  <div class="col-12">
    <button class="btn btn-primary" type="submit">提交表单</button>
  </div>
</form>