uni.navigateTo(OBJECT)

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

OBJECT参数说明

参数类型必填默认值说明平台差异说明
urlString是需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔；如 'path?key=value&key2=value2'，path为下一个页面的路径，下一个页面的onLoad函数可得到传递的参数:-
animationTypeString否pop-in窗口显示的动画效果，详见：窗口动画5+App
animationDurationNumber否300窗口动画持续时间，单位为 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已对多端进行封装，可参考。