//跳转底部页面
Vue.prototype.jumpLink = (link) => {
	let arr = ["/pages/index/index", "/pages/mine/mine"];
	if (arr.indexOf(link) > -1) {
		uni.switchTab({
			url: link ||"/pages/index/index"
		});
	} else {
		uni.navigateTo({
			url: link
		});
	}
}
1. 全局挂载方法:Vue.prototype.jumpLink = (link) => { ... }
  • Vue.prototype:Vue 实例的原型对象。在原型上挂载方法后,所有 Vue 组件(包括页面组件)都可以通过 this.jumpLink(link) 直接调用,无需在每个组件中单独定义跳转逻辑(实现 “一次定义,全局使用”)。
  • jumpLink:自定义的方法名,语义是 “跳转链接”,便于开发者理解用途。
  • (link) => { ... }:箭头函数形式的方法体,link 是入参,代表 “要跳转的目标页面路径”(如 /pages/goods/detail)。
2. 定义 Tab 页白名单:let arr = ["/pages/index/index", "/pages/mine/mine"];
  • 这里的 arr 是一个 “Tab 页面路径数组”,本质是 Tab 页的白名单
  • 项目中配置在 pages.json 的 tabBar 中的页面(即底部导航栏对应的页面,如 “首页”“我的”),必须通过 uni.switchTab 跳转,不能用普通跳转 API,因此需要先定义这些页面的路径,用于后续判断。
  • 示例中 "/pages/index/index"(首页)、"/pages/mine/mine"(我的)就是典型的 Tab 页路径。
3. 判断跳转类型:if (arr.indexOf(link) > -1) { ... } else { ... }

通过 arr.indexOf(link) > -1 判断 “目标页面路径 link 是否在 Tab 页白名单中”,从而选择不同的跳转 API:

(1)Tab 页跳转:uni.switchTab({ url: link || "/pages/index/index" })
  • 触发条件:当 link 是白名单中的 Tab 页路径时(如跳转到 “首页”)。
  • uni.switchTab:UniApp 专门用于 “跳转到 TabBar 页面” 的 API,特点是:
    • 会关闭所有非 TabBar 页面,仅保留 TabBar 页面;
    • 不能携带参数(若需传参需用全局变量 / 缓存等方式)。
  • url: link || "/pages/index/index"
    • 优先使用入参 link 作为跳转路径;
    • 若 link 为空(如调用时没传参),则默认跳转到 /pages/index/index(首页),避免路径错误。
(2)普通页跳转:uni.navigateTo({ url: link })
  • 触发条件:当 link 不是 Tab 页路径时(如跳转到 “商品详情页”“订单页” 等非 Tab 页面)。
  • uni.navigateTo:UniApp 用于 “跳转到普通页面” 的常用 API,特点是:
    • 会保留当前页面(放入页面栈),跳转后点击 “返回” 可回到上一页;
    • 可以通过 URL 携带参数(如 /pages/goods/detail?id=123)。
  • url: link:直接使用入参 link 作为跳转路径(普通页跳转需确保路径正确,且非 Tab 页)。

二、核心作用与优势

  1. 统一跳转逻辑,减少重复代码若不封装这个方法,每个组件跳转时都要手动判断 “是不是 Tab 页”,再选择 switchTab 或 navigateTo,会产生大量重复代码;封装后只需调用 this.jumpLink(link) 即可。

  2. 降低错误概率新手容易混淆 switchTab 和 navigateTo(比如用 navigateTo 跳 Tab 页会报错),通过白名单自动判断,避免因 API 用错导致的跳转失败。

  3. 便于维护若后续项目新增 / 修改 Tab 页,只需修改 arr 数组中的路径,无需修改所有调用跳转的地方,维护成本更低。

三、使用示例(在组件中调用)

在任何 Vue 组件(页面)中,都可以这样调用这个全局跳转方法:

四、注意事项

  1. Tab 页路径必须与 pages.json 一致arr 中的路径(如 /pages/index/index)必须和 pages.json 的 tabBar.list[].pagePath 完全一致(包括大小写、斜杠),否则会判断失败,用错跳转 API。

    示例 pages.json 配置:

{
  "tabBar": {
    "list": [
      { "pagePath": "/pages/index/index", "text": "首页" }, // 必须和 arr 中的路径一致
      { "pagePath": "/pages/mine/mine", "text": "我的" }
    ]
  }
}
  1. 普通页跳转需确保路径存在调用时传入的 link 必须是 pages.json 中已配置的页面路径,否则会跳转失败(UniApp 会提示 “页面不存在”)。

  2. 箭头函数的 this 绑定这里用箭头函数 (link) => { ... } 定义方法体,是为了确保函数内部的 this 指向 Vue 实例(若用普通函数 function(link) { ... },需注意 this 指向可能变化,但箭头函数可避免此问题)。

  3. 不支持跳转到分包页面的特殊场景若目标页面是 “分包页面”,需确保路径包含分包根目录(如 /subpkg/pages/xxx/xxx),且 arr 中若包含分包 Tab 页,也需写全路径。

posted on 2025-09-30 11:43  ycfenxi  阅读(8)  评论(0)    收藏  举报