跳到主要内容

Avatar 头像 ​

WebH5

头像。支持图片、名称首字符、图标三种形态,图片加载失败自动回退,圆形/圆角方形可选。

何时使用 ​

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

何时不使用 ​

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

Props ​

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

示例 ​

名称与图标 ​

示例加载中…

图片加载失败回退 ​

示例加载中…

尺寸与形状 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 Avatar 文档(含手机预览)。