ui
>= iOS 6.0
>= android 6.0
使用说明 :打开指定url
参数
名称
类型
描述
params
Object
必选:是
名称
类型
描述
url
String
必选:是
target
Number
必选:否
默认值:0: 在当前webview打开
可选值:
0: 在当前webview打开
1: 在新webview打开
2: 在外部浏览器上打开(iOS为Safari,Android为系统默认浏览器)
style
Number
必选:否
说明: WebView的样式(只对target=1有效),可选值如下:
默认值:0: 顶部标题栏模式(无底部工具栏)
可选值:
0: 顶部标题栏模式(无底部工具栏)
1: 顶部标题栏无分享入口(无底部工具栏)
2: 底部工具栏模式(顶部标题依然会存在)
3: 底部工具栏模式且顶部无分享入口(顶部标题依然会存在)
animation
Number
必选:否
说明: ( v4.7 ) webview展示动画,(该参数仅对Android有效)可选值如下:
默认值:0: 从右往左
可选值:
0: 从右往左
1: 直接打开
2: 从下往上
callback()
Function
必选:否
说明: 回调函数
返回值
名称
类型
描述
result
Object
必传:是
说明: 返回值 需要传入callback函数,result在callback中传回
名称
类型
描述
data
Object
必传:是
说明: 当前接口返回null
code
Number
必传:是
说明: 返回码
可选值:
0:调用成功
1:权限不允许
2:权限校验超时
3:没有此方法
4:参数错误
5:频率过于频繁
msg
String
必传:是
说明: 返回消息
可选值:
调用成功
权限不允许
权限校验超时
没有此方法
参数错误
频率过于平凡
Example
Copy
//用一个带底部导航栏、无分享按钮的WebView来打开链接
mqq.invoke('ui', 'openUrl', {
url: "//news.qq.com",
target: 1,
style: 3,
callback: function(){
alert(JSON.stringify(arguments));
}
});
>= iOS 6.0
>= android 6.0
使用说明 :关闭当前webview
参数
名称
类型
描述
params
Object
必选:是
名称
类型
描述
callback
String
必选:否
说明: 选填,回调函数
返回值
名称
类型
描述
result
Object
必传:是
说明: 返回值 需要传入callback函数,result在callback中传回
名称
类型
描述
data
Object
必传:是
说明: 当前接口返回null
code
Number
必传:是
说明: 返回码
可选值:
0:调用成功
1:权限不允许
2:权限校验超时
3:没有此方法
4:参数错误
5:频率过于频繁
msg
String
必传:是
说明: 返回消息
可选值:
调用成功
权限不允许
权限校验超时
没有此方法
参数错误
频率过于平凡
Example
Copy
mqq.invoke('ui', 'popBack', {
callback: function(){
alert(JSON.stringify(arguments));
}
});
>= iOS 6.0
android not support
使用说明 :刷新客户端显示的网页标题。在iOS中,网页标题动态改变后,显示WebView的导航栏标题不会改变,请调用refreshTitle来手动刷新。Android不需要。
参数
名称
类型
描述
params
Object
必选:是
名称
类型
描述
callback
String
必选:否
说明: 必填,消息标题,最长45字节
返回值
名称
类型
描述
result
Object
必传:是
说明: 返回值 需要传入callback函数,result在callback中传回
名称
类型
描述
data
Object
必传:是
说明: 当前接口返回null
code
Number
必传:是
说明: 返回码
可选值:
0:调用成功
1:权限不允许
2:权限校验超时
3:没有此方法
4:参数错误
5:频率过于频繁
msg
String
必传:是
说明: 返回消息
可选值:
调用成功
权限不允许
权限校验超时
没有此方法
参数错误
频率过于平凡
Example
Copy
document.title="新标题";
mqq.invoke('ui', 'refreshTitle', {
callback: function(result){
alert(result);
}
});
>= iOS 6.0
>= android 6.0
使用说明 :配置webview顶部返回按钮的文案,点击回调
参数
名称
类型
描述
params
Object
必选:是
名称
类型
描述
title
String
必选:否
说明: 文案,不传或传空不执行文案替换
callback
String
必选:否
说明: 回调函数,该回调函数不附带回调参数,不传不进行事件替换
Example
Copy
mqq.invoke('ui', 'setLeftButton', {
title : "我的..",
callback : function () {
alert("点击左按钮")
}
})
>= iOS 6.0
>= android 6.0
使用说明 :启动下拉刷新,该方法需要配合qbrowserPullDown的监听事件使用,当enable为true的时候,仅标识启用PullDown事件,需要在addEventListener中监听qbrowserPullDown,设置success状态为true/false会把PullDown收起来。其中success为true会有图标及文字展示,false则无。
参数
名称
类型
描述
params
Object
必选:是
名称
类型
描述
enable
Boolean
必选:是
说明: 启动标识, true 启动,false 不启动
可选值:
true:启动
false:不启动
success
Boolean
必选:否
说明: 业务方操作成功后,可以设置该参数,收起刷新界面
可选值:
true:成功
false:失败
text
String
必选:否
说明: 操作成功后提示文案
Example
Copy
// 初始化启动下拉刷新的功能
mqq.invoke('ui', 'setPullDown', { enable: true });
// 监听`qbrowserPullDown`事件,当用户触发之后,即可开始处理业务方的逻辑
mqq.addEventListener("qbrowserPullDown", function () {
// ... Your Code ...
mqq.invoke('ui', 'setPullDown', { success: true , text: "刷新成功" });
});
>= iOS 6.0
>= android 6.0
使用说明 :配置webview顶部右边按钮的标题、点击回调等
参数
名称
类型
描述
params
Object
必选:是
名称
类型
描述
title
String
必选:否
说明: 文案,不传或传空不执行文案替换
callback
String
必选:否
说明: 回调函数,该回调函数不附带回调参数,不传不进行事件替换
Example
Copy
mqq.invoke('ui', 'setRightButton', {
title : "我的..",
callback : function () {
alert("点击右按钮")
}
})
>= iOS 6.0
>= android 6.0
使用说明 :调用客户端的分享接口,分享内容给好友/群,调用后会弹出联系人选择列表
参数
名称
类型
描述
params
Object
必选:是
名称
类型
描述
title
String
必选:是
说明: 必填,消息标题,最长45字节
desc
String
必选:是
说明: 必填,消息摘要,最长60字节。
shareType
Number
必选:是
说明: 分享的目标类型,0:QQ好友;1:QQ空间;2:微信好友;3:微信朋友圈。默认为 0
默认值:0:QQ好友
可选值:
0:QQ好友
1:QQ空间
2:微信好友
3:微信朋友圈
shareUrl
String
必选:是
说明: 必填,点击消息后的跳转url,最长120字节。原 targetUrl 参数,可以继续使用 targetUrl
imageUrl
String
必选:是
说明: 必填,消息左侧缩略图url。图片推荐使用正方形,宽高不够时等比例撑满,不会变形。原 imageUrl 参数,可以继续使用 imageUrl。注意:图片最小需要200 * 200,否则分享到Qzone时会被Qzone过滤掉。
back
Boolean
必选:否
说明: 发送消息之后是否返回到web页面,默认false,直接到AIO,注:该参数只对shareType=0时起作用
默认值:false:不返回到web页面
可选值:
true:返回到web页面
false:不返回到web页面
shareElement
String
必选:否
说明: 分享的类型,目前支持图文和音乐分享。news:图文分享类型,audio:音乐分享类型,video:视频分享类型。默认为news
默认值:news:图文分享类型
可选值:
news:图文分享类型
audio:音乐分享类型
video:视频分享类型
flashUrl
String
必选:否
说明: 如果分享类型是音乐或者视频类型,则填写流媒体url
puin
String
必选:否
说明: 公众帐号uin,用于自定义结构化消息尾巴,只在公众账号分享的时候填写,若不是请不要填,当puin没有索引到本地记录,则显示sourceName字段的文本,若没有sourceName字段,则直接显示puin数字
appid
String
必选:否
说明: 来源 appid,在QQ互联申请的的 appid,如果有,可以填上
sourceName
String
必选:否
说明: 消息来源名称,默认为空,优先读取 appid 对应的名字,如果没有则读取 puin 对应的公众账号名称
toUin
String
必选:否
说明: 分享给指定的好友或群,如果存在这个参数,则不拉起好友选择界面 (针对分享给好友)
uinType
Number
必选:否
说明: 分享给指定的好友或群的uin类型: 0:好友;1:群 (针对分享给好友)
可选值:
0:好友
1:群 (针对分享给好友)
callback()
Function
必选:否
说明: 回调函数
返回值
名称
类型
描述
result
Object
必传:是
说明: 返回值 需要传入callback函数,result在callback中传回
名称
类型
描述
data
Object
必传:是
说明: 返回执行结果
名称
类型
描述
retCode
String
必传:是
说明: 返回码
可选值:
0:用户点击发送,完成整个分享流程
1:用户点击取消,中断分享流程
-2:iOS端分享到微信或朋友圈时,手动取消分享将返回-2
code
Number
必传:是
说明: 返回码
可选值:
0:调用成功
1:权限不允许
2:权限校验超时
3:没有此方法
4:参数错误
5:频率过于频繁
msg
String
必传:是
说明: 返回消息
可选值:
调用成功
权限不允许
权限校验超时
没有此方法
参数错误
频率过于平凡
Example
Copy
// 分享给QQ好友
mqq.invoke('ui', 'shareMessage', {
title: '6.0马上要来了,你知道吗',
desc: '这里是分享的内容,支持定向分享哦,快来体验海量Q粉吧!',
shareUrl: '//qq.com',
shareType:0,
back: true,
sourceName: '个人定制',
back: true,
imageUrl: '//dcloud.oa.com/Public/waltz/ck_img/1393900982.png',
callback: function (ret) {
alert(JSON.stringify(ret))
}
})
Example
Copy
// 分享给微信好友
mqq.invoke('ui', 'shareMessage', {
title: '6.0马上要来了,你知道吗',
desc: '这里是分享的内容,支持定向分享哦,快来体验海量Q粉吧!',
shareUrl: '//qq.com',
shareType:2,
back: true,
sourceName: '个人定制',
back: true,
imageUrl: '//dcloud.oa.com/Public/waltz/ck_img/1393900982.png',
callback: function (ret) {
alert(JSON.stringify(ret))
}
})
Example
Copy
// 分享到空间
mqq.invoke('ui', 'shareMessage', {
title: '6.0马上要来了,你知道吗',
desc: '这里是分享的内容,支持定向分享哦,快来体验海量Q粉吧!',
shareUrl: '//qq.com',
shareType:1,
back: true,
sourceName: '个人定制',
back: true,
imageUrl: '//dcloud.oa.com/Public/waltz/ck_img/1393900982.png',
callback: function (ret) {
alert(JSON.stringify(ret))
}
})
>= iOS 6.0
>= android 6.0
使用说明 :弹出 ActionSheet UI
参数
名称
类型
描述
params
Object
必选:是
说明: 该组件参数可自由组合,调用结果会通过callback函数返回
名称
类型
描述
title
String
必选:否
说明: ActionSheet 标题
cancel
String
必选:否
说明: 指定取消按钮的文字
close
String
必选:否
说明: 指定关闭按钮的文字
items
Array|String
必选:否
说明: 选项列表, 字符串
callback()
Function
必选:否
说明: 回调函数
callback()
Function
必选:否
说明: 回调函数
返回值
名称
类型
描述
result
Object
必传:是
说明: 返回值 需要传入callback函数,result在callback中传回
名称
类型
描述
data
String
必传:是
说明: 返回执行结果
可选值:
0,n - 1:点击用户提供的items选项表第n - 1项,n表示共有n项,计数从0开始,下面两项也然
2,n + 1:用户点击关闭按钮
1,n:用户点击取消按钮,用户通过其它途径离开选择状态也为该返回值
code
Number
必传:是
说明: 返回码
可选值:
0:调用成功
1:权限不允许
2:权限校验超时
3:没有此方法
4:参数错误
5:频率过于频繁
msg
String
必传:是
说明: 返回消息
可选值:
调用成功
权限不允许
权限校验超时
没有此方法
参数错误
频率过于平凡
Example
Copy
mqq.invoke('ui', 'showActionSheet', {
title : "title",
items : ["item1", "item2"],
cancel : "cancel",
close : "close",
callback: function(ret){
alert(JSON.stringify(ret))
}
});
>= iOS 5.0
>= android 5.0
使用说明 :弹出一个确认框
参数
名称
类型
描述
params
Object
必选:是
说明: 参数
名称
类型
描述
title
String
必选:否
说明: 确认框的标题
text
String
必选:否
说明: 确认框的提示内容
needOkBtn
Boolean
必选:是
说明: 是否显示确认按钮(默认为true)
needCancelBtn
Boolean
必选:是
说明: 是否显示取消按钮(默认为true)
okBtnText
String
必选:否
说明: 确认按钮的文本(默认为"确定")
cancelBtnText
String
必选:否
说明: 取消按钮的文本(默认为"取消")
callback()
Function
必选:否
说明: 回调
返回值
名称
类型
描述
result
Object
必传:是
说明: 返回值 需要传入callback函数,result在callback中传回
名称
类型
描述
data
String
必传:是
说明: 返回执行结果
名称
类型
描述
button
String
必传:是
说明: 指示用户点击的按钮
可选值:
0:点击了确认按钮
1:点击了取消按钮
code
Number
必传:是
说明: 返回码
可选值:
0:调用成功
1:权限不允许
2:权限校验超时
3:没有此方法
4:参数错误
5:频率过于频繁
msg
String
必传:是
说明: 返回消息
可选值:
调用成功
权限不允许
权限校验超时
没有此方法
参数错误
频率过于平凡
Example
Copy
mqq.invoke('ui', 'showDialog', {
title: '这是标题',
text: '这是内容这是内容这是内容这是内容这是内容',
needOkBtn: true,
needCancelBtn: true,
okBtnText: '大胆继续',
cancelBtnText: '忍痛离开',
callback: function(ret) {
alert(JSON.stringify(ret))
}
})
注意 :needOkBtn 和 needCancelBtn 至少要有一个为 true
>= iOS 6.0
>= android 6.0
使用说明 :弹出文本的toast提示,2秒后消失
参数
名称
类型
描述
params
Object
必选:是
名称
类型
描述
text
String
必选:是
说明: 要提示的文字内容
iconMode
Number
必选:否
说明: icon类型
默认值:2
可选值:
1: 勾选图标
2: 空心警告图标
返回值
名称
类型
描述
result
Object
必传:是
说明: 返回值 需要传入callback函数,result在callback中传回
名称
类型
描述
data
Object
必传:是
说明: 当前接口返回null
code
Number
必传:是
说明: 返回码
可选值:
0:调用成功
1:权限不允许
2:权限校验超时
3:没有此方法
4:参数错误
5:频率过于频繁
msg
String
必传:是
说明: 返回消息
可选值:
调用成功
权限不允许
权限校验超时
没有此方法
参数错误
频率过于平凡
Example
Copy
mqq.invoke('ui', 'showTips', {
text: "hello",
iconMode: 2
})