更新记录
0.1.3(2026-08-24) 下载此版本
修复ios小程序 返回滑动在取消时,页面会生效的问题
0.1.2(2026-01-30) 下载此版本
最新版本
0.0.9(2025-09-13) 下载此版本
减少微信组件体积
查看更多平台兼容性
uni-app(4.85)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | - | - | √ | - | - | - | - |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| - | - | - | - | - | - | - | - | - | - | - | - |
uni-app x(4.85)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| - | - | - | - | - | - |
自定义head
兼容微信浏览器自带的head。避免小程序和APP返回监听不统一,微信小程序,ios和android统一监听返回监听;
leo-head 拖拽排序 说明
组件主要针对微信小程序与APP返回监听问题,使用了此插件,页面不可配置onBackPress事件以防失效,应统一使用组件的beforeleave回调函数处理。
leo-head简单DOM,更多请看下方API
- 提供简单的使用示例,更多请查看下方的demo
<!-- beforeleave -->
<leo-head :beforeleave="beforeleave" title="首页" ></leo-head>
export default {
data() {
return {
callback: null, // 用于统一处理返回事件
}
},
methods:{
// 统一处理返回事件,避免小程序和APP返回监听不统一
beforeleave(callback){
// 首次调用uni.navigateBack会触发beforeleave,表示第一次拦截。 如果不调用callback函数,在当前页面触发uni.navigateBack会直接返回;
callback(true); // 传入true表示继续监听返回事件
callback(false); // 传入false表示直接触发返回事件
this.callback = callback; // 可以在其他地方调用callback函数,继续监听返回事件
}
}
}
// 在插件的源码中有一个navigator函数, 在h5中,刷新页面会丢失路由的历史记录,导致无法放回,这个时候配置返回首页需要直行调整一下,修改homePath的路径;
function navigator() {
// 直接返回首页 && false 不允许
if (showHome.value) {
const homePath = "/pages/tabBar/home";
uni.reLaunch({url: homePath});
} else if(onBack.value) {
// 触发逻辑-逻辑会把
pageContainerBeforeleave();
} else{
uni.navigateBack();
}
}
API
Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| navStyle | 导航栏的样式 对象形式,可以监听滚动慢慢隐藏背景,或者修改样式 | Object | { background: '#fff', color: '#333', fontSize: '40rpx'} |
| showStatusBarHeight | 是否显示状态栏高度 | Boolean | true |
| menuInfo | 小程序胶囊样式 | Object | {} |
| titleStyle | 标题的样式 | Object | {} |
| icon | 是否显示左上角icon | Boolean | true |
| backType | icon 类型 | String | back" |
| title | 标题 默认空 | String | "" |
| iconColor | icon 的颜色 - 默认跟优先根据navStyle的值 | String | navStyle.color || '#333' |
| beforeleave | 自定义返回逻辑--返回时不会立即返回.优先执行逻辑然后使用uni.navigateBack()返回即可 | [Function, Boolean] | false |

收藏人数:
下载插件并导入HBuilderX
赞赏(0)
下载 700
赞赏 7
下载 12596008
赞赏 1949
赞赏
京公网安备:11010802035340号