templet函数无法访问全局变量是因Layui将其包装为闭包且动态构造,仅接收data参数;正确方式是挂载window对象、使用函数体形式或闭包捕获变量,字符串模板则完全不可访问JS变量。

templet 函数里拿不到全局变量,是因为作用域隔离
Layui 的 templet 配置项实际会被包装进一个闭包函数执行,它默认只接收 data 参数(当前行数据),不自动继承外层作用域的变量。你写的 var myConfig = {…} 在 templet 函数内部根本看不见。
- 不是 layui “故意封掉”,而是它用
new Function('d', 'return ' + templetStr)动态构造渲染函数,天然没有词法作用域 - 哪怕你在
<script></script>标签顶部定义了window.myConfig,也得显式写window.myConfig才能访问,直接写myConfig会报ReferenceError - 别试
this.myConfig或layui.myConfig—— 它们和你的变量没关系
正确引用方式:用 window 显式挂载 + templet 内显式读取
最稳、最直白的做法就是把变量挂到 window 上,然后在 templet 字符串里老老实实写 window.xxx。
- 定义时:
window.tableOptions = { pageSize: 10, apiBase: '/api/v2/' }; - templet 中:
templet: function(d) { return '<button onclick="handleClick(' + d.id + ', window.tableOptions.apiBase)">编辑</button>'; } - 注意:如果变量是对象或数组,别直接拼进字符串,容易 JSON 转义出错;优先用函数体形式,而非字符串形式的 templet
- 字符串形式的 templet(如
templet: '<div>{{d.name}}</div>')完全无法访问任何 JS 变量,只能用 {{d.xxx}},别在这儿打 window 的主意
templet 函数体中传参比挂 window 更干净
如果你的变量是局部定义的(比如在 table.render() 外层函数里),直接把它作为闭包变量捕获,比塞 window 更安全、更易维护。
- 示例:
const apiHost = 'https://api.example.com'; table.render({ elem: '#demo', url: '/list', cols: [[ { field: 'name', title: '名称', templet: function(d) { return `<a href="https://www.php.cn/link/146777c25fa9755117e2a841be9f1c92">${d.name}</a>`; } } ]] }); - 关键点:这个
templet是个普通函数,不是字符串,所以能自然访问外层的apiHost - 避免把大对象或 DOM 节点传进去——templet 会为每行调用一次,频繁访问大对象可能影响渲染性能
用 lay-data 和事件委托替代部分变量依赖
很多场景下你以为要“引用全局变量”,其实只是想传点配置给按钮点击逻辑。这时候用 lay-data 属性 + 事件委托更解耦、更可控。
- templet 写成:
templet: '<button lay-data="{"type":"edit","host":"https://api.example.com"}" class="layui-btn">编辑</button>' - 然后统一绑定:
$(document).on('click', '.layui-btn', function() { const data = $(this).attr('lay-data'); const cfg = JSON.parse(data); ajax(cfg.host + '/edit'); }); - 好处:templet 纯静态,不依赖 JS 执行环境;配置随 HTML 走,调试时一眼可见;避免闭包内存泄漏风险
- 坑:
lay-data值必须是合法 JSON 字符串,单双引号要小心嵌套,建议用JSON.stringify()生成


















