更新记录
1.0.0(2025-05-19)
下载此版本
v1.0.0
- 初始版本发布
- 支持图片和文字头像
- 支持自定义样式和边距
- 支持文字截取方向和长度控制
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 4.0 app-vue |
√ |
√ |
√ |
√ |
√ |
√ |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
√ |
√ |
√ |
√ |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
d-avatar 头像组件
一个灵活的头像组件,支持图片显示和文字头像,适用于用户头像、群组头像等场景。
功能特点
- 支持图片头像和文字头像
- 可自定义头像大小和边距
- 支持自定义背景颜色
- 文字头像支持自定义截取方向和长度
- 响应式设计,适配不同尺寸
安装使用 (官方下载的话不需要引用,会自动注入,可忽略)
- 将组件复制到您的项目中
- 在需要使用的页面引入组件
import MyAvatar from '@/components/my-avatar.vue'
export default {
components: {
MyAvatar
}
}
基础用法
<!-- 图片头像 -->
<my-avatar src="https://example.com/avatar.jpg" />
<!-- 文字头像 -->
<my-avatar name="王冰冰" />
<!-- 自定义大小和边距 -->
<my-avatar
name="王冰冰"
width="100rpx"
:top="10"
:right="20"
:bottom="10"
:left="20"
/>
属性说明
属性名 |
类型 |
默认值 |
说明 |
src |
String |
'' |
头像图片地址,设置后优先显示图片 |
name |
String |
'' |
显示的名称,当没有图片时显示文字头像 |
width |
String |
'80rpx' |
头像宽度,同时决定高度 |
bg |
String |
'#E0FFFF' |
文字头像的背景颜色 |
size |
String |
'12px' |
文字头像的字体大小 |
top |
String |
'0' |
上边距 |
right |
String |
'0' |
右边距 |
bottom |
String |
'0' |
下边距 |
left |
String |
'0' |
左边距 |
keepLength |
Number |
2 |
文字头像保留的字符数量 |
direction |
Number |
1 |
文字截取方向:1-从后向前,2-从前向后 |
使用示例
1. 基础图片头像
<my-avatar src="https://example.com/avatar.jpg" />
2. 基础文字头像
<my-avatar name="王冰冰" />
3. 自定义样式
<my-avatar
name="王冰冰"
width="100rpx"
bg="#FFE4E1"
size="16px"
/>
4. 自定义边距
<my-avatar
name="王冰冰"
:top="10"
:right="20"
:bottom="10"
:left="20"
/>
5. 自定义文字截取
<!-- 从前向后取3个字符 -->
<my-avatar
name="王冰冰丰"
:keep-length="3"
:direction="2"
/>
<!-- 从后向前取1个字符 -->
<my-avatar
name="王冰冰丰"
:keep-length="1"
:direction="1"
/>
注意事项
- 当同时设置
src
和 name
时,优先显示图片头像
- 文字头像会自动截取指定长度的字符
- 所有尺寸相关的属性都支持 rpx 单位
- 边距属性支持数字或带单位的字符串
更新日志
v1.0.0
- 初始版本发布
- 支持图片和文字头像
- 支持自定义样式和边距
- 支持文字截取方向和长度控制