介绍
基于字体的图标集,可以通过 Icon 组件使用,也可以在其他组件中通过icon属性引用
引入
import Vue from vue;
import { Icon } from vant;
Vue.use(Icon);
代码演示
基础用法
Icon的name属性支持传入图标名称或图片链接,所有可用的图标名称见右侧示例
<van-icon name="chat-o" />
<van-icon name="https://b.yzcdn.cn/vant/icon-demo-1126.png" />
提示信息
设置dot属性后,会在图标右上角展示一个小红点。设置info属性后,会在图标右上角展示相应的徽标
<van-icon name="chat-o" dot />
<van-icon name="chat-o" info="9" />
<van-icon name="chat-o" info="99+" />
图标颜色
Icon的color属性用来设置图标的颜色
<van-icon name="chat-o" color="#1989fa" />
<van-icon name="chat-o" color="#07c160" />
图标大小
Icon的size属性用来设置图标的尺寸大小,默认单位为px
<van-icon name="chat-o" size="40" />
<van-icon name="chat-o" size="3rem" />
使用本地字体文件
Icon 组件默认引用有赞 CDN 提供的字体文件,并通过网络下载。如果需要在项目中使用本地字体文件,请引入下面的 CSS 文件,并在项目中配置url-loader
import vant/lib/icon/local.css;
自定义图标
如果需要在现有 Icon 的基础上使用更多图标,可以引入第三方 iconfont 对应的字体文件和 CSS 文件,之后就可以在 Icon 组件中直接使用
/* 引入第三方或自定义的字体图标样式 */
@font-face {
font-family: my-icon;
src: url(./my-icon.ttf) format(truetype);
}
.my-icon {
font-family: my-icon;
}
.my-icon-extra::before {
content: e626;
}
<!-- 通过 class-prefix 指定类名为 my-icon -->
<van-icon class-prefix="my-icon" name="extra" />
API
Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
name | 图标名称或图片链接 | string | – |
dot v2.2.1 | 是否显示图标右上角小红点 | boolean | false |
info | 图标右上角徽标的内容 | number | string | – |
color | 图标颜色 | string | inherit |
size | 图标大小,如 20px 2em ,默认单位为px | number | string | inherit |
class-prefix | 类名前缀 | string | van-icon |
tag | HTML 标签 | string | i |
Events
事件名 | 说明 | 回调参数 |
---|---|---|
click | 点击图标时触发 | event: Event |