头像
Avatar
UI 组件也叫:用户头像、头像框、Profile Picture、头像组
一句话:用圆形或圆角方形的小图片代表一个人或一个账号,没有图片时显示姓名首字或默认图标。
详细解释
头像是一个小尺寸的圆形或圆角方形图片,用来代表用户、团队成员或某个账号。它常出现在导航栏右上角、评论和消息列表的左侧、成员名单里。用户没有上传图片时,一般显示姓名的第一个字或默认人像图标,配上灰色或按名字生成的底色。
多个头像可以错开叠成一排,组成头像组,超出数量时显示「+5」这样的计数。头像右下角的小圆点表示在线状态,右上角的红色数字表示未读消息,这两者属于徽标的用法。
头像和普通图片的区别在于用途:头像只用来识别「这是谁」,尺寸小、统一裁成圆形;商品图、文章配图这类内容图片应该用图片组件展示。
示例
灰度线框示意,只表达结构,不代表具体视觉风格。
怎么跟 AI 说
可以直接贴给 Cursor、Claude Code 等工具,把里面的业务内容换成你自己的。
在导航栏右上角放一个 32px 的圆形用户头像,有头像图时裁剪居中显示,没有时显示姓名首字、浅灰底深灰字。头像右下角有一个 8px 小圆点表示在线状态,点击头像弹出下拉菜单,包含「个人中心」和「退出登录」。图片加载失败时自动回退为姓名首字。
结构与适用场景
结构描述
由圆形或圆角方形的容器和其中的图片、姓名首字或默认图标组成,可附带在线状态点或徽标。
适用场景
- 在评论、消息、聊天等内容旁边,需要一眼区分是谁发布的时候
- 在导航栏右上角表示当前登录用户,并作为个人菜单的入口时
- 成员列表、协作者名单等需要展示一组人的地方,可以叠成头像组
不适用场景
- 展示商品图、文章配图等内容本身的图片时,应该用图片组件
- 表示分类或状态时,应该用标签,不要拿头像当图标
- 需要看清人物细节的大幅照片,头像尺寸太小不合适
常见坏用法
- 没有图片时显示破图图标或空白圆圈,没有回退成姓名首字
- 同一个列表里的头像大小、形状不统一,有圆有方
- 图片没有按比例裁剪,被拉伸或压扁成椭圆
识别特征
- 小尺寸的圆形图片,或写着姓名首字的圆形色块
- 常位于导航栏右上角,或列表、评论每一行的最左侧
- 多个圆形略微重叠排成一排,末尾带「+N」
DOM 线索
插件本地识别时匹配的 CSS 选择器(标签、ARIA role、常见组件库 class)。
.ant-avatar.el-avatar[class*="MuiAvatar-root"].arco-avatar.t-avatar.n-avatar[data-slot="avatar"]img[alt*="avatar" i]img[alt*="头像"]img[class*="avatar" i]img[src*="avatar" i]img.rounded-circle