ActionSheetIOS

显示 iOS 原生的 Action Sheet 组件。

示例

参考

方法

showActionSheetWithOptions()

tsx

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

显示一个 iOS action sheet。options 对象必须包含以下一项或多项：

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

'callback' 函数接受一个参数，即所选项目的从零开始的索引。

最小示例：

tsx

ActionSheetIOS.showActionSheetWithOptions(
  {
    options: ['Cancel', 'Remove'],
    destructiveButtonIndex: 1,
    cancelButtonIndex: 0,
  },
  buttonIndex => {
    if (buttonIndex === 1) {
      /* 破坏性操作 */
    }
  },
);

---

dismissActionSheet()

tsx

static dismissActionSheet();

dismiss 最上层的 iOS action sheet，如果没有呈现 action sheet，则会显示警告。

---

showShareActionSheetWithOptions()

tsx

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

显示 iOS 分享 sheet。options 对象应包含 message 和 url 中的一个或两个，并且还可以具有 subject 或 excludedActivityTypes：

• url（string）- 要分享的 URL
• message（string）- 要分享的消息
• subject（string）- 消息的主题
• excludedActivityTypes（数组）- 要从 ActionSheet 中排除的活动

注意： 如果 url 指向本地文件，或者是 base64 编码的 uri，则它将指向的文件会被加载并直接分享。通过这种方式，你可以分享图片、视频、PDF 文件等。如果 url 指向远程文件或地址，它必须符合 RFC 2396 中描述的 URL 格式。例如，没有适当协议（HTTP/HTTPS）的 web URL 将不会被分享。

'failureCallback' 函数接受一个参数，一个 error 对象。此对象上定义的唯一属性是一个可选的 string 类型的 stack 属性。

'successCallback' 函数接受两个参数：

• 一个表示成功或失败的布尔值
• 一个字符串，在成功的情况下，表示分享的方法