• uni.navigateTo(OBJECT)

    uni.navigateTo(OBJECT)

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

    OBJECT参数说明

    参数类型必填默认值说明平台差异说明
    urlString需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔,参数键与参数值用=相连,不同参数用&分隔;如 'path?key=value&key2=value2',path为下一个页面的路径,下一个页面的onLoad函数可得到传递的参数:-
    animationTypeStringpop-in窗口显示的动画效果,详见:窗口动画5+App
    animationDurationNumber300窗口动画持续时间,单位为 ms5+App
    successFunction接口调用成功的回调函数
    failFunction接口调用失败的回调函数
    completeFunction接口调用结束的回调函数(调用成功、失败都会执行)

    示例

    1. //在起始页面跳转到test.vue页面并传递参数
    2. uni.navigateTo({
    3. url: 'test?id=1&name=uniapp'
    4. });
    1. // 在test.vue页面接受参数
    2. export default {
    3. onLoad: function (option) { //option为object类型,会序列化上个页面传递的参数
    4. console.log(option.id); //打印出上个页面传递的参数。
    5. console.log(option.name); //打印出上个页面传递的参数。
    6. }
    7. }

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

    1. <navigator :url="'/pages/test/test?item='+ encodeURIComponent(JSON.stringify(item))"></navigator>
    1. // 在test.vue页面接受参数
    2. onLoad: function (option) {
    3. const item = JSON.parse(decodeURIComponent(option.item));
    4. }

    注意:

    • 页面跳转路径有层级限制,不能无限制跳转新页面
    • 跳转到 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已对多端进行封装,可参考。