在Web开发中,总会遇到需要用户输入日期的情况。一般都是提供一个text类型的input供用户输入日期。然而,这种方式,开发人员必须对用户输入的日期进行验证,判断其合法性。除此之外,用户输入日期也是一件不爽的事,如果用户可以直接选择日期,这两个问题都解决了。听起来很不错。实际上,很多开发者都是这么做的。

我们可以自己用javascript写一个日期选择控件,然而,想要写的很好、很漂亮却需要花不少时间和精力。jQuery有一个UI插件:datepicher,可以帮我们实现该功能,而且界面很漂亮。下面就学学如何使用它吧。

datepicher插件是jQuery UI的一个插件,它提供一个日期弹出窗口(或直接显示在页面),供用户选择日期。

datepicher插件的使用很简单,语法如下:

$("#regDate").datepicher(optional);




其中optional是一个对象,该对象的每一个属性及含义可以参看官方文档:http://jqueryui.com/demos/datepicker/。在此,仅介绍一些常用的属性。



1、datepicher最简单的使用



$("#regDate").datepicher();




其中,regDate是页面日期输入框的ID属性值。



就这一句话,在日期输入框获得焦点时,就会弹出一个日期选择窗口。然而,这时候的日期选择窗口有很多不方便的地方,比如:只能一个月一个月的往前或往后,没有关闭按钮等。



2、配置datepicher



通过给datepicher设置一些属性值可以改变默认的显示。如:



$("#regDate").datepicker(
 {
  showMonthAfterYear: true, // 月在年之后显示
  changeMonth: true,   // 允许选择月份
  changeYear: true,   // 允许选择年份
  dateFormat:'yy-mm-dd',  // 设置日期格式
  closeText:'关闭',   // 只有showButtonPanel: true才会显示出来
  duration: 'fast',
  showAnim:'fadeIn',
  showOn:'button',   // 在输入框旁边显示按钮触发,默认为:focus。还可以设置为both
  buttonImage: 'images/commons/calendar.gif',   // 按钮图标
  buttonImageOnly: true,        // 不把图标显示在按钮上,即去掉按钮
  buttonText:'选择日期',
  showButtonPanel: true,
  showOtherMonths: true,
  //appendText: '(yyyy-mm-dd)',
 });




这个时候的日期选择就很方便了。可以自由选择年份和月份。



3、增加清除按钮和日期判断功能(增强版datepicher1.7.2)



datepicher1.7.2版本没有提供清除按钮,这让人有点遗憾。(好像之前的版本有提供)。没有清除按钮是很不方便的,特别是输入框获得焦点就弹出日期选择窗口的情况更是如此,因为这时想要清除输入框中的日期比较麻烦。在此推荐一位网友提供的增强版datepicher1.7.2。该增强版datepicher1.7.2不仅实现了清除按钮功能,而且增加了日期大小比较验证,比如:一个日期只能在另一个之后。可以访问该网址查看:。这时datepicher的使用已经相当完美:



