更新记录

2.0.5（2025-09-03） 下载此版本

优化触摸事件穿透问题

2.0.4（2024-12-23） 下载此版本

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

2.0.3（2024-12-16） 下载此版本

修改基本信息

查看更多

平台兼容性

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 当前悬浮球是否为贴边或缩进状态

隐私、权限声明

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

无

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

无

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

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉
加载更多...