全部产品

my.showActionSheet

显示操作菜单。

示例代码

// API-DEMO page/API/action-sheet/action-sheet.json
{
    "defaultTitle": "Action Sheet"
}

<!-- API-DEMO page/API/action-sheet/action-sheet.axml-->
<view class="page">
  <view class="page-description">操作菜单 API</view>
  <view class="page-section">
    <view class="page-section-title">my.showActionSheet</view>
    <view class="page-section-demo">
      <button type="primary" onTap="showActionSheet">显示操作菜单</button>
    </view>
  </view>
</view>

// API-DEMO page/API/action-sheet/action-sheet.js
Page({
  showActionSheet() {
    my.showActionSheet({
      title: '阿里云-ActionSheet',
      items: ['菜单一', '菜单二', '菜单三'],
      cancelButtonText: '取消好了',
      success: (res) => {
        const btn = res.index === -1 ? '取消' : '第' + res.index + '个';
        my.alert({
          title: `你点了${btn}按钮`
        });
      },
    });
  },
});

入参

Object 类型,属性如下:

属性

类型

必填

描述

最低基础库版本

title

String

菜单标题。

-

items

String Array

菜单按钮文字数组。

-

cancelButtonText

String

取消按钮文案。默认为‘取消’。注:Android平台此字段无效,不会显示取消按钮。

-

destructiveBtnIndex

Number

(iOS特殊处理)指定按钮的索引号,从0开始,使用场景:需要删除或清除数据等类似场景,默认红色。

-

badges

Object Array

需飘红选项的数组,数组内部对象字段见下表。

success

Function

调用成功的回调函数。

-

fail

Function

调用失败的回调函数。

-

complete

Function

调用结束的回调函数(调用成功、失败都会执行)。

-

badges 属性

属性

类型

描述

index

Number

需要飘红的选项的索引,从 0 开始。

type

String

飘红类型,支持 none(无红点)/ point(纯红点) / num(数字红点)/ text(文案红点)/ more(...)。

text

String

自定义飘红文案:type 为 none / point / more 时,text 可不填;

type为 num 时,text 为小数或 ≤ 0均不显示, ≥ 100 显示"..."。