快應(yīng)用 頁(yè)面路由

接口聲明

無需聲明

導(dǎo)入模塊

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

接口定義

router.push(OBJECT)

跳轉(zhuǎn)到應(yīng)用內(nèi)的某個(gè)頁(yè)面

參數(shù)：

params 參數(shù):

___PARAMPAGE_ANIMATION\__ 參數(shù):

slide模式在各動(dòng)作下的動(dòng)畫變化詳情如下：

示例：

• 喚醒電話

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

• 發(fā)送短信

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

• 應(yīng)用內(nèi)切換頁(yè)面
  • path 切換

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

  • name 切換

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

  • 切換頁(yè)面并清除其他頁(yè)面

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

• 打開網(wǎng)頁(yè)

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

• 打開原生應(yīng)用

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

• 打開另一個(gè)快應(yīng)用

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

• 打開 wifi 設(shè)置頁(yè)面

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

• 配置跳轉(zhuǎn)動(dòng)畫模式

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

router.replace(OBJECT)

跳轉(zhuǎn)到應(yīng)用內(nèi)的某個(gè)頁(yè)面，當(dāng)前頁(yè)面無法返回

參數(shù)：

示例：

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

router.back(OBJECT)

返回指定頁(yè)面

參數(shù)：

示例：

// A頁(yè)面, open page by name
router.push({
  uri: 'B'
})
// B頁(yè)面, open page by name
router.push({
  uri: 'C'
})
// C頁(yè)面, open page by name
router.push({
  uri: 'D'
})
// D頁(yè)面, open page by name
router.push({
  uri: 'E'
})
// E頁(yè)面不傳入頁(yè)面路徑，返回至D頁(yè)面
router.back()
// D頁(yè)面不傳入頁(yè)面名稱，返回至C頁(yè)面
router.back()
// C頁(yè)面?zhèn)魅腠?yè)面路徑，返回至A頁(yè)面
router.back({
  path: '/A'
})

router.clear()

清空所有歷史頁(yè)面記錄，僅保留當(dāng)前頁(yè)面

參數(shù)：

無

示例：

router.clear()

router.getLength()

獲取當(dāng)前頁(yè)面棧的頁(yè)面數(shù)量

返回值:

示例：

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

router.getState()

獲取當(dāng)前頁(yè)面狀態(tài)

返回參數(shù)：

示例：

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

router.getPages()

獲取當(dāng)前頁(yè)面棧列表

返回值：

數(shù)組每一項(xiàng)構(gòu)成：

示例：

var stacks = router.getPages();
console.log("棧底頁(yè)面名稱為：", stacks[0].name); // 如 list、detail 等
console.log("棧底頁(yè)面路徑為：", stacks[0].path); // 如 /list、/detail、/home/preview

后臺(tái)運(yùn)行限制

禁止使用。 后臺(tái)運(yùn)行詳細(xì)用法參見 后臺(tái)運(yùn)行 腳本。