更新记录
0.0.4(2024-10-03) 下载此版本
- fix: vue2
0.0.3(2024-10-02) 下载此版本
- fix: filter
0.0.2(2024-10-01) 下载此版本
- fix: group
平台兼容性
Vue2 | Vue3 |
---|---|
√ | √ |
App | 快应用 | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 |
---|---|---|---|---|---|---|
HBuilderX 4.26 app-vue app-uvue | × | √ | × | × | × | × |
钉钉小程序 | 快手小程序 | 飞书小程序 | 京东小程序 |
---|---|---|---|
× | × | × | × |
H5-Safari | Android Browser | 微信浏览器(Android) | QQ浏览器(Android) | Chrome | IE | Edge | Firefox | PC-Safari |
---|---|---|---|---|---|---|---|---|
√ | × | × | × | × | × | × | × | × |
lime-avatar 头像
- 来代表用户或事物,支持图片、图标或字符展示,兼容uniapp/uniappx(h5,ios,安卓)
安装
插件市场导入即可
代码演示
基础用法
通过src
可设置图片,通过icon
可设置图标,插槽可显示文本
<l-avatar src="https://tdesign.gtimg.com/mobile/demos/avatar1.png"></l-avatar>
<l-avatar icon="user"></l-avatar>
<l-avatar>A</l-avatar>
尺寸
通过size
可设置头像尺寸,可选值有small/medium/large等,可以是50rpx/50px等带单位的具体值。
<l-avatar size="large" icon="user"></l-avatar>
<l-avatar icon="user"></l-avatar>
<l-avatar size="small">A</l-avatar>
<l-avatar size="30rpx">B</l-avatar>
形状
通过shape
可设置头像形状,可选值有square/circle。默认是circle
<l-avatar icon="user"></l-avatar>
<l-avatar shape="square" icon="user"></l-avatar>
自定义颜色
通过color
可设置头像颜色,通过text-color
可设置图标或文本颜色。
<l-avatar color="#3283ff" icon="user"></l-avatar>
<l-avatar color="#34c471" shape="square" icon="user"></l-avatar>
头像组
通过max
设置最多显示多少个,超过后显示一个折叠的头像,如+5
,通过collapseText
可设置折叠头像显示的内容。
<l-avatar-group :max="5" collapseFontSize="20rpx" collapseText="更多" cascading="left-up">
<l-avatar src="https://tdesign.gtimg.com/mobile/demos/avatar1.png"></l-avatar>
<l-avatar src="https://tdesign.gtimg.com/mobile/demos/avatar2.png"></l-avatar>
<l-avatar src="https://tdesign.gtimg.com/mobile/demos/avatar3.png"></l-avatar>
<l-avatar src="https://tdesign.gtimg.com/mobile/demos/avatar4.png"></l-avatar>
<l-avatar color="#3283ff">陈</l-avatar>
<l-avatar color="#3283ff">王</l-avatar>
<l-avatar color="#3283ff">李</l-avatar>
<l-avatar color="#3283ff">黄</l-avatar>
</l-avatar-group>
查看示例
- 导入后直接使用这个标签查看演示效果
// 代码位于 uni_modules/lime-avatar/compoents/lime-avatar
<lime-avatar />
插件标签
- 默认 l-avatar 为 component
- 默认 l-avatar-group 为 component
- 默认 lime-avatar 为 demo
关于vue2的使用方式
- 插件使用了
composition-api
, 如果你希望在vue2中使用请按官方的教程vue-composition-api配置 - 关键代码是: 在main.js中 在vue2部分加上这一段即可.
// vue2
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)
API
Avatar Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
icon | 图标。 | string | - |
size | 尺寸,示例值:small/medium/large/24px/38px 等。优先级高于 AvatarGroup.size 。Avatar 单独存在时,默认值为 medium。如果父组件 AvatarGroup 存在,默认值便由 AvatarGroup.size 决定 | string | medium |
shape | 形状。优先级高于 AvatarGroup.shape 。Avatar 单独存在时,默认值为 circle。如果父组件 AvatarGroup 存在,默认值便由 AvatarGroup.shape 决定。可选项:circle | string | circle |
src | 图片地址 | string | - |
fontSize | 图标或文本字体大小 | string | - |
color | 背景色 | string | - |
textColor | 文本颜色 | string | - |
AvatarGroup Props
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
size | 尺寸,示例值:small/medium/large/24px/38rpx 等 | string | medium |
shape | 形状。可选值为 square/circle。 | string | circle |
max | 能够同时显示的最多头像数量 | number | - |
cascading | 图片之间的层叠关系,可选值:左侧图片在上和右侧图片在上。可选项:left-up/right-up | string | right-up |
collapseText | 折叠头像显示内容 | string | - |
collapseFontSize | 折叠头像图标或文本字体大小 | string | - |
collapseColor | 折叠头像背景色 | string | - |
collapseTextColor | 折叠头像文本颜色 | string | - |
CSS 变量
组件提供了下列 CSS 变量,可用于自定义样式。uvue app无效。
名称 | 默认值 | 描述 |
---|---|---|
--l-avatar-bg-color | $primary-color-1 | - |
--l-avatar-text-color | $primary-color | - |
--l-avatar-circle-border-radius | 999px | - |
--l-avatar-square-border-radius | 12rpx | - |
--l-avatar-small-size | 70rpx | - |
--l-avatar-medium-size | 96rpx | - |
--l-avatar-large-size | 127rpx | - |
--l-avatar-small-font-size | 28rpx | - |
--l-avatar-medium-font-size | 36rpx | - |
--l-avatar-large-font-size | 58rpx | - |
--l-avatar-small-icon-size | 40rpx | - |
--l-avatar-medium-icon-size | 48rpx | - |
--l-avatar-large-icon-size | 58rpx | - |
--l-avatar-small-border-width | 4rpx | - |
--l-avatar-medium-border-width | 6rpx | - |
--l-avatar-large-border-width | 8rpx | - |
--l-avatar-border-color | #fff | - |
--l-avatar-group-overlapping | -20rpx | - |
打赏
如果你觉得本插件,解决了你的问题,赠人玫瑰,手留余香。