Vue 自定義標籤的 src 屬性不能使用相對路徑

時間 2019-11-07

標籤 vue 自定義標籤 src 屬性不能使用相對路徑简体版

原文原文鏈接

Vue 自定義標籤的 src 屬性不能使用相對路徑

吾輩的博客原文: https://blog.rxliuli.com/p/4b...

場景

吾輩在使用 Vuetify 時忽然遇到的，明明 img 標籤就可使用相對路徑獲取到圖片，而 Veutify 的組件 v-img 卻不能使用。css

以下面 3 種加載圖片的方式html

<!-- 正常加載 -->
<v-img :src="require('../../assets/logo.png')" />
<!-- 沒法加載 -->
<v-img src="../../assets/logo.png" />
<!-- 正常加載 -->
<img src="../../assets/logo.png" />

吾輩在 segmentfault 上的提問

緣由

是的，竟然必須用 require() 引入圖片才能生效，那爲何 img 標籤能夠直接使用相對路徑呢？這和 vue-loader 資源路徑處理有關係。vue

官方明確指出會將全部資源路徑做爲模塊依賴，也就是後臺 vue-loader 幫咱們轉換成 require() 的形式了。webpack

解決方案

vue cli 3

vue cli 3 的配置項 API 發生了改變，由 transformToRequire 改成 transformAssetUrls，並且配置方式也再也不是直接修改 webpack 配置文件，而是修改 vue.config.js 這個通過包裝後的文件。如今，最新的配置方式以下web

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 便可npm

// vuetify 框架的 src 標籤也須要自動轉換爲 require
'v-img': 'src'

吾輩的配置文件在 build > vue-loader.conf.jssegmentfault

'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',
  },
}