- 发布：2023-05-07 -
- -随着 Layui `2.8` 的发布，以及官方新文档站的归来 ([**https://layui.dev**](//layuion.com))，为了保证 Layui 文档的及时性和权威性，我们郑重呼吁第三方单位或个人停止搭建 Layui 文档镜像站点，这不仅严重侵害 Layui 维护团队的基本权益，更严重影响开发者在使用 Layui 时可能造成的一系列信息不对称问题。过去两年，第三方镜像站点已经造成诸多弊端，譬如镜像文档与实际使用版本的出入问题，无形之中给维护团队增加了与使用者的 `Issue` 沟通成本和障碍。 - -我们再次重申《[**Layui 新版文档站上线初衷**](https://layui.dev/docs/@note/2.8/news.html)》中的观点：**此次重新上线的新版文档站，旨在为 Layui 开发使用者提供一个新的精神「基站」，并能够在第一时间获悉版本的最新动态与及时的文档内容**，不至于造成信息的混乱。同时，也是希望通过官方文档站的流量，在日后也能为创作团队支撑一丝基本的日常开支。希望第三方尊重创作者的劳动成果，一起守望好这来之不易的坚持。 - -也请大家以官方文档为准，避免可能造成的信息差异。 - -Layui · 2023.05.07 - ---- - - \ No newline at end of file diff --git a/docs/@note/2.8/news.md b/docs/@note/2.8/news.md deleted file mode 100644 index 83fa8b11..00000000 --- a/docs/@note/2.8/news.md +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: 🚀 Layui 2.8.0 正式发布，全新文档站朴实归来 -toc: false -editable: false ---- - -# 🚀 Layui 2.8.0 正式发布，全新文档站朴实归来 - -- 发布：2023-04-24 -
- -我们终于迎来了 Layui `2.8.0` 的正式版本，以及全新的文档站。 - -在 Layui 过往七年的开源历程中，从未用多达**二十个预览版**去为一个正式版而引路。 显然，`2.8.0` 是 Layui 一次朴实的回归，更是情怀的延续。但却并不是想以此呼吁人们重新去选择它，我们仍然坚持两年前那则《[Layui 原官网下线公告](https://unpkg.com/outeres@0.0.7/img/layui/notice-2021.png)》中的观点， _即仍然推荐大家去拥抱主流，始终保持对前沿技术的无限热爱，是开发者们都应具备的思维属性_。 **而 Layui 所做的，是为填补主流之外的那些略显狭小的空隙**。 - -Layui 虽不是前端主流，但也早已不是作者个人的 Layui，而是所有仍在坚持使用它的人的 Layui，它仍然支撑着许多项目，也代表着许多人的工作，作为开源创作者的我们，应该要为这些坚持者而守望。 - -### 新文档站 - -2021 年 Layui 原官网下线后，互联网出现了许多第三方的 Layui 文档镜像站，这在当时，给大家能继续阅读文档确实提供了便利，但原官网的下线，只是单纯一个网站自身生命周期的结束，它并不意味着 Layui 这样一个开源项目的停更，这在公告中也有清晰的阐述。但或许是由于那则公告的用词过于「悲壮」，使得各大自媒体有所误读，从而让大家都以为是 Layui 停更了。 事实上，自那以后，Layui 仍然在 Github 和 Gitee 保持活跃，并不存在所谓的停止更新，甚至从 `2.6.9` 一直迭代到今天的最新版本，而现存的第三方文档镜像站点的内容却仍然定格在 Layui `2.6.8` 的版本，已严重滞后于 Layui 的当前版本，显然是不利于开发者们对 Layui 的应用。 两年来，Layui 始终处于没有中心文档的窘迫境地，虽然也一度以 **Gitee Pages** 为文档的承载，但似乎很难形成一个焦点和归属感。 随着 `2.8.0` 正式版本的发布，它所包含的上百项的内容更新，使得全新的文档站呼之欲出。 - -此次上线的新版文档站，旨在为朴实归来的 Layui 提供一个新的精神「基站」，它基于 laytpl 和 markdown 驱动，在版面上进行了大量优化，内容重新编写、力求精简，以辅助大家更好地使用 Layui。 同时，Layui 文档也已和 Layui 本身一同开源在项目中，以供大家在线和离线都能阅读以及协同维护。 - -- **文档协作:** https://github.com/layui/layui/tree/2.x/docs -- **文档阅读:** https://layui.dev - ---- - - diff --git a/docs/@note/2.8/upgrade-guide.md b/docs/@note/2.8/upgrade-guide.md deleted file mode 100644 index 5f530fa2..00000000 --- a/docs/@note/2.8/upgrade-guide.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: 📑 Layui 2.8 《升级指南》 -toc: false ---- - -# 📑 Layui 2.8 《升级指南》 - -Layui `2.8` 总体向下兼容，但仍有以下变更需要注意： - -1. `2.8` 剔除了 ~~layedit~~ 组件，若是之前用到该组件的，注意采用第三方成熟富文本组件替换，详见：#I5JSE3 -1. `2.8` 调整了 `table` 的 `page,limit` 属性，当 `page` 未开启时，则默认不再向后端传递这两个参数 -1. `2.8` 调整了 `table` 的特定属性名。序号: `LAY_INDEX` → `LAY_NUM`；下标: `LAY_TABLE_INDEX` → `LAY_INDEX`，若是之前用到这几个特定属性，需更换为新版名称。 -1. `2.8` 调整了 `checkbox` 的 `lay-skin` 属性默认为原始风格，原来的标签风格可通过 `lay-skin="tag"` 来设置。 -1. `2.8` 调整了 `checkbox` 的私有属性 `lay-text`，采用统一的 `title` 属性替代 -1. `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` 的几处调整要适配，包括： -{{! -1. **重要**：`2.6.11` 调整了 `laytpl` 的 `{{ d.field }}` 标签的输出为默认开启编码。即与 `{{= d.field }}` 等同。因此，若输出内容包含 `HTML` 且需要正常渲染的，需采用 `{{- d.field }}` 的标签语句。详细可参考：#I5AXSP -1. `2.6.11` 调整了 `table` 组件的 `escape` 属性默认为 `true`，即默认开启编码功能（之前默认为 `false`） -1. `2.7.5` 调整了 `table` 表头的 `edit` 属性，支持函数写法，且单元格是否编辑不再以 `