AvatarImage 图片头像

用于展示图片头像，支持圆形/方形形状、尺寸和深浅视觉风格；图片加载失败或 src 为空时会展示组件内置占位图标。

示例

基础用法

头像形状

头像尺寸

视觉风格

API

Props

属性名	说明	类型	默认值
shape	头像形状	'circle' | 'square'	'circle'
size	头像尺寸，单位 px	number	32
src	图片地址	string	''
effect	视觉风格	'dark' | 'light' | 'plain'	'dark'

Events

该组件无自定义事件。

Slots

该组件无插槽。

注意事项

• 组件内部使用 MtImage 展示图片，并固定使用 fit="cover"、position="top center"。
• 当图片加载失败时，dark 风格展示人物图标，其他风格展示浅色占位图标。
• size 会同时控制头像容器宽高和加载失败占位图标的大小。
• 列表或卡片中建议统一头像尺寸，避免视觉跳动。
• 图片地址为空时可直接依赖内置占位，也可以在业务侧提供默认头像地址。