uniapp 实现路由切或者tab切换详细步骤

uniapp 实现路由切或者tab切换详细步骤

在 UniApp 中实现页面路由和标签页（Tab）切换是核心开发技能。下面为你梳理详细步骤和不同场景的实践方案。
下面表格中帮助你快速了解 UniApp 中主要的页面跳转方式及其区别：

🔄 路由跳转详解

1. 基本跳转与传参

最常用的跳转方式是uni.navigateTo。在跳转时，可以通过URL传递参数。

// 在起始页面跳转并传递参数uni.navigateTo({url:'/pages/detail/detail?id=80&title=Hello'});

在目标页面，于onLoad生命周期函数中接收参数：

// 在目标页面（/pages/detail/detail.vue）接收参数exportdefault{onLoad(options){// options 是一个对象，包含传递过来的参数console.log(options.id);// 输出：80console.log(options.title);// 输出：'Hello'}}

注意：通过URL传递的参数值会被转换为字符串类型，如有需要（如ID为数字），请在接收后进行类型转换 。

2. 返回上一页

使用uni.navigateBack可以返回上一页面或多级页面。

// 返回上一页uni.navigateBack();// 返回上两级页面uni.navigateBack({delta:2});

🏷️ 实现Tab切换

在 UniApp 中，Tab 切换有两种主要形式：基于原生 TabBar 的切换和自定义顶部标签页切换。

1. 原生TabBar切换（底部导航栏）

这是最标准的方式，通过uni.switchTab实现，体验与原生应用一致。

步骤一：配置 pages.json
首先，需要在pages.json中正确配置tabBar。

{"pages":[{"path":"pages/index/index","style":{"navigationBarTitleText":"首页"}},{"path":"pages/category/category","style":{"navigationBarTitleText":"分类"}},{"path":"pages/cart/cart","style":{"navigationBarTitleText":"购物车"}},{"path":"pages/profile/profile","style":{"navigationBarTitleText":"我的"}}],"tabBar":{"color":"#7A7E83","selectedColor":"#007AFF","backgroundColor":"#F8F8F8","list":[{"pagePath":"pages/index/index","text":"首页","iconPath":"static/tab-home.png","selectedIconPath":"static/tab-home-active.png"},{"pagePath":"pages/category/category","text":"分类","iconPath":"static/tab-cate.png","selectedIconPath":"static/tab-cate-active.png"}]}}

步骤二：使用API跳转
在代码中，使用uni.switchTab进行跳转。

// 从任意非tabbar页面跳转到首页（tabbar页面）uni.switchTab({url:'/pages/index/index'});

重要：uni.switchTab的url不能带参数 。

2. 自定义顶部标签页切换

当需要更灵活的样式或顶部标签效果时，可以结合swiper和scroll-view组件自定义。

步骤一：构建模板结构

<template><view><!-- 1. 自定义顶部标签栏 --><scroll-viewscroll-xclass="nav-scroll":scroll-into-view="currentNavId"><viewv-for="(item, index) in navList":key="index":id="'nav'+index":class="['nav-item', currentTab === index ?'active':'']"@click="switchTab(index)">{{ item.text }}</view></scroll-view><!-- 2. 可滑动的页面区域 --><swiper:current="currentTab"@change="onSwiperChange"class="swiper-box"><swiper-itemv-for="(item, index) in navList":key="index"><viewclass="swiper-item"><!-- 第一个标签页的内容 --><textv-if="index === 0">首页内容</text><!-- 第二个标签页的内容 --><textv-if="index === 1">分类内容</text><!-- 可以在这里嵌入子组件 --></view></swiper-item></swiper></view></template>

步骤二：实现逻辑与样式

<script>exportdefault{data(){return{currentTab:0,// 当前选中的标签索引navList:[// 标签列表{text:'首页'},{text:'分类'}]};},methods:{// 点击标签切换switchTab(index){this.currentTab=index;},// 滑动swiper时触发onSwiperChange(e){this.currentTab=e.detail.current;}}};</script><style>.nav-scroll{white-space:nowrap;width:100%;background-color:#f8f8f8;}.nav-item{display:inline-block;padding:20rpx30rpx;font-size:30rpx;}.nav-item.active{color:#007AFF;font-weight:bold;border-bottom:4rpx solid #007AFF;}.swiper-box{height:calc(100vh-80rpx);/* 根据导航栏高度调整 */}.swiper-item{height:100%;padding:20rpx;box-sizing:border-box;}</style>

这种自定义方式能实现丰富的交互效果，如滑动切换、标签滚动居中定位等 。

💡 场景选择与建议

• 需要标准底部导航：优先使用原生TabBar，体验最佳且配置简单。
• 需要顶部导航或高度自定义UI：使用自定义顶部标签页方案。
• 普通页面跳转（如进入详情页）：使用uni.navigateTo。
• 完成操作后无需返回（如登录成功）：使用uni.redirectTo或uni.reLaunch。
• 从深层级页面一键返回首页：使用uni.switchTab（回tab页）或uni.reLaunch（回普通页）。