更新记录
1.0.0(2024-12-06)
下载此版本
初始化群聊头像显示组件
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.8.3 app-vue app-nvue |
√ |
√ |
√ |
√ |
√ |
√ |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
√ |
√ |
√ |
√ |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
√ |
nl-group-chat-avatar
微信/企业微信/钉钉/飞书 群聊头像显示组件
安装方式
本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面template中即可直接使用,无需在页面中import和注册components。
基本使用
通过list
参数传入日程列表值,该值为一个数组,
<template>
<view class="wrap">
<view class="title">最多显示九张图片</view>
<view class="item">
<nl-group-chat-avatar :imgs="imgs.slice(0, 1)" :is-dot="false"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 2)" :is-dot="false"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 3)" :is-dot="false"></nl-group-chat-avatar>
</view>
<view class="item">
<nl-group-chat-avatar :imgs="imgs.slice(0, 4)" :is-dot="false"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 5)" :is-dot="false"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 6)" :is-dot="false"></nl-group-chat-avatar>
</view>
<view class="item">
<nl-group-chat-avatar :imgs="imgs.slice(0, 7)" :is-dot="false"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 8)" :is-dot="false"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 9)" :is-dot="false"></nl-group-chat-avatar>
</view>
<view class="title">显示徽标红点</view>
<view class="item">
<nl-group-chat-avatar :imgs="imgs.slice(0, 2)" :is-dot="true"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 5)" :is-dot="true"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 8)" :is-dot="true"></nl-group-chat-avatar>
</view>
<view class="title">圆形头像</view>
<view class="item">
<nl-group-chat-avatar :imgs="imgs.slice(0, 1)" round="22" img-round="100" padding="0" :is-dot="false"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 5)" round="22" :is-dot="false" :dot-offset="[0, 0]"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 9)" round="22" :is-dot="true" :dot-offset="[0, 0]"></nl-group-chat-avatar>
</view>
<view class="title">不同尺寸头像</view>
<view class="item">
<nl-group-chat-avatar :imgs="imgs.slice(0, 7)" size="44" round="4" :is-dot="false"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 8)" size="80" round="4" :is-dot="true" dot-size="16" :dot-offset="[-6, -6]"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 9)" size="120" round="100"></nl-group-chat-avatar>
</view>
<view class="title">其他头像</view>
<view class="item">
<nl-group-chat-avatar :imgs="imgs.slice(0, 7)" background-color="#ff0000" size="80" round="4"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 7)" background-color="#fcff45" size="80" round="4" img-round="50"></nl-group-chat-avatar>
<nl-group-chat-avatar :imgs="imgs.slice(0, 8)" background-color="#73c3ff" size="80" round="4" img-round="50"></nl-group-chat-avatar>
</view>
</view>
</template>
<script>
export default {
data() {
return {
imgs: [
'https://q5.itc.cn/q_70/images03/20240406/2c8f1d2cd13e4d4392fa07ccaab1f219.jpeg',
'https://q1.itc.cn/q_70/images03/20240414/d477378709494a9e8adf154fb5200feb.jpeg',
'https://q5.itc.cn/q_70/images03/20240406/2c8f1d2cd13e4d4392fa07ccaab1f219.jpeg',
'https://q5.itc.cn/q_70/images03/20240406/2c8f1d2cd13e4d4392fa07ccaab1f219.jpeg',
'https://img1.baidu.com/it/u=2021651211,1099682584&fm=253&app=138&f=JPEG?w=806&h=800',
'https://q5.itc.cn/q_70/images03/20240406/2c8f1d2cd13e4d4392fa07ccaab1f219.jpeg',
'https://q1.itc.cn/q_70/images03/20240414/d477378709494a9e8adf154fb5200feb.jpeg',
'https://q5.itc.cn/q_70/images03/20240406/2c8f1d2cd13e4d4392fa07ccaab1f219.jpeg',
'https://q5.itc.cn/q_70/images03/20240406/2c8f1d2cd13e4d4392fa07ccaab1f219.jpeg',
'https://img1.baidu.com/it/u=2021651211,1099682584&fm=253&app=138&f=JPEG?w=806&h=800',
],
}
},
}
</script>
<style scoped>
.wrap {
margin: 10px;
}
.item {
display: flex;
justify-content: space-around;
margin-top: 10px;
}
.title {
text-align: center;
margin-top: 20px;
}
</style>
API
属性 |
说明 |
类型 |
默认值 |
imgs |
群聊头像图片数组 |
Array |
[] |
size |
群聊头像大小 |
String/Number |
46 (单位px) |
round |
群聊头像圆角 |
String/Number |
4 (单位px) |
padding |
群聊头像内边距 |
String/Number |
1.5 (单位px) |
backgroundColor |
群聊头像背景颜色 |
String |
'#dddbd9' |
imgRound |
每个小图片的圆角值 |
String/Number |
0(单位px) |
mode |
每个小图片的填充模式 |
String |
'scaleToFill' 此模式用法与uni-app的image组件的mode参数完全一致,详见:image |
isDot |
是否显示徽标圆点 |
Boolean |
false |
dotSize |
徽标圆点尺寸 |
String/Number |
10 (单位px) |
dotColor |
徽标圆点颜色 |
String |
'#fa5151' |
dotOffset |
徽标圆点位置 |
Array |
[-4, -4] (距离头像顶部和右边距离,单位px) |