@capacitor/action-sheet

Action Sheet API 提供对原生 Action Sheet 的访问，这些面板从屏幕底部弹出并显示用户可以执行的操作。

安装

npm install @capacitor/action-sheet
npx cap sync

变量

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

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

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