# 路由

# 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'
})

基础库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)
    })
  }
})

基础库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

事件监听的回调函数