layui表单怎么添加自定义验证规则

梦婷大大_4161

梦婷大大_4161

2026-08-17

362人浏览

原创

form.verify()规则必须在layui.use(['form'], function(){})回调内注册,否则因异步加载失效;规则名不可与内置required、phone等重名;正则须用字面量而非字符串;提示文案不能为空;跨字段校验需手动取值并同步状态。

layui表单怎么添加自定义验证规则

form.verify() 注册规则必须写在 layui.use 里

直接写 form.verify({ ... }) 但没包在 layui.use(['form'], function(){ ... }) 回调中,规则根本不会生效。Layui 的模块加载是异步的,form 实例还没就位,注册等于白写。

常见错误现象:页面刷新后验证没反应、控制台无报错、自定义规则函数压根不执行。

  • 必须确保 layui.use 的依赖数组包含 'form'
  • 注册要放在回调函数内部,且通常在 form.render() 之前(除非是动态插入的表单)
  • 如果用了模块按需加载(比如只引入了 laydate 没引 form),layui.form 会是 undefined,直接报错

规则名不能和内置规则重名

比如你写 form.verify({ phone: function(){...} }),Layui 会直接走它自己的 phone 校验逻辑,你的函数永远不会被调用——它根本不会进你注册的这个函数。

内置规则列表(v2.8+):required、phone、email、url、number、date、identity、pass。这些名字全部保留,碰都不能碰。

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
  • 想校验手机号但要兼容带空格或括号?改用 mobile 或 myPhone
  • 想覆盖 required 提示文案?注册 required 规则即可,它会覆盖内置行为(此时 lay-reqtext 失效)
  • 规则名建议加业务前缀,比如 orderAmount、couponCode,避免后期冲突

正则写法必须是字面量,不能是字符串

lay-verify 属性里写正则毫无作用,它只认规则名;而你在 form.verify() 里传正则,必须是 /^[a-z0-9]+$/ 这种字面量形式,写成 "^[a-z0-9]+$" 就会被忽略,校验永远通过。

示例正确写法:

form.verify({
  username: [/^[a-z0-9_]{3,16}$/, '用户名只能是小写字母、数字、下划线,且3–16位']
});
  • 正则字面量里如果有变量(比如动态长度),得用 new RegExp('^\w{' + minLen + ',' + maxLen + '}$'),注意双反斜杠转义
  • 提示文案不能为空字符串或 undefined,否则失败时不显示任何提示
  • 注册后记得调用 form.render(),特别是 Ajax 动态插入的表单

联动校验必须手动取值,不能靠 lay-verify="a b" 自动关联

“确认密码”要和“密码”字段比对,这种跨字段逻辑,lay-verify="required repass" 只是绑定规则名,具体怎么取另一个字段的值、怎么比,全得你写在规则函数里。

关键点不是“怎么比”,而是“怎么安全地取”:

  • 用 layui.$ 而不是全局 $,避免 jQuery 冲突
  • 取值写成 layui.$('[name="password"]').val(),别用 document.querySelector 后再 .value,容易因渲染时机出错
  • 函数返回 undefined 表示通过,返回字符串(如 '两次输入不一致')才报错;返回 true 或 false 都无效
  • 主字段(如密码)修改时,应主动清掉确认密码字段的 layui-form-danger 类并触发 blur,否则状态不同步
真正麻烦的不是写函数,是字段间状态同步和 DOM 渲染时机——这两个地方一松懈,就会出现“明明改了密码,确认框还显示绿色对勾”的问题。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2363

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

5123

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6190

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

5738

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

803

5

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2680

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

340

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

2513

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1141

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 12.8万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习