SxAvatar (头像)

  • Implemented

用于展示用户或实体标识，支持图片、姓名首字母与在线状态。

使用场景

  • 用户列表与资料卡片
  • 群组成员展示
  • 在线状态指示

约束说明

  • 未提供 Src 时显示姓名首字母。
  • CustomSize 优先于 Size。

行为说明

  • Presence 不为 None 时显示状态徽标。

API

Parameters

状态 参数名 类型 默认值 描述
Implemented Name string? "" 用户姓名。
Implemented Src string? null 图片地址。
Implemented Alt string? null 图片替代文本。
Implemented Link string? null 点击跳转链接。
Implemented Color string? null 文字颜色。
Implemented Fill string? null 填充颜色。
Implemented Size ControlSize Medium 头像尺寸。
Implemented CustomSize int? null 自定义尺寸。
Implemented Shape AvatarShape Circular 形状。
Implemented Presence AvatarPresence None 在线状态。
Implemented Id (继承) string? null 组件 Id。
Implemented Class (继承) string? null 自定义 CSS 类名。
Implemented Style (继承) string? null 自定义样式。
Implemented Title (继承) string? null HTML title 属性。
Not Implemented TabIndex (继承) int? null TabIndex（未应用）。
Not Implemented AccessKey (继承) string? null AccessKey（未应用）。
Not Implemented Disabled (继承) bool false 禁用状态（未应用）。
Not Implemented Loading (继承) bool false 加载状态（未应用）。
Implemented AdditionalAttributes (继承) IEnumerable<KeyValuePair<string, object>>? null 捕获不匹配的 HTML 属性。

示例

<SxAvatar Src="user.jpg" Name="张三" Size="ControlSize.Large" />
<SxAvatar Name="李四" Shape="AvatarShape.Square" Presence="AvatarPresence.Online" />
在 Playground 中打开 →