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 初始化
当前状态