码迷,mamicode.com
首页 > Web开发 > 详细

jQuery Datepicker日期控件

时间:2016-12-21 09:44:27      阅读:317      评论:0      收藏:0      [点我收藏+]

标签:render   most   middle   cto   range   block   default   pos   按钮   

datepicker可以为bootstrap添加一个事件选择控件,适用于任何需要调用的场合,支持多种事件格式输出(比如:dd, d, mm, m, yyyy, yy等),是制作网页不可缺失的插件。

技术分享

Requirements

在线文档

  1. Datepicker基础使用
  2. Datepicker功能定制
  3. Datepicker英文文档

  4. Datepicker中文文档
  5. Datepicker项目主页

简单示例

技术分享

  1. var nowTemp =newDate();
  2. var now =newDate(nowTemp.getFullYear(), nowTemp.getMonth(), nowTemp.getDate(),0,0,0,0);
  3. var checkin = $(‘#dpd1‘).datepicker({
  4. onRender:function(date){
  5. return date.valueOf()< now.valueOf()?‘disabled‘:‘‘;
  6. }
  7. }).on(‘changeDate‘,function(ev){
  8. if(ev.date.valueOf()> checkout.date.valueOf()){
  9. var newDate =newDate(ev.date)
  10. newDate.setDate(newDate.getDate()+1);
  11. checkout.setValue(newDate);
  12. }
  13. checkin.hide();
  14. $(‘#dpd2‘)[0].focus();
  15. }).data(‘datepicker‘);
  16. var checkout = $(‘#dpd2‘).datepicker({
  17. onRender:function(date){
  18. return date.valueOf()<= checkin.date.valueOf()?‘disabled‘:‘‘;
  19. }
  20. }).on(‘changeDate‘,function(ev){
  21. checkout.hide();
  22. }).data(‘datepicker‘);
复制

使用bootstrap-datepicker.js

通过JavaScript调用Datepicker:

  1. $(‘.datepicker‘).datepicker()
复制

选项

Nametypedefaultdescription
format string ‘mm/dd/yyyy’ the date format, combination of d, dd, m, mm, yy, yyy.
weekStart integer 0 day of the week start. 0 for Sunday – 6 for Saturday
viewMode string|integer 0 = ‘days’ set the start view mode. Accepts: ‘days’, ‘months’, ‘years’, 0 for days, 1 for months and 2 for years
minViewMode string|integer 0 = ‘days’ set a limit for view mode. Accepts: ‘days’, ‘months’, ‘years’, 0 for days, 1 for months and 2 for years

标记

  1. <divclass="input-append date"id="dp3"data-date="12-02-2012"data-date-format="dd-mm-yyyy">
  2. <inputclass="span2"size="16"type="text"value="12-02-2012">
  3. <spanclass="add-on"><iclass="icon-th"></i></span>
  4. </div>
复制

方法

  • .datepicker(options):初始化一个DataPicker。
  • .datepicker(‘show’):显示Datepicker。
  • .datepicker(‘hide’):隐藏Datepicker。
  • .datepicker(‘place’):更新日期选取器的相对位置的元素
  • .datepicker(‘setValue’, value):设置Datepicker新值。它可以在指定的格式或约会对象的字符串。

属性

DatePicker支持鼠标点选日期,同时还可以通过键盘控制选择:

  1. page up/down -上一月、下一月
  2. ctrl+page up/down -上一年、下一年
  3. ctrl+home -当前月或最后一次打开的日期
  4. ctrl+left/right -上一天、下一天
  5. ctrl+up/down -上一周、下一周
  6. enter -确定选择日期
  7. ctrl+end-关闭并清除已选择的日期
  8. escape -关闭并取消选择
复制

实用功能

  1. $.datepicker.setDefaults( settings )-全局设置日期选择插件的参数.
  2. $.datepicker.formatDate( format, date, settings )-格式化显示的日期字符串
  3. $.datepicker.iso8601Week( date )-给出一个日期,确实他是一年中的第几周
  4. $.datepicker.parseDate( format, value, settings )-按照指定格式获取日期字符串
复制

