更新记录

2.0.4(2024-12-23) 下载此版本

1、修改滑动时底部跟随滑动问题

2.0.3(2024-12-16) 下载此版本

修改基本信息

2.0.2(2024-11-28) 下载此版本

1、增加点击回调中“当前悬浮球是否贴边或缩进”状态参数

查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
app-vue
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari

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。设置背景色或图片,例如 #f40url(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 当前悬浮球是否为贴边或缩进状态

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问