Vue.js 图标选择组件实践

41次阅读

共计 2711 个字符,预计需要花费 7 分钟才能阅读完成。

背景
最近项目中在做一个自定义菜单需求,其中有一个为菜单设置小图标的功能,就是大家常见的左侧菜单
设置图标不难,方案就是字体图标,可供使用的图标库也有很多,比如阿里巴巴的 Iconfont,以及 Fontaswsome 等,问题在于如何优雅的提供几百个图标供用户选择,而不需要开发去一个一个的写标签,也不需要一个个的去找图标。
字体图标库 Fontawesome 方案
我们使用字体图标的方式,一般是一个 <i class=”iconfont icon-home”></i> 这样的标签,平常开发中用一些图标都是用到一个写一个,展示 10 个图标,就要写 10 个标签。
在项目中本人使用的是 Fontawesome 图标库方案,使用它是因为提供的可用图标比较丰富,基本上不需要特意去找合适的图标,直接把它的图标库下载过来,免费的有 800 多个。
这么多图标难道要一个一个手写 800 多个 i 标签吗?三连拒绝!
Fontawesome 下载后的文件中提供一个 svg 格式的精灵图,这个非常人性化,用 VSCode 打开这个 SVG 文件
可以看到是熟悉的 DOM,因为 SVG 本质上就是一个 XML,既然是 DOM,那么祭出 JS 大法吧,用浏览器打开这个 SVG 文件,在控制台编写如下代码获取所有的图标名称:
const nodeArray = Array.from(document.querySelectorAll(‘symbol’));
const names = nodeArray.map(item => item.id)
names.toString()

Icons 组件
大牛可以忽略
拿到了所有图标的 name 那就好办了,一个数组循环呗。先别急着写代码,我们的目的是封装成组件复用,那么先创建一个 Icons 组件
提供一个筛选框,然后给一个事件即可
<template>
<div class=”ui-fas”>
<el-input v-model=”name” @input.native=”filterIcons” suffix-icon=”el-icon-search” placeholder=” 请输入图标名称 ”></el-input>
<ul class=”fas-icon-list”>
<li v-for=”(item, index) in iconList” :key=”index” @click=”selectedIcon(item)”>
<i class=”fas” :class=”[‘fa-‘ + item]” />
<span>{{item}}</span>
</li>
</ul>
</div>
</template>
<script>
import fontawesome from ‘@/extend/fontawesome/solid.js’
export default {
name: ‘compIcons’,
data () {
return {
name: ”,
iconList: fontawesome
}
},
methods: {
filterIcons () {
if (this.name) {
this.iconList = this.iconList.filter(item => item.includes(this.name))
} else {
this.iconList = fontawesome
}
},
selectedIcon (name) {
this.$emit(‘selected’, name)
},
reset () {
this.name = ”
this.iconList = fontawesome
}
}
}
</script>
先把拿到的所有图标 name 放到一个 solid.js 文件中,输出为数组,在组件中引入,然后就是循环数组 iconList,输出 i 标签,Fontawesome 的使用方式是:<i class=”fas fas- 图标 name”></i>。
筛选功能利用数组的 filter 方法,this.$emit(‘selected’, name) 方式返回给父组件图标名称。
以上样式都是利用 Element UI 的 Popover、Input 组件实现
<el-form-item label=” 图标:” >
<el-popover
placement=”left-start”
width=”540″
trigger=”click”
@show=”$refs.icons.reset()”
popper-class=”popper-class”>
<ui-icons ref=”icons” @selected=”selectedIcon” />
<el-input slot=”reference” placeholder=” 请输入内容 ” readonly v-model=”form.menu_icon” style=”cursor: pointer;”>
<template slot=”prepend”><i class=”fas” :class=”[‘fa-‘ + form.menu_icon]”></i></template>
</el-input>
</el-popover>
</el-form-item>
组件实现了,接下来就是引用,既可以直接到导入此组件引用,也可以挂载到全局进行使用,这里说说挂载到全局使用的方式,因为我的项目中所有的公共组件都是挂载到全局的方式使用。
在组件平级新建一个 index.js 文件
import IconsCompontent from ‘./Icons.vue’
const Icons = {
install(Vue) {
Vue.component(‘ui-icons’, IconsCompontent);
}
}
export default Icons;
第 4 行为组件命名,此名称决定了如何使用组件,这里是 ui-icons,那么使用的时候就是:
<ui-icons />
接着在项目 components 根目录新建 index.js,这里是所有组件的集合
最后一步是在 main.js 中注册:
import CustomComponents from ‘./components/index.js’
Object.keys(CustomComponents).forEach(key => Vue.use(CustomComponents[key]))
这样就可以在项目中任意.vue 文件中以 <ui-icons /> 方式使用组件了。
后记
点击图标后要不要关闭图标弹出层(Popover)呢?Popover 是需要鼠标点击其他地方才会隐藏的,选择一个图标后就关闭 Popover 呢,我的做法是:document.body.click()。
selectedIcon (name) {
this.form.menu_icon = name
// document.body.click()
}
…. 完。

正文完
 0