技术备忘
vue3+vite assets动态引入图片的几种方式
vue3+vite assets动态引入图片的几种方式

vue3+vite assets动态引入图片的几种方式

vue3+vite assets动态引入图片的几种方式,解决打包后图片路径错误不显示的问题

vite官方默认的配置,如果资源文件在assets文件夹打包后会把图片名加上hash值,但是直接通过:src="imgSrc"方式引入并不会在打包的时候解析,导致开发环境可以正常引用,打包后却不能显示的问题

vite官方文档解释 https://vitejs.bootcss.com/guide/assets.html

我们不希望资源文件被wbpack编译可以把图片放到public 目录会更省事,不管是开发环境还是生产环境,可以始终以根目录保持图片路径的一致,这点跟webpack是一致的

public目录说明

看到这里,也许问题就解决了,如果在vite确实需要将静态文件放在assets

这里我们先假设:
静态文件目录:src/assets/images/
我们的目标静态文件在 src/assets/images/home/home_icon.png

<img :src="require('@/assets/images/home/home_icon.png')" />

尝试过require动态引入, 发现报错:require is not defind,这是因为 require 是属于 Webpack 的方法

第一种方法(适用于处理单个链接的资源文件)

import homeIcon from '@/assets/images/home/home_icon.png'

<img :src="homeIcon" />

第二种方式(适用于处理多个链接的资源文件)

推荐,这种方式传入的变量可以动态传入文件路径!!

静态资源处理 | Vite 官方中文文档

new URL() + import.meta.url

这里我们假设:
工具文件目录: src/util/pub-use.ts
pub-use.ts

// 获取assets静态资源
export default  const getAssetsFile = (url: string) => {
   return new URL(`../assets/images/${url}`, import.meta.url).href
}

使用

import usePub from '@/util/public-use'
setup () {
  const Pub = usePub()
  const getAssetsFile = Pub.getAssetsFile
  return { getAssetsFile }
}

可以包含文件路径

<img :src="getAssetsFile('/home/home_icon.png')" />

第三种方式(适用于处理多个链接的资源文件)

不推荐,这种方式引入的文件必须指定到具体文件夹路径,传入的变量中只能为文件名,不能包含文件路径

使用vite的import.meta.globimport.meta.globEager,两者的区别是前者懒加载资源,后者直接引入。

这里我们假设:
工具文件目录: src/util/pub-use.ts
pub-use.ts

// 获取assets静态资源
export default const getAssetsHomeFile = (url: string) => {
    const path = `../assets/images/home/${url}`;
    const modules = import.meta.globEager("../assets/images/home/*");
    return modules[path].default;
}

使用

import usePub from '@/util/public-use'
setup () {
  const Pub = usePub()
  const getAssetsHomeFile = Pub.getAssetsHomeFile 
  return { getAssetsHomeFile }
}

不能包含文件路径

<img :src="getAssetsHomeFile('home_icon.png')" />

补充:如果是背景图片引入的方式(一定要使用相对路径)

.imgText {
  background-image: url('../../assets/images/1462466500644.jpg');
}

生产环境会自动加上hash,并且路径正确

css背景

以下错误用法,使用绝对路径在开发环境能够正常显示,但将导致打包后的路径不正确

.imgText {
  background-image: url('src/assets/images/1462466500644.jpg');
}

生产环境资源404

错误实例