uni.showActionSheet(options) @showactionsheet

# uni.showActionSheet(options)

从底部向上弹出操作菜单

# showActionSheet 兼容性

Web	Android	iOS
4.0	3.9.0	4.11

# 参数

名称

类型

必填

默认值

兼容性

描述

options

ShowActionSheetOptions

是

uni.showActionSheet函数参数定义

名称

类型

必备

默认值

兼容性

描述

title

string

否

菜单标题

alertText

string

否

警示文案（同菜单标题, app无效）

itemList

Array<string>

是

按钮的文字数组

itemColor

string.ColorString

否

按钮的文字颜色，字符串格式（iOS默认为系统控件颜色）

popover

Popover

否

大屏设备弹出原生选择按钮框的指示区域，默认居中显示

名称	类型	必备	默认值	兼容性	描述
top	number	是	-	-	指示区域坐标，使用原生 navigationBar 时一般需要加上 navigationBar 的高度
left	number	是	-	-	指示区域坐标
width	number	是	-	-	指示区域宽度
height	number	是	-	-	指示区域高度

success

(res: ShowActionSheetSuccess) => void

否

uni.showActionSheet成功回调函数定义

fail

(res: IPromptError) => void

否

uni.showActionSheet成功回调函数定义

complete

(res: any) => void

否

uni.showActionSheet成功回调函数定义

# ShowActionSheetSuccess 的属性值

名称	类型	必备	默认值	兼容性	描述
tapIndex	number	否	-	-	用户点击的按钮，从上到下的顺序，从0开始

# IPromptError 的属性值

名称

类型

必备

默认值

兼容性

描述

errCode

number

是

错误码

合法值	兼容性	描述
1	-	撤销
1001	-	请求参数非法

errSubject

string

是

统一错误主题（模块）名称

data

any

否

错误信息中包含的数据

cause

Error

否

源错误信息，可以包含多个错误，详见SourceError

errMsg

string

是

# 示例

hello uni-app x

Template

Script

<template>
  <!-- #ifdef APP -->
  <scroll-view style="flex: 1;">
  <!-- #endif -->
  <view>
    <page-head :title="title"></page-head>
    <view class="uni-list">
      <radio-group @change="radioChange">
        <radio class="uni-list-cell uni-list-cell-pd" v-for="(item, index) in items" :key="item.value"
          :class="index < items.length - 1 ? 'uni-list-cell-line': ''" :value="item.value" :checked="index === current">
          {{item.name}}
        </radio>
      </radio-group>
    </view>
    <view class="uni-list">
      <view class="uni-list-cell uni-list-cell-pd">
        <view class="uni-list-cell-db">自定义itemColor</view>
        <switch :checked="itemColorCustom" @change="itemColorChange" />
      </view>
      <view class="uni-list-cell uni-list-cell-pd">
        <view class="uni-list-cell-db">超长文本和空文本item</view>
        <switch :checked="itemContentLarge" @change="itemContentLargeChange" />
      </view>
      <view class="uni-list-cell uni-list-cell-pd">
        <view class="uni-list-cell-db">超过6个item</view>
        <switch :checked="itemNumLargeSelect" @change="itemNumLargeChange" />
      </view>
    </view>
    <view class="uni-padding-wrap">
      <view class="uni-btn-v">
        <button class="uni-btn-v" type="default" @tap="actionSheetTap" id="btn-action-sheet-show">弹出action
          sheet</button>
      </view>
    </view>
  </view>
  <!-- #ifdef APP -->
  </scroll-view>
  <!-- #endif -->
</template>