SepAvatar 头像组件 v1.0.0

用户头像展示 · 图片 / 图标 / 文字 三种来源(优先级 src > icon > text) · shape 形状 · size 尺寸 · gap 文字间距 · backgroundColor 背景色 · objectFit 图片适应 · autoFixFontSize 自动字号 · loading 骨架 · onError 降级

1. 基础用法(图片 / 图标 / 文字)

HTML 声明式标签
JS API 初始化

2. shape 形状(circle / square / rounded)

HTML 声明式标签
JS API 初始化

3. size 尺寸(预设 small / default / large + 自定义数字)

HTML 声明式标签
JS API 初始化

4. 文字头像自动取色(按文本哈希分配色板)

HTML 声明式标签
JS API 初始化
JS API 初始化 — name 自动生成文字头像(中文取首字 / 英文取首字母)

5. gap 文字左右间距

HTML 声明式标签
JS API 初始化

6. backgroundColor 自定义背景色

HTML 声明式标签
JS API 初始化

7. objectFit 图片适应模式

HTML 声明式标签
JS API 初始化

7b. 图片高级属性(crossOrigin / srcSet / referrerPolicy / draggable)

JS API 初始化 — crossOrigin + referrerPolicy(用于 canvas 跨域绘制)
JS API 初始化 — 加载事件回调(loadStart / loadSuccess / loadError)
等待加载...

8. autoFixFontSize 自动文字缩放

HTML 声明式标签
JS API 初始化

9. loading 骨架占位

HTML 声明式标签
JS API 初始化

10. onError 图片加载失败降级

JS API 初始化

10b. bordered 边框样式

HTML 声明式标签
JS API 初始化

10b-2. status 状态指示器(online / busy / away / offline)

JS API 初始化 — 四种状态
JS API 初始化 — 四个角落位置
JS API 初始化 — 图片头像 + status

10c. onClick 点击交互(hover 上浮 + 光晕)

JS API 初始化
点击头像试试看

10d. SepAvatarGroup 头像组(重叠展示 + 溢出 +N)

JS API 初始化 — 基础文字头像组
JS API 初始化 — maxCount 溢出 +N
JS API 初始化 — 图片头像组
JS API 初始化 — 方形 + 自定义间距
JS API 初始化 — maxStyle 自定义溢出样式 + onItemClick
点击组内头像查看回调
JS API 初始化 — maxPopover hover 浮层(鼠标移到 +N 上)
JS API 初始化 — maxPopover click 浮层(点击 +N)
JS API 初始化 — showTotal 显示总数
JS API 初始化 — draggable 拖拽排序(拖动头像调整顺序)
拖动头像查看排序结果

11. 优先级 src > icon > text

JS API 初始化

12. 动态 API 切换(setShape / setSize / setSrc / setText / setLoading)

JS API 初始化
切换形状 切换尺寸 切换图片 切换文字 切换 Loading
当前状态

13. 自动化断言