imgrender

加载图片

在 imgrender 中如何正确引用和加载图片

网络图片

imgrender 支持通过 img 标签、CSS 属性 background-imagemask-image 引用网络图片。

支持的图片格式有:jpegpngwebpsvg

为了保证渲染性能,请满足以下要求

  1. 图片文件尽可能小,最大不能超过 10 MB。超过 10 MB 会加载失败。

  2. 保证图片链接可公网访问。若托管你图片的服务开启了鉴权措施(如私有访问的对象存储服务),则提供的图片 URL 一定要包含鉴权信息。

  3. 图片链接公网访问速度足够快。

<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

On this page