uni-app悬浮球需用position:fixed实现，但H5与小程序表现不一致：H5端可靠但需处理z-index和body高度，小程序则必须用cover-view+cover-image（如通过隐藏video挂载），且事件、坐标、兼容性均有特殊限制。
uni-app 里悬浮球必须用 position: fixed，但 H5 和小程序表现不一致
uni-app 的 view 默认无法真正“悬浮”在所有页面之上，尤其在小程序中 fixed 会被原生导航栏、tabBar 或下拉刷新容器截断。H5 环境下 fixed 可靠，但需注意 z-index 层级和 body 高度撑开问题；小程序则必须用 cover-view + cover-image（仅限微信/支付宝等支持 cover 组件的平台），否则会穿透或被遮挡。
实操建议：
- 全局悬浮球不要放在某个页面组件内，而应挂载到
App.vue的<template>最外层（H5）或使用uni.createCoverView()动态创建（微信小程序） - 微信小程序中，
cover-view不支持v-if、@click等 Vue 指令，事件必须用bind:touchstart等原生写法，且只响应cover-view内部子节点 - 避免在
onPullDownRefresh触发时让悬浮球消失——小程序下拉刷新会重置cover-view位置，需监听onReachBottom或手动重置坐标
如何跨页面保持悬浮球状态并响应点击
悬浮球不是“每个页面都加一个”，而是全局唯一实例。状态（如显隐、位置、是否展开）必须抽离到 Vuex/Pinia 或 uni.$u.store（若用 uView）中统一管理；点击事件不能写在页面 methods 里，否则切换页面后回调丢失。
实操建议：
- 在
App.vue中用watch监听 store 中的showFloatBall，控制cover-view的hidden属性（小程序）或v-show（H5） - 点击事件统一注册在
App.vue，通过uni.$emit('floatball:click')广播，各业务页面用uni.$on('floatball:click')订阅（注意页面 onUnload 时uni.$off） - 如果需要拖动，H5 用
touchstart/move/end手动更新left/top；小程序必须用cover-view的style动态绑定，且每次移动后调用coverView.setStyle()更新（不能直接改 data）
微信小程序中 cover-view 悬浮球的兼容性坑
微信小程序要求 cover-view 必须是 camera、map、video、live-player、live-pusher 的直接子节点才能生效，但 uni-app 没有这些原生组件的全局挂载点。所以实际方案是：用一个隐藏的 <video src="" style="display:none"></video> 作为父容器，再把 cover-view 插入其中——这是目前最稳定、无需条件编译的 hack 方式。
常见错误现象：
-
cover-view完全不显示 → 检查是否包裹在合法原生组件内，以及是否设置了position: fixed（cover-view 自身不支持 fixed，要靠父 video 的定位上下文） - 点击无响应 →
cover-view内必须嵌套cover-view或cover-image才能触发事件，纯文字不行 - 安卓真机上拖动卡顿 → 关闭
cover-view的animation样式，避免触发合成层频繁重建
性能与体验细节：别让悬浮球拖慢首屏
悬浮球逻辑如果在 App.vue 里做太多计算（比如实时监听 scroll、频繁更新 position），会影响整个应用的渲染帧率，尤其低端安卓机。它不该参与路由切换的生命周期，也不该在非激活页面持续监听 touch 事件。
实操建议：
- 拖动逻辑只在用户长按 >300ms 后启用，用
setTimeout控制，避免误触 - 位置坐标用
px单位而非%，防止不同屏幕缩放导致偏移错乱 - 图标资源用 base64 内联或雪碧图，避免
cover-image加载空白期；微信小程序中cover-image不支持网络图片，必须本地路径或 base64 - App 启动时默认隐藏悬浮球，等
uni.getSystemInfo返回后再根据platform和SDKVersion决定是否启用——老版本微信不支持cover-view动态创建
最麻烦的其实是坐标同步：小程序里 cover-view 的 left/top 是相对于窗口左上角，但 touch 事件返回的 clientX/clientY 在某些机型上会包含状态栏高度，这个偏差必须用 uni.getSystemInfo 的 statusBarHeight 手动修正，漏掉就会偏移一截。
