在 Vue 项目中如何使用 svg?

在 vue 项目中我们可以使用 svg 来导入图标。以后台管理系统为例。

涉及相关文件及目录

  • 静态资源文件夹下的 icons/svg 用来存放 svg 图标;
  • 静态资源文件夹下的 icons/index.js 用来全局导入组件及实现自动导入所有图标;
  • vue.config.js 文件中配置 loader;

使用步骤

1. 安装 svg-sprite-loader

2. 配置 loader 及 svg 图标存放目录

在 vue.config.js 文件我们做如下配置:

js 复制代码
const path = require("path");

function resolve(dir) {
  return path.join(__dirname, dir);
}

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

3. 自动导入所有图标

  • 在 icons/index.js 中编写自动导入的逻辑代码;
js 复制代码
// icons/index.js
const req = require.context('./svg', false, /\.svg$/)
const requireAll = requireContext => requireContext.keys().map(requireContext)
requireAll(req)
  • 在 main.js 中引入;
js 复制代码
// main.js
import "./assets/icons/index";

4. 创建使用 svg 图标的公共组件

将使用 svg 图标的代码封装成一个公共的组件。

在 src/components 下创建 SvgIcon 目录

html 复制代码
<!-- SvgIcon/index.vue -->
<template>
  <svg :class="svgClass" aria-hidden="true" v-on="$listeners">
    <use :xlink:href="iconName" />
  </svg>
</template>
js 复制代码
export default {
  name: 'SvgIcon', // 组件名
  props: {
    iconClass: {
      type: String,
      required: true
    },
    className: {
      type: String,
      default: ''
    }
  },
  computed: {
    iconName() {
      return `#icon-${this.iconClass}`
    },
    svgClass() {
      if (this.className) {
        return 'svg-icon ' + this.className
      } else {
        return 'svg-icon'
      }
    }
  }
}

5. 全局注册组件

在 icons/index.js 中全局注册该组件

js 复制代码
import Vue from 'vue'
import SvgIcon from '@/components/SvgIcon'// svg component

Vue.component('svg-icon', SvgIcon)

6. 使用 svg 图标

当我们需要使用 svg 图标时,可以导入通用的组件 SvgIcon。

由于组件是全局注册的,因此可以直接使用:

html 复制代码
<svg-icon icon-class="user"></svg-icon>

icon-class 属性的值为 svg 文件夹下图标文件的名称。

相关推荐
zhensherlock24 分钟前
Protocol Launcher 系列:CodeHub 移动端 GitHub 协作利器
前端·javascript·typescript·node.js·自动化·github·js
tryCbest5 小时前
Vue3——第 22 篇:Pinia——新一代状态管理(上)
前端·javascript·vue.js
bai2736 小时前
"👨‍👩‍👧‍👦" 的 length 是 11:我把自己写的字数统计脚本拖出来审了一遍
前端·javascript
zhanlang02177 小时前
HTML 零基础入门到企业实战【第八章 8.5】画布 canvas、SVG 矢量图形基础入门
前端·html
星云_byto8 小时前
CSS面试题
前端·css
zhanlang02178 小时前
HTML 零基础入门到企业实战全套教程【连载 8.4】HTML5 新增表单属性与表单控件
前端·html·html5
科研邪修法16 小时前
PDF新增页面文字与文本批注怎么区分?以双版本培训讲义为例
前端·css·pdf
Lanwarf-前端开发18 小时前
Vue3 + Canvas/WebGL 雷达扫描可视化实战:PPI、RHI、VOL、SVOL 四种模式原理与实现
前端·javascript·vue.js·webgl
FRing0318 小时前
vue3干货总结2(vue3生命周期、父子通信、模版引用、provide和inject)
开发语言·前端·vue.js·vue3
锋行天下20 小时前
langgraph 全栈项目(三)
前端·人工智能·后端