lazyswitch

LazySwitch 让多页也可以像单页一样做页面切换动画
GitHub Pages: https://github.com/fengshangbin/LazySwitch

现实问题

单页 VS 多页
1, 单页可以在切换视图时使用酷炫的过度动画，但会所有内容放在一个页面会增加开发难度，同时会消耗很多实际没用到的网络流量，如果内容是动态生成的如博客的博文，就很难做单页了。
2，多页传统模式，不支持页面切换动画。

关于 LazySwitch

LazySwitch 是一个 js 插件，实现页面切换的各种动画。 主要特点
1, 支持多页面间的切换动画。
2, 无依赖，轻量级，使用简单。

在线示例

https://www.fengshangbin.com/node/lazyswitch/

如何使用

1. 引入 LazySwitch

引用 lazyswitch.css 到页面

<link href="/css/lazyswitch.css" rel="stylesheet" type="text/css" />

引用 lazyswitch.js 到页面

<script src="js/lazyswitch.js"></script>

或者 npm 导入

npm install --save lazyswitch

...

const LazySwitch = require("lazyswitch");

给执行切换动画的单元添加 class="lazyswitch"

<div class="lazyswitch">
	...
</div>

3. 单页面存在多个单元

如 $.html

<div class="lazyswitch in" data-path="/2019.html">2019</div>
<div class="lazyswitch out" data-path="/2018.html">2018</div>
<div class="lazyswitch out" data-path="/2017.html">2017</div>

多单元只能有一个 lazyswitch 元素是展示状态 CSS 样式 in，其他 lazyswitch 的 css 样式为 out
每个单元需要配置对应的路径属性 data-path="xxx"
同时需要把 URL domain/2019.html, domain/2019.html, domain/2019.html 的访问指向这个单页面 html 文件，这需要后台语言的支持，也可以结合 LazyPage 框架 使用，让前端也可设置访问 URL
关于 LazyPage 框架, 参见 https://github.com/fengshangbin/LazyPage

4. 页面切换动画

lazyswitch.css 内置了 slide、slidevertical、fade、popup 四种切换动画，您也可以自己定义自己需要的动画样式
lazyswitch 默认使用 slide 进行页面切换

<div class="lazyswitch" data-animate="slidevertical">...</div>

属性 data-animate 为该页面切换时的动画样式

5. 页面顺序

当页面动态载入时会按照属性 data-sort 的值去插入 dom 结构中
如 news/2017.html 代码

<div class="lazyswitch" data-sort="2017">2017</div>

news/2018.html 代码

<div class="lazyswitch" data-sort="2018">2018</div>

news/2019.html 代码

<div class="lazyswitch" data-sort="2019">2019</div>

当从 news/2018.html 跳转到 news/2019.html 时 dom 结构会变为

<div class="lazyswitch out" data-path="/news/2018.html" data-sort="2018">2018</div>
<div class="lazyswitch in" data-path="/news/2019.html" data-sort="2019">2019</div>

而从 news/2018.html 跳转到 news/2017.html 时 dom 结构会变为

<div class="lazyswitch in" data-path="/news/2017.html" data-sort="2017">2017</div>
<div class="lazyswitch out" data-path="/news/2018.html" data-sort="2018">2018</div>

lazyswitch 页面切换时，如果目标单元在 dom 中的位置是当前单元的前面，则会进行反转动画 css 类 reverse
反转动画在一些切换效果中很有用如 slide，在 fade 切换时则无效

6. 禁用部分页面切换动画

在超链接 a 设置属性 data-direct="true" 如果跨域名跳转链接时会自动直接跳转的

<a href="/index" data-direct="true">index(direct)</a>

a 标签还有一个属性 data-history="true",默认为 true 控制页面切换时是否产生浏览器历史纪录

7. 禁用 loading 动画

loading 动画默认开启
关闭

<script>
	LazySwitch.closeLoading();
</script>

开启

<script>
	LazySwitch.openLoading();
</script>

8. 开启多页面预加载

页面预加载默认关闭
开启

<script>
	LazySwitch.openPreLoad();
</script>

开启预加载后 会自动查找 DOM 中的 a 标签的超链接，预加载这些超链接对应的页面

关闭

<script>
	LazySwitch.closePreLoad();
</script>

9. 监听页面切换事件

LazySwitch 页面切换会有 6 种事件发出
PAGE_SWITCH_BEFORE: 每次切换页面前触发
PAGE_FIRST_IN: 页面第一次进场
PAGE_IN_START: 页面开始进场
PAGE_IN_END: 页面结束进场
PAGE_OUT_START: 页面开始出场
PAGE_OUT_END: 页面结束出场

<script>
    LazySwitch.addEventListener(LazySwitch.PageEvent.PAGE_FIRST_IN, function test(event) {
        console.log(event);
    });
</script>

事件 event 为相同结构
event.type: 当前事件类型
event.data.page 当前事件对应的页面单元
event.data.animate 页面切换动画类型
event.data.history 页面切换是否产生浏览器历史纪录
event.data.isBack 页面切换动画是否反转
对于 PAGE_SWITCH_BEFORE 事件没有 event.data.page,
但是多了 event.data.from 和 event.data.to 对应将要出场和进场的页面单元

10. 动态调用页面切换

lazyswitch 页面切换默认在点击超链接 a 标签时触发 也可以通过代码调用触发页面切换

<script>
    LazySwitch.goto(url, option);
</script>

参数:
url: 跳转目标地址
option: 跳转配置项
默认值为 { history: true, isBack: "auto", animate: "auto", }

11. 页面标题

如果一个 html 文件中只有唯一一个页面单元时，这个页面单元会自动继承该页面的 title 值，
如果有多个页面单元时 需要设置每个页面单元的标题 data-title
如 $.html

<div class="lazyswitch in" data-path="/2019.html" data-title="2019">2019</div>
<div class="lazyswitch out" data-path="/2018.html" data-title="2018">2018</div>
<div class="lazyswitch out" data-path="/2017.html" data-title="2017">2017</div>