Avatar 头像
WebH5
头像。支持图片、名称首字符、图标三种形态,图片加载失败自动回退,圆形/圆角方形可选。
何时使用
用户/实体标识展示:评论列表、成员列表、个人中心头部。
何时不使用
需要大图预览用图片组件;纯装饰性图标直接用 Icon。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
src | string | "undefined" | 图片地址;加载失败时回退到 name 首字符或 icon |
name | string | "undefined" | 名称;无图(或图片加载失败)时取首字符展示 |
size | number | string:'sm' | 'md' | 'lg' | "md" | 尺寸:sm 28 / md 36 / lg 44,也可传 number 自定义 px |
shape | string:'circle' | 'square' | "circle" | 形状:circle 圆形,square 圆角方形(radius-md) |
icon | string | "undefined" | rn-icon 图标名(如 user);src/name 都缺省时展示 |
示例
名称与图标
示例加载中…
图片加载失败回退
示例加载中…
尺寸与形状
示例加载中…
Playground
加载中…
md
circle
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Avatar 文档(含手机预览)。