日期格式

  1. d -每月的第几天(没有前导零)
  2. dd -每月的第几天(两位数字)
  3. o -一年中的第几天(没有前导零)
  4. oo -一年中的第几天(三位数字)
  5. D - day name short
  6. DD - day name long
  7. m -月份(没有前导零)
  8. mm -月份(两位数字)
  9. M - month name short
  10. MM - month name long
  11. y -年份(两位数字)
  12. yy -年份(四位数字)
  13. @-Unix时间戳(从01/01/1970开始)
  14. ‘...‘-文本
  15. ‘‘-单引号
  16. (其它)-文本
复制

其它标准日期格式

  1. ATOM -‘yy-mm-dd‘(Sameas RFC 3339/ISO 8601)
  2. COOKIE -‘D, dd M yy‘
  3. ISO_8601 -‘yy-mm-dd‘
  4. RFC_822 -‘D, d M y‘
  5. RFC_850 -‘DD, dd-M-y‘
  6. RFC_1036 -‘D, d M y
  7. RFC_1123 - ‘D, d M yy
  8. RFC_2822 - ‘D, d M yy
  9. RSS - ‘D, d M y
  10. TIMESTAMP - ‘@
  11. W3C - ‘yy-mm-dd
复制

参数(参数名 : 参数类型 : 默认值)

