跳到主内容

如何在vue3实现动态图片展示

· 3分钟阅读

问题

在使用 Vue3 开发的时候,展示动态图片功能,我们都知道,引入一张图片可以使用下面的方法。

<img src="/src/assets/images/my-image.png" alt="Image" class="logo" />

如果要根据数据库返回的数据来展示,应该是这样实现才对吧。

<img :src="'/src/assets/images/' + menuItem.iconSource" />

这里的 menuItem 是数据库返回的,例如 home.png 等等,在开发环境可以正常运行,但是构建完发布到生产环境,报的是 404,非常苦恼。

我们先来理解下 Vite 在处理静态资源是如何处理的,通过查阅 官方文档 可以了解到。

import imgUrl from "./img.png";
document.getElementById("hero-img").src = imgUrl;

imgUrl 最终构建完的路径为 /assets/img.2d8efhg.png

要解决动态图片路径问题,首先要先理解 new URL(url, import.meta.url) 这个方法。

new URL(url, import.meta.url)

import.meta.url 是一个 ESM 的原生功能,会暴露当前模块的 URL。将它与原生的 URL 构造器 组合使用,在一个 JavaScript 模块中,通过相对路径我们就能得到一个被完整解析的静态资源 URL:

const imgUrl = new URL('./img.png', import.meta.url).href
document.getElementById('hero-img').src = imgUrl

这样 Vite 并不需要在开发阶段处理这些代码

这个模式同样还可以通过字符串模板支持动态 URL

function getImageUrl(name) {
return new URL(`./dir/${name}.png`, import.meta.url).href
}

经过几天几夜的尝试,最终找到了解决方法,下面主要针对静态图片路径,动态图片路径(相对路径/绝对路径)这几种情况进行讲解。

静态图片路径

可以通过 import 关键字来引入图片,然后在 template 中使用它。

<script setup>
import imageUrl from "@/assets/images/logo.svg";
</script>

<template>
<img :src="imageUrl" alt="img" />
</template>

动态图片路径(相对路径)

<script setup>
const imageUrl = new URL(`./dir/${name}.png`, import.meta.url).href
</script>

<template>
<img :src="imageUrl" alt="img" />
</template>

动态图片路径(绝对路径)

注意,这里的路径不能使用 @ 来实现,必须是项目的绝对路径才行

<script setup>
const imageUrl = new URL('/src/assets/images/logo.svg', import.meta.url);
</script>

<template>
<img :src="imageUrl" alt="img" />
</template>

注意这个 import.meta.url 在node环境下表现不一致,所以不能用于SSR