iosDialog4A
来自于：开发者
概述
iosDialog4A模块是为了在App中提供统一风格的dialog服务，本模块在安卓平台中精仿了iOS平台中常用的对话框以及选择器。例如 alert对话框; confirm确认框; prompt输入框; actionsheet选择器; 以及支持三级联动的picker选择器。本模块仅限安卓平台使用。 使用此模块：app控制台添加使用该模块然后编译即可
三种使用样例：
confrim如图所示：
actionsheet如图所示：
picker如图所示：
alert
弹出alert对话框
alert({params},callback(ret, err))
params
title：
- 类型：字符串
- 描述：弹窗标题
- 默认值：提示
msg：
- 类型：字符串
- 描述：弹窗显示的内容
- 默认值：Hello APICloud!
btnText：
- 类型：字符串
- 描述：按钮上的文字
- 默认值：好
callback(ret, err)
ret：
- 类型：JSON对象
- 内部字段：
{
buttonIndex: 1 //用户点击了按钮
}
err：
- 类型：JSON对象
- 内部字段：
{
msg: 'exception'
}
示例代码
var iosDialog4A = api.require('iosDialog4A');
var param = {
title:"提示",
msg:"Hello APICloud!",
btnText:"好"
};
iosDialog4A.alert(param, function(ret, err){
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本
confirm
confirm确认对话框
confirm({params}, callback(ret, err))
params
title：
- 类型：字符串
- 描述：弹窗标题
- 默认值：提示
msg：
- 类型：字符串
- 描述：弹窗显示的内容
- 默认值：Hello APICloud!
rigthBtnText：
- 类型：字符串
- 描述：右边按钮文字
- 默认值：取消
leftBtnText：
- 类型：字符串
- 描述：左边按钮文字
- 默认值：确定
callback(ret, err)
ret：
- 类型：JSON对象
- 内部字段：
{
buttonIndex: 'left' //点击按钮的位置；left||right
}
err：
- 类型：JSON对象
- 内部字段：
{
msg:'exception'
}
示例代码
var param = {
title:"提示",
msg:"Hello APICloud!",
leftBtnText:"确定",
rigthBtnText:"取消"
};
iosDialog4A.confirm(param,function(ret, err){
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本
prompt
弹出带有输入框的dialog
prompt({params}, callback(ret, err))
params
title：
- 类型：字符串
- 描述：弹窗标题
- 默认值：提示
rigthBtnText：
- 类型：字符串
- 描述：右边按钮文字
- 默认值：取消
leftBtnText：
- 类型：字符串
- 描述：左边按钮文字
- 默认值：确定
inputType:
- 类型：字符串
- 描述：输入文字的类型
- 默认值：'text' //可选类型 number;password
- 取值范围：
- number（数字）
- password（密码）
- text（文本）
callback(ret, err)
ret：
- 类型：JSON对象
- 内部字段：
{
buttonIndex: 'left' //点击按钮的位置；left||right
inputText:text //用户输入的text
}
err：
- 类型：JSON对象
- 内部字段：
{
msg:'exception'
}
示例代码
var iosDialog4A = api.require('iosDialog4A');
var param = {
title:"请输入密码",
leftBtnText:"确定",
rigthBtnText:"取消",
inputType:'number'
};
iosDialog4A.prompt(param,function(ret, err){
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本
actionsheet
弹出actionsheet选择器
actionsheet({params}, callback(ret, err))
params
title：
- 类型：字符串
- 描述：actionsheet标题
- 默认值：提示
cancel：
- 类型：字符串
- 描述：最下面取消按钮文字
- 默认值：取消
titleSize：
- 类型：数字
- 描述：title文字大小
- 默认值：12
cancelSize：
- 类型：数字
- 描述：cancel文字大小
- 默认值：15
buttons：
- 类型：json数组
- 描述：按钮
- 内部字段：
[
{
text: 'button1', //按钮文字
color:'#FF0000', //文字颜色 默认蓝色
size:15 //文字大小 默认15
},
{
text: 'button1', //按钮文字
color:'#FF0000', //文字颜色 默认蓝色
size:15 //文字大小 默认15
}
]
callback(ret, err)
ret：
- 类型：JSON对象
- 内部字段：
{
buttonIndex: 1 //int；从上至下 按钮位置 从1开始
}
err：
- 类型：JSON对象
- 内部字段：
{
msg:'XX exception'
}
示例代码
var iosDialog4A = api.require('iosDialog4A');
var param = {
title:"title",
cancel:"cancel",
buttons:[
{
text:"button1",
color:""
},{
text:"button2",
color:""
},{
text:"delete",
color:"#FF0000"
}
]
};
iosDialog4A.actionsheet(param, function(ret, err){
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本
picker
弹出三级联动选择器
picker({params}, callback(ret, err))
params
title：
- 类型：字符串
- 描述：选择器的title
- 默认值：''
datas：
- 类型：json数组
- 描述：选择器数据（可选）
- 默认值：''
特殊说明：该字段若不传，那么默认显示的是由本模块提供的省市区三级联动
level：
- 类型：int
- 描述：联动级别（可选）。//若是不传datas则该字段无意义，若传datas，level默认为1，level应与datas结构匹配
option1：
- 类型：int
- 描述：第一项的默认选中位置（可选）
- 默认值 ：0
option2：
- 类型：int
- 描述：第二项的默认选中位置（可选）
- 默认值 ：0
option3：
- 类型：int
- 描述：第三项的默认选中位置（可选）
- 默认值 ：0
callback(ret, err)
ret：
- 类型：JSON对象
- 内部字段：
{
options1: {
name: "北京市",//名称
position: 0 //所在该项的位置
},
options2: {
name: "北京市",
position: 0
},
options3: {
name: "东城区",
position: 0
}
}
err：
- 类型：JSON对象
- 内部字段：
{
msg:'exception'
}
示例代码
var iosDialog4A = api.require('iosDialog4A');
var params = {
title:"城市选择"
level:3,
option1:0,
option2:0,
option3:0,
datas:[
{
"name": "北京市",
"datas": [
{
"name": "北京市",
"datas": [
"东城区",
"西城区"
]
}
]
},
{
"name": "天津市",
"datas": [
{
"name": "天津市",
"datas": [
"和平区",
"河东区",
"河西区",
"南开区"
]
}
]
}
]
};
iosDialog4A.picker(params,function(ret, err){
alert(JSON.stringify(ret));
});
可用性
Android系统
可提供的1.0.0及更高版本