Vue 自定義標籤的 src 屬性不能使用相對路徑
吾輩的博客原文: https://blog.rxliuli.com/p/4b...
場景
吾輩在使用 Vuetify 時突然遇到的,明明 img
標籤就可以使用相對路徑獲取到圖片,而 Veutify 的組件 v-img
卻不能使用。
如下面 3 種加載圖片的方式
<!-- 正常加載 -->
<v-img :src="require('../../assets/logo.png')" />
<!-- 無法加載 -->
<v-img src="../../assets/logo.png" />
<!-- 正常加載 -->
<img src="../../assets/logo.png" />
吾輩在 segmentfault 上的提問
原因
是的,居然必須用 require()
引入圖片才能生效,那爲什麼 img
標籤可以直接使用相對路徑呢?這和 vue-loader 資源路徑處理 有關係。
官方明確指出會將所有資源路徑作爲模塊依賴,也就是後臺 vue-loader
幫我們轉換成 require()
的形式了。
解決方案
vue cli 3
vue cli 3 的配置項 API 發生了改變,由 transformToRequire
改爲 transformAssetUrls
,而且配置方式也不再是直接修改 webpack 配置文件,而是修改 vue.config.js
這個經過包裝後的文件。現在,最新的配置方式如下
module.exports = {
chainWebpack: config => {
config.module
.rule('vue')
.use('vue-loader')
.loader('vue-loader')
.tap(options => {
return {
...options,
//修復靜態資源引用的問題 vue cli 2 => vue cli 3 升級之後配置項由 transformToRequire 改爲 transformAssetUrls
transformAssetUrls: {
video: ['src', 'poster'],
source: 'src',
img: 'src',
image: 'xlink:href',
// 在這裏添加需要使用靜態資源的自定義元素
'a-avatar': 'src',
},
}
})
},
}
具體參考
Vue Loader => 從 v14 遷移 => 廢棄的選項
Vue Cli 3 => webpack 相關 => 鏈式操作 (高級) => 修改 Loader 選項
vue cli 2
那麼,Veutify 組件中的 src
不能使用相對路徑的原因就很明確了。因爲 vue-loader
並不知道我們要把 v-img
的 src
屬性轉換成 require()
依賴。我們找到 vue-loader
配置處,在 options.transformToRequire
中加上 v-img
即可
// vuetify 框架的 src 標籤也需要自動轉換爲 require
'v-img': 'src'
吾輩的配置文件在 build > vue-loader.conf.js
'use strict'
const utils = require('./utils')
const config = require('../config')
const isProduction = process.env.NODE_ENV === 'production'
const sourceMapEnabled = isProduction
? config.build.productionSourceMap
: config.dev.cssSourceMap
module.exports = {
loaders: utils.cssLoaders({
sourceMap: sourceMapEnabled,
extract: isProduction,
}),
cssSourceMap: sourceMapEnabled,
cacheBusting: config.dev.cacheBusting,
transformToRequire: {
video: ['src', 'poster'],
source: 'src',
img: 'src',
image: 'xlink:href',
'v-img': 'src',
},
}
vue-loader 官方文檔參考
然後重啓 npm run dev
刷新一下就行啦