本文へスキップ

ActionSheetIOS

iOSネイティブのAction Sheetコンポーネントを表示します。

例​

リファレンス

メソッド​

showActionSheetWithOptions()​

static showActionSheetWithOptions: (
  options: ActionSheetIOSOptions,
  callback: (buttonIndex: number) => void,
);

iOSのアクションシートを表示します。optionsオブジェクトには、1つ以上の項目を含める必要があります。

  • options (文字列の配列) - ボタンタイトルのリスト（必須）
  • cancelButtonIndex (整数) - optionsにおけるキャンセルボタンのインデックス
  • cancelButtonTintColor (文字列) - キャンセルボタンのテキストの色を変更するために使用される色
  • destructiveButtonIndex (整数または整数の配列) - optionsにおける破棄ボタンのインデックス
  • title (文字列) - アクションシートの上に表示するタイトル
  • message (文字列) - タイトルの下に表示するメッセージ
  • anchor (数値) - アクションシートを固定するノード（iPadで使用）
  • tintColor (文字列) - 破壊的でないボタンのタイトルに使用される色
  • disabledButtonIndices (数値の配列) - 無効にするボタンのインデックスのリスト
  • userInterfaceStyle (文字列) - アクションシートに使用されるインターフェーススタイル。lightまたはdarkに設定できます。それ以外の場合は、デフォルトのシステムスタイルが使用されます。

'callback'関数は、選択された項目の0ベースのインデックスを1つのパラメーターとして受け取ります。

最小限の例

ActionSheetIOS.showActionSheetWithOptions(
  {
    options: ['Cancel', 'Remove'],
    destructiveButtonIndex: 1,
    cancelButtonIndex: 0,
  },
  buttonIndex => {
    if (buttonIndex === 1) {
      /* destructive action */
    }
  },
);

dismissActionSheet()​

static dismissActionSheet();

表示されている一番上のiOSアクションシートを閉じます。アクションシートが表示されていない場合は、警告が表示されます。

showShareActionSheetWithOptions()​

static showShareActionSheetWithOptions: (
  options: ShareActionSheetIOSOptions,
  failureCallback: (error: Error) => void,
  successCallback: (success: boolean, method: string) => void,
);

iOSの共有シートを表示します。optionsオブジェクトには、messageとurlのいずれかまたは両方を含める必要があり、さらにsubjectまたはexcludedActivityTypesを含めることができます。

  • url (文字列) - 共有するURL
  • message (文字列) - 共有するメッセージ
  • subject (文字列) - メッセージの件名
  • excludedActivityTypes (配列) - アクションシートから除外するアクティビティ

注記: urlがローカルファイルまたはbase64でエンコードされたURIを指している場合、そのファイルがロードされ、直接共有されます。この方法で、画像、ビデオ、PDFファイルなどを共有できます。urlがリモートファイルまたはアドレスを指している場合、RFC 2396で説明されているように、URL形式に準拠する必要があります。たとえば、適切なプロトコル（HTTP/HTTPS）のないWeb URLは共有されません。

'failureCallback'関数は、エラーオブジェクトを1つのパラメーターとして受け取ります。このオブジェクトで定義されている唯一のプロパティは、オプションのstackプロパティ（型: string）です。

'successCallback'関数は2つのパラメーターを受け取ります。

  • 成功または失敗を示すブール値
  • 成功した場合、共有方法を示す文字列