直接 return 字符串会触发 layer.tips 气泡提示,无法实现输入框下方红字效果;需返回 false 阻止提交,并手动在 .layui-form-item 内插入 .layui-form-error 元素来显示红字。

默认情况下,Layui 表单验证失败时若返回字符串(如 return '不能为空'),会触发内置的 layer.tips 气泡提示,而不是在输入框下方显示红字。要实现「不弹气泡、只在下方显示红字」,必须绕过 Layui 的默认提示机制,手动控制 DOM 插入和样式。
为什么直接 return 字符串不行
Layui 的 form.verify 中返回非空字符串,会自动调用 layer.tips() 显示浮动提示——它不插入 DOM、不加类、不控制位置,和「下方红字」完全无关。即使你写了 lay-vertype="tips" 或改了 CSS,也改变不了这个行为。
- 返回字符串 → 触发
layer.tips→ 浮动气泡(不可控位置) - 返回
false→ 阻止提交,但不触发任何提示 → 你需要自己加红字 - 返回
undefined或true→ 视为通过 → 无反馈
如何在 input 正下方插入红字提示
核心是:拦截默认提示,用 jQuery 在 .layui-form-item 末尾插入一个 <div class="layui-form-error">,并控制显隐。前提是该容器已设 <code>position: relative(Layui 默认已设)。
- HTML 中每个需要验证的
<input>必须包裹在<div class="layui-form-item"> 内,这是定位锚点 <li>在 <code>form.verify规则里,对失败字段手动插入提示:$(elem).closest('.layui-form-item').append('<div class="layui-form-error">用户名不能为空</div>') - 添加 CSS:
.layui-form-error { color: #ff5722; font-size: 12px; margin-top: 4px; line-height: 1; } - 每次校验前先清理旧提示:
$(elem).closest('.layui-form-item').find('.layui-form-error').remove() - 提交时:
form.on('submit(filter)', function(data){ ... })内统一校验并插入/清理 - 失焦时:
form.on('change', 'input[name][lay-verify]', function(data){ ... })中调用同一套逻辑 - 每次插入前先
.remove()所有.layui-form-error,避免重复叠加 - 不要用
layer.close()或操作layer实例——它和红字无关
怎么确保红字只在验证失败时出现、通过时消失
不能依赖 form.on('submit') 单点触发——用户可能反复修改、失焦再提交。得把清理 + 插入逻辑封装成函数,在多个时机调用:
真正容易被忽略的是:动态渲染的表单(比如 tab 切换后加载的)必须在 form.render() 后再绑定 change 事件,否则失焦监听失效;另外,elem 是可靠参数,别用 $('input[name=xxx]') 查找,否则多实例下会错位。


















