首頁 > 軟體

Vue封裝svg-icon元件使用教學

2023-02-09 06:01:11

一、SVG可縮放向量圖形

SVG(Scalable Vector Graphics)可縮放向量圖形,是一種用於描述基於二維的向量圖形的 XML 標示語言,其基本向量顯示物件包括矩形、圓、橢圓、多邊形、直線、任意曲線等,還能顯示文字物件和嵌入式外部影象(包括 PNG、JPEG、SVG 等)。實際專案中大多數圖示都是使用的 SVG 圖示檔案,其主要有以下幾個優點:

1.內容可讀,檔案是純粹的 XML。

2.影象檔案小,可伸縮性強。

3.向量放縮,能以不犧牲影象質量為前提,進行任意縮放。

4.還能基於 DOM 模型實現動態和一些互動功能

二、SVG在vue專案中的設定與使用

1. 下載

npm install vue-svg-icon xml-loader -D

2. 下載的.svg的檔案,存放於src/icons/svg檔案

3. 設定src/icons/index.js檔案

import Vue from 'vue'
import SvgIcon from '@/components/SvgIcon'// svg component
// register globally
Vue.component('svg-icon', SvgIcon)
// 在./svg下查詢 「.svg」檔案
const req = require.context('./svg', false, /.svg$/)
const requireAll = requireContext => requireContext.keys().map(requireContext)
requireAll(req)

4.在main.js中引入icon/index.js檔案中全域性設定

//全域性載入就可以了
import '@/icons/index.js'

5. 封裝元件

/src/components/svgIcon/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 :xlink:href="iconName" rel="external nofollow"  />
  </svg>
</template>
<script>
// doc: https://panjiachen.github.io/vue-element-admin-site/feature/component/svg-icon.html#usage
import { isExternal } from '@/utils'
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>

6.頁面使用

<div>
  <svg-icon icon-class="peoples" />
</div>

到目前為止使用 < svg-icon icon-class=“left-indent” /> 還沒有效果,因為還缺少組態檔

7. vue.config.js 中設定 svg-sprite-loader

安裝:

npm install svg-sprite-loader -D

設定 vue.config.js:

使用chainWebpack方法可自定義設定 loader vue.config.js

module.exports = { 
   	 chainWebpack: config => {
   	    config.module
   	    .rule('svg')
   	    .exclude.add(resolve('src/icons'))
   	    .end()
   	    config.module
   	    .rule('icons')
   	    .test(/.svg$/)
   	    .include.add(resolve('src/icons'))
   	    .end()
   	    .use('svg-sprite-loader')
   	    .loader('svg-sprite-loader')
   	    .options({
   	      symbolId: 'icon-[name]'
   	    })
   	    .end()
   	  }	
   }

重啟專案遇到報錯:error: resolve is not defined

在vue.config.js中沒有設定 resolve 方法, 需要自定義一個,程式碼如下

const path = require('path')
function resolve(dir) {
  return path.join(__dirname, dir)
}

此時,圖示在頁面已經出效果;

到此這篇關於Vue封裝svg-icon元件使用教學的文章就介紹到這了,更多相關Vue svg icon元件內容請搜尋it145.com以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援it145.com!


IT145.com E-mail:sddin#qq.com