Icon 图标

引入

通过以下方式来全局注册组件,更多注册方式请参考。

基础用法

通过 name 属性来指定需要使用的图标,Vant 内置了一套图标库(见右侧示例),可以直接传入对应的名称来使用。

  1. <van-icon name="chat-o" />
  1. <van-icon name="https://cdn.jsdelivr.net/npm/@vant/assets/icon-demo.png" />

徽标提示

设置 dot 属性后,会在图标右上角展示一个小红点;设置 badge 属性后,会在图标右上角展示相应的徽标。

图标颜色

通过 color 属性来设置图标的颜色。

  1. <!-- 不指定单位,默认使用 px -->
  2. <van-icon name="chat-o" size="40" />
  3. <!-- 指定使用 rem 单位 -->
  4. <van-icon name="chat-o" size="3rem" />

自定义图标

如果需要在现有 Icon 的基础上使用更多图标,可以引入第三方 iconfont 对应的字体文件和 CSS 文件,之后就可以在 Icon 组件中直接使用。

  1. <!-- 通过 class-prefix 指定类名为 my-icon -->
  2. <van-icon class-prefix="my-icon" name="extra" />

API

Props

事件名说明回调参数
click点击图标时触发event: MouseEvent

类型定义

组件导出以下类型定义: