跳到主要内容

Icon 图标 ​

uni-appH5微信小程序App

uni-app 跨端图标组件。使用 base64 data URL 在小程序与原生 App 中渲染 SVG 图标。

何时使用 ​

需要在跨端场景下展示一致矢量图标。

何时不使用 ​

需要复杂渐变或动态 SVG 动画时,考虑使用条件编译自定义实现。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Icon 图标 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
namestring-图标名称,对应 icons.ts 中的键名
sizenumber | string24图标尺寸,默认 24px;传入数字时自动补 px,也可传入带单位的字符串
colorstring"currentColor"图标颜色,默认继承父级文字颜色

示例 ​

常用图标 ​

vue
<view class="row">
  <Icon name="home" :size="22" color="#3b6ef6" />
  <Icon name="star" :size="22" color="#e2a03f" />
  <Icon name="bell" :size="22" color="#f56c6c" />
  <Icon name="user" :size="22" color="#22a06b" />
  <Icon name="settings" :size="22" color="#8b5cf6" />
  <Icon name="search" :size="22" color="#06b6d4" />
</view>

尺寸阶梯 ​

vue
<view class="row">
  <Icon name="star" :size="14" />
  <Icon name="star" :size="18" />
  <Icon name="star" :size="24" />
  <Icon name="star" :size="32" />
  <Icon name="star" :size="40" />
</view>

方向与操作 ​

vue
<view class="row">
  <Icon name="arrow-left" :size="20" />
  <Icon name="arrow-right" :size="20" />
  <Icon name="chevron-down" :size="20" />
  <Icon name="plus" :size="20" />
  <Icon name="check" :size="20" color="#22a06b" />
  <Icon name="trash" :size="20" color="#f56c6c" />
</view>

自定义颜色 ​

vue
<view class="row">
  <Icon name="star" :size="24" color="#f7b500" />
  <Icon name="bell" :size="24" color="#3b6ef6" />
  <Icon name="success" :size="24" color="#22a06b" />
</view>