iosDialog4A

confirm actionsheet

概述

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

三种使用样例:

confrim如图所示:

actionsheet如图所示:

iosDialog4A - 图1

picker如图所示:

alert

弹出alert对话框

alert({params},callback(ret, err))

title:

  • 类型:字符串
  • 描述:弹窗标题
  • 默认值:提示

msg:

  • 类型:字符串
  • 描述:弹窗显示的内容
  • 默认值:Hello APICloud!

btnText:

  • 类型:字符串
  • 描述:按钮上的文字
  • 默认值:好

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:

err:

  • 类型:JSON对象
  • 内部字段:
  1. msg: 'exception'
  2. }

示例代码

  1. var iosDialog4A = api.require('iosDialog4A');
  2. var param = {
  3. title:"提示",
  4. msg:"Hello APICloud!",
  5. btnText:"好"
  6. };
  7. iosDialog4A.alert(param, function(ret, err){
  8. alert(JSON.stringify(ret));
  9. });

可用性

Android系统

可提供的1.0.0及更高版本

confirm

confirm确认对话框

params

title:

  • 类型:字符串
  • 描述:弹窗标题
  • 默认值:提示

msg:

  • 类型:字符串
  • 描述:弹窗显示的内容
  • 默认值:Hello APICloud!

rigthBtnText:

  • 类型:字符串
  • 描述:右边按钮文字
  • 默认值:取消

leftBtnText:

  • 类型:字符串
  • 描述:左边按钮文字
  • 默认值:确定

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. }

err:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. msg:'exception'
  3. }

可用性

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对象
  • 内部字段:
  1. {
  2. buttonIndex: 'left' //点击按钮的位置;left||right
  3. inputText:text //用户输入的text
  4. }

err:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. msg:'exception'
  3. }

示例代码

  1. var iosDialog4A = api.require('iosDialog4A');
  2. var param = {
  3. title:"请输入密码",
  4. leftBtnText:"确定",
  5. inputType:'number'
  6. };
  7. iosDialog4A.prompt(param,function(ret, err){
  8. alert(JSON.stringify(ret));
  9. });

可用性

Android系统

可提供的1.0.0及更高版本

actionsheet

弹出actionsheet选择器

title:

  • 类型:字符串
  • 描述:actionsheet标题
  • 默认值:提示

cancel:

  • 类型:字符串
  • 描述:最下面取消按钮文字
  • 默认值:取消

titleSize:

  • 类型:数字
  • 描述:title文字大小
  • 默认值:12

cancelSize:

  • 类型:数字
  • 描述:cancel文字大小
  • 默认值:15

buttons:

  • 类型:json数组
  • 描述:按钮
  • 内部字段:
  1. [
  2. {
  3. text: 'button1', //按钮文字
  4. color:'#FF0000', //文字颜色 默认蓝色
  5. size:15 //文字大小 默认15
  6. },
  7. {
  8. text: 'button1', //按钮文字
  9. size:15 //文字大小 默认15
  10. }
  11. ]

callback(ret, err)

ret:

  • 类型:JSON对象
  • 内部字段:

err:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. msg:'XX exception'
  3. }

示例代码

  1. var iosDialog4A = api.require('iosDialog4A');
  2. var param = {
  3. title:"title",
  4. cancel:"cancel",
  5. buttons:[
  6. {
  7. text:"button1",
  8. color:""
  9. text:"button2",
  10. color:""
  11. },{
  12. text:"delete",
  13. color:"#FF0000"
  14. }
  15. ]
  16. };
  17. iosDialog4A.actionsheet(param, function(ret, err){
  18. alert(JSON.stringify(ret));
  19. });

可用性

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对象
  • 内部字段:
  1. {
  2. options1: {
  3. name: "北京市",//名称
  4. position: 0 //所在该项的位置
  5. },
  6. options2: {
  7. name: "北京市",
  8. position: 0
  9. },
  10. options3: {
  11. name: "东城区",
  12. position: 0
  13. }
  14. }

err:

  • 类型:JSON对象
  • 内部字段:
  1. {
  2. }

可用性

可提供的1.0.0及更高版本