# 导航栏

# 关闭当前页面

# 使用说明

调用此接口可以关闭当前浏览器窗口。

Android iOS PC
支持 支持 不支持

yy.biz.navigation.close({
  onSuccess: function(result) {
    /*result结构
        {}
    */
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8

# 替换页面

# 使用说明

使用新的页面替换当前页面,当前页面会被立即销毁,展示新页面,无动画。

Android iOS PC
支持 支持 不支持
yy.biz.navigation.replace({
  url: "https://xxx.com", // 新的页面链接
  onSuccess: function(result) {
    /*
        {}
        */
  },
  onFail: function(err) {}
});
url;
1
2
3
4
5
6
7
8
9
10

# 参数说明

参数 参数类型 必传 说明
url String 新的页面链接

# 设置导航栏标题

# 使用说明

Android iOS PC
支持 支持 支持

此 JSAPI 在 iOS 和 Android 上的显示不同:
(1)iOS/Android
标题在导航栏正中央。

(2)PC 端
注意,只在 SlidePanel 和 Modal 里起作用。

yy.biz.navigation.setTitle({
  title: "邮箱正文", //控制标题文本,空字符串表示显示默认文本
  onSuccess: function(result) {
    /*结构
        {
        }*/
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8
9

# 参数说明

参数 参数类型 必传 说明
title String
控制标题文本,空字符串表示显示默认文本

# 关闭页面

# 使用说明

注意:只在 SlidePanel 和 Modal 里起作用。

Android iOS PC
不支持 不支持 支持
yy.biz.navigation.quit({
  message: "quit message", //退出信息,传递给openSlidePanel的onSuccess函数的result参数
  onSuccess: function(result) {
    /**/
  },
  onFail: function() {}
});
1
2
3
4
5
6
7

# 参数说明

参数 参数类型 必传 说明
message String 退出信息,传递给 openSlidePanel 的 onSuccess 函数的 result 参数
1. message 参数仅支持字符串或者数字
2. 如果未传入 message,则传递给 openModal 的值为随机值

# 设置左侧导航按钮文本

# 使用说明

Android iOS PC
支持 支持 支持(只在 SlidePanel 里起作用)

# iOS/Android

yy.biz.navigation.setLeft({
  control: true, //是否控制点击事件,true 控制,false 不控制, 默认false
  text: "", //控制显示文本,空字符串表示显示默认文本
  onSuccess: function(result) {
    /*
        {}
        */
    //如果control为true,则onSuccess将在发生按钮点击事件被回调
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8
9
10
11
参数 参数类型 说明
contorl Boolean 是否控制点击事件,true 控制,false 不控制,默认 false
为 true 时,按钮点击触发 onSuccess 回调
text String 显示文本,默认 '返回'

# PC

只在 SlidePanel 里起作用

yy.biz.navigation.setLeft({
  text: "lalala", //显示文字信息
  onSuccess: function(result) {
    /**/
  },
  onFail: function() {}
});
1
2
3
4
5
6
7
参数 参数类型 说明
text String 显示文本

# 设置导航栏右侧单个按钮

# 使用说明

调用 setRight 可以设置导航栏最右侧按钮的文字,并且接收点击事件,只能设置文本按钮,需要设置按钮的 icon 请查看设置下面的导航栏右侧多个按钮。

Android iOS PC
支持 支持 不支持
yy.biz.navigation.setRight({
  show: false, //控制按钮显示, true 显示, false 隐藏, 默认true
  control: true, //是否控制点击事件,true 控制,false 不控制, 默认false
  text: "发送", //控制显示文本,空字符串表示显示默认文本
  color: "#fff", // 控制文本颜色
  onSuccess: function(result) {
    //如果control为true,则onSuccess将在发生按钮点击事件被回调
    /*
        {}
        */
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8
9
10
11
12
13

# 参数说明

参数 参数类型 说明
show Boolean 控制按钮显示,true 显示,false 隐藏,默认 true
control Boolean 是否控制点击事件,true 控制,false 不控制,默认 false
text String 控制显示文本,空字符串表示显示默认文本
color String 控制文本颜色

# 设置导航栏右侧多个按钮

# 使用说明

Android iOS PC
支持 支持 不支持
yy.biz.navigation.setMenu({
  backgroundColor: "#ADD8E6",
  textColor: "#ADD8E611",
  items: [
    {
      id: "1", //字符串
      url: "图标地址",
      text: "帮助"
    },
    {
      id: "2",
      url: "https://www...",
      text: "dierge"
    },
    {
      id: "3",
      url: "图标地址",
      text: "disange"
    }
  ],
  onSuccess: function(data) {
    /*
        {"id":"1"}
        */
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

# 参数说明

参数 参数类型 必传 说明
backgroundColor String 下拉菜单背景色
textColor String 下拉菜单文字颜色
items JSONArray 多个按钮的属性数组
item.id String 每一个 item 的唯一标识
item.url String 图标的网络地址
item.text String item 的文字属性

# 返回说明

点击任意一个按钮将会回调 onSuccess,并返回被点击 item 的 id。

多个按钮排序规则
items 个数小于等于两个,将在右上角直接排列,如下图:

items 个数大于两个,第一个按钮将在右上角显示,其他按钮在下拉菜单中显示。

每个按钮显示规则
每个 item 中的“text”字段是必填项。
(1)导航栏上的按钮显示规则(优先级从上至下)
url 对应的图片
text 对应的文本

# 设置下拉 title

# 使用说明

用来设置头部下拉 title

Android iOS PC
支持 支持 不支持

# iOS/Android

yy.biz.navigation.setTitleExpandIcon({
  isShowIcon: true, //true :展示标题右边icon ,false :隐藏标题右边icon
  title: "", //默认标题内容
  onSuccess: function(result) {
    /*
        {}
        */
    //onSuccess第一调用不触发,之后每次点击title都会触发onSuccess回调;
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8
9
10
11
参数 参数类型 说明
isShowIcon Boolean 控制右侧图标是否显示,true :展示标题右边 icon ,false :隐藏标题右边 icon
title String 设置 title 内容

# 配合 biz.navigation.updateExpandTitle 来实现下图日志的下拉

# image.png

# image.png

# 更新 title

# 使用说明

和 biz.navigation.setTitleExpandIcon 结合使用来实现 title 切换

Android iOS PC
支持 支持 不支持

# iOS/Android

yy.biz.navigation.updateExpandTitle({
  title: "", //需要更新的标题内容
  onSuccess: function(result) {
    /*
        {}
        */
  },
  onFail: function(err) {}
});
1
2
3
4
5
6
7
8
9
参数 参数类型 说明
title String 需要更新的标题内容

1
上次更新: 3/21/2020, 9:22:50 PM