ActionSheetIOS

显示一个 iOS 原生的Action Sheet组件。

示例

文档

方法

showActionSheetWithOptions()

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

在 iOS 设备上显示一个 ActionSheet 弹出框，其中options参数为一个对象，其属性必须包含以下一项或多项：

• options（字符串数组） - 按钮标题列表（必需）
• cancelButtonIndex（整数） - options 中取消按钮的索引
• cancelButtonTintColor（字符串） - 用于改变取消按钮文本颜色的颜色（颜色）
• destructiveButtonIndex（整数或整数数组） - options 中破坏性按钮的索引
• title（字符串） - 显示在操作表上方的标题
• message（字符串） - 显示在标题下方的消息
• anchor（数字） - 操作表应锚定的节点（用于 iPad）
• tintColor（字符串） - 用于非破坏性按钮标题的颜色（颜色）
• disabledButtonIndices（数字数组） - 应禁用的按钮索引列表
• userInterfaceStyle（字符串） - 用于操作表的界面样式，可以设置为 light 或 dark，否则将使用默认的系统样式

callback函数则仅接受一个参数，即所点击按钮的索引。

一个例子：

ActionSheetIOS.showActionSheetWithOptions({
  options: ['取消', '删除'],
  destructiveButtonIndex: 1,
  cancelButtonIndex: 0,
},
(buttonIndex) => {
if (buttonIndex === 1) { /* 当接收到的索引为1，即点击了删除按钮时，执行对应操作 */ }
});

---

dismissActionSheet()

static dismissActionSheet();

关闭当前显示的最顶层 ActionSheet。如果当前没有 ActionSheet，则会显示警告。

---

showShareActionSheetWithOptions()

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

在 iOS 设备上显示一个分享弹出框，其中options参数为一个对象，其属性包含以下几项（必须至少有 message 或 url）:

• url （字符串） - 要分享的 URL 地址
• message （字符串） - 要分享的信息
• subject （字符串） - 要分享的信息主题
• excludedActivityTypes （数组） - 指定在 actionsheet 中不显示的活动

注：如果url指向本地文件，或者是一个 base64 编码的 url，则会直接读取并分享相应的文件。你可以用这样的方式来分享图片、视频以及 PDF 文件等。If url points to a remote file or address it must conform to URL format as described in RFC 2396. For example, a web URL without a proper protocol (HTTP/HTTPS) will not be shared.

failureCallback函数仅接受一个错误对象参数。此对象中仅包含一个可选的stack属性，类型为字符串。

successCallback函数接受两个参数：

• 表示成功与否的布尔值
• 成功的话返回一个表示分享方式的字符串