wx.nextTick(function callback)

基础库 2.2.3 开始支持,低版本需做兼容处理。

微信小程序插件:支持,需要微信小程序基础库版本不低于 2.7.1

微信 Windows 版:支持

微信 Mac 版:支持

微信 鸿蒙 OS 版:支持

功能描述

延迟一部分操作到下一个时间片再执行。(类似于 setTimeout)

参数

function callback

说明

因为自定义组件中的 setData 和 triggerEvent 等接口本身是同步的操作,当这几个接口被连续调用时,都是在一个同步流程中执行完的,因此若逻辑不当可能会导致出错。

一个极端的案例:当父组件的 setData 引发了子组件的 triggerEvent,进而使得父组件又进行了一次 setData,期间有通过 wx:if 语句对子组件进行卸载,就有可能引发奇怪的错误,所以对于不需要在一个同步流程内完成的逻辑,可以使用此接口延迟到下一个时间片再执行。

示例代码

Component({
  doSth() {
    this.setData({ number: 1 }) // 直接在当前同步流程中执行

    wx.nextTick(() => {
      this.setData({ number: 3 }) // 在当前同步流程结束后,下一个时间片执行
    })

    this.setData({ number: 2 }) // 直接在当前同步流程中执行
  }
})

wx.setTopBarText(Object object)

从基础库 1.9.9 开始,本接口停止维护

基础库 1.4.3 开始支持,低版本需做兼容处理。

以 Promise 风格 调用:支持

需要页面权限:当前是插件页面时,宿主微信小程序不能调用该接口,反之亦然

微信小程序插件:不支持

功能描述

动态设置置顶栏文字内容。只有当前微信小程序被置顶时能生效,如果当前微信小程序没有被置顶,也能调用成功,但是不会立即生效,只有在用户将这个微信小程序置顶后才换上设置的文字内容。

参数

Object object

属性 类型 默认值 必填 说明
text string 置顶栏文字
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

wx.setTopBarText({
  text: 'hello, world!'
})

注意

  • 调用成功后,需间隔 5s 才能再次调用此接口,如果在 5s 内再次调用此接口,会回调 fail,errMsg:”setTopBarText: fail invoke too frequently”

Animation.step(Object object)

微信小程序插件:支持

相关文档: 动画

功能描述

表示一组动画完成。可以在一组动画中调用任意多个动画方法,一组动画中的所有动画会同时开始,一组动画完成后才会进行下一组动画。

参数

Object object

属性 类型 默认值 必填 说明
duration number 400 动画持续时间,单位 ms
timingFunction string ‘linear’ 动画的效果
合法值 说明
‘linear’ 动画从头到尾的速度是相同的
‘ease’ 动画以低速开始,然后加快,在结束前变慢
‘ease-in’ 动画以低速开始
‘ease-in-out’ 动画以低速开始和结束
‘ease-out’ 动画以低速结束
‘step-start’ 动画第一帧就跳至结束状态直到结束
‘step-end’ 动画一直保持开始状态,最后一帧跳到结束状态
delay number 0 动画延迟时间,单位 ms
transformOrigin string ‘50% 50% 0’

返回值

Animation

animation