calendar
来自于:官方
概述
calendar是一个简单的日历模块,原生实现了公历历法列表,开发者可添加特殊日期标注,只需简单配置参数即可实现一个复杂的日历效果界面。UICalendar 模块是 calendar 模块的优化版,建议使用 UICalendar 模块,此模块已停止更新。
open
打开日历
open({params}, callback(ret, err))
params
x:
- 类型:数字
- 默认值:0
- 描述:日历视图左上角点的x坐标,可为空
y:
- 类型:数字
- 默认值:100
- 描述:日历视图左上角点的y坐标,可为空
w:
- 类型:数字
- 默认值:当前设备屏幕的宽
- 描述:日历视图宽,可为空
h:
- 类型:数字
- 默认值:w-40
- 描述:日历视图高,可为空
specialDate:
- 类型:数组
- 默认值:无
- 描述:需要标记的特殊日期组成的数组,数组元素类型为字符串,格式为yyyy-MM-dd,可为空
fixedOn:
- 类型:字符串类型
- 描述:(可选项)模块视图添加到指定 frame 的名字(只指 frame,传 window 无效)
- 默认:模块依附于当前 window
callback(ret, err)
ret:
- 类型:JSON 对象
内部字段:
{
date:’’ //用户点击的日期,格式为yyyy-MM-dd
}
示例代码
var calendar = api.require('calendar');
calendar.open({
x: 100,
y: 100,
width: 300,
height: 300,
specialDate: ['2014-05-01', '2014-05-11', '2014-05-20', '2014-05-25', '2014-05-31']
}, function(ret, err) {
var date = ret.date;
});
补充说明
打开日历
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
close
关闭日历
close()
示例代码
var calendar = api.require('calendar'); calendar.close();
补充说明
关闭日历
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本
hide
隐藏日历
hide()
示例代码
var calendar = api.require('calendar'); calendar.hide();
补充说明
隐藏日历视图,并没有从内存清空
可用性
iOS系统,Android系统
可提供的1.0.1及更高版本
show
显示已隐藏日历
show()
示例代码
var calendar = api.require('calendar'); calendar.show();
补充说明
显示已隐藏日历视图
可用性
iOS系统,Android系统
可提供的1.0.1及更高版本