更新记录
2.0.4(2024-12-23) 下载此版本
1、修改滑动时底部跟随滑动问题
2.0.3(2024-12-16) 下载此版本
修改基本信息
2.0.2(2024-11-28) 下载此版本
1、增加点击回调中“当前悬浮球是否贴边或缩进”状态参数
查看更多平台兼容性
uni-app
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | × | - | - | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | √ | - | √ | √ | √ | √ |
其他
多语言 | 暗黑模式 | 宽屏模式 |
---|---|---|
× | × | √ |
float-ball 悬浮球
组件名:dui-float-ball
一个移动端好用的,可自由拖拽,可自动回弹的悬浮球组件
注意事项 为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的文档,可以帮你避免一些错误。
基本用法
在 template
中直接使用组件
<template>
<dui-float-ball></dui-float-ball>
</template>
API
Props
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
dragable | Boolean | true |
是否自由拖动悬浮球 |
ballText | String | - | 小球内文本内容 |
ballTextColor | String | #fff |
小球内文本颜色 |
ballTextSize | String | 28rpx |
小球内文本大小 |
background | String | 无 | 设置backgroud。设置背景色或图片,例如 #f40 ,url(https://www.xxx.com/xxx.jpg) |
position | Object | {left:0,top:'50%'} |
悬浮球初始位置。只能设置left和top值,left设置100% 时靠最右边贴边 |
immediateIndent | Boolean | true |
是否立即缩进。nearEdgeIndent开启时生效 |
needNearEdge | Boolean | true |
是否自动贴边 |
nearEdgeDirection | String | - | 自动贴边方向。needNearEdge开启时生效,可选值left ,right ,top ,bottom ,未设置则自动贴近距离最近的方向 |
nearEdgeTransition | String | all ease 0.3s |
贴边动画 |
nearEdgeIndent | Boolean | true |
贴边后是否缩进悬浮球 |
nearEdgeIndentDelay | Number | 1000 |
贴边后延时缩进悬浮球,单位ms |
nearEdgeIndentDistance | Number | 30 |
贴边缩进距离。如设置值大于0且小于等于1时,那么缩进距离为小球的百分比。 |
slotsDirection | String | - | 插槽没容相对悬浮球的方向。有添加插槽时生效,可选值left ,right ,top ,bottom |
Slots
名称 | 说明 |
---|---|
default | 默认插槽,跟随悬浮球展示的内容 |
Events
参数 | 类型 | 说明 |
---|---|---|
touchFunc | Function | 悬浮按钮点击事件 |
touchFunc事件回调参数
参数 | 类型 | 说明 |
---|---|---|
iSNearEdge | Boolean | 当前悬浮球是否为贴边或缩进状态 |