/**
* @class Ext.picker.Date
* @extends Ext.Component
* <p>A date picker. This class is used by the {@link Ext.form.field.Date} field to allow browsing and
@@ -92,12 +109,12 @@ Ext.define('Ext.picker.Date', {
],
ariaTitle: 'Date Picker',
- /**
+ /**
* @cfg {String} todayText
* The text to display on the button that selects the current date (defaults to <code>'Today'</code>)
*/
todayText : 'Today',
- /**
+ /**
* @cfg {Function} handler
* Optional. A function that will handle the select event of this picker.
* The handler is passed the following parameters:<div class="mdetail-params"><ul>
@@ -105,96 +122,96 @@ Ext.define('Ext.picker.Date', {
* <li><code>date</code> : Date <div class="sub-desc">The selected date.</div></li>
* </ul></div>
*/
- /**
+ /**
* @cfg {Object} scope
* The scope (<code><b>this</b></code> reference) in which the <code>{@link #handler}</code>
* function will be called. Defaults to this DatePicker instance.
*/
- /**
+ /**
* @cfg {String} todayTip
* A string used to format the message for displaying in a tooltip over the button that
* selects the current date. Defaults to <code>'{0} (Spacebar)'</code> where
* the <code>{0}</code> token is replaced by today's date.
*/
todayTip : '{0} (Spacebar)',
- /**
+ /**
* @cfg {String} minText
* The error text to display if the minDate validation fails (defaults to <code>'This date is before the minimum date'</code>)
*/
minText : 'This date is before the minimum date',
- /**
+ /**
* @cfg {String} maxText
* The error text to display if the maxDate validation fails (defaults to <code>'This date is after the maximum date'</code>)
*/
maxText : 'This date is after the maximum date',
- /**
+ /**
* @cfg {String} format
* The default date format string which can be overriden for localization support. The format must be
* valid according to {@link Ext.Date#parse} (defaults to {@link Ext.Date#defaultFormat}).
*/
- /**
+ /**
* @cfg {String} disabledDaysText
* The tooltip to display when the date falls on a disabled day (defaults to <code>'Disabled'</code>)
*/
disabledDaysText : 'Disabled',
- /**
+ /**
* @cfg {String} disabledDatesText
* The tooltip text to display when the date falls on a disabled date (defaults to <code>'Disabled'</code>)
*/
disabledDatesText : 'Disabled',
- /**
+ /**
* @cfg {Array} monthNames
* An array of textual month names which can be overriden for localization support (defaults to Ext.Date.monthNames)
*/
- /**
+ /**
* @cfg {Array} dayNames
* An array of textual day names which can be overriden for localization support (defaults to Ext.Date.dayNames)
*/
- /**
+ /**
* @cfg {String} nextText
* The next month navigation button tooltip (defaults to <code>'Next Month (Control+Right)'</code>)
*/
nextText : 'Next Month (Control+Right)',
- /**
+ /**
* @cfg {String} prevText
* The previous month navigation button tooltip (defaults to <code>'Previous Month (Control+Left)'</code>)
*/
prevText : 'Previous Month (Control+Left)',
- /**
+ /**
* @cfg {String} monthYearText
* The header month selector tooltip (defaults to <code>'Choose a month (Control+Up/Down to move years)'</code>)
*/
monthYearText : 'Choose a month (Control+Up/Down to move years)',
- /**
+ /**
* @cfg {Number} startDay
* Day index at which the week should begin, 0-based (defaults to 0, which is Sunday)
*/
startDay : 0,
- /**
+ /**
* @cfg {Boolean} showToday
* False to hide the footer area containing the Today button and disable the keyboard handler for spacebar
* that selects the current date (defaults to <code>true</code>).
*/
showToday : true,
- /**
+ /**
* @cfg {Date} minDate
* Minimum allowable date (JavaScript date object, defaults to null)
*/
- /**
+ /**
* @cfg {Date} maxDate
* Maximum allowable date (JavaScript date object, defaults to null)
*/
- /**
+ /**
* @cfg {Array} disabledDays
* An array of days to disable, 0-based. For example, [0, 6] disables Sunday and Saturday (defaults to null).
*/
- /**
+ /**
* @cfg {RegExp} disabledDatesRE
* JavaScript regular expression used to disable a pattern of dates (defaults to null). The {@link #disabledDates}
* config will generate this regex internally, but if you specify disabledDatesRE it will take precedence over the
* disabledDates value.
*/
- /**
+ /**
* @cfg {Array} disabledDates
* An array of 'dates' to disable, as strings. These strings will be used to build a dynamic regular
* expression so they are very powerful. Some examples:
@@ -210,40 +227,40 @@ Ext.define('Ext.picker.Date', {
* escape the dot when restricting dates. For example: ['03\\.08\\.03'].
*/
- /**
+ /**
* @cfg {Boolean} disableAnim True to disable animations when showing the month picker. Defaults to <tt>false</tt>.
*/
disableAnim: true,
- /**
+ /**
* @cfg {String} baseCls
* The base CSS class to apply to this components element (defaults to <tt>'x-datepicker'</tt>).
*/
baseCls: Ext.baseCSSPrefix + 'datepicker',
- /**
+ /**
* @cfg {String} selectedCls
* The class to apply to the selected cell. Defaults to <tt>'x-datepicker-selected'</tt>
*/
- /**
+ /**
* @cfg {String} disabledCellCls
* The class to apply to disabled cells. Defaults to <tt>'x-datepicker-disabled'</tt>
*/
- /**
+ /**
* @cfg {String} longDayFormat
* The format for displaying a date in a longer format. Defaults to <tt>'F d, Y'</tt>
*/
longDayFormat: 'F d, Y',
- /**
+ /**
* @cfg {Object} keyNavConfig Specifies optional custom key event handlers for the {@link Ext.util.KeyNav}
* attached to this date picker. Must conform to the config format recognized by the {@link Ext.util.KeyNav}
* constructor. Handlers specified in this object will replace default handlers of the same name.
*/
- /**
+ /**
* @cfg {Boolean} focusOnShow
* True to automatically focus the picker on show. Defaults to <tt>false</tt>.
*/
@@ -279,7 +296,7 @@ Ext.define('Ext.picker.Date', {
clearTime(me.value, true) : clearTime(new Date());
me.addEvents(
- /**
+ /**
* @event select
* Fires when a date is selected
* @param {DatePicker} this DatePicker
@@ -423,7 +440,7 @@ Ext.define('Ext.picker.Date', {
me.update(me.value);
},
- /**
+ /**
* Setup the disabled dates regex based on config options
* @private
*/
@@ -446,7 +463,7 @@ Ext.define('Ext.picker.Date', {
}
},
- /**
+ /**
* Replaces any existing disabled dates with new values and refreshes the DatePicker.
* @param {Array/RegExp} disabledDates An array of date strings (see the {@link #disabledDates} config
* for details on supported values), or a JavaScript regular expression used to disable a pattern of dates.
@@ -466,7 +483,7 @@ Ext.define('Ext.picker.Date', {
return me;
},
- /**
+ /**
* Replaces any existing disabled days (by index, 0-6) with new values and refreshes the DatePicker.
* @param {Array} disabledDays An array of disabled day indexes. See the {@link #disabledDays} config
* for details on supported values.
@@ -477,7 +494,7 @@ Ext.define('Ext.picker.Date', {
return this.update(this.value, true);
},
- /**
+ /**
* Replaces any existing {@link #minDate} with the new value and refreshes the DatePicker.
* @param {Date} value The minimum date that can be selected
* @return {Ext.picker.Date} this
@@ -487,7 +504,7 @@ Ext.define('Ext.picker.Date', {
return this.update(this.value, true);
},
- /**
+ /**
* Replaces any existing {@link #maxDate} with the new value and refreshes the DatePicker.
* @param {Date} value The maximum date that can be selected
* @return {Ext.picker.Date} this
@@ -497,7 +514,7 @@ Ext.define('Ext.picker.Date', {
return this.update(this.value, true);
},
- /**
+ /**
* Sets the value of the date field
* @param {Date} value The date to set
* @return {Ext.picker.Date} this
@@ -507,7 +524,7 @@ Ext.define('Ext.picker.Date', {
return this.update(this.value);
},
- /**
+ /**
* Gets the current selected value of the date field
* @return {Date} The selected date
*/
@@ -534,7 +551,7 @@ Ext.define('Ext.picker.Date', {
this.setDisabledStatus(true);
},
- /**
+ /**
* Set the disabled state of various internal components
* @private
* @param {Boolean} disabled
@@ -551,7 +568,7 @@ Ext.define('Ext.picker.Date', {
}
},
- /**
+ /**
* Get the current active date.
* @private
* @return {Date} The active date
@@ -560,7 +577,7 @@ Ext.define('Ext.picker.Date', {
return this.activeDate || me.value;
},
- /**
+ /**
* Run any animation required to hide/show the month picker.
* @private
* @param {Boolean} isHide True if it's a hide operation
@@ -580,7 +597,7 @@ Ext.define('Ext.picker.Date', {
Ext.create('Ext.fx.Anim', options);
},
- /**
+ /**
* Hides the month picker, if it's visible.
* @return {Ext.picker.Date} this
*/
@@ -598,7 +615,7 @@ Ext.define('Ext.picker.Date', {
return me;
},
- /**
+ /**
* Show the month picker
* @return {Ext.picker.Date} this
*/
@@ -627,7 +644,7 @@ Ext.define('Ext.picker.Date', {
return me;
},
- /**
+ /**
* Create the month picker instance
* @private
* @return {Ext.picker.Month} picker
@@ -655,7 +672,7 @@ Ext.define('Ext.picker.Date', {
return picker;
},
- /**
+ /**
* Respond to an ok click on the month picker
* @private
*/
@@ -673,7 +690,7 @@ Ext.define('Ext.picker.Date', {
me.hideMonthPicker();
},
- /**
+ /**
* Respond to a cancel click on the month picker
* @private
*/
@@ -681,7 +698,7 @@ Ext.define('Ext.picker.Date', {
this.hideMonthPicker();
},
- /**
+ /**
* Show the previous month.
* @return {Ext.picker.Date} this
*/
@@ -689,7 +706,7 @@ Ext.define('Ext.picker.Date', {
return this.update(Ext.Date.add(this.activeDate, Ext.Date.MONTH, -1));
},
- /**
+ /**
* Show the next month.
* @return {Ext.picker.Date} this
*/
@@ -697,7 +714,7 @@ Ext.define('Ext.picker.Date', {
return this.update(Ext.Date.add(this.activeDate, Ext.Date.MONTH, 1));
},
- /**
+ /**
* Show the previous year.
* @return {Ext.picker.Date} this
*/
@@ -705,7 +722,7 @@ Ext.define('Ext.picker.Date', {
this.update(Ext.Date.add(this.activeDate, Ext.Date.YEAR, -1));
},
- /**
+ /**
* Show the next year.
* @return {Ext.picker.Date} this
*/
@@ -713,7 +730,7 @@ Ext.define('Ext.picker.Date', {
this.update(Ext.Date.add(this.activeDate, Ext.Date.YEAR, 1));
},
- /**
+ /**
* Respond to the mouse wheel event
* @private
* @param {Ext.EventObject} e
@@ -730,7 +747,7 @@ Ext.define('Ext.picker.Date', {
}
},
- /**
+ /**
* Respond to a date being clicked in the picker
* @private
* @param {Ext.EventObject} e
@@ -757,7 +774,7 @@ Ext.define('Ext.picker.Date', {
}
},
- /**
+ /**
* Perform any post-select actions
* @private
*/
@@ -767,7 +784,7 @@ Ext.define('Ext.picker.Date', {
}
},
- /**
+ /**
* Sets the current value to today.
* @return {Ext.picker.Date} this
*/
@@ -787,7 +804,7 @@ Ext.define('Ext.picker.Date', {
return me;
},
- /**
+ /**
* Update the selected cell
* @private
* @param {Date} date The new date
@@ -812,7 +829,7 @@ Ext.define('Ext.picker.Date', {
}, this);
},
- /**
+ /**
* Update the contents of the picker for a new month
* @private
* @param {Date} date The new date
@@ -933,7 +950,7 @@ Ext.define('Ext.picker.Date', {
me.monthBtn.setText(me.monthNames[date.getMonth()] + ' ' + date.getFullYear());
},
- /**
+ /**
* Update the contents of the picker
* @private
* @param {Date} date The new date
@@ -992,4 +1009,6 @@ function() {
proto.format = Ext.Date.defaultFormat;
});
-