$(function()
{
 $("#effDate").datepicker(
 {
  showMonthAfterYear: true, // 月在年之后显示
  changeMonth: true,   // 允许选择月份
  changeYear: true,   // 允许选择年份
  dateFormat:'yy-mm-dd',  // 设置日期格式
  showClearButton: true,
  //clearText: '清除',
  closeText:'关闭',   // 只有showButtonPanel: true才会显示出来
  duration: 'fast',
  showAnim:'fadeIn',
  showOn:'button',
  buttonImage: 'images/commons/calendar.gif',
  buttonImageOnly: true,
  buttonText:'选择日期',
  showButtonPanel: true,
  showOtherMonths: true,
  //appendText: '(yyyy-mm-dd)',
  onSelect: function(dateText, inst)    // 使结束时间大于开始时间
  {
   /**
    * 以下写法在IE中出现问题。
    * $('#expDate').datepicker('option', 'minDate', new Date(dateText.replace(/-/g,',')));
    * 时,在结束(过期时间)选择时,年会没有,而且控制会失效。通过调试,发现new Date(dateText.replace(/-/g,','))
    * 返回的结果是NaN。说明Date对象不能这么构造(但是Firefox可以)
    */ 
    var arys = new Array();
    var arys = dateText.split('-');
    $('#expDate').datepicker('option', 'minDate', new Date(arys[0],arys[1]-1,arys[2]));
  }
 });

 $("#expDate").datepicker(
 {
  showMonthAfterYear: true, // 月在年之后显示
  changeMonth: true,   // 允许选择月份
  changeYear: true,   // 允许选择年份
  dateFormat:'yy-mm-dd',  // 设置日期格式
  showClearButton: true,  // 自定义的方法(1.7.2没有清除按钮)
  //clearText: '清除',   // 自定义的文本,在文档在有定义(js中)
  closeText:'关闭',   // 只有showButtonPanel: true才会显示出来
  duration: 'fast',
  showAnim:'fadeIn',
  showOn:'button',   // 在输入框旁边显示按钮触发,默认为:focus。还可以设置为both
  buttonImage: 'images/commons/calendar.gif',   // 按钮图标
  buttonImageOnly: true,        // 不把图标显示在按钮上,即去掉按钮
  buttonText:'选择日期',
  showButtonPanel: true,
  showOtherMonths: true,
  //appendText: '(yyyy-mm-dd)',
  onSelect: function(dateText, inst)
  {
   var arys = new Array();
   var arys = dateText.split('-');
   $('#effDate').datepicker('option','maxDate',new Date(arys[0],arys[1]-1,arys[2]));
  }
 });
});




4、国际化



datepicher提供了国际化的功能。只需将ui.datepicker-zh-CN.js导入页面即可。(或者导入jquery-ui-i18n.js,该文件包含了很多中语言)注意,如果想使用上面提到的增强版datepicher1.7.2,则需要下载作者提供的国际化文件。另外,如果用Eclipse之类的工具编码,注意用eclipse打开国际化文件看看,很有可能显示为乱码。只需要把文件的编码格式改为utf-8,然后用其他编辑工具,如editplus打开国际化文件,拷贝,粘贴覆盖eclipse中的,保存就OK了。



5、国际化为中文可能遇到的显示问题



在使用国际化同时启用changeYear和changeMonth后,两个select显示为两行,很不好看。找了好久,发现在官方提供的jquery-ui-1.7.2.custom.css中,应该作如下几处修改:


.ui-datepicker .ui-datepicker-title select { float:left; font-size:1em; margin:1px 0; }


.ui-datepicker select.ui-datepicker-month-year {width: 100%;}


.ui-datepicker select.ui-datepicker-month,


.ui-datepicker select.ui-datepicker-year { width: 49%;}


.ui-datepicker .ui-datepicker-title select.ui-datepicker-year { float: right; }


应该改为:


.ui-datepicker .ui-datepicker-title select {font-size:1em; margin:1px 0; }


.ui-datepicker select.ui-datepicker-month-year {width: 100%;}


.ui-datepicker select.ui-datepicker-month,


.ui-datepicker select.ui-datepicker-year { width: 47%;}


.ui-datepicker .ui-datepicker-title select.ui-datepicker-year { float: left; }


就OK了



6、换肤



jQuery UI预定义了很多皮肤,下载后,只需在页面引入相应皮肤的jquery-ui-1.7.2.custom.css可以实现换肤。如果给用户提供换肤功能,可以通过js控制,实现换肤。



总结:



可以看出,datepicher是一个很好用的插件,比自己写的肯定要好用很多,推荐大家使用。



另外,在使用中,可以定义一个文件,包含该插件的使用,配置好。以后有需要使用的地方,引入该文件,同时传给当前需要使用日期选择控件的id属性,这样便可以只配置一次了。