Skip to content

Icon 图标

基于字体的图标集,包含了大多数常见场景的图标。

平台差异说明

App(vue)App(nvue)H5小程序

基本使用


注意

因为在nvue下暂时无法解决自定义图标的问题,所以此功能暂缓推出。

icon下载地址


通过<up-icon>形式来调用,设置name参数为图标名即可。其中color默认为#606266size默认为16px

html
<up-icon name="photo"></up-icon>

修改图标的样式

  • 通过color参数修改图标的颜色
  • 通过size参数修改图标的大小,单位为px
html
<up-icon name="photo" color="#2979ff" size="28"></up-icon>

图片图标

这里说的图片图标,指的是小图标,起作用定位为"icon"图标作用,而非大尺寸的图片展示场景,理论上,这个小图标应该为png格式的正方形图标。

上面说到,给组件的name参数传入一个图片的名称即可显示字体图标,这些名称中不能带有/斜杠符号,否则会被认为是传入了图片图标,同时,size参数 也被设置为这个图片图标的宽度,由于是图片,诸如颜色color等参数都会失效。

html
<up-icon label="uview-ultra" size="40" name="https://cdn.uviewui.com/uview/example/button.png"></up-icon>

右侧演示页面源代码地址

点击以下链接以查看右侧演示页面的源码


 github  gitee

API

Props

参数说明类型默认值可选值
name图标名称,见示例图标集,如名称带有/,会被认为是图片图标String--
color图标颜色Stringcolor['up-content-color']-
size图标字体大小,单位默认pxString | Number16px-
bold是否显示粗体Booleanfalse-
index一个用于区分多个图标的值,点击图标时通过click事件传出String | Number--
hoverClass图标按下去的样式类,用法同uni的view组件的hover-class参数,详见:hover-classString--
customPrefix(暂不可用)自定义字体图标库时,需要写上此值,详见:扩展自定义图标库Stringuicon-
label图标右侧/下方的label文字String | Number--
labelPoslabel相对于图标的位置Stringrightbottom / top / left
labelSizelabel字体大小,单位默认pxString | Number15px-
labelColorlabel字体颜色Stringcolor['up-content-color']-
spacelabel与图标的距离,单位默认pxString | Number3px-
imgMode图片裁剪、缩放的模式,image组件原生属性,详见:imageString--
widthname为图片路径时图片的宽度,单位默认pxString | Number--
heightname为图片路径时图片的高度,单位默认pxString | Number--
top图标到顶部的距离,如果某些场景,如果图标没有垂直居中,可以调整此参数,单位默认pxString | Number0-
stop是否阻止事件传播Booleanfalse-

Events

事件名说明回调参数版本
click点击图标时触发index: 通过props传递的index-

图标集