ActionSheet
- category: UI
- chinese: 弹出菜单
- type: UI组件
何时使用
ActionSheet 定义一组动作菜单,使用者在菜单中选择一项,或取消不做操作。
API
ActionSheet.show(params,onNotify,afterOpen,onFail)
ActionSheet 组件采用静态方法形式调用。
ActionSheet
params
params 对象包含下面几个基本属性
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
title | 标题 | string | 无 |
options | 菜单数组 | array | 无 |
cancelButtonIndex | cancelButton在options中的index | num | 无 |
destructiveButtonIndex | destructiveButton在options中的index | num | 无 |
-
destructiveButton
destructiveButton 是指在一系列菜单项中唯一的一个具有危险性、不可恢复性操作的按钮,按照ios的设计规范,这个按钮在 ActionSheet 中最多只能有1个,并且排列在列表倒数第二项。
options: '拨打电话''发送短信''删除订单''取消'cancelButtonIndex: 3destructiveButtonIndex: 2title:'ActionSheet Title'
建议把 destructiveButtonIndex 与 cancelButtonIndex 分别放在数组倒数第二项和倒数第一项。
- cancelButton
cancelButton 在 iOS 和 Android 2 端展现方式不同。
在 iOS 端作为取消按钮,排列在列表最后一项,在安卓端不展示。
onNotify 回调
点击菜单项或取消按钮的回调,具有以下几种类型
-
{ type : "cancel"}
-
{ type : "button",buttonIndex : 1/2/3 }
-
{ type : "destructive"}