lsm/layui

mirror of https://gitee.com/layui/layui.git synced 2025-10-26 10:49:18 +08:00

Files

2023-05-03 17:17:39 +08:00

title, toc

title	toc
📑 Layui 2.8 《升级指南》	false

📑 Layui 2.8 《升级指南》

Layui 2.8 总体向下兼容，但仍有以下变更需要注意：

2.8 剔除了 ~~layedit~~ 组件，若是之前用到该组件的，注意采用第三方成熟富文本组件替换，详见：#I5JSE3
2.8 调整了 table 的 page,limit 属性，当 page 未开启时，则默认不再向后端传递这两个参数
2.8 调整了 table 的特定属性名。序号: LAY_INDEX → LAY_NUM；下标: LAY_TABLE_INDEX → LAY_INDEX，若是之前用到这几个特定属性，需更换为新版名称。
2.8 调整了 checkbox 的 lay-skin 属性默认为原始风格，原来的标签风格可通过 lay-skin="tag" 来设置。
2.8 调整了 checkbox 的私有属性 lay-text，采用统一的 title 属性替代
2.8 调整了 util.fixbar 的 showHeight 属性名称为 margin

2.8 对 2.7.6 最友好，可直接覆盖升级，只需按照上述提到的几点进行适配即可。

该跨度相对较大，主要是中间的 2.6.11 和 2.7.x 的几处调整要适配，包括：

重要：2.6.11 调整了 laytpl 的 {{ d.field }} 标签的输出为默认开启编码。即与 {{= d.field }} 等同。因此，若输出内容包含 HTML 且需要正常渲染的，需采用 {{- d.field }} 的标签语句。详细可参考：#I5AXSP
2.6.11 调整了 table 组件的 escape 属性默认为 true，即默认开启编码功能（之前默认为 false）
2.7.5 调整了 table 表头的 edit 属性，支持函数写法，且单元格是否编辑不再以 <td> 标签上的 data-edit 属性为准，而是统一以 cols 属性中的 edit 属性为准，详细可参考新版文档关于 edit 的用法：https://layui.dev/docs/table/#cols.edit

若当前用的版本低于 2.6.0，一般不建议升级。但如果非升级不可，除了结合上述提到的变更外，还要重点参考 2.6.0 的更新日志中提到的「重要提示」进行适配：https://layui.dev/2.7/docs/base/changelog.html#2.6.0

同时，还要特别注意，2.6.0 之前的版本是按需加载内置组件，从 2.6.0 开始，统一构建到 layui.js 中。因此，要注意下之前引入的 JS 业务代码的放置位置，若是放在 <head> 区域，需调整放置到 <body> 标签内部的尾端。

主要还是根据当前主题中所用的 Layui 的版本，进行对应的适配，尤其是单页版中的动态模板，需按照前面提到的 laytpl 的调整进行修改。具体也可以参考：#I65D80

若按照以上调整后仍然存在兼容性问题，也可以详细阅读过往所有版本的更新日志： https://layui.dev/docs/versions.html

或新建 Issue 进行详细反馈。