Layui radio 的 title 属性无效是因为渲染时原生 input 被包裹进 .layui-radio 容器,原始 title 被丢弃;应使用 data-title 预埋,form.render('radio') 后通过 JS 将 title 补到 .layui-radio 上。

layui radio 的 title 属性为什么不起作用
直接给 <input type="radio"> 加 title 属性,在 Layui 表单中基本无效——Layui 渲染时会重写 DOM 结构,把原生 input 包进 <div class="layui-radio"> 里,原始 <code>title 被丢弃,浏览器 tooltip 自然不显示。
用 data-title + form.render 后手动补属性
这是最稳定、兼容性最好的方式,核心是:等 Layui 把 radio 渲染成最终 DOM 后,再给外层容器加 title。
- HTML 中用
data-title预埋提示文字:<input type="radio" name="type" value="1" data-title="选择后将启用自动同步"> - 表单初始化或动态插入后,必须调用
form.render('radio') - 紧接着执行 JS 补
title:layui.use(['form'], function(){ var form = layui.form; form.render('radio'); // 等渲染完成再操作 setTimeout(function(){ layui.$('input[name="type"]').each(function(){ var $this = layui.$(this); var title = $this.data('title'); if(title){ $this.closest('.layui-radio').attr('title', title); } }); }, 0); });
表格(table)里 templet 输出的 radio 怎么加提示
如果 radio 是在 Layui 表格列中用 templet 函数输出的(推荐做法),那它本质是原生标签,title 可以直接加在 <input> 上,但要注意时机和位置:
- 必须确保该列没配
type: 'radio',否则 Layui 会接管并清空你的属性 - 在
templet函数里输出时就带上:<input type="radio" name="select_row" value="'+ d.id +'" title="'+ (d.tip || '默认提示') +'"> - 仍需调用
form.render('radio'),否则 Layui 不识别这个 radio 组,事件和样式都不生效 - 注意:表格行内 DOM 在
done回调之后才稳定,若提示文字依赖后端字段,务必在done里统一补一次title,避免因异步导致部分缺失
别踩的坑:hover 提示不是万能的
原生 title 在移动端(尤其 iOS Safari、微信内置 WebView)默认不显示或延迟极高,且无法自定义样式。如果业务要求强提示,建议放弃 title,改用 lay-tips 或 hover 时浮层展示说明文案——但这需要额外引入 layer 或手写 tooltip 逻辑,和 radio 本身无关。真正容易被忽略的是:你加了 title,但没确认它到底附着在哪个 DOM 节点上;Layui 的 radio 外层容器层级多,错加在 input 上等于白加。


















