calendar-base.js revision 968de103b6c098098a5166a4de778706cbb825e0
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The CalendarBase submodule is a basic UI calendar view that displays
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * a range of dates in a two-dimensional month grid, with one or more
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * months visible at a single time. CalendarBase supports custom date
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * rendering, multiple calendar panes, and selection.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @module calendar
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @submodule calendar-base
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass CAL_COL_HIDDEN = getCN(CALENDAR, 'column-hidden'),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass CAL_DAY_SELECTED = getCN(CALENDAR, 'day-selected'),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass SELECTION_DISABLED = getCN(CALENDAR, 'selection-disabled'),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass CAL_PREVMONTH_DAY = getCN(CALENDAR, 'prevmonth-day'),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass CAL_NEXTMONTH_DAY = getCN(CALENDAR, 'nextmonth-day'),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass/** Create a calendar view to represent a single or multiple
d8d2286d8330892bb02eb2bf0735322f559ef5efSatyen Desai * month range of dates, rendered as a grid with date and
d8d2286d8330892bb02eb2bf0735322f559ef5efSatyen Desai * weekday labels.
d8d2286d8330892bb02eb2bf0735322f559ef5efSatyen Desai * @class CalendarBase
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai * @extends Widget
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param config {Object} Configuration object (see Configuration
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * attributes)
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @constructor
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass CalendarBase.superclass.constructor.apply ( this, arguments );
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav GlassY.CalendarBase = Y.extend( CalendarBase, Y.Widget, {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A storage for various properties of individual month
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _paneProperties
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Object
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The number of month panes in the calendar, deduced
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * from the CONTENT_TEMPLATE's number of {calendar_grid}
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _paneNumber
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Number
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The unique id used to prefix various elements of this
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * calendar instance.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _calendarId
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type String
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The hash map of selected dates, populated with
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * selectDates() and deselectDates() methods
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _selectedDates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Object
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A private copy of the rules object, populated
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * by setting the customRenderer attribute.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _rules
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Object
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A private copy of the filterFunction, populated
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * by setting the customRenderer attribute.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _filterFunction
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Function
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Storage for calendar cells modified by any custom
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * formatting. The storage is cleared, used to restore
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * cells to the original state, and repopulated accordingly
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * when the calendar is rerendered.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @property _storedDateCells
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @type Object
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * Designated initializer
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * Initializes instance-level properties of
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method initializer
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai initializer : function () {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * renderUI implementation
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Creates a visual representation of the calendar based on existing parameters.
f10a402d8cc7dba5b475e38d8beaf6b79342c927Tilo Mitra * @method renderUI
f10a402d8cc7dba5b475e38d8beaf6b79342c927Tilo Mitra renderUI : function () {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai contentBox.appendChild(this._initCalendarHTML(this.get('date')));
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * bindUI implementation
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * Assigns listeners to relevant events that change the state
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * of the calendar.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method bindUI
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai bindUI : function () {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai this.after('dateChange', this._afterDateChange);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai this.after('showPrevMonthChange', this._afterShowPrevMonthChange);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai this.after('showNextMonthChange', this._afterShowNextMonthChange);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai this.after('headerRendererChange', this._afterHeaderRendererChange);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai this.after('customRendererChange', this._afterCustomRendererChange);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * syncUI implementation
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * Update the scroll position, based on the current value of scrollY
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method syncUI
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai syncUI : function () {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * An internal utility method that generates a list of selected dates
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * from the hash storage.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _getSelectedDatesList
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @return {Array} The array of `Date`s that are currently selected.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A utility method that returns all dates selected in a specific month.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _getSelectedDatesInMonth
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} oDate corresponding to the month for which selected dates
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * are requested.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @protected
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @return {Array} The array of `Date`s in a given month that are currently selected.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if (hasKey(this._selectedDates, year) && hasKey(this._selectedDates[year], month)) {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai return Y.Object.values(this._selectedDates[year][month]);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * An internal rendering method that modifies a date cell to have the
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * selected CSS class if the date cell is visible.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _renderSelectedDate
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} oDate The date corresponding to a specific date cell.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai this._dateToNode(oDate).addClass(CAL_DAY_SELECTED);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * An internal rendering method that modifies a date cell to remove the
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * selected CSS class if the date cell is visible.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _renderUnelectedDate
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} oDate The date corresponding to a specific date cell.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai this._dateToNode(oDate).removeClass(CAL_DAY_SELECTED);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * An internal utility method that checks whether a particular date
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * is in the current view of the calendar.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _isDateVisible
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date} oDate The date corresponding to a specific date cell.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @return {boolean} Returns true if the given date is in the current
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai * view of the calendar.
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai maxDate = ydate.addMonths(minDate, this._paneNumber - 1),
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai oDateTime = this._normalizeDate(oDate).getTime();
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai if (minDate.getTime() <= oDateTime && oDateTime <= maxDate) {
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai return true;
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai return false;
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly * An internal parsing method that receives a String list of numbers
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly * and number ranges (of the form "1,2,3,4-6,7-9,10,11" etc.) and checks
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly * whether a specific number is included in this list. Used for looking
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly * up dates in the customRenderer rule set.
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly * @method _isNumInList
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly * @param {Number} num The number to look for in a list.
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly * @param {String} strList The list of numbers of the form "1,2,3,4-6,7-8,9", etc.
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly * @return {boolean} Returns true if the given number is in the given list.
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai if (range.length == 2 && num >= parseInt(range[0], 10) && num <= parseInt(range[1], 10)) {
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai return true;
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai else if (range.length == 1 && (parseInt(elements[val], 10) == num)) {
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai return true;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return false;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Given a specific date, returns an array of rules (from the customRenderer rule set)
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * that the given date matches.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _getRulesForDate
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date} oDate The date for which an array of rules is needed
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @return {Array} Returns an array of `String`s, each containg the name of
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * a rule that the given date matches.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai if (L.isString(rules[years][months][dates][days])) {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai outputRules.push(rules[years][months][dates][days]);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A utility method which, given a specific date and a name of the rule,
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * checks whether the date matches the given rule.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _matchesRule
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} oDate The date to check
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {String} rule The name of the rule that the date should match.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @return {boolean} Returns true if the date matches the given rule.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai return (iOf(this._getRulesForDate(oDate), rule) >= 0);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A utility method which checks whether a given date matches the `enabledDatesRule`
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * or does not match the `disabledDatesRule` and therefore whether it can be selected.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _canBeSelected
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} oDate The date to check
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @return {boolean} Returns true if the date can be selected; false otherwise.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var enabledDatesRule = this.get("enabledDatesRule"),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass disabledDatesRule = this.get("disabledDatesRule");
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return this._matchesRule(oDate, enabledDatesRule);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return !this._matchesRule(oDate, disabledDatesRule);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return true;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Selects a given date or array of dates.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method selectDates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date|Array} dates A `Date` or `Array` of `Date`s.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Deselects a given date or array of dates, or deselects
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * all dates if no argument is specified.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method deselectDates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date|Array} [dates] A `Date` or `Array` of `Date`s, or no
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * argument if all dates should be deselected.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if (dates == null) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A utility method that adds a given date to selection..
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addDateToSelection
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date} oDate The date to add to selection.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Number} [index] An optional parameter that is used
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * to differentiate between individual date selections and multiple
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * date selections.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._selectedDates = setVal(this._selectedDates, [year, month, day], oDate);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if (index == null) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A utility method that adds a given list of dates to selection.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addDatesToSelection
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Array} datesArray The list of dates to add to selection.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A utility method that adds a given range of dates to selection.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _addDateRangeToSelection
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date} startDate The first date of the given range.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date} endDate The last date of the given range.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _addDateRangeToSelection : function (startDate, endDate) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var timezoneDifference = (endDate.getTimezoneOffset() - startDate.getTimezoneOffset())*60000,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for (var time = startTime; time <= endTime; time += 86400000) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A utility method that removes a given date from selection..
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _removeDateFromSelection
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date} oDate The date to remove from selection.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Number} [index] An optional parameter that is used
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * to differentiate between individual date selections and multiple
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * date selections.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _removeDateFromSelection : function (oDate, index) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if (index == null) {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A utility method that removes a given list of dates from selection.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _removeDatesFromSelection
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Array} datesArray The list of dates to remove from selection.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai _removeDatesFromSelection : function (datesArray) {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai each(datesArray, this._removeDateDromSelection);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A utility method that removes a given range of dates from selection.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _removeDateRangeFromSelection
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} startDate The first date of the given range.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} endDate The last date of the given range.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai _removeDateRangeFromSelection : function (startDate, endDate) {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai for (var time = startTime; time <= endTime; time += 86400000) {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai this._removeDateFromSelection(new Date(time), time);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A utility method that removes all dates from selection.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _clearSelection
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {boolean} noevent A Boolean specifying whether a selectionChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * event should be fired.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.get("contentBox").all("." + CAL_DAY_SELECTED).removeClass(CAL_DAY_SELECTED);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A utility method that fires a selectionChange event.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _fireSelectionChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * Fired when the set of selected dates changes. Contains a payload with
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * a `newSelection` property with an array of selected dates.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @event selectionChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.fire("selectionChange", {newSelection: this._getSelectedDatesList()});
479b9ac417be02467aadae8cd650d29050001f0bSatyen Desai * A utility method that restores cells modified by custom formatting.
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly * @method _restoreModifiedCells
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly contentbox.one("#" + id).replace(this._storedDateCells[id]);
aa1e03f2af02ffea69e75323bf4fff95cbf736c5Satyen Desai * A rendering assist method that renders all cells modified by the customRenderer
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly * rules, as well as the enabledDatesRule and disabledDatesRule.
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly * @method _renderCustomRules
aa1e03f2af02ffea69e75323bf4fff95cbf736c5Satyen Desai this.get("contentBox").all("." + CAL_DAY + ",." + CAL_NEXTMONTH_DAY).removeClass(SELECTION_DISABLED);
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly for (var paneNum = 0; paneNum < this._paneNumber; paneNum++) {
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly var paneDate = ydate.addMonths(this.get("date"), paneNum);
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly var dateArray = ydate.listOfDatesInMonth(paneDate);
aa1e03f2af02ffea69e75323bf4fff95cbf736c5Satyen Desai var matchingRules = this._getRulesForDate(date);
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly if ((enRule && !(iOf(matchingRules, enRule) >= 0)) ||
609b3fdb3368975ebd66bf9ef6a074e3ca726524Jenny Donnelly (disRule && (iOf(matchingRules, disRule) >= 0))) {
aa1e03f2af02ffea69e75323bf4fff95cbf736c5Satyen Desai this._storedDateCells[dateNode.get("id")] = dateNode.cloneNode(true);
aa1e03f2af02ffea69e75323bf4fff95cbf736c5Satyen Desai this._filterFunction (date, dateNode, matchingRules);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A rendering assist method that renders all cells that are currently selected.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _renderSelectedDates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this.get("contentBox").all("." + CAL_DAY_SELECTED).removeClass(CAL_DAY_SELECTED);
38dc51e07d95d1f02b709139ee7fe8caab01ad61Satyen Desai for (var paneNum = 0; paneNum < this._paneNumber; paneNum++) {
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly var paneDate = ydate.addMonths(this.get("date"), paneNum);
d5daadf7c87a641483741ee68c26b343acb5717cJenny Donnelly var dateArray = this._getSelectedDatesInMonth(paneDate);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._dateToNode(date).addClass(CAL_DAY_SELECTED);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A utility method that converts a date to the node wrapping the calendar cell
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * the date corresponds to..
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _dateToNode
c32ac843533f2b40173501ca749de5d972f101c4Satyen Desai * @param {Date} oDate The date to convert to Node
c32ac843533f2b40173501ca749de5d972f101c4Satyen Desai * @protected
c32ac843533f2b40173501ca749de5d972f101c4Satyen Desai * @return {Node} The node wrapping the DOM element of the cell the date
c32ac843533f2b40173501ca749de5d972f101c4Satyen Desai * corresponds to.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass paneNum = (12 + oDate.getMonth() - this.get("date").getMonth()) % 12,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass cutoffCol = this._paneProperties[paneId].cutoffCol;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass return(this.get("contentBox").one("#" + this._calendarId + "_pane_" + paneNum + "_" + col + "_" + day));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A utility method that converts a node corresponding to the DOM element of
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * the cell for a particular date to that date.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _nodeToDate
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Node} oNode The Node wrapping the DOM element of a particular date cell.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @return {Date} The date corresponding to the DOM element that the given node wraps.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var idParts = oNode.get("id").split("_").reverse(),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var shiftedDate = ydate.addMonths(this.get("date"), paneNum),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A placeholder method, called from bindUI, to bind the Calendar events.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _bindCalendarEvents
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A utility method that normalizes a given date by converting it to the 1st
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * day of the month the date is in, with the time set to noon.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _normalizeDate
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} oDate The date to normalize
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @protected
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @return {Date} The normalized date, set to the first of the month, with time
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * set to noon.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai return new Date(date.getFullYear(), date.getMonth(), 1, 12, 0, 0, 0);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A render assist utility method that computes the cutoff column for the calendar
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * rendering mask.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @method _getCutoffColumn
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Date} date The date of the month grid to compute the cutoff column for.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @param {Number} firstday The first day of the week (modified by internationalized calendars)
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @return {Number} The number of the cutoff column.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var distance = this._normalizeDate(date).getDay() - firstday;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A render assist method that turns on the view of the previous month's dates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * in a given calendar pane.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _turnPrevMonthOn
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Node} pane The calendar pane that needs its previous month's dates view
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane_date = this._paneProperties[pane_id].paneDate,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass daysInPrevMonth = ydate.daysInMonth(ydate.addMonths(pane_date, -1));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if (!this._paneProperties[pane_id].hasOwnProperty("daysInPrevMonth")) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._paneProperties[pane_id].daysInPrevMonth = 0;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass if (daysInPrevMonth != this._paneProperties[pane_id].daysInPrevMonth) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._paneProperties[pane_id].daysInPrevMonth = daysInPrevMonth;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_" + cell + "_" + (cell-5)).setContent(daysInPrevMonth--);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A render assist method that turns off the view of the previous month's dates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * in a given calendar pane.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _turnPrevMonthOff
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Node} pane The calendar pane that needs its previous month's dates view
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._paneProperties[pane_id].daysInPrevMonth = 0;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_" + cell + "_" + (cell-5)).setContent(" ");
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A render assist method that cleans up the last few cells in the month grid
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * when the number of days in the month changes.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _cleanUpNextMonthCells
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Node} pane The calendar pane that needs the last date cells cleaned up.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_6_29").removeClass(CAL_NEXTMONTH_DAY);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_7_30").removeClass(CAL_NEXTMONTH_DAY);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_8_31").removeClass(CAL_NEXTMONTH_DAY);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_0_30").removeClass(CAL_NEXTMONTH_DAY);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_1_31").removeClass(CAL_NEXTMONTH_DAY);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A render assist method that turns on the view of the next month's dates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * in a given calendar pane.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _turnNextMonthOn
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Node} pane The calendar pane that needs its next month's dates view
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass daysInMonth = this._paneProperties[pane_id].daysInMonth,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass cutoffCol = this._paneProperties[pane_id].cutoffCol;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for (var cell = daysInMonth - 22; cell < cutoffCol + 7; cell++)
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_" + cell + "_" + (cell+23)).setContent(dayCounter++).addClass(CAL_NEXTMONTH_DAY);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass for (var cell = startingCell ; cell < cutoffCol + 7; cell++) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass pane.one("#" + pane_id + "_" + cell + "_" + (cell+30)).setContent(dayCounter++).addClass(CAL_NEXTMONTH_DAY);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * A render assist method that turns off the view of the next month's dates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * in a given calendar pane.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _turnNextMonthOff
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Node} pane The calendar pane that needs its next month's dates view
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai * @protected
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass daysInMonth = this._paneProperties[pane_id].daysInMonth,
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai cutoffCol = this._paneProperties[pane_id].cutoffCol;
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai for (var cell = daysInMonth - 22; cell <= 12; cell++)
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai pane.one("#" + pane_id + "_" + cell + "_" + (cell+23)).setContent(" ").addClass(CAL_NEXTMONTH_DAY);
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai else if (daysInMonth == 30 && cutoffCol == 0) {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai for (var cell = startingCell ; cell <= 12; cell++) {
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai pane.one("#" + pane_id + "_" + cell + "_" + (cell+30)).setContent(" ").addClass(CAL_NEXTMONTH_DAY);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The handler for the change in the showNextMonth attribute.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterShowNextMonthChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass lastPane = contentBox.one("#" + this._calendarId + "_pane_" + (this._paneNumber - 1));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The handler for the change in the showPrevMonth attribute.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterShowPrevMonthChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass firstPane = contentBox.one("#" + this._calendarId + "_pane_" + 0);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The handler for the change in the headerRenderer attribute.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterHeaderRendererChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var headerCell = this.get('contentBox').one("." + CAL_HD).one("h4");
10d8bafc5c24f3a4285cf6060a1935ba5cfc4b85Luke Smith headerCell.setContent(this._updateCalendarHeader(this.get('date')));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The handler for the change in the customRenderer attribute.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterCustomRendererChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * The handler for the change in the date attribute. Modifies the calendar
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * view by shifting the calendar grid mask and running custom rendering and
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * selection rendering as necessary.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _afterDateChange
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass _afterDateChange : function () {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass headerCell = contentBox.one("." + CAL_HD).one("h4"),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass headerCell.setContent(this._updateCalendarHeader(currentDate));
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass this._rerenderCalendarPane(ydate.addMonths(currentDate, counter++),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A rendering assist method that initializes the HTML for a single
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * calendar pane.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @method _initCalendarPane
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date} baseDate The date corresponding to the month of the given
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * calendar pane.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {String} pane_id The id of the pane, to be used as a prefix for
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * element ids in the given pane.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai _initCalendarPane : function (baseDate, pane_id) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Initialize final output HTML string
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Get a list of short weekdays from the internationalization package, or else use default English ones.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass weekdays = this.get('strings.very_short_weekdays') || ["Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"],
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Get the first day of the week from the internationalization package, or else use Sunday as default.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass firstday = this.get('strings.first_weekday') || 0,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Compute the cutoff column of the masked calendar table, based on the start date and the first day of week.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass cutoffCol = this._getCutoffColumn(baseDate, firstday),
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Compute the number of days in the month based on starting date
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai // Initialize the array of individual row HTML strings
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai // Initialize the partial templates object
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai // Initialize the partial template for the weekday row cells.
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai // Populate the partial template for the weekday row cells with weekday names
6bb97cfdea627b5bb0523ad4e6d2623c5fbf6954Satyen Desai for (var day = firstday; day <= firstday + 6; day++) {
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Populate the partial template for the weekday row container with the weekday row cells
10d8bafc5c24f3a4285cf6060a1935ba5cfc4b85Luke Smith partials["weekday_row_template"] = substitute(CalendarBase.WEEKDAY_ROW_TEMPLATE, partials);
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Populate the array of individual row HTML strings
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Compute the value of the date that needs to populate the cell
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Compose the value of the unique id of the current calendar cell
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var id_date = pane_id + "_" + column + "_" + date;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Set the calendar day class to one of three possible values
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Cut off dates that fall before the first and after the last date of the month
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Decide on whether a column in the masked table is visible or not based on the value of the cutoff column.
10d8bafc5c24f3a4285cf6060a1935ba5cfc4b85Luke Smith var column_visibility = (column >= cutoffCol && column < (cutoffCol + 7)) ? '' : CAL_COL_HIDDEN;
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Substitute the values into the partial calendar day template and add it to the current row HTML string
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass row_array[row] += substitute (CalendarBase.CALDAY_TEMPLATE,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Instantiate the partial calendar pane body template
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Populate the body template with the rows templates
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass partials["body_template"] += substitute(CalendarBase.CALDAY_ROW_TEMPLATE,
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Populate the calendar grid id
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass // Generate final output by substituting class names.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass var output = substitute(substitute (CalendarBase.CALENDAR_GRID_TEMPLATE, partials),
10d8bafc5c24f3a4285cf6060a1935ba5cfc4b85Luke Smith // Store the initialized pane information
d8d2286d8330892bb02eb2bf0735322f559ef5efSatyen Desai this._paneProperties[pane_id] = {cutoffCol: cutoffCol, daysInMonth: daysInMonth, paneDate: baseDate};
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * A rendering assist method that rerenders a specified calendar pane, based
d8d2286d8330892bb02eb2bf0735322f559ef5efSatyen Desai * on a new Date.
d8d2286d8330892bb02eb2bf0735322f559ef5efSatyen Desai * @method _rerenderCalendarPane
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Date} newDate The date corresponding to the month of the given
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * calendar pane.
76ca635d61eb3f9fb7c9d788a44fa8b1690aa138Dav Glass * @param {Node} pane The node corresponding to the calendar pane to be rerenders.
// Get the first day of the week from the internationalization package, or else use Sunday as default.
// Compute the cutoff column of the masked calendar table, based on the start date and the first day of week.
// Go through all columns, and flip their visibility setting based on whether they are within the unmasked range.
switch(column)
else if (headerRenderer instanceof Function) {
return headerString;
var partials = {},
function paneReplacer () {
var singlePane = this._initCalendarPane(ydate.addMonths(baseDate, counter), partials["calendar_id"]+"_pane_"+counter);
counter++;
return singlePane;
// Go through all occurrences of the calendar_grid_template token and replace it with an appropriate calendar grid.
var output = partials["body_template"].replace(/\{calendar_grid_template\}/g, Y.bind(paneReplacer, this));
return output;
CALDAY_TEMPLATE: '<td class="{calendar_col_class} {calendar_day_class} {calendar_col_visibility_class}" id="{calendar_day_id}">' +
ATTRS: {
date: {
value: new Date(),
value: false
value: false
strings : {
value: null
value: null
selectedDates : {
readOnly: true,
return (this._getSelectedDatesList());
customRenderer : {
value: {},