页面路由
- 导入模块
- 权限列表
- router.push(OBJECT)
- router.replace(OBJECT)
- router.back(OBJECT)
- router.clear()
- router.getLength()
- router.getState()
须知: 页面路由需要在页面渲染完成之后才能调用,在onInit和onReady生命周期中页面还处于渲染阶段,禁止调用页面路由方法。
导入模块
import router from '@system.router';
权限列表
无
router.push(OBJECT)
跳转到应用内的指定页面。
-
参数
跳转时要同时传递到目标页面的数据,跳转到目标页面后,参数可以在页面中直接使用,如this.data1(data1为跳转时params参数中的key值)。如果目标页面中已有该字段,则其值会被传入的字段值覆盖。
-
示例
// 在当前页面中 export default { pushPage() { router.push({ uri: 'pages/routerpage2/routerpage2', params: { data1: 'message', data2: { data3: [123, 456, 789] }, }, }); } } // 在routerpage2页面中 export default { data: { data1: 'default', data2: { data3: [1, 2, 3] } }, onInit() { console.info('showData1:' + this.data1); console.info('showData3:' + this.data2.data3); } }
说明: 页面路由栈支持的最大Page数量为32。
router.replace(OBJECT)
用应用内的某个页面替换当前页面,并销毁被替换的页面。
-
参数
跳转时要同时传递到目标页面的数据,跳转到目标页面后,参数可以在页面中直接使用,如this.data1(data1为跳转时params参数中的key值)。如果目标页面中已有该字段,则其值会被传入的字段值覆盖。
-
示例
// 在当前页面中 export default { replacePage() { router.replace({ uri: 'pages/detail/detail', params: { data1: 'message', }, }); } } // 在detail页面中 export default { data: { data1: 'default' }, onInit() { console.info('showData1:' + this.data1) } }
router.back(OBJECT)
返回上一页面或指定的页面。
-
参数
-
示例
// index页面 router.push({ uri: 'pages/detail/detail', }); // detail页面 router.push({ uri: 'pages/mall/mall', }); // mall页面通过back,将返回detail页面 router.back(); // detail页面通过back,将返回index页面 router.back(); // 通过back,返回到detail页面 router.back({uri:'pages/detail/detail'});
说明: 示例中的uri字段是页面路由,由配置文件中的pages列表指定。
router.clear()
清空页面栈中的所有历史页面,仅保留当前页面作为栈顶页面。
-
参数
无。
-
示例
router.clear();
router.getLength()
获取当前在页面栈内的页面数量。
-
返回值
-
示例
var size = router.getLength(); console.log('pages stack size = ' + size);
router.getState()
获取当前页面的状态信息。