加载图片
在 imgrender 中如何正确引用和加载图片
网络图片
imgrender 支持通过 img 标签、CSS 属性 background-image 和 mask-image 引用网络图片。
支持的图片格式有:jpeg、png、webp、svg。
为了保证渲染性能,请满足以下要求
-
图片文件尽可能小,最大不能超过 10 MB。超过 10 MB 会加载失败。
-
保证图片链接可公网访问。若托管你图片的服务开启了鉴权措施(如私有访问的对象存储服务),则提供的图片 URL 一定要包含鉴权信息。
-
图片链接公网访问速度足够快。
<img src="https://www.imgrender.net/example.png" /><div
style={{
backgroundImage: 'url("https://www.imgrender.net/example.png")',
}}
>
...
</div><div
style={{
maskImage: 'url("https://www.imgrender.net/example.png")',
}}
>
...
</div>缓存
为提升渲染性能,imgrender 会以图片 url 为 key 缓存图片。加载图片时,若图片命中缓存,则会优先使用缓存数据,不再从网络上下载图片。
如何主动失效缓存
在 url 对应的图片已被 imgrender 缓存地情况下,图片内容改变了,但 url 未改变,imgrender 仍会使用已缓存的旧图片内容。
为了避免这种情况发生,可在 url 上增加或修改 query 参数。如下所示。
旧 url:
https://www.imgrender.net/images/example.png新 url:
https://www.imgrender.net/images/example.png?v=1