2.8+
是指 2.8.0 及其以上版本,涵盖了 2.8.x 和 2.9.x,但低于 3.0。
2.8
剔除了 2.8
调整了 table
的 page,limit
属性,当 page
未开启时,则默认不再向后端传递这两个参数2.8
调整了 table
的特定属性名。序号: LAY_INDEX
→ LAY_NUM
;下标: LAY_TABLE_INDEX
→ LAY_INDEX
,若是之前用到这几个特定属性,需更换为新版名称。2.8
调整了 form
内置规则,除 required
规则外,其他内置规则不再强制必填。如需保留必填,可叠加 required
规则,如: lay-verify="required|number"
,可参考:#lay-verify。2.8
调整了 checkbox
的 lay-skin
属性默认为原始风格,原来的标签风格可通过 lay-skin="tag"
来设置。2.8
调整了 checkbox
的私有属性 lay-text
,采用统一的 title
属性替代2.8
调整了 util.fixbar
的 showHeight
属性名称为 margin
该跨度相对较大,主要是中间的 2.6.11
和 2.7.x
的几处调整要适配,包括:
2.6.11
调整了 laytpl
的 {{ d.field }}
标签的输出为默认开启编码。即与 {{= d.field }}
等同。因此,若输出内容包含 HTML
且需要正常渲染的,需采用 {{- d.field }}
的标签语句。详细可参考:#I5AXSP2.6.11
调整了 table
组件的 escape
属性默认为 true
,即默认开启编码功能(之前默认为 false
)2.7.5
调整了 table
表头的 edit
属性,支持函数写法,且单元格是否编辑不再以 <td>
标签上的 data-edit
属性为准,而是统一以 cols
属性中的 edit
属性为准,详细可参考新版文档: #edit 的用法
若当前用的版本低于 2.6.0
,一般不建议升级。但如果非升级不可,除了结合上述提到的变更外,还要重点参考 2.6.0
的更新日志中提到的「重要提示」进行适配:#2.6.0 更新日志
同时,还要特别注意,2.6.0
之前的版本是按需加载内置组件,从 2.6.0
开始,统一构建到 layui.js
中。因此,要注意下之前引入的 JS
业务代码的放置位置,若是放在 <head>
区域,需调整放置到 <body>
标签内部的尾端。
主要还是根据当前主题中所用的 Layui 的版本,进行对应的适配,尤其是单页版中的动态模板,需按照前面提到的 laytpl
的调整进行修改。具体也可以参考:#I65D80
若按照以上调整后仍然存在兼容性问题,也可以详细阅读过往所有版本的:更新日志
或新建 Issue
进行详细反馈。