目录
Vue3 + Vite 项目使用 svg 加载 iconfont 的最佳实践
1 为什么需要使用 iconfont？
一般情况下，Vue3 项目会搭配使用 Element Plus 组件 UI 库，因此大部分情况下可以直接使用其自带的图标 el-icon 。但是，有时候我们想要使用的图标在 el-icon 中不存在，这时就要寻找其他的图标库资源了（ps：大佬们可以自己设计绘画图标，doge~）。通常我们会使用 iconfont ——它是阿里巴巴提供的矢量图标管理、交流平台，提供了丰富的图标、插画以及字体资源。
2 如何在 Vue3 + Vite 项目中使用 iconfont？
2.1 封装 SvgIcon.vue 组件
在 src/component 文件夹下新建 SvgIcon.vue 文件，添加如下代码：
<template>
<svg :class="svgClass" aria-hidden="true">
<use :xlink:href="iconClassName" :fill="color" />
</svg>
</template>
<script setup lang="ts">
import {
computed } from 'vue'
const props = defineProps({
iconName: {
type: String,
required: true
},
className: {
type: String,
default: ''
},
color: {
type: String,
default: '#409eff'
},
size: {
type: String,
default: '1em'
}
})
// 图标在 iconfont 中的名字
const iconClassName = computed(()=>{
return `#${
props.iconName}`
})
// 给图标添加上类名
const svgClass = computed(() => {
if (props.className) {
return `svg-icon ${
props.className}`
}
return 'svg-icon'
});
</script>
<style scoped>
.svg-icon {
/* v-bind 是 Vue3 才支持的功能，可以将 CSS 的值与 js 的值绑定 */
width: v-bind('props.size');
height: v-bind('props.size');
position: relative;
fill: currentColor;
vertical-align: -2px;
}
</style>
组件封装好以后需要在 main.js 中全局注册一下，不然每次使用图标时还要单独引入一次该组件。
import {
createApp } from 'vue'
import App from './App.vue'
import SvgIcon from './components/common/SvgIcon.vue'
const app = createApp(App)
app.component('SvgIcon', SvgIcon)
app.mount('#app')
2.2 引入 iconfont
进入 iconfont 官网，输入图标名后按下回车，如下图所示：
将鼠标悬浮到自己喜欢的图标上，然后点击添加入库图标，如下图所示：
然后点击导航栏购物车图标，然后在侧边栏中点击添加至项目按钮，如下图所示：
之后会自动跳转至个人项目页面，然后按下图进行点击：
将网页中的 js 代码全部选中后复制（按下键盘上的 Ctrl + A 后鼠标右键）：
回到项目文件夹中在 src/assets 下新建 iconfont 文件夹，然后在其下面新建 iconfont.js 文件，最后把刚刚复制的 js 代码粘贴到该文件中。
然后在 main.js 中引入这个文件。
import './assets/iconfont/iconfont.js'
2.3 具体使用示例
直接在具体页面（.vue 文件）的 template 标签中使用即可。
<template>
<img alt="Vue logo" src="./assets/logo.png" />
<svg-icon iconName="icon-like"></svg-icon>
<svg-icon iconName="icon-star" color="green"></svg-icon>
</template>
2.4 如何改变图标的 hover 效果？
svg 图标不同于 class 样式，其无法直接通过修改 hover 样式来设置鼠标悬浮在图标上面时颜色改变，这个时候我们就需要换一种思路了。我们在 SvgIcon.vue 中传入了 color 属性，并且通过 fill 将 color 作用到 svg 图标上，因此我们可以在父组件中通过监听鼠标悬浮事件修改 color 的值来改变 hover 效果。
<template>
<div class="icon-wrapper" @mouseenter="handleMouseenter" @mouseleave="handleMouseleave">
<SvgIcon iconName="icon-star" :color="iconColor"></SvgIcon>
</div>
</template>
<script setup>
const iconColor = ref('grey')
const handleMouseenter = () => {
iconColor.value = 'blue'
}
const handleMouseleave = () => {
iconColor.value = 'grey'
}
</script>
文章评论