交互

用户使用小程序的反馈

wx.showToast

object.icon 的合法值

示例代码

wx.showToast({
  title: '成功',
  icon: 'success',
  duration: 2000
})

注意

  • wx.showLoading 和 wx.showToast 同时只能显示一个

  • wx.showToast 应与 wx.hideToast 配对使用

呈现效果

wx.hideToast(Object object)

隐藏消息提示框

参数

Object object

注意

  • wx.showToast 应与 wx.hideToast 配对使用

wx.showModal(Object object)

显示模态对话框

参数

Object object

object.success 回调函数

参数

Object res

示例代码

wx.showModal({
  title: '提示',
  content: '这是一个模态弹窗',
  success (res) {
    if (res.confirm) {
      console.log('用户点击确定')
    } else if (res.cancel) {
      console.log('用户点击取消')
    }
  }
})

注意

  • Android 6.7.2 以下版本,点击取消或蒙层时,回调 fail, errMsg 为 "fail cancel";

  • Android 6.7.2 及以上版本 和 iOS 点击蒙层不会关闭模态弹窗,所以尽量避免使用「取消」分支中实现业务逻辑

呈现效果

wx.showLoading(Object object)

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

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

参数

Object object

示例代码

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

setTimeout(function () {
  wx.hideLoading()
}, 2000)

注意

  • wx.showLoading 和 wx.showToast 同时只能显示一个

  • wx.showLoading 应与 wx.hideLoading 配对使用

wx.hideLoading(Object object)

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

隐藏 loading 提示框

参数

Object object

wx.showActionSheet(Object object)

显示操作菜单

参数

Object object

object.success 回调函数

参数

Object res

示例代码

wx.showActionSheet({
  itemList: ['A', 'B', 'C'],
  success (res) {
    console.log(res.tapIndex)
  },
  fail (res) {
    console.log(res.errMsg)
  }
})

注意

  • Android 6.7.2 以下版本,点击取消或蒙层时,回调 fail, errMsg 为 "fail cancel";

  • Android 6.7.2 及以上版本 和 iOS 点击蒙层不会关闭模态弹窗,所以尽量避免使用「取消」分支中实现业务逻辑

呈现效果

wx.enableAlertBeforeUnload

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

开启小程序页面返回询问对话框

参数

Object object

wx.disableAlertBeforeUnload(Object object)

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

关闭小程序页面返回询问对话框

参数

Object object

Last updated