altField : String : ‘‘ 
  将选择的日期同步到另一个域中,配合altFormat可以显示不同格式的日期字符串。 

  1. 初始:$(‘.selector‘).datepicker({ altField:‘#actualDate‘});
  2. 获取:var altField = $(‘.selector‘).datepicker(‘option‘,‘altField‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘altField‘,‘#actualDate‘);
复制

altFormat : String : ‘‘ 
  当设置了altField的情况下,显示在另一个域中的日期格式。 

  1. 初始:$(‘.selector‘).datepicker({ altFormat:‘yy-mm-dd‘});
  2. 获取:var altFormat = $(‘.selector‘).datepicker(‘option‘,‘altFormat‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘altFormat‘,‘yy-mm-dd‘);
复制

appendText : String : ‘‘ 
  在日期插件的所属域后面添加指定的字符串。 

  1. 初始:$(‘.selector‘).datepicker({ appendText:‘(yyyy-mm-dd)‘});
  2. 获取:var appendText = $(‘.selector‘).datepicker(‘option‘,‘appendText‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘appendText‘,‘(yyyy-mm-dd)‘);
复制

buttonImage : String : ‘‘ 
  设置弹出按钮的图片,如果非空,则按钮的文本将成为alt属性,不直接显示。 

  1. 初始:$(‘.selector‘).datepicker({ buttonImage:‘/images/datepicker.gif‘});
  2. 获取:var buttonImage = $(‘.selector‘).datepicker(‘option‘,‘buttonImage‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘buttonImage‘,‘/images/datepicker.gif‘);
复制

buttonImageOnly : Boolean : false 
  Set to true to place an image after the field to use as the trigger without it appearing on a button. 

  1. 初始:$(‘.selector‘).datepicker({ buttonImageOnly:true});
  2. 获取:var buttonImageOnly = $(‘.selector‘).datepicker(‘option‘,‘buttonImageOnly‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘buttonImageOnly‘,true);
复制

buttonText : String : ‘...‘ 
  设置触发按钮的文本内容。 

  1. 初始:$(‘.selector‘).datepicker({ buttonText:‘Choose‘});
  2. 获取:var buttonText = $(‘.selector‘).datepicker(‘option‘,‘buttonText‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘buttonText‘,‘Choose‘);
复制

changeMonth : Boolean : false 
  设置允许通过下拉框列表选取月份。 

  1. 初始:$(‘.selector‘).datepicker({ changeMonth:true});
  2. 获取:var changeMonth = $(‘.selector‘).datepicker(‘option‘,‘changeMonth‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘changeMonth‘,true);
复制

changeYear : Boolean : false 
  设置允许通过下拉框列表选取年份。 

  1. 初始:$(‘.selector‘).datepicker({ changeYear:true});
  2. 获取:var changeYear = $(‘.selector‘).datepicker(‘option‘,‘changeYear‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘changeYear‘,true);
复制

closeTextType: StringDefault: ‘Done‘ 
  设置关闭按钮的文本内容,此按钮需要通过showButtonPanel参数的设置才显示。 

  1. 初始:$(‘.selector‘).datepicker({ closeText:‘X‘});
  2. 获取:var closeText = $(‘.selector‘).datepicker(‘option‘,‘closeText‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘closeText‘,‘X‘);
复制

constrainInput : Boolean : true 
  如果设置为true,则约束当前输入的日期格式。 

  1. 初始:$(‘.selector‘).datepicker({ constrainInput:false});
  2. 获取:var constrainInput = $(‘.selector‘).datepicker(‘option‘,‘constrainInput‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘constrainInput‘,false);
复制

currentText : String : ‘Today‘ 
  设置当天按钮的文本内容,此按钮需要通过showButtonPanel参数的设置才显示。 

  1. 初始:$(‘.selector‘).datepicker({ currentText:‘Now‘});
  2. 获取:var currentText = $(‘.selector‘).datepicker(‘option‘,‘currentText‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘currentText‘,‘Now‘);
复制

dateFormat : String : ‘mm/dd/yy‘ 
  设置日期字符串的显示格式。 

  1. 初始:$(‘.selector‘).datepicker({ dateFormat:‘yy-mm-dd‘});
  2. 获取:var dateFormat = $(‘.selector‘).datepicker(‘option‘,‘dateFormat‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘dateFormat‘,‘yy-mm-dd‘);
复制

dayNames : Array : [‘Sunday‘, ‘Monday‘, ‘Tuesday‘, ‘Wednesday‘, ‘Thursday‘, ‘Friday‘, ‘Saturday‘] 
  设置一星期中每天的名称,从星期天开始。此内容用于dateFormat时显示,以及日历中当鼠标移至行头时显示。 

  1. 初始:$(‘.selector‘).datepicker({ dayNames:[‘Dimanche‘,‘Lundi‘,‘Mardi‘,‘Mercredi‘,‘Jeudi‘,‘Vendredi‘,‘Samedi‘]});
  2. 获取:var dayNames = $(‘.selector‘).datepicker(‘option‘,‘dayNames‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘dayNames‘,[‘Dimanche‘,
  4. ‘Lundi‘,‘Mardi‘,‘Mercredi‘,‘Jeudi‘,‘Vendredi‘,‘Samedi‘]);
复制

dayNamesMin : Array : [‘Su‘, ‘Mo‘, ‘Tu‘, ‘We‘, ‘Th‘, ‘Fr‘, ‘Sa‘] 
  设置一星期中每天的缩语,从星期天开始,此内容用于dateFormat时显示,以前日历中的行头显示。 

  1. 初始:$(‘.selector‘).datepicker({ dayNamesMin:[‘Di‘,‘Lu‘,‘Ma‘,‘Me‘,‘Je‘,‘Ve‘,‘Sa‘]});
  2. 获取:var dayNamesMin = $(‘.selector‘).datepicker(‘option‘,‘dayNamesMin‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘dayNamesMin‘,[‘Di‘,‘Lu‘,‘Ma‘,‘Me‘,‘Je‘,‘Ve‘,‘Sa‘]);
复制

dayNamesShort : Array : [‘Sun‘, ‘Mon‘, ‘Tue‘, ‘Wed‘, ‘Thu‘, ‘Fri‘, ‘Sat‘] 
  设置一星期中每天的缩语,从星期天开始,此内容用于dateFormat时显示,以前日历中的行头显示。 

  1. 初始:$(‘.selector‘).datepicker({ dayNamesShort:[‘Dim‘,‘Lun‘,‘Mar‘,‘Mer‘,‘Jeu‘,‘Ven‘,‘Sam‘]});
  2. 获取:var dayNamesShort = $(‘.selector‘).datepicker(‘option‘,‘dayNamesShort‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘dayNamesShort‘,[‘Dim‘,‘Lun‘,‘Mar‘,‘Mer‘,‘Jeu‘,‘Ven‘,‘Sam‘]);
复制

defaultDate : Date, Number, String : null 
  设置默认加载完后第一次显示时选中的日期。可以是Date对象,或者是数字(从今天算起,例如+7),或者有效的字符串(‘y‘代表年, ‘m‘代表月, ‘w‘代表周, ‘d‘代表日, 例如:‘+1m +7d‘)。 

  1. 初始:$(‘.selector‘).datepicker({ defaultDate:+7});
  2. 获取:var defaultDate = $(‘.selector‘).datepicker(‘option‘,‘defaultDate‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘defaultDate‘,+7);
复制

duration : String, Number : ‘normal‘ 
  设置日期控件展开动画的显示时间,可选是"slow", "normal", "fast",‘‘代表立刻,数字代表毫秒数。 

  1. 初始:$(‘.selector‘).datepicker({ duration:‘slow‘});
  2. 获取:var duration = $(‘.selector‘).datepicker(‘option‘,‘duration‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘duration‘,‘slow‘);
复制

firstDay : Number : 0 
  设置一周中的第一天。星期天为0,星期一为1,以此类推。 

  1. 初始:$(‘.selector‘).datepicker({ firstDay:1});
  2. 获取:var firstDay = $(‘.selector‘).datepicker(‘option‘,‘firstDay‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘firstDay‘,1);
复制

gotoCurrent : Boolean : false 
  如果设置为true,则点击当天按钮时,将移至当前已选中的日期,而不是今天。 

  1. 初始:$(‘.selector‘).datepicker({ gotoCurrent:true});
  2. 获取:var gotoCurrent = $(‘.selector‘).datepicker(‘option‘,‘gotoCurrent‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘gotoCurrent‘,true);
复制

hideIfNoPrevNext : Boolean : false 
  设置当没有上一个/下一个可选择的情况下,隐藏掉相应的按钮。(默认为不可用) 

  1. 初始:$(‘.selector‘).datepicker({ hideIfNoPrevNext:true});
  2. 获取:var hideIfNoPrevNext = $(‘.selector‘).datepicker(‘option‘,‘hideIfNoPrevNext‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘hideIfNoPrevNext‘,true);
复制

isRTL : Boolean : false 
  如果设置为true,则所有文字是从右自左。 

  1. 初始:$(‘.selector‘).datepicker({ isRTL:true});
  2. 获取:var isRTL = $(‘.selector‘).datepicker(‘option‘,‘isRTL‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘isRTL‘,true);
复制

maxDate : Date, Number, String : null 
  设置一个最大的可选日期。可以是Date对象,或者是数字(从今天算起,例如+7),或者有效的字符串(‘y‘代表年, ‘m‘代表月, ‘w‘代表周, ‘d‘代表日, 例如:‘+1m +7d‘)。 

  1. 初始:$(‘.selector‘).datepicker({ maxDate:‘+1m +1w‘});
  2. 获取:var maxDate = $(‘.selector‘).datepicker(‘option‘,‘maxDate‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘maxDate‘,‘+1m +1w‘);
  4. $(‘.selector‘).datepicker(‘option‘,‘maxDate‘,‘12/25/2012‘);
复制

minDate : Date, Number, String : null 
  设置一个最小的可选日期。可以是Date对象,或者是数字(从今天算起,例如+7),或者有效的字符串(‘y‘代表年, ‘m‘代表月, ‘w‘代表周, ‘d‘代表日, 例如:‘+1m +7d‘)。 
 

  1. 初始:$(‘.selector‘).datepicker({ minDate:newDate(2007,1-1,1)});
  2. 获取:var minDate = $(‘.selector‘).datepicker(‘option‘,‘minDate‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘minDate‘,newDate(2007,1-1,1));
  4. $(‘.selector‘).datepicker(‘option‘,‘minDate‘,‘12/25/2012‘);
复制

monthNames : Array : [‘January‘, ‘February‘, ‘March‘, ‘April‘, ‘May‘, ‘June‘, ‘July‘, ‘August‘, ‘September‘, ‘October‘, ‘November‘, ‘December‘] 
  设置所有月份的名称。 
 

  1. 初始:$(‘.selector‘).datepicker({monthNames:[‘Januar‘,‘Februar‘,‘Marts‘,‘April‘,‘Maj‘,‘Juni‘,‘Juli‘,‘August‘,‘September‘,‘Oktober‘,‘November‘,‘December‘]});
  2. 获取:var monthNames = $(‘.selector‘).datepicker(‘option‘,‘monthNames‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘monthNames‘,
  4. [‘Januar‘,‘Februar‘,‘Marts‘,‘April‘,‘Maj‘,‘Juni‘,‘Juli‘,‘August‘,‘September‘,‘Oktober‘,‘November‘,‘December‘]);
复制

monthNamesShort : Array : [‘Jan‘, ‘Feb‘, ‘Mar‘, ‘Apr‘, ‘May‘, ‘Jun‘, ‘Jul‘, ‘Aug‘, ‘Sep‘, ‘Oct‘, ‘Nov‘, ‘Dec‘] 
  设置所有月份的缩写。 
 

  1. 初始:$(‘.selector‘).datepicker({monthNamesShort:[‘Jan‘,‘Feb‘,‘Mar‘,‘Apr‘,‘Maj‘,‘Jun‘,‘Jul‘,‘Aug‘,‘Sep‘,‘Okt‘,‘Nov‘,‘Dec‘]});
  2. 获取:var monthNamesShort = $(‘.selector‘).datepicker(‘option‘,‘monthNamesShort‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘monthNamesShort‘,
  4. [‘Jan‘,‘Feb‘,‘Mar‘,‘Apr‘,‘Maj‘,‘Jun‘,‘Jul‘,‘Aug‘,‘Sep‘,‘Okt‘,‘Nov‘,‘Dec‘]);
复制

navigationAsDateFormat : Boolean : false 
  如果设置为true,则formatDate函数将应用到 prevText,nextText和currentText的值中显示,例如显示为月份名称。 
 

  1. 初始:$(‘.selector‘).datepicker({ navigationAsDateFormat:true});
  2. 获取:var navigationAsDateFormat = $(‘.selector‘).datepicker(‘option‘,‘navigationAsDateFormat‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘navigationAsDateFormat‘,true);
复制

nextText : String : ‘Next‘ 
  设置“下个月”链接的显示文字。 
 

  1. 初始:$(‘.selector‘).datepicker({ nextText:‘Later‘});
  2. 获取:var nextText = $(‘.selector‘).datepicker(‘option‘,‘nextText‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘nextText‘,‘Later‘);
复制

numberOfMonths : Number, Array : 1 
  设置一次要显示多少个月份。如果为整数则是显示月份的数量,如果是数组,则是显示的行与列的数量。 
 

  1. 初始:$(‘.selector‘).datepicker({ numberOfMonths:[2,3]});
  2. 获取:var numberOfMonths = $(‘.selector‘).datepicker(‘option‘,‘numberOfMonths‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘numberOfMonths‘,[2,3]);
复制

prevText : String : ‘Prev‘ 
  设置“上个月”链接的显示文字。 
 

  1. 初始:$(‘.selector‘).datepicker({ prevText:‘Earlier‘});
  2. 获取:var prevText = $(‘.selector‘).datepicker(‘option‘,‘prevText‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘prevText‘,‘Earlier‘);
复制

shortYearCutoff : String, Number : ‘+10‘ 
  设置截止年份的值。如果是(0-99)的数字则以当前年份开始算起,如果为字符串,则相应的转为数字后再与当前年份相加。当超过截止年份时,则被认为是上个世纪。 
 

  1. 初始:$(‘.selector‘).datepicker({ shortYearCutoff:50});
  2. 获取:var shortYearCutoff = $(‘.selector‘).datepicker(‘option‘,‘shortYearCutoff‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘shortYearCutoff‘,50);
复制

showAnim : String : ‘show‘ 
  设置显示、隐藏日期插件的动画的名称。

  1. 初始:$(‘.selector‘).datepicker({ showAnim:‘fold‘});
  2. 获取:var showAnim = $(‘.selector‘).datepicker(‘option‘,‘showAnim‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘showAnim‘,‘fold‘);
复制

showButtonPanel : Boolean : false 
  设置是否在面板上显示相关的按钮。

  1. 初始:$(‘.selector‘).datepicker({ showButtonPanel:true});
  2. 获取:var showButtonPanel = $(‘.selector‘).datepicker(‘option‘,‘showButtonPanel‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘showButtonPanel‘,true);
复制

showCurrentAtPos : Number : 0 
  设置当多月份显示的情况下,当前月份显示的位置。自顶部/左边开始第x位。

  1. 初始:$(‘.selector‘).datepicker({ showCurrentAtPos:3});
  2. 获取:var showCurrentAtPos = $(‘.selector‘).datepicker(‘option‘,‘showCurrentAtPos‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘showCurrentAtPos‘,3);
复制

showMonthAfterYear : Boolean : false 
  是否在面板的头部年份后面显示月份。

  1. 初始:$(‘.selector‘).datepicker({ showMonthAfterYear:true});
  2. 获取:var showMonthAfterYear = $(‘.selector‘).datepicker(‘option‘,‘showMonthAfterYear‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘showMonthAfterYear‘,true);
复制

showOn : String : ‘focus‘ 
  设置什么事件触发显示日期插件的面板,可选值:focus, button, both

  1. 初始:$(‘.selector‘).datepicker({ showOn:‘both‘});
  2. 获取:var showOn = $(‘.selector‘).datepicker(‘option‘,‘showOn‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘showOn‘,‘both‘);
复制

showOptions : Options : {} 
  如果使用showAnim来显示动画效果的话,可以通过此参数来增加一些附加的参数设置。

  1. 初始:$(‘.selector‘).datepicker({ showOptions:{direction:‘up‘});
  2. 获取:var showOptions = $(‘.selector‘).datepicker(‘option‘,‘showOptions‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘showOptions‘,{direction:‘up‘);
复制

showOtherMonths : Boolean : false 
  是否在当前面板显示上、下两个月的一些日期数(不可选)。

  1. 初始:$(‘.selector‘).datepicker({ showOtherMonths:true});
  2. 获取:var showOtherMonths = $(‘.selector‘).datepicker(‘option‘,‘showOtherMonths‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘showOtherMonths‘,true);
复制

stepMonths : Number : 1 
  当点击上/下一月时,一次翻几个月。

  1. 初始:$(‘.selector‘).datepicker({ stepMonths:3});
  2. 获取:var stepMonths = $(‘.selector‘).datepicker(‘option‘,‘stepMonths‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘stepMonths‘,3);
复制

yearRange : String : ‘-10:+10‘ 
  控制年份的下拉列表中显示的年份数量,可以是相对当前年(-nn:+nn),也可以是绝对值 (-nnnn:+nnnn)

  1. 初始:$(‘.selector‘).datepicker({ yearRange:‘2000:2010‘});
  2. 获取:var yearRange = $(‘.selector‘).datepicker(‘option‘,‘yearRange‘);
  3. 设置:$(‘.selector‘).datepicker(‘option‘,‘yearRange‘,‘2000:2010‘);
    复制

事件

beforeShow : function(input) 
  在日期控件显示面板之前,触发此事件,并返回当前触发事件的控件的实例对象。

  1. 初始:$(‘.selector‘).datepicker({ beforeShow:function(input){...}});
    复制

beforeShowDay : function(date) 
  在日期控件显示面板之前,每个面板上的日期绑定时都触发此事件,参数为触发事件的日期。调用函数后,必须返回一个数组:[0]此日期是否可选(true/false),[1]此日期的CSS样式名称(""表示默认),[2]当鼠标移至上面出现一段提示的内容。

  1. 初始:$(‘.selector‘).datepicker({ beforeShowDay:function(date){...}});
    复制

onChangeMonthYear : function(year, month, inst) 
  当年份或月份改变时触发此事件,参数为改变后的年份月份和当前日期插件的实例。

  1. 初始:$(‘.selector‘).datepicker({ onChangeMonthYear:function(year, month, inst){...}});
    复制

onClose : function(dateText, inst) 
  当日期面板关闭后触发此事件(无论是否有选择日期),参数为选择的日期和当前日期插件的实例。

  1. 初始:$(‘.selector‘).datepicker({ onClose:function(dateText, inst){...}});
    复制

onSelect : function(dateText, inst) 
  当在日期面板选中一个日期后触发此事件,参数为选择的日期和当前日期插件的实例。

  1. $(‘.selector‘).datepicker({ onSelect:function(dateText, inst){...}});
    复制

方法:

destory 
  从元素中移除拖拽功能。 
  用法:.datepicker( ‘destroy‘ ) 

disable 
  禁用元素的拖拽功能。 
  用法:.datepicker( ‘disable‘ ) 

enable 
  启用元素的拖拽功能。 
  用法:.datepicker( ‘enable‘ ) 

option 
  获取或设置元素的参数。 
  用法:.datepicker( ‘option‘ , optionName , [value] ) 

dialog 
  在dialog插件中打开一个日期插件。 
  用法:.datepicker( ‘dialog‘ , dateText , [onSelect] , [settings] , [pos] ) 

isDisabled 
  确实日期插件是否已被禁用。 
  用法:.datepicker( ‘isDisabled‘ ) 

hide 
  隐藏(关闭)之前已经打开的日期面板。 
  用法:.datepicker( ‘hide‘ , [speed] )  

show 
.datepicker( ‘show‘ ) 
  显示日期插件。 
  用法:.datepicker( ‘show‘ ) 

getDate 
  返回当前日期插件选择的日期。 
  用法:.datepicker( ‘getDate‘ ) 

setDate 
  设置日期插件当前的日期。date参数可以是数字(从今天算起,例如+7),或者有效的字符串(‘y‘代表年, ‘m‘代表月, ‘w‘代表周, ‘d‘代表日, 例如:‘+1m +7d‘),null表示当天。 
  用法:.datepicker( ‘setDate‘ , date )

事件

datepicker类公开了一些事件处理日期。

EventDescription
show This event fires immediately when the date picker is displayed.
hide This event is fired immediately when the date picker is hidden.
changeDate This event is fired when the date is changed.
onRender This event is fired when a day is rendered inside the datepicker. Should return a string. Return ‘disabled’ to disable the day from being selected.
  1. $(‘#dp5‘).datepicker()
  2. .on(‘changeDate‘,function(ev){
  3. if(ev.date.valueOf()< startDate.valueOf()){
  4. ....
  5. }
  6. });
    复制

Data API

As with bootstrap’s own plugins, datepicker provides a data-api that can be used to instantiate datepickers without the need for custom javascript. For most datepickers, simply set data-provide="datepicker" on the element you want to initialize, and it will be intialized lazily, in true bootstrap fashion. For inline datepickers, use data-provide="datepicker-inline"; these will be immediately initialized on page load, and cannot be lazily loaded.

  1. <inputdata-provide="datepicker">
  2. 复制

You can disable datepicker’s data-api in the same way as you would disable other bootstrap plugins:

  1. $(document).off(‘.datepicker.data-api‘);
  2. 复制

Configuration

Options are passed to the datepicker function via an options hash at instantiation:

  1. $(‘.datepicker‘).datepicker({
  2. format:‘mm/dd/yyyy‘,
  3. startDate:‘-3d‘
  4. })
  5. 复制

Most options may be provided as data-attributes on the target element:

  1. <inputclass="datepicker"data-date-format="mm/dd/yyyy">
  2. 复制
  1. $(‘.datepicker‘).datepicker({
  2. startDate:‘-3d‘
  3. })
  4. 复制

Defaults for all options can be modified directly by changing values in the $.fn.datepicker.defaults hash:

  1. $.fn.datepicker.defaults.format ="mm/dd/yyyy";
  2. $(‘.datepicker‘).datepicker({
  3. startDate:‘-3d‘
  4. })
  5. 复制

No Conflict mode

$.fn.datepicker.noConflict provides a way to avoid conflict with other jQuery datepicker plugins:

  1. var datepicker = $.fn.datepicker.noConflict();// return $.fn.datepicker to previously assigned value
  2. $.fn.bootstrapDP = datepicker;// give $().bootstrapDP the

jQuery Datepicker日期控件

标签:render   most   middle   cto   range   block   default   pos   按钮   

原文地址:http://www.cnblogs.com/niuboren/p/6206283.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!