sud.showActionSheet
显示操作菜单,供用户从多个选项中选择一项。
javascript
sud.showActionSheet(object);参数
| 属性 | 类型 | 必填 | 说明 |
|---|---|---|---|
| alertText | string | 否 | 菜单顶部的提示文字 |
| itemList | Array<string> | 是 | 选项文字列表,最多 6 项 |
| itemColor | string | 否 | 选项文字颜色,如 #000000 |
| success | function | 否 | 用户选择一项后的回调,参数见下文 |
| fail | function | 否 | 调用失败或用户取消选择时的回调 |
| complete | function | 否 | 调用结束时执行,成功、失败均执行,不传入参数 |
成功回调参数
| 属性 | 类型 | 说明 |
|---|---|---|
| tapIndex | number | 用户选择项在 itemList 中的下标,从 0 开始 |
失败回调参数
| 属性 | 类型 | 说明 |
|---|---|---|
| errCode | number | 错误码 |
| errMsg | string | 错误或取消说明 |
使用说明
使用前请确认目标 App 支持该界面能力。传入非空选项列表;用户取消时不会得到有效的选项下标,不应继续执行选中操作。
示例
javascript
const items = ['查看规则', '联系支持'];
sud.showActionSheet({
alertText: '请选择操作',
itemList: items,
itemColor: '#000000',
success(result) {
console.log('所选操作', items[result.tapIndex]);
},
fail(error) {
console.log('未完成选择', error.errCode, error.errMsg);
}
});