如何在vue項目中使用svg圖標

• svg圖標優點

svg與iconfont之類的字體圖標在網頁中的使用差別不大，可以修改大小，顏色等而且不失真。

• 安裝svg-sprite-loader

npm install --save-dev svg-sprite-loader

• 文件夾目錄 （xxx.svg 注意：這里的 xxx 不要使用中文）

- assets
-- icon
--- svg
--- index.js

• 配置依賴

// Vue2.x 在 webpack.base.conf.js 中配置如下：
// 注意svg圖標的路徑 src/assets/icon 要寫正確
 module: {
    rules: [
      {
        test: /\.svg$/,
        loader: 'svg-sprite-loader',
        include: [resolve('src/assets/icon')],
        options: {
          symbolId: 'icon-[name]'
        }
      },
      {
        test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
        loader: 'url-loader',
        exclude: [resolve('src/assets/icon')],
        options: {
          limit: 10000,
          name: utils.assetsPath('img/[name].[hash:7].[ext]')
        }
      }
    ]
  }

// Vue3.x 在根目錄新建 vue.config.js 中配置如下：
module.exports = {
  chainWebpack: config => {
    const svgRule = config.module.rule('svg')
    svgRule.uses.clear()
    svgRule.exclude.add(/node_modules/)
    svgRule
      .test(/\.svg$/)
      .use('svg-sprite-loader')
      .loader('svg-sprite-loader')
      .options({
        symbolId: 'icon-[name]',
      })

    // 修改images loader 添加svg處理
    const imagesRule = config.module.rule('images')
    imagesRule.exclude.add(resolve('src/assets/icon'))
    config.module
      .rule('images')
      .test(/\.(png|jpe?g|gif|svg)(\?.*)?$/)
  }
}

// Vue4.x 在根目錄新建 vue.config.js 中配置如下：
const path = require('path')
module.exports = {
  // 使用svg-sprite-loader編譯svg，若使用file-loader時排除src/icon下的svg矢量圖標
  chainWebpack: (config) => {
    const svgRule = config.module.rule('svg')
    // 清除已有的所有 loader 否則接下來的 loader 會附加在該規則現有的 loader 之后
    svgRule.uses.clear()
    svgRule
      .test(/\.svg$/)
      .include.add(path.resolve(__dirname, './src/icon'))
      .end()
      .use('svg-sprite-loader')
      .loader('svg-sprite-loader')
      .options({
        symbolId: 'icon-[name]',
      })
    const fileRule = config.module.rule('file')
    fileRule.uses.clear()
    fileRule
      .test(/\.svg$/)
      .exclude.add(path.resolve(__dirname, './src/icon'))
      .end()
      .use('file-loader')
      .loader('file-loader')
  },
}

• 在components目錄下增加一個SvgIcon組件

<template>
  <div
    v-if="isExternal"
    :style="styleExternalIcon"
    class="svg-external-icon svg-icon"
    v-on="$listeners"
  />
  <svg v-else :class="svgClass" aria-hidden="true" v-on="$listeners">
    <use :xlink:href="iconName" />
  </svg>
</template>

<script>
// 檢查是否是外部鏈接
var isExternal function(path) {
  return /^(https?:|mailto:|tel:)/.test(path)
}

export default {
  name: "SvgIcon",
  props: {
    iconClass: {
      type: String,
      required: true,
    },
    className: {
      type: String,
      default: "",
    },
  },
  computed: {
    isExternal() {
      return isExternal(this.iconClass)
    },
    iconName() {
      return `#icon-${this.iconClass}`
    },
    svgClass() {
      if (this.className) {
        return "svg-icon " + this.className
      } else {
        return "svg-icon"
      }
    },
    styleExternalIcon() {
      return {
        mask: `url(${this.iconClass}) no-repeat 50% 50%`,
        "-webkit-mask": `url(${this.iconClass}) no-repeat 50% 50%`,
      }
    }
  }
}
</script>

<style scoped>
    .svg-icon {
      width: 1em;
      height: 1em;
      vertical-align: -0.15em;
      fill: currentColor;
      overflow: hidden;
    }

    .svg-external-icon {
      background-color: currentColor;
      mask-size: cover !important;
      display: inline-block;
    }
</style>

• 在icon文件夾下index.js中導入所有svg文件，並將SvgIcon注冊到全局

import Vue from 'vue'
import SvgIcon from '@/components/SvgIcon'

// 全局注冊
Vue.component('svg-icon', SvgIcon)

const req = require.context('./svg', false, /\.svg$/)
const requireAll = requireContext => requireContext.keys().map(requireContext)
requireAll(req)

• 在main.js文件中引入 svg 配置

import '@/assets/icon'

• 使用

<!-- 其中icon-class對應圖標svg文件的名稱；className對應圖標的css樣式屬性 -->
<svg-icon icon-class="arrow" className="left-arrow"></svg-icon>

• 備注

若svg圖標不能通過樣式修改顏色，打開svg文件，刪除style標簽里的每一項fill樣式設置。但是如果svg文件中使用的不是 path 那就沒有辦法了。比如有些在線的工具可以把圖片轉成svg格式，轉換后svg文件中的地址是 base64 ，這種的就不能改變樣式了，而且放縮也會失真。