由于每个 API 参数:对象的属性都有 success,fail,complete,所以在这个提前介绍,就不再每个API 上写了
success:类型 函数 接口调用成功的回调函数
fail:类型 函数 接口调用失败的回调函数
complete:类型 函数 接口调用结束的回调函数(调用 成功,失败,都会执行)
----------------------------------
下拉刷新:
wx.stopPullDownRefresh() 停止当前页面的下拉刷新 直接调用即可
wx.startPullDownRefresh() 开始下拉刷新,调用后触发下拉刷新动画,效果与用户手动下拉刷新一致 直接调用即可
滚动:
wx.pageScrollTo() 将页面滚动到目标位置 参数:对象
对象的属性:
scrollTop:类型 数字 滚动到页面的目标位置,单位 px
duration:类型 数字 滚动的动画的时长,单位ms
动画:
wx.createAnimation() 创建一个动画实例 animation ,调用实例的方法来描述动画,最后通过动画实例的export方法到处动画数据,传递给组件的 animation 属性; 参数:对象
对象的属性:
duration:类型 数字 动画的持续时间
timingFunction:类型 字符串 动画的效果
属性值:linear 动画从头到尾速度时相同的
ease 动画以低速开始,然后加载,结束前变慢
ease-in 动画以低速开始
ease-in-out 动画以低速开始和结束
ease-out 动画以低速结束
step-start 动画第一帧就跳至结束状态,知道结束
step-end 动画一直保持开始状态,最后一帧跳至结束状态
delay:类型 数字 动画的延迟时间,单位ms
transformOrigin:类型 字符串 动画的中心点 默认"50% 50% 0" (中心)
wx.createAnimation() 定义了动画的一些东西,但是想要操作动画的执行,就要通过他的实例对象来调用这些方法( 目前实例对象用 animation 代替,用什么代替都可以)
注意,如果想使用下面的代码,需要在组件标签中 添加属性 animation 的属性 才会有效果
参数:数字
animation.height() 设置高度(具有动画效果)
animation.left() 设置 left 值
animation.matrix() 矩阵
animation.matrix3d() 3d变幻的矩阵
animation.opacity() 设置透明度
animation.right() 设置 right 值
animation.rotate() 在原点的顺时针旋转一个角度
animation.rotate3d() 从x轴顺时针旋转一个角度
animation.rotateX() 从x轴顺时针旋转一个角度
animation.rotateY() 从y轴顺时针旋转一个角度
animation.rotateZ() 从z轴顺时针旋转一个角度
animation.scale() 缩放 一个参数,同时缩放,两个参数,x 缩放 y 缩放
animation.scale3d() 3d 缩放 x y z
animation.scaleX() 缩放 x 轴
animation.scaleY() 缩放 y 轴
animation.scaleZ() 缩放 z 轴
animation.skew() 对 x y 坐标进行倾斜 , 一个参数 x,y 。两个参数 分别代表 x y
animation.skewX() 对 x 坐标进行倾斜
animation.skewY() 对 y 坐标进行倾斜
animation.step() 表示一组动画完成,可以在一组动画中调用任意多个动画的方法,一组动画中的所有动画会同时开始,一组动画完成后才会进行下一组动画
animaiton.top() 设置 top 值
animation.translate() 平移切换 参数 x y
animation.translate3d() 对 x y z 坐标进行平移切换
animation.translateX() 对 x 轴进行平移
animation.translateY() 对 y 轴进行平移
animation.translateZ() 对 z 轴进行平移
animation.width() 设置宽度
animation.backgroundColor() 设置背景色
animation.bottom 设置 bottom 值
animation.export() 导出队列动画,export(),方法每次执行,都会清掉之前的动画
自定义组件
wx.nextTick() 延迟一部分操作到下一个时间片在执行 参数:回调函数
菜单:
wx.getMenuButtonBoundingClientRect() 获取菜单按钮(右上角胶囊按钮)的布局位置信息,坐标信息以屏幕左上角为原点 参数:实例对象
实例对象上的属性:
width:类型 数字 宽度(单位 px )
height:类型 数字 高度(单位 px )
top:类型 数字 上边界坐标
right:类型 数字 右边界坐标
bottom:类型 数字 下边界坐标
left:类型 数字 左边界坐标
窗口:(现阶段不提倡)
wx.onWindowResize() 监听窗口尺寸变化事件 参数:回调函数
事件对象
size:对象 windowWidth 属性值:数字 变化后的窗口宽度
windowHeight 属性值:数字 变化后的窗口高度
wx.offWindowResize() 取消监听窗口尺寸的变化
键盘:(2.70开始支持的新接口)
wx.onKeyboardHeightChange() 监听键盘高度变化
wx.getSelectedTextRange() 在 input,textarea 等 focus 之后,获取输入框的光标位置,注意:中有在focus的时候调用此接口才有效