Icon 图标选择器

选择icon图标的组件,默认图标库使用@element-plus/icons-vue,您也可以自行拓展本地文件或者三方图标库

基础用法

点击即可选中图标,再次点击取消选中。需要根据组件数量通过调整pagination初始化属性进行组件最佳效果展示。pagination属性同pagination

尺寸

可以通过icon-background-sizeicon-size属性对尺寸进行调整

颜色

通过修改icon-coloricon-background-colorselected-colorbackground-color属性个性化你的展示

多选

使用multiple属性来设置多选。 此时v-model绑定的值变成数组。

使用自定义图标

通过icons属性传递图标的svg模板字符串,同时可以将use-default-icon属性设置为false屏蔽自带组件库

过滤

通过filter属性可以对图标集进行过滤,可以配合search插槽进行组件内过滤

自定义渲染

通过icon插槽可以自定义渲染dom,这在你项目里已经使用了三方icon解析组件时很有用

与反馈组件一起使用

属性

属性名说明类型可选值默认值
v-model绑定值string/ string[] / null / undefined
icons要添加的图标列表{name:string;val:string}[][]
pagination分页属性,同pagination
iconBackgroundSize图标背景的大小stringlarge / default / smalldefault
filter过滤条件string
iconColor图标颜色string#000000
backgroundColor组件背景颜色string#ffffff
selectedColor选中的图标颜色string#409eff
iconSize图标大小number24
multiple多选booleanfalse
hiddenPagination是否隐藏分页,分页功能仍然可用,如果你需要自定义分页组件,请隐藏它booleanfalse
useDefaultIcon是否使用默认的图标集booleantrue
scrollbarscrollbar

插槽

插槽名说明
default自定义渲染区
search过滤组件区

源代码

组件文档

贡献者