rubyisapm/calendar

calendar

​

快速开始

该组插件包含日历选择和月历选择两个独立部分，用于日常项目中的日期或月份选择。

该日历插件采用jquery插件的形式，易于使用。

对于区间选择，支持弱限制，前端需要在提交前进行进一步的验证。

插件按照正常模式返回DOM对应的jquery对象，但是该jquery对象上有某些属性指向组件中事先的calendar对象，方便开发者在外部进行对象方法调用。

示例：

• 单日历

$('#date').datePicker({
   clear:true,
   switchYM:true,
   partner:beginCalendar.calendar,
   begin:false,
   date:'2015/4/10'
});

图示

• 结合式双日历

$('#double').datePicker({
   double:true,
   switchYM:true,
   beginDate:'2015/1/3',
   endDate:'2015/9/10'
})

图示

• 分离式双日历

var d_beginCalendar = $('#d_begin').datePicker({
        clear: true
    });
$('#d_end').datePicker({
  clear: true,
  switchYM: true,
  partner: d_beginCalendar.calendar,
  begin: false,
  date: '2015/4/10'
});

日历参数解析(通用)

参数名称	类型	格式	说明
double	boolean	true/false	是否双日历
switchYM	boolean	true/false	是否可以进行年月的select选择
partner	jquery对象	jquery对象	该日历的对应的开始/结束日历对象
sure	function对象	function	确定日期选择后的回调函数，其参数为选择的日期, 如2015/10/10或''(单日历)，2015/10/10-2015/10/11(双日历)

日历参数解析(单日历)

参数名称	类型	格式	说明
clear	boolean	true/false	是否含有清空按钮
date	string	2015/10/10	单日历中的初始日期
defaultDate	string	2015/10/10	单日历中日期点击input后日期为空时的渲染依据

日历参数解析(双日历)

参数名称	类型	格式	说明
beginDate	string	2015/10/10	双日历中的初始开始日期
endDate	string	2015/10/10	双日历中的初始结束日期
clear	function对象	function	清除日历后的回调
verify	boolean	true / false	是否做验证
limited	string	number+'y/m/d'	验证规则
defaultBeginDate	string	2015/10/10	双日历中日期点击input后日期为空时的渲染依据(起始日期)
defaultEndDate	string	2015/10/10	双日历中日期点击input后日期为空时的渲染依据(结束日期)

注：default系列的日期并不会直接呈现在input框内，而是为了用户选择日期时提供参考，如果用户认可该日期，可直接确认，从而减少操作次数。

• 单月历

$('#month').monthPicker({
   clear:true,
   date:'2015/3'
})

图示

• 结合式双月历

$('#m_double').monthPicker({
   double:true,
   beginDate:'2015/3',
   endDate:'2016/6',
   limited:'3y'
})

图示

• 分离式双月历

var m_beginCalendar=$('#m_begin').monthPicker();
$('#m_end').monthPicker({
  clear:true,
  partner:m_beginCalendar.calendar,
  begin:false,
  date:'2015/3'
})

• 月历参数解析（通用）

参数名称	类型	格式	说明
double	boolean	true/false	是否双月历
partner	jquery对象	jquery对象	该日历的对应的开始/结束日历对象
sure	function对象	function	确定日期选择后的回调函数

• 月历参数解析(单月历)

参数名称	类型	格式	说明
clear	boolean	true/false	是否含有清空按钮（针对单月历）
date	string	2015/10/10	单月历中的初始日期
defaultDate	string	2015/10/10	单日历中日期点击input后日期为空时的渲染依据

• 月历参数解析(双月历)

参数名称	类型	格式	说明
beginDate	string	2015/10/10	双月历中的初始开始日期
endDate	string	2015/10/10	双月历中的初始结束日期
clear	function对象	function	清空日期选择后的回调函数
necessary	boolean	true / false	是否必填
verify	boolean	true / false	是否做验证
limited	string	number+'y/m'	验证规则
defaultBeginDate	string	2015/10/10	双日历中日期点击input后日期为空时的渲染依据(起始日期)
defaultEndDate	string	2015/10/10	双日历中日期点击input后日期为空时的渲染依据(结束日期)

注：default系列的日期并不会直接呈现在input框内，而是为了用户选择日期时提供参考，如果用户认可该日期，可直接确认，从而减少操作次数。