Layui表单验证lay-verify如何绑定一个异步Ajax校验函数

浅静大大_1190

浅静大大_1190

2026-06-05

545人浏览

原创

必须用 form.verify() 注册同步规则,再通过 form.on('submit') 拦截提交并手动发起异步请求,校验通过后调用 data.form.submit() 触发原生提交,避免死循环。

layui表单验证lay-verify如何绑定一个异步ajax校验函数

lay-verify 怎么绑定自定义异步校验函数

不能直接在 lay-verify 属性里写异步逻辑,Layui 的内置验证是同步的。必须用 form.verify() 注册一个带 Ajax 的规则,再在表单元素上通过 lay-verify="yourRuleName" 引用。

  • 异步校验必须手动调用 layui.form().verify() 或触发 form.on('submit') 时由框架自动调用
  • 注册的函数接收两个参数:value(当前输入值)和 item(DOM 元素),返回 undefined 表示通过,返回字符串表示错误提示
  • 注意:函数体内部不能直接 return 错误信息,因为 Ajax 是异步的 —— 必须用 return false 阻止默认提交,并在回调里用 form.msg() 或操作 DOM 显示提示

为什么 form.verify() 里的异步函数不生效

因为 form.verify() 期望的是同步返回,你放个 $.ajax() 进去,函数立刻执行完并返回 undefined,校验就“通过”了,根本等不到请求回来。

  • 真实场景中,常见错误是这样写:form.verify({ checkUser: function(value) { $.get('/api/check', {u: value}, ...) } }) —— 这毫无校验效果
  • 正确做法是:把表单提交拦截下来,在回调里手动判断并调用 form.msg() 或 layer.msg() 提示,再决定是否允许提交
  • Layui 2.8+ 支持 form.on('submit') 中用 return false 阻止提交,这是唯一可控的时机

实际可运行的异步校验写法(含防重复提交)

核心思路:禁用提交按钮 → 发起请求 → 根据响应决定是否恢复按钮或跳转。

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

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

下载
form.on('submit(login)', function(data){
  var btn = $(this).find('button[type="submit"]');
  btn.prop('disabled', true).text('校验中...');
  
  $.post('/api/check-username', { username: data.field.username }, function(res){
    if(res.code === 0) {
      // 校验通过,继续提交
      layer.msg('用户名可用');
      // 注意:这里不能直接 submit(),会死循环,应改用原生 form.submit()
      data.form.submit();
    } else {
      layer.msg(res.msg || '用户名已存在');
      btn.prop('disabled', false).text('立即登录');
      // 手动聚焦到出错字段
      $('input[name="username"]').focus();
    }
  }).fail(function(){
    layer.msg('网络异常');
    btn.prop('disabled', false).text('立即登录');
  });
  
  return false; // 阻止默认提交
});
  • 不要依赖 lay-verify 自动触发异步,它压根不支持
  • data.form.submit() 是原生 DOM 表单对象,避免再次触发 layui 的 submit 监听
  • 务必加按钮禁用和文字反馈,否则用户可能连点多次,后端收到重复请求
  • 服务端返回格式建议统一为 {code: 0, msg: ''},前端只关心 code

兼容性与性能注意点

Layui 本身不处理 Promise,也不支持 async/await 写法;所有 Ajax 必须用 jQuery 的回调风格。

  • 如果项目已升级 jQuery 3.0+,注意 .success() 已废弃,一律用 .done() + .fail()
  • 移动端需额外加防抖:连续快速点击提交,可能触发多个并发请求,后端需幂等设计或前端加锁变量
  • 校验接口响应时间超过 1.5s,用户大概率会失去耐心,建议加 loading 动画或超时提示(timeout: 3000)
  • 不要在 form.verify() 里做任何异步操作,这个函数只适合放正则、长度、必填等同步检查

真正难的不是写 Ajax,而是把「异步结果」和「表单提交生命周期」对齐——Layui 没给你留钩子,只能自己接管 submit 事件,这点很容易被忽略。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.08.11

2303

5

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

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

2023.10.09

4983

6

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

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

2024.03.19

6070

13

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

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

2024.03.22

5578

10

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

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

2024.05.22

783

5

ajax教程
ajax教程

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

2023.06.14

2600

4

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

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

2023.08.31

340

5

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

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

2023.11.15

2433

5

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

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

2024.09.24

1141

6

热门下载

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

精品课程

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

共87课时 | 12.7万人学习

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

共89课时 | 11万人学习

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

共5课时 | 1.6万人学习