tt.navigateTo
基础库 1.0.0 版本开始支持本方法。
保留当前页面，跳转到应用内的某个页面，但是不能跳转到 tabbar 页面，使用 tt.navigateBack 可以返回到原页面。
语法
tt.navigateTo(options)参数说明
options 是 object 类型，属性如下：
| 属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
|---|---|---|---|---|---|
| url | string | 是 | 需要跳转的应用内非 tabBar 的页面的路径 , 路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔；如 ‘path?key=value&key2=value2’ | 1.0.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 | 参数校验错误 | 2.28.0 |
| 20000 | navigateTo:fail params.url should be string, but got ${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 | 不允许跳转到 tab 页面 | 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 |
效果示例
扫码体验
请使用字节宿主APP扫码
代码示例
// pages/list
Page({
onItemClick(event) {
var sku = event.target.dataset.sku;
tt.navigateTo({
url: `/pages/detail/detail?sku=${sku}`,
success(res) {
console.log(res);
},
fail(res) {
console.log("navigateTo调用失败");
},
});
},
});// pages/detail
Page({
onLoad(options) {
console.log(options.sku);
},
});Bug & Tip
- Tip: 使用navigator组件也可以实现一样的功能。
- Tip: 小程序页面栈中最多能有 10 个页面，超过 10 个后，navigateTo 会失败。
点击纠错
评价此篇文档