jquery-ui/ui/datepicker.js
2015-01-29 17:52:50 -05:00

365 lines
8.1 KiB
JavaScript

/*!
* jQuery UI Datepicker @VERSION
* http://jqueryui.com
*
* Copyright jQuery Foundation and other contributors
* Released under the MIT license.
* http://jquery.org/license
*/
//>>label: Datepicker
//>>group: Widgets
//>>description: Displays a calendar from an input or inline for selecting dates.
//>>docs: http://api.jqueryui.com/datepicker/
//>>demos: http://jqueryui.com/datepicker/
(function( factory ) {
if ( typeof define === "function" && define.amd ) {
// AMD. Register as an anonymous module.
define([
"jquery",
"./core",
"./widget",
"./calendar",
"./position"
], factory );
} else {
// Browser globals
factory( jQuery );
}
}(function( $ ) {
// TODO Use uniqueId, if possible
var idIncrement = 0,
// TODO Move this to the instance
suppressExpandOnFocus = false;
$.widget( "ui.datepicker", {
version: "@VERSION",
options: {
appendTo: null,
dateFormat: { date: "short" },
// TODO Review
eachDay: $.noop,
max: null,
min: null,
numberOfMonths: 1,
position: {
my: "left top",
at: "left bottom"
},
showWeek: false,
show: true,
hide: true,
// callbacks
beforeOpen: null,
close: null,
open: null,
select: null
},
_create: function() {
this._createCalendar();
},
_getCreateOptions: function() {
var max = this.element.attr( "max" ),
min = this.element.attr( "min" ),
options = {};
if ( max !== undefined ) {
options.max = Globalize.parseDate( max, { pattern: "yyyy-MM-dd" } );
}
if ( min !== undefined ) {
options.min = Globalize.parseDate( min, { pattern: "yyyy-MM-dd" } );
}
return options;
},
_createCalendar: function() {
var that = this;
this.calendar = $( "<div>" )
.addClass( "ui-front ui-datepicker" )
.appendTo( this._appendTo() );
// Initialize calendar widget
this.calendarInstance = this.calendar
.calendar({
dateFormat: this.options.dateFormat,
eachDay: this.options.eachDay,
max: this.options.max,
min: this.options.min,
numberOfMonths: this.options.numberOfMonths,
showWeek: this.options.showWeek,
value: this._getParsedValue(),
select: function( event ) {
that.element.val( that.calendarInstance.value() );
that.close();
that._focusTrigger();
that._trigger( "select", event );
}
})
.calendar( "instance" );
this._setHiddenPicker();
this.element
.attr( "aria-haspopup", "true" )
.attr( "aria-owns", this.calendar.attr( "id" ) );
this._on({
keydown: function( event ) {
switch ( event.keyCode ) {
case $.ui.keyCode.TAB:
// Waiting for close() will make popup hide too late, which breaks tab key behavior
this.calendar.hide();
this.close( event );
break;
case $.ui.keyCode.ESCAPE:
if ( this.isOpen ) {
this.close( event );
}
break;
case $.ui.keyCode.ENTER:
this.calendarInstance._handleKeydown( event );
break;
case $.ui.keyCode.DOWN:
case $.ui.keyCode.UP:
clearTimeout( this.closeTimer );
this._delay( function() {
this.open( event );
this.calendarInstance.grid.focus();
}, 1 );
break;
case $.ui.keyCode.HOME:
if ( event.ctrlKey ) {
this.valueAsDate( new Date() );
event.preventDefault();
if ( this.isOpen ) {
this.calendarInstance.refresh();
} else {
this.open( event );
}
}
break;
case $.ui.keyCode.END:
if ( event.ctrlKey ) {
this.element.val( "" );
event.preventDefault();
if ( this.isOpen ) {
this.close( event );
}
}
break;
}
},
keyup: function() {
if ( this.isValid() ) {
this.refresh();
}
},
mousedown: function( event ) {
if ( this.isOpen ) {
suppressExpandOnFocus = true;
this.close();
return;
}
this.open( event );
clearTimeout( this.closeTimer );
},
focus: function( event ) {
if ( !suppressExpandOnFocus ) {
this._delay( function() {
if ( !this.isOpen ) {
this.open( event );
}
}, 1);
}
this._delay( function() {
suppressExpandOnFocus = false;
}, 100 );
},
blur: function() {
suppressExpandOnFocus = false;
}
});
this._on( this.calendar, {
focusout: function( event ) {
// Use a timer to allow click to clear it and letting that
// handle the closing instead of opening again
// also allows tabbing inside the calendar without it closing
this.closeTimer = this._delay( function() {
this.close( event );
}, 150 );
},
focusin: function() {
clearTimeout( this.closeTimer );
},
mouseup: function() {
clearTimeout( this.closeTimer );
},
// TODO On TAB (or shift TAB), make sure it ends up on something useful in DOM order
keyup: function( event ) {
if ( event.keyCode === $.ui.keyCode.ESCAPE && this.calendar.is( ":visible" ) ) {
this.close( event );
this._focusTrigger();
}
}
});
this._on( this.document, {
click: function( event ) {
if ( this.isOpen && !$( event.target ).closest( this.element.add( this.calendar ) ).length ) {
this.close( event );
}
}
});
},
_appendTo: function() {
var element = this.options.appendTo;
if ( element ) {
element = element.jquery || element.nodeType ?
$( element ) :
this.document.find( element ).eq( 0 );
}
if ( !element || !element[ 0 ] ) {
element = this.element.closest( ".ui-front" );
}
if ( !element.length ) {
element = this.document[ 0 ].body;
}
return element;
},
_focusTrigger: function() {
suppressExpandOnFocus = true;
this.element.focus();
},
refresh: function() {
this.calendarInstance.option( "value", this._getParsedValue() );
},
open: function( event ) {
if ( this.isOpen ) {
return;
}
if ( this._trigger( "beforeOpen", event ) === false ) {
return;
}
this.calendarInstance.refresh();
this.calendar
.attr( "aria-hidden", "false" )
.attr( "aria-expanded", "true" )
.show()
.position( this._buildPosition() )
.hide();
this._show( this.calendar, this.options.show );
// Take trigger out of tab order to allow shift-tab to skip trigger
// TODO Does this really make sense? related bug: tab-shift moves focus to last element on page
this.element.attr( "tabindex", -1 );
this.isOpen = true;
this._trigger( "open", event );
},
close: function( event ) {
this._setHiddenPicker();
this._hide( this.calendar, this.options.hide );
this.element.attr( "tabindex" , 0 );
this.isOpen = false;
this._trigger( "close", event );
},
_setHiddenPicker: function() {
this.calendar
.attr( "aria-hidden", "true" )
.attr( "aria-expanded", "false" );
},
_buildPosition: function() {
return $.extend( { of: this.element }, this.options.position );
},
value: function( value ) {
if ( arguments.length ) {
this.valueAsDate( Globalize.parseDate( value , this.options.dateFormat ) );
} else {
return this._getParsedValue() ? this.element.val() : null;
}
},
valueAsDate: function( value ) {
if ( arguments.length ) {
if ( this.calendarInstance._isValid( value ) ) {
this.calendarInstance.valueAsDate( value );
this.element.val( Globalize.format( value, this.options.dateFormat ) );
}
} else {
return this._getParsedValue();
}
},
isValid: function() {
return this.calendarInstance._isValid( this._getParsedValue() );
},
_destroy: function() {
this.calendarInstance.destroy();
this.calendar.remove();
this.element
.removeAttr( "aria-haspopup" )
.removeAttr( "aria-owns" );
},
widget: function() {
return this.calendar;
},
_getParsedValue: function() {
return Globalize.parseDate( this.element.val(), this.options.dateFormat );
},
_setOption: function( key, value ) {
this._super( key, value );
if ( $.inArray( key, [ "showWeek", "numberOfMonths", "dateFormat", "eachDay", "min", "max" ] ) !== -1 ) {
this.calendarInstance.option( key, value );
}
if ( key === "appendTo" ) {
this.calendar.appendTo( this._appendTo() );
}
if ( key === "dateFormat" ) {
this.element.val( this.calendarInstance.value() );
}
if ( key === "position" ) {
this.calendar.position( this._buildPosition() );
}
}
});
}));