跳到正文

头像

图片头像;图片缺失或加载失败时,用姓名首字(中文取第一个字,英文取首字母)和由姓名决定的颜色代替。

带行为 核心包

示例

在线试用 Markdown 版

代码

<span class="zh-avatar" data-name="张三" data-size="md"></span>
<span class="zh-avatar" data-name="Ada Lovelace" data-size="md"></span>
<span class="zh-avatar" data-name="设计" data-size="md" data-shape="square"></span>
<span class="zh-avatar" data-name="在线" data-size="lg" data-status="success"></span>

属性

属性用在取值说明
data-name.zh-avatar字符串姓名;必填,库据此初始化,也是无障碍名称
data-src.zh-avatar图片地址头像图片;加载失败自动退回首字
data-size.zh-avatarxs | sm | md | lg | xl尺寸
data-shape.zh-avatarsquare | circle(默认)方形头像,默认圆形
data-icon.zh-avatar图标名用图标代替首字
data-status.zh-avatarsuccess | warning | danger | primary右下角的在线状态点
data-tone头像brand用品牌色代替按名字挑选的 8 种分类色,适合一个品牌页里所有头像颜色一致

样式类

zh-avatar zh-avatar-face zh-avatar-status zh-avatar-group

无障碍

  • 元素带 role="img" 与 aria-label(取姓名)
  • 状态点只是装饰,需要传达状态时请在旁边写文字

常见问题

头像是什么?

图片头像;图片缺失或加载失败时,用姓名首字(中文取第一个字,英文取首字母)和由姓名决定的颜色代替。

怎么使用头像?

先在页面里引入 zhaoui.css 和 zhaoui.js(放在 </body> 前,不加 defer),再照本页「用法」里的标记书写。

头像支持键盘和读屏吗?

元素带 role="img" 与 aria-label(取姓名);状态点只是装饰,需要传达状态时请在旁边写文字。

头像需要依赖框架吗?

不需要。ZhaoUI 是原生 HTML、CSS 和 JavaScript,不依赖 jQuery、Vue 或 React。