Skip to content

表单校验

表单场景是盘古最为常用的场景,我们在使用表单时经常会需要进行表单项的校验工作,盘古平台除了为不同表单项组件提供一些内置的常见校验规则还提供了自定义表单项校验的能力,帮助用户更好的管理表单数据,避免脏数据的提交。

当用户的提交的数据没有通过校验规则,则会在表单项下方展示错误信息并阻止用户提交表单数据,效果如下所示:

校验设置

盘古平台提供两种表单设置方案,其设置方案分别如下所示。

注意

需要校验的表单需要放置到表单容器中。

内置校验规则

盘古平台为每个表单组件都内置了一些常用的校验规则,用户只要通过简单的设置并启用该规则就可以了,例如上面的姓名必填设置,我们通过如下配置便可轻松实现:

自定义校验规则

盘古内置的表单项校验方法难免会有覆盖不到的情况,因此盘古还为每个表单项组件增加了一个自定义规则设置的方案,通过函数来控制表单校验结果,函数参数value为表单填写内容,若校验不通过,可执行callback方法,方法参数为需要提示用户的校验失败信息,通过校验,可执行无参数的callback方法。

js
function validate(value, callback) {
  if (!value) return callback('必填');
  callback(); // 通过校验
}

例如我们需要校验一个文本输入框的内容是否以 "青岛"开头,可以通过如下方式:

API

表单校验除了在表单提交的时候进行校验,还能够在事件配置中进行手动触发。