wx.preloadAssets(Object object)

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

以 Promise 风格 调用:不支持

微信小程序插件:不支持

微信 Windows 版:支持

微信 Mac 版:支持

微信 鸿蒙 OS 版:支持

功能描述

为视图层预加载媒体资源文件,目前支持:字体(font)、图片(image)

参数

Object object

属性 类型 默认值 必填 说明
data Array.<Object> 预加载的资源列表
结构属性 类型 默认值 必填 说明
type string 资源类型
合法值 说明
‘font’ 字体
‘image’ 图片
src string 资源地址
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

wx.preloadAssets({
  data: [
    {
      type: 'image',
      src: imgUrl,
    },
  ],
  success(resp) {
    console.log('preloadAssets success', resp)
  },
  fail(err) {
    console.log('preloadAssets fail', err)
  },
})
  • 开发过程中,可在开发者工具 network 面板查看预加载情况。