AvatarText 文字头像

用于通过文字生成头像，适合联系人、成员列表等没有图片头像的场景，支持通过属性或默认插槽提供文字。

示例

基础用法

头像形状

视觉风格

插槽文字

API

Props

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

Events

该组件无自定义事件。

Slots

插槽名	说明	作用域参数
default	头像文字来源，优先级低于 text 属性	-

注意事项

• text 属性优先级高于默认插槽文本。
• 展示文字长度为 1 或 4：文本长度小于 4 时展示首字，长度大于等于 4 时展示前 4 个字符。
• size 会同时影响头像宽高、内边距和字号。
• 建议使用姓名、昵称或名称首字作为头像文字。
• 同一业务区域内保持形状和尺寸一致。