一、故事序幕
时间一分一秒地流逝,小程序已伴随我们三载有余,今天要讲的是关于小程序与动画的故事:从前...
二、故事开头
一提小程序与动画,首先想到的是什么?嗯,微信小程序独创了一套动画玩法,官方支持3种动画方案,分别是 createAnimation
、 this.animate
和 CSS3动画
。
1. createAnimation
与Animation
创建一个动画实例animation。调用实例的方法来描述动画。最后通过动画实例的export方法导出动画数据传递给组件的animation属性。
var animation = wx.createAnimation({
transformOrigin: "50% 50%",
duration: 1000,
timingFunction: "ease",
delay: 0
})
// step() 表示一组动画的完成,可以在一组动画中调用任意多个动画方法
// 一组动画中的所有动画会同时开始,一组动画完成后才会进行下一组动画
animation.translate(150, 0).rotate(180).step()
animation.opacity(0).scale(0).step()
this.setData({
animationData: animation.export()
})
2. 关键帧动画this.animate
接口
从小程序基础库 2.9.0 开始支持一种更友好的动画创建方式,用于代替旧的 wx.createAnimation 。它具有更好的性能和更可控的接口。在页面或自定义组件中,当需要进行关键帧动画时,可以使用 this.animate 接口。
this.animate(selector, keyframes, duration, callback)
官方给出的例子:
this.animate(‘#container‘, [
{ opacity: 1.0, rotate: 0, backgroundColor: ‘#FF0000‘ },
{ opacity: 0.5, rotate: 45, backgroundColor: ‘#00FF00‘},
{ opacity: 0.0, rotate: 90, backgroundColor: ‘#FF0000‘ },
], 5000, function () {
this.clearAnimation(‘#container‘, { opacity: true, rotate: true }, function () {
console.log("清除了#container上的opacity和rotate属性")
})
}.bind(this))
3. css3动画
这是界面动画的常见方式,CSS 动画运行效果良好,甚至在低性能的系统上。渲染引擎会使用跳帧或者其他技术以保证动画表现尽可能的流畅。
利用样式实现小程序动画,用法和css用法相似,定义好指定的动画类名后给元素加上即可。
这是一个模仿心跳的动画:
@keyframes heartBeat {
0% {
transform: scale(1);
}
14% {
transform: scale(1.3);
}
28% {
transform: scale(1);
}
42% {
transform: scale(1.3);
}
70% {
transform: scale(1);
}
}
.heartBeat {
animation-name: heartBeat;
animation-duration: 1.3s;
animation-timing-function: ease-in-out;
}
三、故事发展
故事的设定是这样子的:需要支持多种预设的动画效果配置,且实现进场动画、强调动画、退场动画按顺序运行。
如下,“3件5折/2件7折/1件9折”的文本 设置了 进场动画-从小到大 以及 强调动画-脉冲 的动画效果:
生成的小程序效果:
Taro 是小程序的好伙伴,而且基于故事的设定,H5 还是要点饭吃的。
要想快速进入故事高潮,不得不采用一些取巧的手段了,决定采用市面上常见的 Animate.css 动画库来支持多种预设的动画效果!
1. 支持多种动画配置
Animate.css是一个可在您的Web项目中使用的即用型跨浏览器动画库,预设了抖动(shake)、闪烁(flash)、弹跳(bounce)、翻转(flip)、旋转(rotateIn/rotateOut)、淡入淡出(fadeIn/fadeOut)等97种动画效果。官网首页即可查看所有动画效果。
要支持多种动画配置,考虑将 animate.css 这个非常棒的css库引入到小程序内使用。
从https://github.com/animate-css/animate.css/releases 下载源码,将 .css 文件 改名为 .wxss 或者.scss 文件,在页面或组件中引入样式文件即可。
import ‘./animate.scss‘
Animate.css 的使用非常简单,因为它是把不同的动画类型绑定到了不同的类里,所以想用哪种动画,只需要把相应的类添加到元素上就可以尽情享用了。
由于小程序对代码包的大小限制,因此可删除 animate.css 中所有 @-webkit-
等前缀的样式减少一半体积,甚至直接使用 @keyframes
的代码,即去掉类名的方式调用。
2. 执行完一个动画后接着执行另一个动画 ?
从上文可知,采用的是CSS3的动画方案,基本决定了故事的下一个发展阶段。
如果要实现进场动画、强调动画、退场动画按顺序运行,那么需要监听上一个动画结束,紧接着运行下一个动画。
动画过程中,微信小程序可以使用 bindtransitionend
、bindanimationstart
、bindanimationiteration
、bindanimationend
来监听动画事件。
在 Taro 中内置组件的事件依然是以 on 开头的,即 onTransitionEnd
、onAnimationStart
、onAnimationIteration
、onAnimationEnd
。
注意:监听动画事件都不是冒泡事件,需要绑定在真正发生了动画的节点上才会生效。
要实现进场之前不可见,退场后不可见,设置 animation-fill-mode: both
即可,且不可移除样式,因为退场动画的效果效果 会失效,元素又显示出来了。
可能还得处理其他行为,比如 消失的元素 实际可能还占位,交互点击的行为最好解绑。
<View
onAnimationEnd={this.onAnimationEnd}
>
{this.props.children}
</View>
四、故事高潮
故事都铺垫好了,终于来到了高潮。
眼尖的人儿也发现了,上文GIF图 “生成的小程序效果” 还实现了滚动到可视区域才开始执行动画的效果。
这是老生常谈的话题了,那怎么在小程序侧实现呢?
方案一:页面滚动模式
- 小程序利用
onPageScroll
的 API 监听用户滑动页面事件,可获取scrollTop
:页面在垂直方向已滚动的距离(单位px)。 -
Taro.createSelectorQuery
获取元素在显示区域的竖直滚动位置。 - 基上计算是否在可视区域来判断是否要开始动画。
方案二:观察者模式
- 不支持
onPageScroll
的情况下,则需要使用Taro.createIntersectionObserver
获取目标节点与参照区域的相交比例触发相关的回调函数,即观察者模式。
代码奉上
(1) Taro获取当前页面的方式
首先我们要知道如何获取当前页面栈,数组中第一个元素为首页,最后一个元素为当前页面:
getCurrentPage () {
const pages = Taro.getCurrentPages ? Taro.getCurrentPages() : [{}]
const currentPage = pages[pages.length - 1]
return currentPage
}
(2) 初始化页面滚动
判断使用页面滚动模式还是观察者模式:
initPageScroll () {
const env = Taro.getEnv()
const currentPage = this.getCurrentPage()
// 获取onPageScroll方法
const onPageScroll = currentPage.onPageScroll
// 页面滚动模式:h5 或「小程序页面有onPageScroll钩子」使用统一的代码
const isPageScroll =
env === Taro.ENV_TYPE.WEB ||
(env !== Taro.ENV_TYPE.WEB && onPageScroll !== undefined)
// 观察者模式:小程序页面没有 onPageScroll 钩子,使用 Taro.createIntersectionObserver 监听
const isObserver = env !== Taro.ENV_TYPE.WEB && Taro.createIntersectionObserver
if (isPageScroll) {
this.listenPageScroll(currentPage)
} else if (isObserver) {
this.observePageScroll()
}
}
(3) 页面滚动模式
首先在类外头定义一个多环境的 pageScroll 钩子,支持小程序和H5:
const createPageScroll = function(page) {
const env = Taro.getEnv()
let onPageScroll = () => {}
if (env !== Taro.ENV_TYPE.WEB) {
// 小程序
const prevOnPageScroll = page.onPageScroll.bind(page)
page.onPageScroll = e => {
prevOnPageScroll(e)
onPageScroll(e)
}
} else if (env === Taro.ENV_TYPE.WEB) {
// H5
window.addEventListener("scroll", () => {
onPageScroll({ scrollTop: window.scrollY })
})
}
return nextOnPageScroll => {
onPageScroll = nextOnPageScroll
}
}
使用上述定义的createPageScroll方法,开始监听滚动:
listenPageScroll (currentPage) {
const pageScroll = createPageScroll(currentPage)
pageScroll(this.onScroll)
}
获取距离页面顶部高度来判断是否要开始动画:
知识点:
- 在 Taro 的页面和组件类中,
this
指向的是 Taro 页面或组件的实例,而通过this.$scope
获取 Taro 的页面和组件所对应的小程序原生页面和组件的实例。 -
Taro.createSelectorQuery
返回一个 SelectorQuery 对象实例。在自定义组件或包含自定义组件的页面中,应使用 this.createSelectorQuery() 来代替。 - SelectorQuery对象实例可进一步查询节点信息,提供
select
、in
、exec
等方法。 - NodesRef 的
boundingClientRect
用于查询节点的布局位置,相对于显示区域,以像素为单位,其功能类似于 DOM 的 getBoundingClientRect。
onScroll = () => {
const query = Taro.createSelectorQuery().in(this.$scope)
query
.select(`.animation-${this.uniq}`)
.boundingClientRect(res => {
if (!res) return
let resTop = res.top
const distance = res.height / 2
const isStartAnimation = resTop + distance < this.windowHeight
if (isStartAnimation && !this.isAnimated) {
this.startAnimation()
// 动画只出现一次
this.isAnimated = true
}
})
.exec()
}
(4) 观察者模式:
知识点:
-
Taro.createIntersectionObserver
创建并返回一个 IntersectionObserver 对象实例。在自定义组件或包含自定义组件的页面中,应使用 this.createIntersectionObserver([options]) 来代替。 - IntersectionObserver 对象,用于推断某些节点是否可以被用户看见、有多大比例可以被用户看见。
- IntersectionObserver 的
relativeToViewport
方法 指定页面显示区域作为参照区域之一。 - IntersectionObserver 的
observe
指定目标节点并开始监听相交状态变化情况,其中res.intersectionRatio
指相交区域占目标节点的布局区域的比例。
observePageScroll () {
const navObserver = Taro.createIntersectionObserver(this.$scope, {
initialRatio: 0.5,
thresholds: [0.5]
})
navObserver.relativeToViewport()
navObserver.observe(`.animation-${this.uniq}`, res => {
const isStartAnimation = !this.isAnimated && res.intersectionRatio > 0.5
if (isStartAnimation) {
this.startAnimation()
// 动画只出现一次
this.isAnimated = true
}
})
}
五、故事结尾
小程序与动画的故事远远没有结束,纵使故事有了开头,你看到的只是故事的万种可能的其中一种。