1. 为什么自定义图标
使用组件库自带图标虽然也很方便,但为了更多的灵活性,动态渲染图标,使用更多组件库中没有的组件,所以需要自定义图标组件。
2. svg下载导入项目
- 下载需要的svg图标,放入src/assets/icons/svg下
阿里图标库地址: https://www.iconfont.cn/
3. 导入依赖,依赖配置
- 导入依赖
npm install fast-glob
npm install vite-plugin-svg-icons
- vite.config.ts 配置:
import { createSvgIconsPlugin } from 'vite-plugin-svg-icons'
// 配置自定义icon
createSvgIconsPlugin({
iconDirs: [path.resolve(process.cwd(), 'src/assets/icons/svg')],
symbolId: '[name]'
}),
4. 编写组件
src\components\SvgIcon\index.vue
<template>
<!-- svg:图标外层容器节点,内部需要与use标签结合使用 -->
<svg :style="{ width, height }">
<!-- xlink:href执行用哪一个图标,属性值务必#icon-图标名字 -->
<!-- use标签fill属性可以设置图标的颜色 -->
<use :xlink:href="prefix + name" :fill="color"></use>
</svg>
</template>
<script lang="ts" setup>
//接受父组件传递过来的参数
defineProps({
//xlink:href属性值前缀
prefix: {
type: String,
default: "#",
},
//提供使用的图标名字
name: String,
//接受父组件传递颜色
color: {
type: String,
default: "",
},
//接受父组件传递过来的图标的宽度
width: {
type: String,
default: "16px",
},
//接受父组件传递过来的图标的高度
height: {
type: String,
default: "16px",
},
})
</script>
<style lang="scss" scoped>
</style>
5. 全局注册
在main.ts
// 注册全局组件
import SvgIcon from '@/components/SvgIcon/index.vue';
import 'virtual:svg-icons-register';
// 注册自定义全局组件
app.component('svg-icon', SvgIcon);
使用示例: