路由

switchTab

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38

switchTab(Object object)

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

参数

Object object

属性	类型	默认值	必填	说明
url	string		是	需要跳转的 tabBar 页面的路径（需在 app.json 的 tabBar 字段定义的页面），路径后不能带参数。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

{
  "tabBar": {
    "list": [
      {
        "pagePath": "/pages/home/home",
        "text": "首页"
      },
      {
        "pagePath": "/pages/other/other",
        "text": "其他"
      }
    ]
  }
}

reLaunch

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38

reLaunch(Object object)

关闭所有页面，打开到应用内的某个页面。

参数

Object object

属性	类型	默认值	必填	说明
url	string		是	需要跳转的应用内页面路径，路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔；如 'path?key=value&key2=value2'
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

ft.reLaunch({
  url: '/pages/other/other'
})

redirectTo

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38

redirectTo(Object object)

关闭当前页面，跳转到应用内的某个页面。

参数

Object object

属性	类型	默认值	必填	说明
url	string		是	需要跳转的应用内非 tabBar 的页面的路径，路径后可以带参数。参数与路径之间使用?分隔，参数键与参数值用=相连，不同参数用&分隔；如 'path?key=value&key2=value2'
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

ft.redirectTo({
  url: '/pages/other/other'
})

navigateTo

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38

navigateTo(Object object)

保留当前页面，跳转到应用内的某个页面。可以使用navigateBack返回原页面。

参数

Object object

属性	类型	默认值	必填	说明
url	string		是	需要跳转的应用内非 tabBar 的页面的路径 (代码包路径), 路径后可以带参数。参数与路径之间使用 ? 分隔，参数键与参数值用 = 相连，不同参数用 & 分隔；如 'path?key=value&key2=value2'
events	Object		否	页面间通信接口，用于监听被打开页面发送到当前页面的数据。基础库 2.7.3 开始支持。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

属性	类型	说明
eventChannel	EventChannel	和被打开页面进行通信

示例代码

ft.navigateTo({
  url: 'test?id=1',
  events: {
    // 为指定事件添加一个监听器，获取被打开页面传送到当前页面的数据
    acceptDataFromOpenedPage: function(data) {
      console.log(data)
    },
    someEvent: function(data) {
      console.log(data)
    }
    ...
  },
  success: function(res) {
    // 通过eventChannel向被打开页面传送数据
    res.eventChannel.emit('acceptDataFromOpenerPage', { data: 'test' })
  }
})

//test.js
Page({
  onLoad: function(option){
    console.log(option.query)
    const eventChannel = this.getOpenerEventChannel()
    eventChannel.emit('acceptDataFromOpenedPage', {data: 'test'});
    eventChannel.emit('someEvent', {data: 'test'});
    // 监听acceptDataFromOpenerPage事件，获取上一页面通过eventChannel传送到当前页面的数据
    eventChannel.on('acceptDataFromOpenerPage', function(data) {
      console.log(data)
    })
  }
})

navigateBack

基础库1.3.9开始支持，iOS版本2.1.23，Android版本2.1.38

navigateBack(Object object)

关闭当前页面，返回上一页面或多级页面。可通过 getCurrentPages() 获取当前的页面栈，决定需要返回几层。​

参数

Object object

属性	类型	默认值	必填	说明
delta	number		否	返回的页面数，如果 delta 大于现有页面数，则返回到首页。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

示例代码

// 注意：调用 navigateTo 跳转时，调用该方法的页面会被加入堆栈，而 redirectTo 方法则不会。见下方示例代码

// 此处是A页面
ft.navigateTo({
  url: 'B?id=1'
})

// 此处是B页面
ft.navigateTo({
  url: 'C?id=1'
})

// 在C页面内 navigateBack，将返回A页面
ft.navigateBack({
  delta: 2
})

EventChannel

页面间事件通信通道

EventChannel.emit

EventChannel.emit(string eventName, any args)

触发一个事件

参数

string eventName

事件名称

any args

事件参数

EventChannel.off

EventChannel.off(string eventName, function fn)

取消监听一个事件。给出第二个参数时，只取消给出的监听函数，否则取消所有监听函数

参数

string eventName

事件名称

function fn

事件监听函数

EventChannel.on

EventChannel.on(string eventName, function callback)

持续监听一个事件

参数

string eventName

事件名称

function callback

事件监听的回调函数

EventChannel.once

EventChannel.once(string eventName, function fn)

监听一个事件一次，触发后失效

参数

string eventName

事件名称

function callback

事件监听的回调函数