title: Taro.showActionSheet(option)

sidebar_label: showActionSheet

显示操作菜单

注意

  • Android 6.7.2 以下版本，点击取消或蒙层时，回调 fail, errMsg 为 “fail cancel”；
  • Android 6.7.2 及以上版本 和 iOS 点击蒙层不会关闭模态弹窗，所以尽量避免使用「取消」分支中实现业务逻辑

参考文档

类型

  1. (option: Option) => Promise<SuccessCallbackResult>

参数

Option

参数 类型 必填 说明
itemList string[] 是 按钮的文字数组，数组长度最大为 6
complete (res: CallbackResult) => void 否 接口调用结束的回调函数（调用成功、失败都会执行）
fail (res: CallbackResult) => void 否 接口调用失败的回调函数
itemColor string 否 按钮的文字颜色
success (result: CallbackResult) => void 否 接口调用成功的回调函数

SuccessCallbackResult

参数 类型 说明
tapIndex number 用户点击的按钮序号，从上到下的顺序，从0开始
errMsg string 调用结果

示例代码

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

API 支持度

API 微信小程序 H5 React Native
Taro.showActionSheet ✔️ ✔️ ✔️