Vue 自定义标签的 src 属性不能使用相对路径

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 刷新一下就行啦