跳到主要内容

Avatar 头像 ​

uni-appH5微信小程序App

跨端头像,支持图片、名称首字和图标回退。

何时使用 ​

用户/实体标识展示:评论列表、成员列表、个人中心头部。

何时不使用 ​

需要大图预览用图片组件;纯装饰性图标直接用 Icon。

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

9:41
Avatar 头像 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
srcstring""图片地址;加载失败时回退到 name 首字符或 icon
namestring""名称;无图(或图片加载失败)时取首字符展示
sizestring | number"md"尺寸:sm 28 / md 36 / lg 44,也可传 number 自定义 px
shapestring:'circle' | 'square'"circle"形状:circle 圆形,square 圆角方形(radius-md)
iconstring""rn-icon 图标名(如 user);src/name 都缺省时展示

示例 ​

字符与图标 ​

vue
<view class="row">
  <Avatar name="Ruanno" />
  <Avatar name="李" />
  <Avatar icon="user" />
</view>

尺寸 ​

vue
<view class="row">
  <Avatar size="sm" name="S" />
  <Avatar size="md" name="M" />
  <Avatar size="lg" name="L" />
  <Avatar :size="56" name="56" />
</view>

方形头像 ​

vue
<view class="row">
  <Avatar shape="square" name="方" />
  <Avatar shape="square" icon="home" />
</view>