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

uexControl查看3.0文档

1、简介

1.1、说明

1.2、UI展示

1.3、开源源码

1.4、平台版本支持

1.5、接口有效性

2、API概览

2.1、方法

openDatePicker //打开日期选择器

openTimePicker //打开日期选择器

openInputDialog //打开输入对话框

openDatePickerWithoutDay //打开日期选择器

openDatePickerWithConfig //打开带配置的日期选择器

2.2、监听方法

onError //参数传递错误时的监听方法

3、更新历史

iOS

Android

4、附录

onError