uexControl查看3.0文档

  • 1、简介
  • 2、API概览
  • 3、更新历史
  • errorCode

    1、简介

    日期选择器插件
    1.1、说明
    获取得到设备系统日期和时间。

    本文的目的是为了开发能够更好更快地将API集成到自己的项目中,在使用前最好先使用好我们提供的demo并对照文档运行看看效果。
    这里可以【参考教程】下载AppCan IDE为开发者工具开发,然后集成到自己的项目上。

1.2、UI展示

1.3、开源源码

插件测试用例与源码下载:点击插件中心至插件详情页 (插件测试用例与插件源码已经提供)

1.4、平台版本支持

本插件的所有API默认支持Android4.0+iOS7.0+操作系统.
有特殊版本要求的API会在文档中额外说明.

1.5、接口有效性

本插件所有API默认在插件版本4.0.0+可用.
在后续版本中新添加的接口会在文档中额外说明.

2、API概览

2.1、方法
openDatePicker //打开日期选择器

uexControl.openDatePicker(year, month, day, callbackFunction)

说明:

打开日期选择器, 用户选择日期后会回调callbackFunction,返回选择的日期

参数:

参数名称 参数类型 是否必选 说明
year Number
month Number
day Number
callbackFunction Function 选择日期后的回调函数

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data Object json格式数据,形式如下:
var data = {
    year:,
    month:,
    day:
}

示例:

uexControl.openDatePicker(1990,8,1, function(data) {
    alert(JSON.stringify(data));
});
openTimePicker //打开日期选择器

uexControl.openTimePicker(hour, minute, callbackFunction)

说明:

打开日期选择器, 用户选择时间后会回调callbackFunction,返回选择的时间

参数:

参数名称 参数类型 是否必选 说明
hour Number 小时
minute Number 分钟
callbackFunction 函数 选择时间后的回调函数

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data Object json格式数据,形式如下:
var data = {
    hour:,
    minute:
}

示例:

uexControl.openTimePicker(10,23, function(data) {
    alert(JSON.stringify(data));
});
openInputDialog //打开输入对话框

uexControl.openInputDialog(type,inputHint,btnText, callbackFunction)

说明:

打开输入对话框,点击输入框右侧的按钮后会回调callbackFunction

参数:

参数名称 参数类型 是否必选 说明
type Number 键盘类型,详见CONSTANT中KeyboardTypes
inputHint String 默认数据
btnText String 输入框按钮上标题
callbackFunction 函数 回调函数, 返回输入框中的文字

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data String 输入框中的文字

示例:

uexControl.openInputDialog(0,"默认数据","按钮", fuction(data) {
    alert(data);
})
openDatePickerWithoutDay //打开日期选择器

uexControl.openDatePickerWithoutDay(year,month, callbackFunction)

说明:

打开日期选择器, 用户选择时间后会回调callbackFunction,返回选择的日期

参数:

参数名称 参数类型 是否必选 说明
year Number
month Number
callbackFunction 函数 回调函数, 返回选择的日期

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data Object json格式数据,形式如下:
var data = {
    year:,
    month:
}

示例:

uexControl.openDatePickerWithoutDay(1990,8, function(data) {
    alert(JSON.stringify(data);
});
openDatePickerWithConfig //打开带配置的日期选择器

uexControl.openDatePickerWithConfig(params, callbackFunction)

说明:

打开带配置的日期选择器 callbackFunction用来返回用户最终选择的时间 监听方法onError

参数:

参数名称 参数类型 是否必须 说明
params String 配置信息
callbackFunction Function 选择日期后的回调函数
var params = {
    initDate:{
        year:,
        month:,
        day:
    },
    minDate:{
        limitType:,
        data:{
            year:,
            month:,
            day:
        }
    },
    maxDate:{
        limitType:,
        data:{
            year:,
            month:,
            day:
        }
    }
}

各字段含义如下:

参数名称 参数类型 是否必选 说明
initDate Json 初始化日期,默认为当前日期
minDate Json 最小日期值
maxDate Json 最大日期值
limitType Number 限制方式,0-表示具体日期限制,此种方式年月日参数必选;1-表示相对于初始化日期的前后天数,月数或年数,此种方式年月日参数有且只有一个有效,有效的优先级为日>月>年.具体用法请参考示例.
data Json 限制数据
year Number 年,当limitType为0时,必传,表示具体年份.当limitType为1时,可选(但年,月,日有且只有一个有效)表示相对于初始化日期中年的相对值x,负数表示小于初始化年份x年,正数表示大于初始化年份x年
month Number 月,当limitType为0时,必传,表示具体月份.当limitType为1时,可选(但年,月,日有且只有一个有效)表示相对于初始化日期中月的相对值x,负数表示小于初始化月份x月,正数表示大于初始化月份x月
day Number 日,当limitType为0时,必传,表示具体日期.当limitType为1时,可选(但年,月,日有且只有一个有效)表示相对于初始化日期中日的相对值x,负数表示小于初始化日期x天,正数表示大于初始化日期x天

回调参数:

var callbackFunction = function(data){}
参数名称 类型 说明
data Object json格式数据,形式如下:
var data = {
    day:,
    month:,
    year:
}

示例:

示例1、通过具体日期限制日期范围:

var callback = function(data) {
    alert(JSON.stringify(data));
}
var params = {
    initDate:{
        year:2016,
        month:3,
        day:4
    },
    minDate:{
        limitType:0,
        data:{
            year:2013,
            month:12,
            day:23
        }
    },
    maxDate:{
        limitType:0,
        data:{
            year:2016,
            month:3,
            day:8
        }
    }
}
var data = JSON.stringify(params);
uexControl.openDatePickerWithConfig(data, callback);

示例2、通过相对日期限制日期范围:

var callback = function(data) {
    alert(JSON.stringify(data));
}
var params = {
    initDate:{
        year:2016,
        month:3,
        day:4
    },
    minDate:{
        limitType:1,
        data:{
            day:-3
        }
    },
    maxDate:{
        limitType:1,
        data:{
            month:1
        }
    }
}
var data = JSON.stringify(params); 
uexControl.openDatePickerWithConfig(data, callback);

示例3、单范围限制,即只限制最大日期:

var callback = function(data) {
    alert(JSON.stringify(data));
}
var params = {
    initDate:{
        year:2016,
        month:3,
        day:4
    },
    maxDate:{
        limitType:1,
        data:{
            month:1
        }
    }
}
var data = JSON.stringify(params); 
uexControl.openDatePickerWithConfig(data, callback);
2.2、监听方法
onError //参数传递错误时的监听方法

uexControl.onError(data)

参数:

var data = {
    errorCode:
}

各字段含义如下:

参数名称 参数类型 是否必选 说明
errorCode Number 错误码,详情请参考附录onError

示例:

function onError(data) {
    alert(data);
}
window.uexOnload = function(){
    uexControl.onError = onError;
}

3、更新历史

iOS

API版本: uexControl-4.0.1

最近更新时间:2017-06-08

历史发布版本 更新内容
4.0.1 修改多次打开问题
Android

API版本: uexControl-4.0.1

最近更新时间:2017-2-24

历史发布版本 更新内容
4.0.1 修复openDatePickerWithConfig

4、附录

onError
errorCode 说明
-1 无参数错误
-2 最小日期参数错误
-3 最小日期大于初始化日期错误
-4 最大日期参数错误
-5 最大日期大于初始化日期错误
还需要帮助吗? 联系我们
最新更新 8th Jul 2021