tt.navigateTo
收藏
我的收藏

基础库 1.0.0 开始支持本方法，这是一个异步方法。

保留当前页面，跳转到应用内的某个页面，但是不能跳转到 tabBar 页面，使用 tt.navigateBack 可以返回到原页面。

语法

tt.navigateTo(options)

options 为 object 类型，属性如下：

属性名	类型	默认值	必填	说明	最低支持版本
url	string		是	需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数，参数与路径之间使用 ? 分隔，参数键与参数值用 = 相连，不同参数用 & 分隔，如 "path?key=value&key2=value2"	1.0.0
query	object		否	跳转时需要传递的 query 参数，query 对象中的 key、value 最终会被拼接到 url 中，如 "key1=value1&key2=value2"。请注意，如果 query 对象中的 key 和 url 中的 key 重复将被忽略。	3.7.0
success	function		否	接口调用成功的回调函数	1.0.0
fail	function		否	接口调用失败的回调函数	1.0.0
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）	1.0.0

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"navigateTo:ok"	1.0.0

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"navigateTo:fail " + 详细错误信息	1.0.0

errNo	errMsg	说明	最低支持版本
20000	navigateTo:fail params.url should be string, but got undefined	url 未传	2.28.0
20000	navigateTo:fail params.url should be string, but got ${url}	url 为非字符串	2.28.0
20000	navigateTo:fail url is invalid	url 无效	2.28.0
21101	navigateTo:fail Count of page jump is more then 10 times	跳转超过最大页面栈层数	2.28.0
21102	navigateTo:fail Can only jump to non-tab pages	不允许跳转到 tabBar 页面	2.28.0
21103	navigateTo:fail Full screen player exists	全屏播放器状态下不允许跳转	2.28.0
21500	navigateTo:fail illegal content found	未通过敏感词检测	2.28.0
21500	navigateTo:fail url "${removeHtmlSuffixFromUrl(url)}" is not in app.json	页面未在 app.json 中配置	2.28.0
21500	navigateTo:fail this page has been blocked	目标页面被屏蔽	2.28.0

•

Tip: 使用 navigator 组件也可以实现同样的功能；

•

Tip: 小程序页面栈中最多能有 10 个页面，达到 10 个后调用 tt.navigateTo 会失败。