VUE之使用svg圖標

在使用矢量圖標時，以往都是去網站下載png格式，或者添加unicode格式
現在在vue中，我們以組件的形式加入，跟優雅的使用矢量圖標
先給一張效果圖

一 安裝依賴

在vue中首先需要安裝可以加載svg的依賴

1. npm
   npm install svg-sprite-loader --save-dev
2. yarn
   yarn add svg-sprite-loader ---dev

如果 出現錯誤可以適當降低依賴版本

二：配置webpack

2.1 首先創建一個svg文件用來保存圖標

2.2 配置build文件夾中的webpack.base.conf.js

1. 在圖片規則中加入exclude: [resolve('src/assets/icons')]
   排除此文件中的svg圖標
   

由於vue-cli默認情況下會使用 url-loader 對svg進行處理，會將它放在/img 目錄下，所以這時候我們引入svg-sprite-loader 會引發一些衝突。我們可以使用exclude: [resolve(‘src/assets/icons’)]，讓url-loader只處理除此文件夾之外的svg。

2. 加入加載svg規則

   {
     test: /\.svg$/,
     loader: 'svg-sprite-loader',
     include: [resolve('src/assets/icons')],
     options: {
       symbolId: 'icon-[name]'
     }
   },
   

三 配置svg組件

3.1. 在src/components下新建文件夾及文件SvgIcon/index.vue

3.2. index.vue內容

<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 :href="iconName" />
  </svg>
</template>

<script>
// 提示vue中駝峯命名會自動識別爲icon-class格式
// 使用方式
// <!-- icon-class 爲 icon 的名字; class-name 爲 icon 自定義 class-->
export default {
  name: 'SvgIcon',
  props: {
    iconClass: {
      type: String,
      required: true
    },
    className: {
      type: String,
      default: ''
    }
  },
  computed: {
    isExternal () { // 檢測是否是外鏈的形式引入 svg
      return /^(https?:|mailto:|tel:)/.test(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; //  默認會讀取其父級的 color 
  overflow: hidden;
}

.svg-external-icon {
  background-color: currentColor; //  默認會讀取其父級的 color 
  mask-size: cover!important;
  display: inline-block;
}
</style>

3.2 註冊svg組件

在svg同級目錄下新建index.js文件

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

// register globally
Vue.component('svg-icon', SvgIcon)
// 使用webpack的require.context自動引入src/assets/icons/svg下面所有的圖標
const req = require.context('./svg', false, /\.svg$/)
const requireAll = requireContext => requireContext.keys().map(requireContext)
requireAll(req)

3.3 引入註冊文件到main.js

全局使用

import './assets/icons' // icon

svg配置完成

四 使用方式

默認在 @/assets/icons 中註冊到全局中，可以在項目中任意地方使用。所以圖標均可在 @/assets/icons/svg。可自行添加或者刪除圖標，所以圖標都會被自動導入，無需手動操作。

1. 使用

   !-- icon-class 爲 icon 的名字; class-name 爲 icon 自定義 class-->
   <svg-icon icon-class="password"  class-name='custom-class' />
   

2. 改變顏色

   svg-icon 默認會讀取其父級的 color fill: currentColor;
   你可以改變父級的color或者直接改變fill的顏色即可。

3. 使用外鏈
   支持使用外鏈的形式引入 svg。例如：

   <svg-icon icon-class="https://xxxx.svg />

4. 大小
   這裏圖標默認使用的都是 128*128 大小規格的，可自行根據情況修改
   但大小最後統一
   最後附圖