文档

# 交互

# qq.showToast

QQ mac版本：支持

QQ windows版本：支持

# qq.showToast(Object object)

显示消息提示框

# 参数

# Object object
属性 类型 默认值 必填 说明 最低版本
title string 是 提示的内容
icon string 'success' 否 图标
image string 否 自定义图标的本地路径，image 的优先级高于 icon
duration number 1500 否 提示的延迟时间
mask boolean false 否 是否显示透明蒙层，防止触摸穿透
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

object.icon 的合法值

值 说明
success 显示成功图标，此时 title 文本最多显示 7 个汉字长度
loading 显示加载图标，此时 title 文本最多显示 7 个汉字长度
none 不显示图标，此时 title 文本最多可显示两行

# 示例代码

qq.showToast({
  title: '成功',
  icon: 'success',
  duration: 2000
})
1
2
3
4
5

# 注意

# qq.showModal

QQ mac版本：支持

QQ windows版本：支持

# qq.showModal(Object object)

显示模态对话框

# 参数

# Object object
属性 类型 默认值 必填 说明
title string 是 提示的标题
content string 是 提示的内容
showCancel boolean true 否 是否显示取消按钮
cancelText string '取消' 否 取消按钮的文字，最多 4 个字符
cancelColor string #000000 否 取消按钮的文字颜色，必须是 16 进制格式的颜色字符串
confirmText string '确定' 否 确认按钮的文字，最多 4 个字符
confirmColor string #576B95 否 确认按钮的文字颜色，必须是 16 进制格式的颜色字符串
theme string 否 弹窗主题色，可选值参考主题色可选值 ，不填则跟随系统主题
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
# object.theme 主题色
值 说明
day 白天主题
night 夜间主题
extremeBlack 极致黑主题
# object.success 回调函数

参数

Object res

属性 类型 说明 最低版本
confirm boolean 为 true 时，表示用户点击了确定按钮
cancel boolean 为 true 时，表示用户点击了取消（用于 Android 系统区分点击蒙层关闭还是点击取消按钮关闭）

# 示例代码

qq.showModal({
  title: '提示',
  content: '这是一个模态弹窗',
  success(res) {
    if (res.confirm) {
      console.log('用户点击确定')
    } else if (res.cancel) {
      console.log('用户点击取消')
    }
  }
})
1
2
3
4
5
6
7
8
9
10
11

# qq.showLoading

QQ mac版本：支持

QQ windows版本：支持

# qq.showLoading(Object object)

显示 loading 提示框。需主动调用 qq.hideLoading 才能关闭提示框

# 参数

# Object object
属性 类型 默认值 必填 说明
title string 是 提示的内容
mask boolean false 否 是否显示透明蒙层，防止触摸穿透
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

# 示例代码

qq.showLoading({
  title: '加载中',
})

setTimeout(function () {
  qq.hideLoading()
}, 2000)
1
2
3
4
5
6
7

# 注意

# qq.showActionSheet

QQ mac版本：支持

QQ windows版本：支持

# qq.showActionSheet(Object object)

显示操作菜单

# 参数

# Object object
属性 类型 默认值 必填 说明
itemList Array.<string> 是 按钮的文字数组，数组长度最大为 6
itemColor string #000000 否 按钮的文字颜色
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
# object.success 回调函数

参数

Object res

属性 类型 说明
tapIndex number 用户点击的按钮序号，从上到下的顺序，从0开始

# 示例代码

qq.showActionSheet({
  itemList: ['A', 'B', 'C'],
  success(res) {
    console.log(res.tapIndex)
  },
  fail(res) {
    console.log(res.errMsg)
  }
})
1
2
3
4
5
6
7
8
9

# qq.hideToast

QQ mac版本：支持

QQ windows版本：支持

# qq.hideToast(Object object)

隐藏消息提示框

# 参数

# Object object
属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
noConflict boolean false 否 目前 toast 和 loading 相关接口可以相互混用，此参数可用于取消混用特性（基础库版本不低于1.55.0）

# qq.hideLoading

QQ mac版本：支持

QQ windows版本：支持

# qq.hideLoading(Object object)

QQ mac版本：支持

QQ windows版本：支持

隐藏 loading 提示框

# 参数

# Object object
属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
noConflict boolean false 否 目前 toast 和 loading 相关接口可以相互混用，此参数可用于取消混用特性（基础库版本不低于1.55.0）

# qq.hideHomeButton

QQ mac版本：支持

QQ windows版本：支持

# qq.hideHomeButton(Object object)

基础库 1.10.0 开始支持，低版本需做兼容处理。

隐藏分享面板的返回首页按钮。QQ从8.2.6版本起，当用户打开的小程序最底层页面是非首页时，分享面板默认展示“返回首页”按钮，开发者可调用 hideHomeButton 进行隐藏。

参数 Object object

属性 类型 默认值 必填 说明
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）

← 导航栏 →