AUI.add('aui-calendar-datepicker-select', function(A) {
/**
* The DatePickerSelect Utility
*
* @module aui-calendar
* @submodule aui-calendar-datepicker-select
*/
var L = A.Lang,
isArray = L.isArray,
nodeSetter = function(v) {
return A.one(v);
},
createSelect = function() {
return A.Node.create(SELECT_TPL);
},
APPEND_ORDER = 'appendOrder',
BASE_NAME = 'baseName',
BLANK = '',
BODY = 'body',
BOUNDING_BOX = 'boundingBox',
BUTTON = 'button',
BUTTONITEM = 'buttonitem',
BUTTON_NODE = 'buttonNode',
CALENDAR = 'calendar',
CLEARFIX = 'clearfix',
CURRENT_DAY = 'currentDay',
CURRENT_MONTH = 'currentMonth',
CURRENT_YEAR = 'currentYear',
DATA_COMPONENT_ID = 'data-auiComponentID',
DATEPICKER = 'datepicker',
DATE_FORMAT = 'dateFormat',
DAY = 'day',
DAY_NODE = 'dayNode',
DAY_NODE_NAME = 'dayNodeName',
DISPLAY = 'display',
DOT = '.',
HELPER = 'helper',
MAX_DATE = 'maxDate',
MIN_DATE = 'minDate',
MONTH = 'month',
MONTH_NODE = 'monthNode',
MONTH_NODE_NAME = 'monthNodeName',
NAME = 'name',
OPTION = 'option',
POPULATE_DAY = 'populateDay',
POPULATE_MONTH = 'populateMonth',
POPULATE_YEAR = 'populateYear',
SELECT = 'select',
SELECTED = 'selected',
SELECT_WRAPPER_NODE = 'selectWrapperNode',
SPACE = ' ',
SRC_NODE = 'srcNode',
TRIGGER = 'trigger',
WRAPPER = 'wrapper',
YEAR = 'year',
YEAR_NODE = 'yearNode',
YEAR_NODE_NAME = 'yearNodeName',
YEAR_RANGE = 'yearRange',
getCN = A.ClassNameManager.getClassName,
CSS_BUTTONITEM = getCN(BUTTONITEM),
CSS_DATEPICKER = getCN(DATEPICKER),
CSS_DATEPICKER_BUTTON_WRAPPER = getCN(DATEPICKER, BUTTON, WRAPPER),
CSS_DATEPICKER_DAY = getCN(DATEPICKER, DAY),
CSS_DATEPICKER_DISPLAY = getCN(DATEPICKER, DISPLAY),
CSS_DATEPICKER_MONTH = getCN(DATEPICKER, MONTH),
CSS_DATEPICKER_SELECT_WRAPPER = getCN(DATEPICKER, SELECT, WRAPPER),
CSS_DATEPICKER_YEAR = getCN(DATEPICKER, YEAR),
CSS_HELPER_CLEARFIX = getCN(HELPER, CLEARFIX),
SELECT_TPL = '<select></select>',
SELECT_OPTION_TPL = '<option></option>',
SRC_NODE_TPL = '<div></div>',
WRAPPER_BUTTON_TPL = '<div class="'+ CSS_DATEPICKER_BUTTON_WRAPPER +'"></div>',
WRAPPER_SELECT_TPL = '<div class='+ CSS_DATEPICKER_SELECT_WRAPPER +'></div>';
/**
* <p><img src="assets/images/aui-calendar-datepicker-select/main.png"/></p>
*
* A base class for DatePickerSelect, providing:
* <ul>
* <li>Widget Lifecycle (initializer, renderUI, bindUI, syncUI, destructor)</li>
* <li>Select a date from Calendar to select elements</li>
* </ul>
*
* Quick Example:<br/>
*
* <pre><code>var instance = new A.DatePickerSelect({
* srcNode: '#srcNodeId',
* // locale: 'pt-br',
* dateFormat: '%m/%d/%y',
* yearRange: [ 1970, 2009 ]
* }).render();
* </code></pre>
*
* Check the list of <a href="DatePickerSelect.html#configattributes">Configuration Attributes</a> available for
* DatePickerSelect.
*
* @class DatePickerSelect
* @param config {Object} Object literal specifying widget configuration properties.
* @constructor
* @extends Calendar
*/
var DatePickerSelect = A.Component.create(
{
/**
* Static property provides a string to identify the class.
*
* @property DatePickerSelect.NAME
* @type String
* @static
*/
NAME: DATEPICKER,
/**
* Static property used to define the default attribute
* configuration for the DatePickerSelect.
*
* @property DatePickerSelect.ATTRS
* @type Object
* @static
*/
ATTRS: {
/**
* The order the selects elements are appended to the
* <a href="DatePickerSelect.html#config_srcNode">srcNode</a>.
*
* @attribute appendOrder
* @default [ 'm', 'd', 'y' ]
* @type Array
*/
appendOrder: {
value: [ 'm', 'd', 'y' ],
validator: isArray
},
/**
* A basename to identify the select elements from this
* DatePickerSelect.
*
* @attribute baseName
* @default datepicker
* @type String
*/
baseName: {
value: DATEPICKER
},
/**
* DOM Node to display the button of the DatePickerSelect. If not
* specified try to query using HTML_PARSER an element inside
* contentBox which matches <code>aui-buttonitem</code>.
*
* @attribute buttonNode
* @default Generated div element.
* @type String
*/
buttonNode: {},
/**
* DOM Node to display the day of the DatePickerSelect. If not
* specified try to query using HTML_PARSER an element inside
* contentBox which matches <code>aui-datepicker-year</code>.
*
* @attribute dayNode
* @default Generated div element.
* @type String | Node
*/
dayNode: {
setter: nodeSetter,
valueFn: createSelect
},
/**
* DOM Node to display the month of the DatePickerSelect. If not
* specified try to query using HTML_PARSER an element inside
* contentBox which matches <code>aui-datepicker-year</code>.
*
* @attribute monthNode
* @default Generated div element.
* @type String | Node
*/
monthNode: {
setter: nodeSetter,
valueFn: createSelect
},
/**
* DOM Node to display the year of the DatePickerSelect. If not
* specified try to query using HTML_PARSER an element inside
* contentBox which matches <code>aui-datepicker-year</code>.
*
* @attribute yearNode
* @default Generated div element.
* @type String | Node
*/
yearNode: {
setter: nodeSetter,
valueFn: createSelect
},
/**
* Name attribute used on the
* <a href="DatePickerSelect.html#config_dayNode">dayNode</a>.
*
* @attribute dayNodeName
* @default day
* @type String
*/
dayNodeName: {
valueFn: function() {
return this.get(DAY_NODE).get(NAME) || DAY;
}
},
/**
* Name attribute used on the
* <a href="DatePickerSelect.html#config_monthNode">monthNode</a>.
*
* @attribute monthNodeName
* @default month
* @type String
*/
monthNodeName: {
valueFn: function() {
return this.get(MONTH_NODE).get(NAME) || MONTH;
}
},
/**
* DOM Node to display the selects of the DatePickerSelect. If not
* specified try to query using HTML_PARSER an element inside
* contentBox which matches <code>aui-datepicker-select-wrapper</code>.
*
* @attribute selectWrapperNode
* @default Generated div element.
* @type String
*/
selectWrapperNode: {
valueFn: function() {
return A.Node.create(WRAPPER_SELECT_TPL);
}
},
/**
* Name attribute used on the
* <a href="DatePickerSelect.html#config_yearNode">yearNode</a>.
*
* @attribute yearNodeName
* @default year
* @type String
*/
yearNodeName: {
valueFn: function() {
return this.get(YEAR_NODE).get(NAME) || YEAR;
}
},
/**
* Trigger element to open the calendar. Inherited from
* <a href="OverlayContext.html#config_trigger">OverlayContext</a>.
*
* @attribute trigger
* @default Generated HTLM div element
* @type {Node | String}
*/
trigger: {
valueFn: function() {
return A.Node.create(WRAPPER_BUTTON_TPL);
}
},
/**
* If true the Calendar is visible by default after the render phase.
* Inherited from
* <a href="OverlayContext.html#config_trigger">OverlayContext</a>.
*
* @attribute visible
* @default false
* @type boolean
*/
visible: {
value: false
},
/**
* Year range to be displayed on the year select element. By default
* it displays from -10 to +10 years from the current year.
*
* @attribute yearRange
* @default [ year - 10, year + 10 ]
* @type Array
*/
yearRange: {
valueFn: function() {
var year = new Date().getFullYear();
return [ year - 10, year + 10 ];
},
validator: isArray
},
/**
* Inherited from
* <a href="Calendar.html#config_setValue">Calendar</a>.
*
* @attribute setValue
* @default false
* @type boolean
*/
setValue: {
value: false
},
srcNode: {
valueFn: function() {
var srcNode = A.Node.create(SRC_NODE_TPL);
A.one(BODY).append(srcNode);
return srcNode;
}
},
/**
* If true the select element for the days will be automatic
* populated.
*
* @attribute populateDay
* @default true
* @type boolean
*/
populateDay: {
value: true
},
/**
* If true the select element for the month will be automatic
* populated.
*
* @attribute populateMonth
* @default true
* @type boolean
*/
populateMonth: {
value: true
},
/**
* If true the select element for the year will be automatic
* populated.
*
* @attribute populateYear
* @default true
* @type boolean
*/
populateYear: {
value: true
}
},
/**
* Object hash, defining how attribute values are to be parsed from
* markup contained in the widget's content box.
*
* @property DatePickerSelect.HTML_PARSER
* @type Object
* @static
*/
HTML_PARSER: {
buttonNode: DOT+CSS_BUTTONITEM,
dayNode: DOT+CSS_DATEPICKER_DAY,
monthNode: DOT+CSS_DATEPICKER_MONTH,
selectWrapperNode: DOT+CSS_DATEPICKER_SELECT_WRAPPER,
trigger: DOT+CSS_DATEPICKER_BUTTON_WRAPPER,
yearNode: DOT+CSS_DATEPICKER_YEAR
},
EXTENDS: A.Calendar,
prototype: {
/**
* Create the DOM structure for the DatePickerSelect. Lifecycle.
*
* @method renderUI
* @protected
*/
renderUI: function() {
var instance = this;
DatePickerSelect.superclass.renderUI.apply(this, arguments);
instance._renderElements();
instance._renderTriggerButton();
},
/**
* Bind the events on the DatePickerSelect UI. Lifecycle.
*
* @method bindUI
* @protected
*/
bindUI: function() {
var instance = this;
DatePickerSelect.superclass.bindUI.apply(this, arguments);
instance.after('datesChange', instance._selectCurrentValues);
instance.after('currentMonthChange', instance._afterSetCurrentMonth);
instance.after('disabledChange', instance._afterDisabledChangeDatePicker);
instance._bindSelectEvents();
},
/**
* Sync the DatePickerSelect UI. Lifecycle.
*
* @method syncUI
* @protected
*/
syncUI: function() {
var instance = this;
DatePickerSelect.superclass.syncUI.apply(this, arguments);
instance._pupulateSelects();
instance._selectCurrentValues();
},
/**
* Fired after
* <a href="DatePickerSelect.html#config_disabled">disabled</a> is set.
*
* @method _afterDisabledChangeDatePicker
* @param {EventFacade} event
* @protected
*/
_afterDisabledChangeDatePicker: function(event) {
var instance = this;
var disabled = event.newVal;
instance.get(DAY_NODE).set('disabled', disabled);
instance.get(MONTH_NODE).set('disabled', disabled);
instance.get(YEAR_NODE).set('disabled', disabled);
},
/*
* Override the default content box value, since we don't want the srcNode
* to be the content box for DatePickerSelect.
*/
_defaultCB: function() {
return null;
},
/**
* Gets an Array with the field elements in the correct order defined
* on <a href="DatePickerSelect.html#config_appendOrder">appendOrder</a>.
*
* @method _getAppendOrder
* @protected
* @return {Array}
*/
_getAppendOrder: function() {
var instance = this;
var appendOrder = instance.get(APPEND_ORDER);
var mapping = {
d: instance.get(DAY_NODE),
m: instance.get(MONTH_NODE),
y: instance.get(YEAR_NODE)
};
var firstField = mapping[ appendOrder[0] ];
var secondField = mapping[ appendOrder[1] ];
var thirdField = mapping[ appendOrder[2] ];
var id = instance.get('id');
firstField.setAttribute(DATA_COMPONENT_ID, id);
secondField.setAttribute(DATA_COMPONENT_ID, id);
thirdField.setAttribute(DATA_COMPONENT_ID, id);
return [ firstField, secondField, thirdField ];
},
/**
* Render DOM elements for the DatePickerSelect.
*
* @method _renderElements
* @protected
*/
_renderElements: function() {
var instance = this;
var boundingBox = instance.get(BOUNDING_BOX);
var srcNode = instance.get(SRC_NODE);
// re-insert srcNode back into the DOM, it was replaced in _renderBox Widget method
boundingBox.placeAfter(srcNode);
var dayNode = instance.get(DAY_NODE);
var monthNode = instance.get(MONTH_NODE);
var yearNode = instance.get(YEAR_NODE);
dayNode.addClass(CSS_DATEPICKER_DAY);
monthNode.addClass(CSS_DATEPICKER_MONTH);
yearNode.addClass(CSS_DATEPICKER_YEAR);
srcNode.addClass(CSS_DATEPICKER);
srcNode.addClass(CSS_DATEPICKER_DISPLAY);
srcNode.addClass(CSS_HELPER_CLEARFIX);
// setting name of the fields
monthNode.set(NAME, instance.get(MONTH_NODE_NAME));
yearNode.set(NAME, instance.get(YEAR_NODE_NAME));
dayNode.set(NAME, instance.get(DAY_NODE_NAME));
// append elements
var selectWrapper = instance.get(SELECT_WRAPPER_NODE);
var orderedFields = instance._getAppendOrder();
// this textNode is to prevent layout shifting only
// simulate the default browser space between inputs/selects on re-append
var textNode = A.one(
document.createTextNode(SPACE)
);
selectWrapper.append(orderedFields[0]);
selectWrapper.append( textNode.clone() );
selectWrapper.append(orderedFields[1]);
selectWrapper.append( textNode );
selectWrapper.append(orderedFields[2]);
srcNode.append( selectWrapper );
},
/**
* Render DOM element for the trigger button of the DatePickerSelect.
*
* @method _renderTriggerButton
* @protected
*/
_renderTriggerButton: function() {
var instance = this;
var trigger = instance.get(TRIGGER).item(0);
var srcNode = instance.get(SRC_NODE);
instance._buttonItem = new A.ButtonItem({
boundingBox: instance.get(BUTTON_NODE),
icon: CALENDAR
});
srcNode.append(trigger);
trigger.setAttribute(DATA_COMPONENT_ID, instance.get('id'));
if ( trigger.test(DOT+CSS_DATEPICKER_BUTTON_WRAPPER) ) {
// use Button if the user doesn't specify a trigger
instance._buttonItem.render(trigger);
}
},
/**
* Bind events on each select element (change, keypress, etc).
*
* @method _bindSelectEvents
* @protected
*/
_bindSelectEvents: function() {
var instance = this;
var selects = instance.get(SELECT_WRAPPER_NODE).all(SELECT);
selects.on('change', A.bind(instance._onSelectChange, instance));
selects.on('keypress', A.bind(instance._onSelectChange, instance));
},
/**
* Select the current values for the day, month and year to the respective
* input field.
*
* @method _selectCurrentValues
* @protected
*/
_selectCurrentValues: function() {
var instance = this;
instance._selectCurrentDay();
instance._selectCurrentMonth();
instance._selectCurrentYear();
},
/**
* Select the current day on the respective input field.
*
* @method _selectCurrentDay
* @protected
*/
_selectCurrentDay: function() {
var instance = this;
var currentDate = instance.getCurrentDate();
instance.get(DAY_NODE).val(
String(currentDate.getDate())
);
},
/**
* Select the current month on the respective input field.
*
* @method _selectCurrentMonth
* @protected
*/
_selectCurrentMonth: function() {
var instance = this;
var currentDate = instance.getCurrentDate();
instance.get(MONTH_NODE).val(
String(currentDate.getMonth())
);
},
/**
* Select the current year on the respective input field.
*
* @method _selectCurrentYear
* @protected
*/
_selectCurrentYear: function() {
var instance = this;
var currentDate = instance.getCurrentDate();
instance.get(YEAR_NODE).val(
String(currentDate.getFullYear())
);
},
/**
* Populate each select element with the correct data for the day, month
* and year.
*
* @method _pupulateSelects
* @protected
*/
_pupulateSelects: function() {
var instance = this;
instance._populateDays();
instance._populateMonths();
instance._populateYears();
// restricting dates based on the selects values
var monthOptions = instance.get(MONTH_NODE).all(OPTION);
var yearOptions = instance.get(YEAR_NODE).all(OPTION);
var mLength = monthOptions.size() - 1;
var yLength = yearOptions.size() - 1;
var firstMonth = monthOptions.item(0).val();
var firstYear = yearOptions.item(0).val();
var lastMonth = monthOptions.item(mLength).val();
var lastYear = yearOptions.item(yLength).val();
var maxMonthDays = instance.getDaysInMonth(lastYear, lastMonth);
var minDate = new Date(firstYear, firstMonth, 1);
var maxDate = new Date(lastYear, lastMonth, maxMonthDays);
instance.set(MAX_DATE, maxDate);
instance.set(MIN_DATE, minDate);
},
/**
* Populate the year select element with the correct data.
*
* @method _populateYears
* @protected
*/
_populateYears: function() {
var instance = this;
var yearRange = instance.get(YEAR_RANGE);
var yearNode = instance.get(YEAR_NODE);
if (instance.get(POPULATE_YEAR)) {
instance._populateSelect(yearNode, yearRange[0], yearRange[1]);
}
},
/**
* Populate the month select element with the correct data.
*
* @method _populateMonths
* @protected
*/
_populateMonths: function() {
var instance = this;
var monthNode = instance.get(MONTH_NODE);
var localeMap = instance._getLocaleMap();
var monthLabels = localeMap.B;
if (instance.get(POPULATE_MONTH)) {
instance._populateSelect(monthNode, 0, (monthLabels.length - 1), monthLabels);
}
},
/**
* Populate the day select element with the correct data.
*
* @method _populateDays
* @protected
*/
_populateDays: function() {
var instance = this;
var dayNode = instance.get(DAY_NODE);
var daysInMonth = instance.getDaysInMonth();
if (instance.get(POPULATE_DAY)) {
instance._populateSelect(dayNode, 1, daysInMonth);
}
},
/**
* Populate a select element with the data passed on the params.
*
* @method _populateSelect
* @param {HTMLSelectElement} select Select to be populated
* @param {Number} fromIndex Index to start
* @param {Number} toIndex Index to end
* @param {Object} values Object with labels to be used as content of each
* option. Optional.
* @protected
* @return {String}
*/
_populateSelect: function(select, fromIndex, toIndex, labels, values) {
var i = 0;
var index = fromIndex;
select.empty();
labels = labels || [];
values = values || [];
while (index <= toIndex) {
var value = values[index] || index;
var label = labels[index] || index;
A.Node.getDOMNode(select).options[i] = new Option(label, index);
i++;
index++;
}
},
/**
* Fired on any select change.
*
* @method _onSelectChange
* @param {EventFacade} event
* @protected
*/
_onSelectChange: function(event) {
var instance = this;
var target = event.currentTarget || event.target;
var monthChanged = target.test(DOT+CSS_DATEPICKER_MONTH);
var currentDay = instance.get(DAY_NODE).val();
var currentMonth = instance.get(MONTH_NODE).val();
var currentYear = instance.get(YEAR_NODE).val();
instance.set(CURRENT_DAY, currentDay);
instance.set(CURRENT_MONTH, currentMonth);
instance.set(CURRENT_YEAR, currentYear);
if (monthChanged) {
instance._afterSetCurrentMonth();
}
instance._selectDate();
},
/**
* Fired after
* <a href="DatePickerSelect.html#config_currentMonth">currentMonth</a> is set.
*
* @method _afterSetCurrentMonth
* @param {EventFacade} event
* @protected
*/
_afterSetCurrentMonth: function(event) {
var instance = this;
instance._populateDays();
instance._selectCurrentDay();
}
}
}
);
A.DatePickerSelect = DatePickerSelect;
}, '@VERSION@' ,{requires:['aui-calendar-base','aui-button-item'], skinnable:true});