vue3使用vite构建如何引入svg图标

强烈推荐使用 vite-svg-loader库。该库每周 npm 下载量大概12w,目前版本已经更新到了 5.1.0,使用方式极其简单,官方文档示例清晰易懂。

本文将简单介绍一下该库的使用方法,更多进阶用法可自行查看官方文档。

1. 安装 vite-svg-loader 库

bash 复制代码
npm install vite-svg-loader --save-dev

2. 在 vite.config 中注册

js 复制代码
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

import svgLoader from 'vite-svg-loader'

export default defineConfig({
  plugins: [
      vue(), 
      svgLoader()
  ]
}

3. 在组件中使用 svg 图标

直接在组件的 script 中引入图标即可在 template 中使用,像引入组件一样。

vue3 复制代码
<script setup>
import IconTest from '@/assets/svg/test.svg'
<script>

<template>
    <IconTest />
</template>

4. 注意事项

如果你想要图标的颜色、大小,自动跟随字体的颜色、大小,那么你可能需要修改下载的 svg 文件。

  • svg 元素上添加一个 fill="currentColor" 属性,并移除 path 元素上的 fill 属性。如下图:

  • 或者,在 svg 元素上添加一个 class="svg-icon" 属性,也要移除 path 元素上的 fill 属性,最好将设置这个类的样式文件全局引入(也可以将这个类添加在 app.vue 中)。样式内容如下:

    css 复制代码
    .svg-icon {
      width: 1em;
      height: 1em;
      fill: currentColor;
    }

主要参考了 vite-svg-loader 的官方文档

相关推荐
原则猫2 小时前
HOOKS 背后机制
前端
码语智行2 小时前
首页导航跳转功能深度解析-系统内和系统外
前端
阿猫的故乡3 小时前
Vue过渡动画从入门到装X:淡入淡出、滑动、列表动画、第三方库全搞定
前端·javascript·vue.js
裕波3 小时前
Vue&ViteConf 2026 将于 7 月 18 日在上海举办,尤雨溪将现场发表主题演讲
vue.js·vite
IManiy3 小时前
总结之Vibe Coding前端骨架
前端
JS菌3 小时前
AI Agent 沙箱双层防护体系:从权限过滤到内核隔离的完整实现
前端·人工智能·后端
Aphasia3113 小时前
从输入URL到页面展示全流程
前端·面试
我叫黑大帅4 小时前
前端如何竖屏固定视口背景
前端·javascript·面试
abcy0712134 小时前
python pandas csv异步后台清洗前端优先返回成功信息
前端·python·pandas
IT_陈寒4 小时前
Vite这个坑我帮你踩了,动态导入居然这样才生效
前端·人工智能·后端