跳到主要内容

ActionSheetIOS

显示 iOS 原生的 Action Sheet 组件。

示例​

参考

方法​

showActionSheetWithOptions()​

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

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

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

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

最小示例：

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

dismissActionSheet()​

React TSX
static dismissActionSheet();

关闭当前显示的最上层 iOS action sheet，如果没有 action sheet 显示，则会提示警告。

showShareActionSheetWithOptions()​

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

显示 iOS 分享面板。options 对象应包含 message 和 url 中的一项或两项，并且还可以额外包含 subject 或 excludedActivityTypes：

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

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

failureCallback 函数接收一个参数，即错误对象。此对象上定义的唯一属性是可选的 stack 属性，类型为 string。

successCallback 函数接收两个参数：

  • 一个表示成功或失败的布尔值
  • 一个字符串，在成功时表示分享方式