lay-verify属性值必须与form.verify定义的key严格一致,大小写、拼写、下划线均不可有误;value为字符串值,item为DOM对象;数组式写法仅支持正则匹配,函数式可动态校验;自定义验证需return false才能屏蔽默认tips提示。
lay-verify 属性值必须和 form.verify 定义的 key 严格一致
这是最容易卡住的地方:你在 input 上写 lay-verify="mobile",但 form.verify 里定义的是 phone,验证就完全不会触发。layui 不做模糊匹配,大小写、下划线、拼写差一个字符都不行。
常见错误现象包括:表单提交时毫无反应、不报错也不放行、控制台无报错但验证逻辑没执行。
- 检查
lay-verify值是否拼写正确(比如写成moblie) - 确认
form.verify是在layui.use(['form'], function(){...})内部调用的,不能放在外部或 DOM 加载前 - 确保表单有
class="layui-form",否则模块不会自动绑定事件
自定义规则函数中 value 和 item 的实际用途
value 是当前输入框的字符串值(永远是 string 类型,哪怕 type="number");item 是该 input 元素的原生 DOM 对象,可用于获取 name、dataset 或定位父级容器。
例如需要限制「用户名不能以数字开头」又想复用同一套规则到多个字段,可以这样写:
form.verify({
username: function(value, item) {
if (!/^[a-zA-Z\u4e00-\u9fa5]/.test(value)) {
return '用户名必须以字母或汉字开头';
}
if (value.length 16) {
return '长度应在 2–16 个字符之间';
}
}
});
注意:函数必须返回字符串才视为校验失败;返回 undefined 或空字符串则表示通过。
数组式写法比函数式更轻量,但无法动态判断
如果你只需要纯正则匹配(比如密码强度、身份证号格式),直接用数组形式更简洁,也避免了函数作用域问题:
form.verify({
idcard: [/^[1-9]\d{5}(18|19|20)\d{2}((0[1-9])|(1[0-2]))(([0-2][1-9])|10|20|30|31)\d{3}[0-9Xx]$/, '身份证号码格式不正确'],
pass: [/^[\S]{8,16}$/, '密码需为8–16位,且不能含空格']
});
这种写法的限制很明显:
- 无法读取其他字段值(比如“确认密码”需与“密码”比对)
- 无法根据
item获取额外属性(如 data-min-length) - 正则失败时提示固定,不能按不同条件返回不同文案
验证失败后默认提示位置不可靠,需手动干预
Layui 的 tips 提示默认贴在 input 右侧,但在 flex 布局、响应式栅格或浮动元素中极易错位甚至消失。它不计算父容器 overflow、z-index 或 transform 影响。
真正稳定的方案是主动调用 layer.msg 或 layer.alert 并返回 false 阻止默认提示:
form.verify({
integer: function(value) {
if (!/^[1-9]\d*$/.test(value)) {
layer.msg('请输入正整数', {icon: 5});
return false; // 关键:必须 return false 才能屏蔽默认提示
}
}
});
这里容易忽略的一点是:return false 和 return '提示文字' 效果完全不同——前者只阻止默认行为,后者还会触发 tips 显示。所以想完全接管提示,必须用 false。











