钉钉开发文档

导航栏

更新时间: 2019-4-17

扫码体验:
APInavigator.png

dd.navigateTo

保留当前页面,跳转到应用内的某个指定页面,可以使用 dd.navigateBack 返回到原来页面。

注意:页面最大深度为5,即可连续调用 5 次 navigateTo

入参

名称 类型 必填 描述
url String 需要跳转的应用内非 tabBar 的目标页面路径 ,路径后可以带参数。参数规则如下:路径与参数之间使用?分隔,参数键与参数值用=相连,不同参数必须用&分隔;如 path?key1=value1&key2=value2
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

代码示例

dd.navigateTo({
  url: 'new_page?count=100'
})
// test.js
Page({
  onLoad(query){
    dd.alert({
      content: JSON.stringify(query),
    });
  }
})

dd.redirectTo

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

入参

名称 类型 必填 描述
url String 需要跳转的应用内非 tabBar 的目标页面路径 ,路径后可以带参数。参数规则如下:路径与参数之间使用?分隔,参数键与参数值用=相连,不同参数必须用&分隔;如path?key1=value1&key2=value2
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

代码示例

dd.redirectTo({
  url: 'new_page?count=100'
})

dd.navigateBack

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

入参

名称 类型 默认值 描述
delta Number 1 返回的页面数,如果 delta 大于现有打开的页面数,则返回到当前页面栈最顶部的页

代码示例

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

// 此处是one页面
dd.navigateTo({
  url: 'two?pageId=10000'
})

// 此处是two页面
dd.navigateTo({
  url: 'one?pageId=99999'
})

// 在three页面内 navigateBack,将返回one页面
dd.navigateBack({
  delta: 2
})

dd.navigateTo 和 dd.redirectTo 不允许跳转到 tabbar 页面;如果需要跳转到 tabbar 页面,请使用 dd.switchTab。

dd.reLaunch

关闭当前所有页面,跳转到应用内的某个指定页面。

入参

名称 类型 必填 描述
url String 页面路径。如果页面不为 tabbar 页面则路径后可以带参数。参数规则如下:路径与参数之间使用?分隔,参数键与参数值用=相连,不同参数必须用&分隔;如path?key1=value1&key2=value2
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

代码示例

dd.reLaunch({
  url: '/page/index'
})

dd.setNavigationBar

扫码体验:
APIset-navigation-bar.png

设置导航栏文字及样式。

入参

名称 类型 必填 描述
title String 导航栏标题
backgroundColor String 导航栏背景色,支持十六进制颜色值
reset Boolean 是否重置导航栏为钉钉默认配色,默认 false
success Function 调用成功的回调函数
fail Function 调用失败的回调函数
complete Function 调用结束的回调函数(调用成功、失败都会执行)

代码示例

dd.setNavigationBar({
  title: '你好',
  backgroundColor: '#108ee9',
  success() {
    dd.alert({
      content: '设置成功', 
    });
  },
  fail() {
    dd.alert({
      content: '设置失败',
    });
  },
});
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!