/ 前言 /
两年前 Layui 官网宣布了下线声明,说实话当时内心确实感慨万千毕竟这个免费为我们后端程序员提供的一个前端快熟开发框架的官网就这样下线了确实十分的惋惜,但是庆幸的是官网的下线,只是单纯一个网站自身生命周期的结束,它并不意味着 Layui 这样一个开源项目的停更,Layui 仍然在 Github 和 Gitee 保持活跃,并不存在所谓的停止更新,甚至从 2.6.9 一直迭代到今天的最新版本。两年来,Layui 始终处于没有中心文档的窘迫境地,虽然也一度以 Gitee Pages 为文档的承载,但似乎很难形成一个焦点和归属感。随着 2.8.0 正式版本的发布,它所包含的上百项的内容更新,使得全新的文档站呼之欲出。Layui 新官网于 2023年4月 Layui 2.8.0 正式发布,全新文档站朴实归来。
/ Layui 过往七年的开源历程 /
作者心声:Layui 虽不是前端主流,但也早已不是作者个人的 Layui,而是所有仍在坚持使用它的人的 Layui,它仍然支撑着许多项目,也代表着许多人的工作,作为开源创作者的我们,应该要为这些坚持者而守望。
在 Layui 过往七年的开源历程中,从未用多达二十个预览版去为一个正式版而引路。显然,2.8.0 是 Layui 一次朴实的回归,更是情怀的延续。但却并不是想以此呼吁人们重新去选择它,我们仍然坚持两年前那则《Layui 原官网下线公告》中的观点, 即仍然推荐大家去拥抱主流,始终保持对前沿技术的无限热爱,是开发者们都应具备的思维属性。而 Layui 所做的,是为填补主流之外的那些略显狭小的空隙。
/ 新文档站 /
此次上线的新版文档站,旨在为朴实归来的 Layui 提供一个新的精神「基站」,它基于 laytpl 和 markdown 驱动,在版面上进行了大量优化,内容重新编写、力求精简,以辅助大家更好地使用 Layui。同时,Layui 文档也已和 Layui 本身一同开源在项目中,以供大家在线和离线都能阅读以及协同维护。
文档协作: https://github.com/layui/layui/tree/2.x/docs
文档阅读: https://layui.dev
/ Layui 2.8 升级指南 /
Layui 2.8
总体向下兼容,但仍有以下变更需要注意:
2.8
剔除了 layedit 组件,若是之前用到该组件的,注意采用第三方成熟富文本组件替换,详见:#I5JSE32.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.7.6 升级到 2.8
2.8
对 2.7.6
最友好,可直接覆盖升级,只需按照上述提到的几点进行适配即可。
2.6.x 升级到 2.8
该跨度相对较大,主要是中间的 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
的用法:https://layui.dev/docs/table/#cols.edit
2.6.0 以下版本 升级到 2.8
若当前用的版本低于 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>
标签内部的尾端。
layuiAdmin 主题升级 Layui 到 2.8
主要还是根据当前主题中所用的 Layui 的版本,进行对应的适配,尤其是单页版中的动态模板,需按照前面提到的 laytpl
的调整进行修改。具体也可以参考:#I65D80
其他细节
若按照以上调整后仍然存在兼容性问题,也可以详细阅读过往所有版本的更新日志:https://layui.dev/docs/versions.html
/ 极简模块化 Web UI 组件库 /
学习是一个永无止境的过程,你知道的越多,你不知道的也会越多,在有限的时间内坚持每天多学一点,你一定能成为你想要成为的那个人。不积跬步无以至千里,不积小流无以成江河!!!
![bedfc4a7656b6d2e31cdba0ce4ecdb39.gif](https://img-blog.csdnimg.cn/img_convert/bedfc4a7656b6d2e31cdba0ce4ecdb39.gif)