ActionSheetIOS
显示 iOS 原生的 操作表 组件。
示例
参考
方法
showActionSheetWithOptions()
tsx
static showActionSheetWithOptions: (
options: ActionSheetIOSOptions,
callback: (buttonIndex: number) => void,
);
显示一个 iOS 操作表。options 对象必须包含以下一项或多项:
options(字符串数组)- 按钮标题列表(必填)cancelButtonIndex(整数)-options中取消按钮的索引cancelButtonTintColor(字符串)- 用于更改取消按钮文本颜色的颜色destructiveButtonIndex(整数或整数数组)-options中破坏性按钮的索引title(字符串)- 显示在操作表上方的标题message(字符串)- 显示在标题下方的消息anchor(数字)- 操作表应锚定的节点(用于 iPad)tintColor(字符串)- 用于非破坏性按钮标题的颜色disabledButtonIndices(数字数组)- 需禁用的按钮索引列表userInterfaceStyle(字符串)- 操作表的界面样式,可设置为light或dark,否则使用默认系统样式
callback 函数接收一个参数,即所选项的零基索引。
最简示例:
tsx
ActionSheetIOS.showActionSheetWithOptions(
{
options: ['取消', '删除'],
destructiveButtonIndex: 1,
cancelButtonIndex: 0,
},
buttonIndex => {
if (buttonIndex === 1) {
/* 破坏性操作 */
}
},
);
dismissActionSheet()
tsx
static dismissActionSheet();
关闭最上层展示的 iOS 操作表,如果没有操作表展示,会显示警告。
showShareActionSheetWithOptions()
tsx
static showShareActionSheetWithOptions: (
options: ShareActionSheetIOSOptions,
failureCallback: (error: Error) => void,
successCallback: (success: boolean, method: string) => void,
);
显示 iOS 分享表。options 对象应包含 message 和/或 url,此外可含有 subject 或 excludedActivityTypes:
url(字符串)- 待分享的 URLmessage(字符串)- 待分享的信息subject(字符串)- 信息的主题excludedActivityTypes(数组)- 需从操作表中排除的活动类型
备注
如果 url 指向本地文件,或是 base64 编码 URI,则直接加载并分享该文件。这样,可以分享图片、视频、PDF 等文件。如果 url 指向远程文件或地址,则必须符合 RFC 2396 中描述的 URL 格式。例如,没有合法协议(HTTP/HTTPS)的网络 URL 将无法分享。
failureCallback 函数接收一个参数,为错误对象。该对象上定义的唯一属性是可选的字符串类型 stack。
successCallback 函数接收两个参数:
- 一个布尔值,表示成功或失败
- 一个字符串,成功时表示分享方式