@capacitor/action-sheet

Action Sheet API 提供访问原生 Action Sheets（操作列表）的功能，这些列表从屏幕底部弹出并显示用户可执行的操作。

安装

npm install @capacitor/action-sheet
npx cap sync

变量

本插件将使用以下项目变量（在应用的 variables.gradle 文件中定义）：

• $androidxMaterialVersion：com.google.android.material:material 的版本（默认值：1.3.0）

PWA 说明

Action Sheet 插件需要 PWA Elements 才能正常工作。

示例

import { ActionSheet, ActionSheetButtonStyle } from '@capacitor/action-sheet';

const showActions = async () => {
  const result = await ActionSheet.showActions({
    title: '照片选项',
    message: '选择一个要执行的操作',
    options: [
      {
        title: '上传',
      },
      {
        title: '分享',
      },
      {
        title: '删除',
        style: ActionSheetButtonStyle.Destructive,
      },
    ],
  });

  console.log('Action Sheet 结果：', result);
};

API

• showActions(...)
• 接口
• 枚举

showActions(...)

showActions(options: ShowActionsOptions) => Promise<ShowActionsResult>

显示一个 Action Sheet 样式的模态框，其中包含各种供用户选择的选项。

参数	类型
options	ShowActionsOptions

返回：

Promise<ShowActionsResult>

起始版本： 1.0.0

---

接口

ShowActionsResult

属性	类型	描述	起始版本
index	number	被点击选项的索引（从零开始）	1.0.0

ShowActionsOptions

属性	类型	描述	起始版本
title	string	Action Sheet 的标题。	1.0.0
message	string	在标题下方显示的消息。此选项仅在 iOS 上支持。	1.0.0
options	ActionSheetButton[]	用户可选择的选项。	1.0.0

ActionSheetButton

属性	类型	描述	起始版本
title	string	选项的标题	1.0.0
style	ActionSheetButtonStyle	选项的样式。此选项仅在 iOS 上支持。	1.0.0
icon	string	选项的图标（ionicon 命名约定）。此选项仅在 Web 上支持。	1.0.0

枚举

ActionSheetButtonStyle

成员	值	描述	起始版本
Default	'DEFAULT'	选项的默认样式。	1.0.0
Destructive	'DESTRUCTIVE'	用于破坏性操作的样式。	1.0.0
Cancel	'CANCEL'	用于取消 Action Sheet 的选项样式。如果使用，应放在最后一个可用选项上。	1.0.0