Taro图片素材不显示?

📅 2025-09-15 19:37:59 ✍️ admin 👁️ 4845 ❤️ 227
Taro图片素材不显示?

本文始发于我的博文Taro图片素材不显示?--Taro下的webpack配置,现转发至此。

前言

最近遇到Taro下图片素材没显示的小问题,解决完顺藤摸瓜了解了下前端领域webpack及其Loader的一些原理。

本文只是简单作个记录,涉及Taro下一些webpack的配置,可以为刚好遇到类似问题的人提供可能的助益。

文末也简单讨论了图片素材转变成base64编码这种处理方式。

场景和问题解决

使用 map组件展示markers,代码如下:

import LocationIcon from '../xxx.png'

class XXX {

render () {

// 定义marker

var markers = [{

iconPath: LocationIcon,

id: 0,

latitude,

longitude,

width: 38,

height: 50

}];

return (

...

...

)

}

}

问题一:真机没有显示 iconPath 的素材?

思路:

可能 iconPath的设置有限制,查看 微信小程序Map组件文档。

iconPath,显示的图标,类型string,项目目录下的图片路径,支持网络路径、本地路径、代码包路径([2.3.0])

图片是按 Taro-引用图片、音频、字体等文件 所说,通过 ES6 的 import 语法来引用的,即“项目目录下的图片路径”,所以不是组件使用问题。

检查运行过程中生成的Wxml,看看是否生成有问题,以此倒推

发现iconPath的值变成了base64编码后的数据。

小结:

至此,找到直接原因,真机环境Taro打包对有些素材进行base64编码,设置给iconPath后,不满足文档要求,所以无法显示。

问题二:那为什么有些素材有展示?有些没有展示?

思路:

查看几处引用素材的地方运行过程中生成的Wxml:

发现相同的用法,有些素材是变成base64数据,有些依旧是素材路径。

比较素材的区别

查看素材发现,编码成base64的,都是几KB的小素材;使用路径的,是十几KB甚至更大的素材。

小结:

依此推断,Taro只对小素材进行了base64编码处理,而对于较大的素材,没有改动。

问题三:这个处理是如何配置的?

思路:

大晚上的,私聊了一下Taro的主程,告知这是webPack进行的处理。于是找到了Taro文档 进阶指南-编译配置详情。此处对配置进行了简单说明。

mini.imageUrlLoaderOption

需要参考url-loader README关于配置字段的说明。

最终配置如下:

// config/index.js

mini: {

imageUrlLoaderOption: {

limit: 10000,

mimetype: 'image/png',

encoding: 'base64'

},

...

}

此处配置imageUrlLoaderOption的作用是,对于png的图片素材,如果体积超过了10000B,则进行base64编码。

Taro在新版本完全开放了WebPack的配置,有很多插件可以配置,文档列的比较详细,此处就不再赘述了。主要是以后遇到一些问题可以想到用webpack这个层面去解决。

扩展

到此可能会想,为什么会有这样的配置?有什么好处?

简单总结下我的想法:

相比网络图片,使用base64编码的方式,减少加载图片的http请求次数,没有因网络加载而带来的延时。

base64编码只是一种编码方式,不是一种压缩方式,它实际上会增加图片本身的大小(在我之前的文章有介绍过),图片越大增加的越多。

相比网络图片,如果是大图进行base64编码,和多一次http请求的耗时比起来,显然划不来。

疑问:

同一个素材多处使用,进行base64编码,会不会导致CSS大小增加?不清楚有待考证。

小的本地素材,进行base64编码有什么好处?大概同“素材加载”和“CSS加载”的区别有关系。

如果有前端的同学知道,请不吝赐教哈。

-END-

欢迎到我的博客交流:https://zackzheng.info