前述
hello,大家好。好就没更新啦,是不是很想我~ 😜。拖更这么久,也没什么原因,哈哈哈,纯粹是懒... 看了一眼距离上次写文章已经过去四个月之久,咦惹~
好了,现在就直接进入正题吧,今天要说的是关于svg的配置以及使用。
为什么要说这个呢,主要是最近一直在看vue3相关的知识,顺便用vite搭了一个项目,以及使用了ts。
在自己的搭建的项目中,本来是想简单点使用的一些公共组件库,但是很鸡肋。没法满足一些特定的业务需求,于是乎,就打算自己写一套。继而呢,就决定用svg,就在这时,发现怎么感觉哪哪都在报错???黑人问号脸,于是就花时间去看了一下。嚯,果然小有差异。于是就有了这篇文章,记录一下。
那就开始咯~
正文
准备工作
安装依赖
npm install svg-sprite-loader -D
yarn add svg-sprite-loader -D
组件编写
在安装好相关依赖之后,就开始写一个公共组件暴露出去吧。这个组件的目的,不言而喻,不做解释啦。
// src/components/svgIcon.vue
<!--只需要给一个dom存放svg即可-->
<template>
<svg :class="svgClass" v-bind="$attrs" :style="{ color: color }">
<!--这边是做一个联动,根据传入的name来展示相关的svg-->
<use :xlink:href="iconName" />
</svg>
</template>
<script lang="ts">
import { defineComponent, computed } from "vue";
export default defineComponent({
name: "SvgIcon",
props: { // 因为是被调用,所以要传入props
name: { // 自定义svg的name属性
type: String,
required: true,
},
color: { // 自定义svg的color属性
type: String,
default: "",
},
},
setup(props) { // 数据处理
// 这边就是根据props的name来进行处理啦
const iconName = computed(() => `#icon-${props.name}`);
const svgClass = computed(() => {
// console.log(props.name, "props.name");
if (props.name) {
return `svg-icon icon-${props.name}`;
}
return "svg-icon"; // svg 标签
});
return {
iconName,
svgClass,
};
},
});
</script>
// 自己定一些喜欢的样式
<style lang="scss">
.svg-icon {
width: 1.6em;
height: 1.6em;
margin-left: 3px;
}
</style>
具体的解释看注解哦~ 接下来看继续下一步。
svg编写
// src/icons/svg/
这个地方就是存放各种你想写入的svg;
eg:
这些文件夹放的位置啊,取名啊,全凭个人爱好,想怎么操作,就怎么操作。(怎么开心怎么来,当然最好正式一点。
全局注入
在main.ts 里面全局注入svg-icon组件,此举是注入灵魂之举。哈哈哈哈
//main.ts
import svgIcon from './components/SvgIcon.vue'
app.use(router).use(store, key).use(ElementPlus, { i18n: i18n.global.t, size: globalComponentSize }).use(i18n).use(VueGridLayout).component('svg-icon', svgIcon).mount('#app');
此举的目的是在全局都可挂载此组件。
关于vite中的plugin(这是重点)
如果你是用的ts,那么这就是重点了,因为不做这一步,就不回生效,各种报错,具体可以参考下
这也是其中一个机制。
好了,说好前文,就开始整活吧
// src/plugins/Builder.js
import { readFileSync, readdirSync } from 'fs'
let idPerfix = ''
const svgTitle = /<svg([^>+].*?)>/
const clearHeightWidth = /(width|height)="([^>+].*?)"/g
const hasViewBox = /(viewBox="[^>+].*?")/g
const clearReturn = /(\r)|(\n)/g
function findSvgFile(dir) {
const svgRes = []
const dirents = readdirSync(dir, {
withFileTypes: true
})
for (const dirent of dirents) {
if (dirent.isDirectory()) {
svgRes.push(...findSvgFile(dir + dirent.name + '/'))
} else {
const svg = readFileSync(dir + dirent.name)
.toString()
.replace(clearReturn, '')
.replace(svgTitle, ($1, $2) => {
// console.log(++i)
// console.log(dirent.name)
let width = 0
let height = 0
let content = $2.replace(
clearHeightWidth,
(s1, s2, s3) => {
if (s2 === 'width') {
width = s3
} else if (s2 === 'height') {
height = s3
}
return ''
}
)
if (!hasViewBox.test($2)) {
content += `viewBox="0 0 ${width} ${height}"`
}
return `<symbol id="${idPerfix}-${dirent.name.replace(
'.svg',
''
)}" ${content}>`
})
.replace('</svg>', '</symbol>')
svgRes.push(svg)
}
}
return svgRes
}
export const svgBuilder = (path, perfix = 'icon') => {
if (path === '') return
idPerfix = perfix
const res = findSvgFile(path)
// console.log(res.length)
// const res = []
return {
name: 'svg-transform',
transformIndexHtml(html) {
return html.replace(
'<body>',
`
<body>
<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="position: absolute; width: 0; height: 0">
${res.join('')}
</svg>
`
)
}
}
}
一发入魂
最后的最后,就是去vite.config.ts 中配置了,目的是将src/icons/svg/下的svg全部导入,不用你写一个导入一个,联动起来,是不是很虚浮?
import { svgBuilder } from './src/plugins/svgBuilder';
plugins: [
svgBuilder('./src/icons/svg/')
],
使用
好了,全部事情都做完之后,就可以进行使用啦。
具体使用:
// 在你具体的vue项目中 导入 & 引用
import SvgIcon from "@/components/SvgIcon.vue";
//
components: { SvgIcon },
//
<SvgIcon :name="fail"></SvgIcon>
如果你想把这个icon 在你的其他组件中进行封装,也很简单奥~
结语
好了,关于vite打包构建的vue3项目下,如何使用svg就讲完了。
接下来也不知道下次更新会在设么时候,不确定。
最近也不知道该做什么,该怎么走。换言之,内心强烈的知道自己要干什么,怎么做。遇到了一个漫长的瓶颈期。
好啦,看完这篇就早点下班吧~ 祝各位双休愉快。嗨起来~ 拜拜~