iosDialog4A

来自于:开发者立即使用

概述

iosDialog4A模块是为了在App中提供统一风格的dialog服务,本模块在安卓平台中精仿了iOS平台中常用的对话框以及选择器。例如 alert对话框; confirm确认框; prompt输入框; actionsheet选择器; 以及支持三级联动的picker选择器。本模块仅限安卓平台使用。 使用此模块:app控制台添加使用该模块然后编译即可

三种使用样例:

confrim如图所示: image

actionsheet如图所示: image

picker如图所示: image

#alert 弹出alert对话框 alert({params},callback(ret, err)) ##params title: - 类型:字符串 - 描述:弹窗标题 - 默认值:提示 msg: - 类型:字符串 - 描述:弹窗显示的内容 - 默认值:Hello APICloud! btnText: - 类型:字符串 - 描述:按钮上的文字 - 默认值:好 ##callback(ret, err) ret: - 类型:JSON对象 - 内部字段: js { buttonIndex: 1 //用户点击了按钮 } err: - 类型:JSON对象 - 内部字段: js { msg: 'exception' } ##示例代码 js 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及更高版本