Avatar 头像
uni-appH5微信小程序App
跨端头像,支持图片、名称首字和图标回退。
何时使用
用户/实体标识展示:评论列表、成员列表、个人中心头部。
何时不使用
需要大图预览用图片组件;纯装饰性图标直接用 Icon。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
src | string | "" | 图片地址;加载失败时回退到 name 首字符或 icon |
name | string | "" | 名称;无图(或图片加载失败)时取首字符展示 |
size | string | number | "md" | 尺寸:sm 28 / md 36 / lg 44,也可传 number 自定义 px |
shape | string:'circle' | 'square' | "circle" | 形状:circle 圆形,square 圆角方形(radius-md) |
icon | string | "" | 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>