文章目录
- 1. 引言
- 2. 项目使用svg图标
-
- 2.1 下载svg图标
- 2.2 注册svg组件
- 2.3 使用svg组件
- 3. 总结
1. 引言
在前面的章节,已经讲解了部分vue-element-admin的知识:
- 《Vue项目实战(01)-vue-element-admin项目结构分析》
- 《Vue项目实战(02)-Vuex状态管理模式》
- 《Vue项目实战(03)-alias》
- 《Vue项目实战(04)-axios封装》
- 《Vue项目实战(05)-多环境配置》
- 《Vue项目实战(06)- 钩子方法触发失败的解决》
- 《Vue项目实战(07)- 登录权限分析》
- 《Vue项目实战(08)- css预处理器》
本文主要讲解vue-element-admin是如何使用svg
图标的。
2.1 下载svg图标
① svg
图标可以去https://www.iconfont.cn查找合适的icon,选择svg下载。
② 下载完成后,在vue-element-admin项目,可以看到图标放到了src/icons/svg
目录
2.2 注册svg组件
③ 在上图,可以看到在src/icons
目录下有一个index.js
文件,其功能就是把组件注册到全局,具体代码如下(使用webpack
的require.context
自动引入src/icons
下面所有的图标):
import Vue from 'vue'
import SvgIcon from '@/components/SvgIcon'// svg component
// register globally
Vue.component('svg-icon', SvgIcon)
const req = require.context('./svg', false, /\.svg$/)
const requireAll = requireContext => requireContext.keys().map(requireContext)
requireAll(req)
④ 可以看到上面的代码引入了SvgIcon
组件(目录src/components/SvgIcon
),具体的代码如下:
<template>
<div v-if="isExternal" :style="styleExternalIcon" class="svg-external-icon svg-icon" v-on="$listeners" />
<svg v-else :class="svgClass" aria-hidden="true" v-on="$listeners">
<use :xlink:href="iconName" />
</svg>
</template>
<script>
// doc: https://panjiachen.github.io/vue-element-admin-site/feature/component/svg-icon.html#usage
import { isExternal } from '@/utils/validate'
export default {
name: 'SvgIcon',
props: {
iconClass: {
type: String,
required: true
},
className: {
type: String,
default: ''
}
},
computed: {
isExternal() {
return isExternal(this.iconClass)
},
iconName() {
return `#icon-${this.iconClass}`
},
svgClass() {
if (this.className) {
return 'svg-icon ' + this.className
} else {
return 'svg-icon'
}
},
styleExternalIcon() {
return {
mask: `url(${this.iconClass}) no-repeat 50% 50%`,
'-webkit-mask': `url(${this.iconClass}) no-repeat 50% 50%`
}
}
}
}
</script>
<style scoped>
.svg-icon {
width: 1em;
height: 1em;
vertical-align: -0.15em;
fill: currentColor;
overflow: hidden;
}
.svg-external-icon {
background-color: currentColor;
mask-size: cover!important;
display: inline-block;
}
</style>
⑤ 在main.js
中引入icon
(目录src/main.js
):
2.3 使用svg组件
举个例子,在登录页面(目录: src/views/login/index.vue
),可以看到使用了svg图标,使用方式如下(这里使用了使用 src/icons/svg/user.svg
文件):
到这里,vue-element-admin使用svg
图标的流程讲解完毕,本文完!