Layui表单input框如何实现失焦自动校验并显示错误边框

阿婷小哥_1660

阿婷小哥_1660

2026-06-27

210人浏览

原创

失焦校验需用Layui封装的form.on('change')而非原生blur,自定义规则必须返回错误字符串才能触发lay-form-danger类和红边框,且input须有name属性、正确声明lay-verify规则并调用form.render('input')。

失焦时触发校验但不依赖原生 blur 事件

直接给 input 绑定原生 blur 并调用 form.verify() 会失败——因为 layui 的验证逻辑依赖表单内部状态同步,而原生事件绕过了它的事件通道,导致 lay-form-danger 类不添加、提示不显示、甚至后续 form.val() 仍返回旧值。

正确路径是走 Layui 封装的 form.on('change', selector, fn):它在用户失焦且值实际变化时触发,天然契合“失焦即校验”场景,且与内部校验链路完全对齐。

  • 必须用 data.elem 获取 DOM 元素,避免 this 指向错乱
  • 不要在回调里手动加 lay-form-danger 类——Layui 会在校验失败后自动添加
  • 若需对所有带校验的 input 统一处理,用属性选择器:form.on('change', 'input[name][lay-verify]')

form.verify() 中如何让失焦校验生效并显示边框

Layui 默认只在 form.on('submit') 或用户主动点击提交时才执行完整校验流程。要让失焦时也触发样式反馈(如红色边框),关键是在 form.verify 规则中**显式返回错误字符串**,而非仅做逻辑判断。

例如定义一个长度校验规则:

form.verify({
  maxlength: function(value, item) {
    const max = parseInt(item.getAttribute('lay-maxlength') || '0');
    if (max > 0 && value.length > max) {
      return '超出最大长度限制'; // ← 必须返回字符串,否则无提示、无边框
    }
  }
});

再配合 HTML 中声明该规则:

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

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

下载
<input name="title" lay-verify="required|maxlength" lay-maxlength="20">
  • 返回 undefined 或 true 表示通过,不会加红边框
  • 返回非空字符串才会触发 lay-form-danger 类和右侧图标
  • 注意:内置规则如 required 自带提示,但自定义规则必须手动返回提示文本

为什么 form.on('change') 后没看到红边框?常见漏点

即使绑了 form.on('change') 且规则返回了错误字符串,仍可能看不到红边框——大概率是以下三处之一没到位:

  • 没调用 form.render('input'):动态插入或 JS 创建的 input,必须显式渲染才能启用 Layui 的事件和样式绑定
  • input 缺少 name 属性:Layui 的 form.verify 和 form.on('change') 都依赖 name 定位字段,无 name 则整个校验链路失效
  • 校验规则名拼写错误或未在 lay-verify 中声明:比如写了 form.verify({ phoneRule: ... }),但 HTML 写的是 lay-verify="phone",两者不匹配就等于没挂上规则

多个 tab 页中失焦校验只作用于当前页

当表单分散在多个 element.tab 标签页里,全局监听 form.on('change') 会导致非激活页的 input 也被校验,干扰用户体验,甚至触发错误滚动。

解决方法是限定事件作用域:不用全局选择器,改用当前激活面板下的子元素。

  • 先获取当前显示的 tab 面板:const $active = $('.layui-tab-content .layui-show');
  • 再在该容器内初始化表单事件:form.on('change', $active.find('input[name][lay-verify]').selector, ...)(注意:.selector 是 jQuery 提供的字符串形式选择器)
  • 更稳妥的做法是为每个 tab 面板加唯一 id,并在 form.on 的 selector 中直接写死范围,如 #tab-user input[name][lay-verify]

动态 tab 渲染后,记得在 tabs.on('tab') 回调里重新执行 form.render('input') 和事件绑定,否则新 tab 的 input 失焦不会触发任何校验。

相关文章

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

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

下载

相关标签:

layui

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

相关专题

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

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

2023.08.11

2643

5

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

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

2023.10.09

5723

6

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

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

2024.03.19

6710

13

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

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

2024.03.22

6418

10

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

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

2024.05.22

903

5

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

2023.10.23

4331

6

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

2024.03.06

7548

6

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

2025.12.30

834

19

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

2025.12.30

714

12

热门下载

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

精品课程

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

共87课时 | 13万人学习

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

共89课时 | 11.3万人学习

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

共5课时 | 1.6万人学习