iosDialog4A

来自于：开发者

alert confirm prompt actionsheet picker

概述

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及更高版本