uni-app 路由与页面跳转

uni-app 路由与页面跳转

uni.navigateTo
保留当前页面，跳转到应用内的某个页面，使用uni.navigateBack可以返回到原页面。

示例

//在起始页面跳转到test.vue页面并传递参数
uni.navigateTo({
    url: 'test?id=1&name=uniapp'
});

// 在test.vue页面接受参数
export default {
    onLoad: function (option) { //option为object类型，会序列化上个页面传递的参数
        console.log(option.id); //打印出上个页面传递的参数。
        console.log(option.name); //打印出上个页面传递的参数。
    }
}

url有长度限制，太长的字符串会传递失败,可使用窗体通信，全局变量或encodeURLComponent等多种方式解决，如下为encodeURLComponent示例。

// 在test.vue页面接受参数
onLoad: function (option) {
    const item = JSON.parse(decodeURIComponent(option.item));
}

注意：

• 页面跳转路径有层级限制，不能无限制跳转新页面。
• 跳转到tabBar页面只能使用switchTab跳转
• 路由API的目标页面必须是在pages.json里注册的vue页面，如果想打开web url，在App平台可以使用plus.runtime.openURL或web-view组件，H5平台使用window.open;小程序平台使用web-view组件(url需在小程序的联网白名单中)。在hello uni-app中有个组件ulink.vue已对多端进行封装，可参考。

uni.redirectTo(OBJECT)

示例

uni.redirectTo({
    url: 'test?id=1'
});

注意：
跳转到tabBar页面只能使用switchTab跳转

uni.reLaunch(OBJECT)

示例：

uni.reLaunch({
    url: 'test?id=1'
});

export default {
    onLoad: function (option) {
        console.log(option.id);
    }
}

uni.switchTab(OBJECT)

跳转到tabBar页面，并关闭其他所有非tabBar页面。

示例

pages.json

	{
	  "tabBar": {
	    "list": [{
	      "pagePath": "pages/index/index",
	      "text": "首页"
	    },{
	      "pagePath": "pages/other/other",
	      "text": "其他"
	    }]
	  }
	}

other.vue

uni.switchTab({
    url: '/pages/index/index'
});

uni.navigateBack(OBJECT)

关闭当前页面，返回上一级页面或多级页面，可通过getCurrentPage()获取当前页页面栈，决定需要返回几层。

示例

// 注意：调用 navigateTo 跳转时，调用该方法的页面会被加入堆栈，而 redirectTo 方法则不会。见下方示例代码

// 此处是A页面
uni.navigateTo({
    url: 'B?id=1'
});

// 此处是B页面
uni.navigateTo({
    url: 'C?id=1'
});

// 在C页面内 navigateBack，将返回A页面
uni.navigateBack({
    delta: 2
});

Tips：

• navigateTo,redirectTo 只能打开非tabBar页面。
• switchTab只能打开tabBar页面。
• reLaunch可以打开任意页面。
• 页面底部的tabBar由页面决定，即只要是定义为tabBar的页面，底部都有tabBar
• 不能在App.vue里面进行页面跳转
• H5端页面刷新之后页面栈会消失，此时navigationBack不能返回，如果一定要返回可以使用history.back()。

参考事项

页面路由拦截和管理，插件市场有很多封装好的工具类，搜索路由。

窗口动画

本API仅支持App支持，小程序自身不支持自定义动画，H5的窗体动画可使用常规单页动画处理方案。

窗口的显示/关闭动画效果，支持在API、组件、pages.json中配置，优先级为：API=组件>page.json.

API
有效的路由API

• navigateTo
• navigateBack

uni.navigateTo({
    url: '../test/test',
    animationType: 'pop-in',
    animationDuration: 200
});
uni.navigateBack({
    delta: 1,
    animationType: 'pop-out',
    animationDuration: 200
});

组件
open-type有效值

• navigateTo
• navigateBack

navigator
navigator

pages.json

pages.json 中配置的是窗口显示的动画

"style": {
    "app-plus": {
        "animationType": "fade-in",
        "animationDuration": 300
    }
}

显示动画与关闭动画，会有默认的对应规则。但是如果通过 API 或组件配置了窗口关闭的动画类型，则不会使用默认的类型。

详细的窗口动画说明，请参考：

• 窗口显示的动画：AnimationTypeShow
• 窗口关闭的动画：AnimationTypeClose

注意

纯nvue项目（render为native），窗体动画默认进入动画为popin，返回为pop-out。如果想修改动画类型，只能通过uni.navigateTo API修改，在组件或pages.json里配置动画类型无效
非纯nvue项目，App端窗体动画，默认进入动画为slider-in-right，默认返回动画为pop-out