页面路由 router

接口声明

无需声明

导入模块

import router from '@system.router' 或 const router = require('@system.router')

接口定义

router.push(OBJECT)

跳转到应用内的某个页面，页面栈层数没有限制

注意：不能跳到 tabBar 页面

参数：

params 参数:

___PARAM_PAGE_ANIMATION___ 参数:

slide 模式在各动作下的动画变化详情如下：

示例：

• 唤醒电话

  router.push({
    uri: 'tel:10086'
  })
  

• 发送短信

  router.push({
    uri: 'sms:10086',
    params: {
      body: 'message'
    }
  })
  

• 应用内切换页面

  • path 切换

    router.push({
      uri: '/about',
      params: {
        testId: '1'
      }
    })
    

  • name 切换

    // open page by name
    router.push({
      uri: 'About',
      params: {
        testId: '1'
      }
    })
    

  • 切换页面并清除其他页面 1050 +

    router.push({
      uri: '/about',
      params: {
        ___PARAM_LAUNCH_FLAG___: 'clearTask'
      }
    })
    

• 打开网页

  router.push({
    uri: 'http://www.example.com'
  })
  

• 打开原生应用

  router.push({
    uri: 'internal://cache/example.apk'
  })
  

• 打开另一个快应用

  router.push({
    uri: 'hap://app/com.example.quickapp/page?key=value'
  })
  

• 打开 wifi 设置页面 1040 +

  router.push({
    uri: 'hap://settings/wlan_manager'
  })
  

• 配置跳转动画模式 1070 +

  router.push({
    uri: '/about',
    params: {
      ___PARAM_PAGE_ANIMATION___: {
        openEnter: `none`,
        closeEnter: `slide`,
        openExit: `slide`,
        closeExit: `slide`
      }
    }
  })
  

router.replace(OBJECT)

跳转到应用内的某个页面，当前页面无法返回

注意：不能跳到 tabBar 页面

参数：

示例：

router.replace({
  uri: '/test',
  params: {
    testId: '1'
  }
})

router.switchTab(OBJECT) 1200+

跳转到 tabBar 页面，并关闭其他所有页面

• 注：oppo侧暂不支持

参数：

示例：

router.switchTab({
  uri: '/test',
  params: {
    testId: '1'
  }
})

router.back(OBJECT)

返回指定页面

参数：

示例：

// A页面, open page by name
router.push({
  uri: 'B'
})
// B页面, open page by name
router.push({
  uri: 'C'
})
// C页面, open page by name
router.push({
  uri: 'D'
})
// D页面, open page by name
router.push({
  uri: 'E'
})
// E页面不传入页面路径，返回至D页面
router.back()
// D页面不传入页面名称，返回至C页面
router.back()
// C页面传入页面路径，返回至A页面
router.back({
  path: '/A'
})

router.clear()

清空所有历史页面记录，仅保留当前页面

参数：

无

示例：

router.clear()

router.getLength()

获取当前页面栈的页面数量

返回值:

示例：

var length = router.getLength()
console.log(`page's length = ${length}`)

router.getState()

获取当前页面状态

返回参数：

示例：

var page = router.getState()
console.log(`page index = ${page.index}`)
console.log(`page name = ${page.name}`)
console.log(`page path = ${page.path}`)

router.getPages()1070+

获取当前页面栈列表

返回值：

数组每一项构成：

示例：

var stacks = router.getPages()
console.log('栈底页面名称为：', stacks[0].name) // 如 list、detail 等
console.log('栈底页面路径为：', stacks[0].path) // 如 /list、/detail、/home/preview

后台运行限制

禁止使用。 后台运行详细用法参见后台运行 脚本。