メインコンテンツまでスキップ
バージョン: v8

@capacitor/action-sheet

アクションシートAPIは、ネイティブなアクションシートへのアクセスを提供します。アクションシートは、画面の下部に表示され、ユーザーが取ることのできるアクションを表示します。

Install

npm install @capacitor/action-sheet
npx cap sync

Variables

このプラグインは以下のプロジェクト変数(アプリの variables.gradle ファイルで定義)を使用します:

  • androidxMaterialVersion: com.google.android.material:material のバージョン(デフォルト: 1.13.0

PWAに関する注意事項

Action Sheetプラグインが動作するにはPWA Elementsが必要です。

Example

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

const showActions = async () => {
const result = await ActionSheet.showActions({
title: 'Photo Options',
message: 'Select an option to perform',
options: [
{
title: 'Upload',
},
{
title: 'Share',
},
{
title: 'Remove',
style: ActionSheetButtonStyle.Destructive,
},
],
});

console.log('Action Sheet result:', result);
};

API

showActions(...)

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

Show an Action Sheet style modal with various options for the user to select.

ParamType
options
ShowActionsOptions

Returns:

Promise<ShowActionsResult>

Since: 1.0.0


Interfaces

ShowActionsResult

PropTypeDescriptionSince
indexnumberThe index of the clicked option (Zero-based)1.0.0

ShowActionsOptions

PropTypeDescriptionSince
titlestringThe title of the Action Sheet.1.0.0
messagestringA message to show under the title. This option is only supported on iOS.1.0.0
optionsActionSheetButton[]Options the user can choose from.1.0.0

ActionSheetButton

PropTypeDescriptionSince
titlestringThe title of the option1.0.0
style
ActionSheetButtonStyle
The style of the option This option is only supported on iOS.1.0.0
iconstringIcon for the option (ionicon naming convention) This option is only supported on Web.1.0.0

Enums

ActionSheetButtonStyle

MembersValueDescriptionSince
Default'DEFAULT'Default style of the option.1.0.0
Destructive'DESTRUCTIVE'Style to use on destructive options.1.0.0
Cancel'CANCEL'Style to use on the option that cancels the Action Sheet. If used, should be on the latest availabe option.1.0.0