列配置中 event 字段仅对内置工具栏生效,普通列需用 templet 返回含 lay-event 的 HTML,并通过 table.on('tool(表ID)') 监听;跳转前须校验 ID、编码参数、用 window.open 安全打开。
列配置里写 event: 'xxx' 为什么没反应
因为 event 字段只对内置工具栏(比如 toolbar 模板里的按钮)生效,对普通数据列完全无效。你写了 event: 'navigate',但点击单元格时什么都不会触发——layui 根本不监听这个字段。
真正起作用的是在列的 templet 中手动插入带 lay-event 属性的 DOM 元素,并配合 table.on('tool(表ID)', callback) 监听。必须这么走,没有捷径。
- 列定义里加
event是常见误解,删掉它 - 如果列内容是纯文本(比如直接写
field: 'name'),lay-event不会被识别,必须用templet返回 HTML 片段 -
templet返回的元素必须有lay-event="xxx",且该xxx要和table.on('tool(表ID)')中的事件名一致
templet 里怎么拼跳转链接才安全
别直接写 window.location.href = '/detail?id=' + obj.data.id —— ID 为空、含特殊字符、XSS 注入风险全在这儿。Layui 不做任何过滤,全靠你自己兜底。
- 先校验主键存在:
if (!obj.data.id) return ''; - 用
encodeURIComponent编码参数:const url = '/detail?uid=' + encodeURIComponent(obj.data.id); - 优先用新窗口打开:
window.open(url, '_blank');,避免用户丢失当前表格页 - 不要依赖
obj.tr.find('td').eq(n)这类 DOM 查找,容易因列顺序变化或渲染延迟出错;始终用obj.data取值
如何监听并处理跳转事件
监听必须写在 table.render() 的 done 回调里,或者确保 DOM 已渲染完成。直接在页面加载完就绑 on('tool(...),大概率失效,因为表格还没画出来。
- 监听写法:
table.on('tool(test)', function(obj){ ... });,其中test是你表格容器的id(即elem: '#test'的值) - 在
templet中这样写:templet: function(d) { return '<a lay-event="goto-detail">' + (d.title || '无标题') + '</a>'; } - 回调里判断:
if (obj.event === 'goto-detail') { window.open('/detail?uid=' + encodeURIComponent(obj.data.id), '_blank'); } - 移动端需加 CSS:
td { touch-action: manipulation; },防止双击缩放干扰点击
跳转前容易被忽略的三个细节
不是所有跳转都“点一下就完事”。实际项目中,这三个点漏一个,用户就会卡住或跳错页。
- ID 字段名未必叫
id,可能是user_id、code或其他,务必核对后端返回字段和前端obj.data键名是否一致 - 如果表格启用了分页,但跳转目标页依赖当前行数据,注意
obj.data是缓存数据,不是实时从服务端拉的最新值;如有强一致性要求,得额外发请求 - 多个跳转列共用同一事件名(如都用
lay-event="navigate")时,靠data-属性区分目标页类型更稳妥:<a lay-event="navigate" data-type="user" data-id="{{d.id}}">...</a>











