- - - -

- -

- - - - -

Roo.util.Observable
-Roo.Component
-Roo.DatePicker 
-
-

- - - - -

- - Class Roo.DatePicker -

- - - - - - - - - - - - - - -

Package:	Roo
Defined In:	- - Roo/DatePicker.js. - -
Class:	DatePicker
Extends:	- Roo.Component - -

- - - -

- Simple date picker class. -

- - - - -

- Class Comments / Notes => - [Add Your comment/notes about this class] -
- -

- - - - - - - - -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Config Options (Usually are also Properties)
Options		Defined By
	- - - - actionMode : String - - - - - - which property holds the element that used for hide() / show() / disable() / enable() default is 'el' - - - - - which property holds the element that used for hide() / show() / disable() / enable() default is 'el' - - - - - - -	- - Roo.Component - -
	- - - - allowDomMove : Boolean - - - - - - Whether the component can move the Dom node when rendering (defaults to true). - - - - - Whether the component can move the Dom node when rendering (defaults to true). - - - - - - -	- - Roo.Component - -
	- - - - cancelText : String - - - - - - The text to display on the cancel button - - - - - The text to display on the cancel button - - - - - - -	- - Roo.DatePicker - -
	- - - - constrainToViewport : Boolean - - - - - - True to constrain the date picker to the viewport (defaults to true) - - - - - True to constrain the date picker to the viewport (defaults to true) - - - - - - -	- - Roo.DatePicker - -
	- - - - dayNames : Array - - - - - - An array of textual day names which can be overriden for localization support (defaults to Date.dayNames) - - - - - An array of textual day names which can be overriden for localization support (defaults to Date.dayNames) - - - - - - -	- - Roo.DatePicker - -
	- - - - disableClass : String - - - - - - CSS class added to the component when it is disabled (defaults to "x-item-disabled"). - - - - - CSS class added to the component when it is disabled (defaults to "x-item-disabled"). - - - - - - -	- - Roo.Component - -
	- - - - disabledDatesRE : RegExp - - - - - - JavaScript regular expression used to disable a pattern of dates (defaults to null) - - - - - JavaScript regular expression used to disable a pattern of dates (defaults to null) - - - - - - -	- - Roo.DatePicker - -
	- - - - disabledDatesText : String - - - - - - The tooltip text to display when the date falls on a disabled date (defaults to "") - - - - - The tooltip text to display when the date falls on a disabled date (defaults to "") - - - - - - -	- - Roo.DatePicker - -
	- - - - disabledDays : Array - - - - - - An array of days to disable, 0-based. - - - - - An array of days to disable, 0-based. For example, [0, 6] disables Sunday and Saturday (defaults to null). - - - - - - -	- - Roo.DatePicker - -
	- - - - disabledDaysText : String - - - - - - The tooltip to display when the date falls on a disabled day (defaults to "") - - - - - The tooltip to display when the date falls on a disabled day (defaults to "") - - - - - - -	- - Roo.DatePicker - -
	- - - - format : String - - - - - - The default date format string which can be overriden for localization support. - - - - - The default date format string which can be overriden for localization support. The format must be valid according to {link DateparseDate} (defaults to 'm/d/y'). - - - - - - -	- - Roo.DatePicker - -
	- - - - hideMode : String - - - - - - How this component should hidden. - - - - - How this component should hidden. Supported values are "visibility" (css visibility), "offsets" (negative offset position) and "display" (css display) - defaults to "display". - Possible Values: display, visibility - - - - - -	- - Roo.Component - -
	- - - - listeners : Object - - - - - - list of events and functions to call for this object, For example : `listeners : { 'click' : function(e) { .` `-` `- - - - list of events and functions to call for this object, For example : listeners : { 'click' : function(e) { ..... } , .... } - - - - - - -`	- - Roo.util.Observable - -
	- - - - maxDate : Date - - - - - - Maximum allowable date (JavaScript date object, defaults to null) - - - - - Maximum allowable date (JavaScript date object, defaults to null) - - - - - - -	- - Roo.DatePicker - -
	- - - - maxText : String - - - - - - The error text to display if the maxDate validation fails (defaults to "This date is after the maximum date") - - - - - The error text to display if the maxDate validation fails (defaults to "This date is after the maximum date") - - - - - - -	- - Roo.DatePicker - -
	- - - - minDate : Date - - - - - - Minimum allowable date (JavaScript date object, defaults to null) - - - - - Minimum allowable date (JavaScript date object, defaults to null) - - - - - - -	- - Roo.DatePicker - -
	- - - - minText : String - - - - - - The error text to display if the minDate validation fails (defaults to "This date is before the minimum date") - - - - - The error text to display if the minDate validation fails (defaults to "This date is before the minimum date") - - - - - - -	- - Roo.DatePicker - -
	- - - - monthNames : Array - - - - - - An array of textual month names which can be overriden for localization support (defaults to Date.monthNames) - - - - - An array of textual month names which can be overriden for localization support (defaults to Date.monthNames) - - - - - - -	- - Roo.DatePicker - -
	- - - - monthYearText : String - - - - - - The header month selector tooltip (defaults to 'Choose a month (Control+Up/Down to move years)') - - - - - The header month selector tooltip (defaults to 'Choose a month (Control+Up/Down to move years)') - - - - - - -	- - Roo.DatePicker - -
	- - - - nextText : String - - - - - - The next month navigation button tooltip (defaults to 'Next Month (Control+Right)') - - - - - The next month navigation button tooltip (defaults to 'Next Month (Control+Right)') - - - - - - -	- - Roo.DatePicker - -
	- - - - okText : String - - - - - - The text to display on the ok button - - - - - The text to display on the ok button - - - - - - -	- - Roo.DatePicker - -
	- - - - prevText : String - - - - - - The previous month navigation button tooltip (defaults to 'Previous Month (Control+Left)') - - - - - The previous month navigation button tooltip (defaults to 'Previous Month (Control+Left)') - - - - - - -	- - Roo.DatePicker - -
	- - - - showClear : Bool - - - - - - Show a clear button (usefull for date form elements that can be blank. - - - - - Show a clear button (usefull for date form elements that can be blank.) - - - - - - -	- - Roo.DatePicker - -
	- - - - startDay : Number - - - - - - Day index at which the week should begin, 0-based (defaults to 0, which is Sunday) - - - - - Day index at which the week should begin, 0-based (defaults to 0, which is Sunday) - - - - - - -	- - Roo.DatePicker - -
	- - - - todayText : String - - - - - - The text to display on the button that selects the current date (defaults to "Today") - - - - - The text to display on the button that selects the current date (defaults to "Today") - - - - - - -	- - Roo.DatePicker - -
	- - - - todayTip : String - - - - - - The tooltip to display for the button that selects the current date (defaults to "{current date} (Spacebar)") - - - - - The tooltip to display for the button that selects the current date (defaults to "{current date} (Spacebar)") - - - - - - -	- - Roo.DatePicker - -

- - - - - - - - - - - - - - - - - - - - - -

Public Methods
Method		Defined By
	- - - new Roo.DatePicker - - (Object *config) - - - - - - - - Create a new Roo.DatePicker - - - - - - - Create a new Roo.DatePicker - - - - Parameters: - - - Object config* - - - The config object - - - - - - - - - - - - - - - - -	- -
	- - - addEvents - - (Object *object) - - - - - - - Used to define events on this Observable - - - - - - Used to define events on this Observable - - - - - - - - Parameters: - - - Object object* - - - The object with the events defined - - - - - - - - - - - - - - - - -	- - Roo.util.Observable - -
	- - - addListener - - (String *eventName, Function handler, Object scope, Object options) - - - - - - - Appends an event handler to this component - - - - - - Appends an event handler to this component - - - - - - - - Parameters: - - - String eventName* - - - The type of event to listen for - - - Function handler - - - The method the event invokes - - - Object scope - - - (optional) The scope in which to execute the handler function. The handler function's "this" context. - - - Object options - - - (optional) An object containing handler configuration properties. This may contain any of the following properties: scope {Object} The scope in which to execute the handler function. The handler function's "this" context. delay {Number} The number of milliseconds to delay the invocation of the handler after te event fires. single {Boolean} True to add a handler to handle just the next firing of the event, and then remove itself. buffer {Number} Causes the handler to be scheduled to run in an {link Roo.util.DelayedTask} delayed by the specified number of milliseconds. If the event fires again within that time, the original handler is not invoked, but the new handler is scheduled in its place. Combining Options Using the options argument, it is possible to combine different types of listeners: A normalized, delayed, one-time listener that auto stops the event and passes a custom argument (forumId) `el.on('click', this.onClick, this, { single: true, delay: 100, forumId: 4 });` Attaching multiple handlers in 1 call The method also allows for a single argument to be passed which is a config object containing properties which specify multiple handlers. `el.on({ 'click': { fn: this.onClick, scope: this, delay: 100 }, 'mouseover': { fn: this.onMouseOver, scope: this }, 'mouseout': { fn: this.onMouseOut, scope: this } });` Or a shorthand syntax which passes the same scope object to all handlers: `el.on({ 'click': this.onClick, 'mouseover': this.onMouseOver, 'mouseout': this.onMouseOut, scope: this });` - - - - - - - - - - - - - - - - -	- - Roo.util.Observable - -
	- - - destroy - - () - - - - - - - Destroys this component by purging any event listeners, removing the component's element from the DOM, removing the component from its {link Roo.Container} (if applicable) and unregistering it from {link Roo.ComponentMgr}. - - - - - - Destroys this component by purging any event listeners, removing the component's element from the DOM, removing the component from its {link Roo.Container} (if applicable) and unregistering it from {link Roo.ComponentMgr}. - - - - - - - - - - - - - - - - - - - -	- - Roo.Component - -
	- - - disable - - () - - - : - - - Roo.Component - - - - - - - - - Disable this component. - - - - - - Disable this component. - - - - - - - - - - - - Returns: - - Roo.Component this - - - - - - - - - - - - -	- - Roo.Component - -
	- - - enable - - () - - - : - - - Roo.Component - - - - - - - - - Enable this component. - - - - - - Enable this component. - - - - - - - - - - - - Returns: - - Roo.Component this - - - - - - - - - - - - -	- - Roo.Component - -
	- - - fireEvent - - (String *eventName, Object... args) - - - : - - - Boolean - - - - - - - - - Fires the specified event with the passed parameters (minus the event name). - - - - - - Fires the specified event with the passed parameters (minus the event name). - - - - - - - - Parameters: - - - String eventName* - - - - - - Object... args - - - Variable number of parameters are passed to handlers - - - - - - - - - Returns: - - Boolean returns false if any of the handlers return false otherwise it returns true - - - - - - - - - - - - -	- - Roo.util.Observable - -
	- - - focus - - (Boolean *selectText) - - - : - - - Roo.Component - - - - - - - - - Try to focus this component. - - - - - - Try to focus this component. - - - - - - - - Parameters: - - - Boolean selectText* - - - True to also select the text in this component (if applicable) - - - - - - - - - Returns: - - Roo.Component this - - - - - - - - - - - - -	- - Roo.Component - -
	- - - getEl - - () - - - : - - - Roo.Element - - - - - - - - - Returns the underlying {link Roo.Element}. - - - - - - Returns the underlying {link Roo.Element}. - - - - - - - - - - - - Returns: - - Roo.Element The element - - - - - - - - - - - - -	- - Roo.Component - -
	- - - getId - - () - - - : - - - String - - - - - - - - - Returns the id of this component. - - - - - - Returns the id of this component. - - - - - - - - - - - - Returns: - - String - - - - - - - - - - - - -	- - Roo.Component - -
	- - - getValue - - () - - - : - - - Date - - - - - - - - - Gets the current selected value of the date field - - - - - - Gets the current selected value of the date field - - - - - - - - - - - - Returns: - - Date The selected date - - - - - - - - - - - - -	- - Roo.DatePicker - -
	- - - hasListener - - (String *eventName) - - - : - - - Boolean - - - - - - - - - Checks to see if this object has any listeners for a specified event - - - - - - Checks to see if this object has any listeners for a specified event - - - - - - - - Parameters: - - - String eventName* - - - The name of the event to check for - - - - - - - - - Returns: - - Boolean True if the event is being listened for, else false - - - - - - - - - - - - -	- - Roo.util.Observable - -
	- - - hide - - () - - - : - - - Roo.Component - - - - - - - - - Hide this component. - - - - - - Hide this component. - - - - - - - - - - - - Returns: - - Roo.Component this - - - - - - - - - - - - -	- - Roo.Component - -
	- - - isVisible - - () - - - - - - - Returns true if this component is visible. - - - - - - Returns true if this component is visible. - - - - - - - - - - - - - - - - - - - -	- - Roo.Component - -
	- - - on - - (String *eventName, Function handler, Object scope, Object options) - - - - - - - Appends an event handler to this element (shorthand for addListener) - - - - - - Appends an event handler to this element (shorthand for addListener) - - - - - - - - Parameters: - - - String eventName* - - - The type of event to listen for - - - Function handler - - - The method the event invokes - - - Object scope - - - (optional) The scope in which to execute the handler function. The handler function's "this" context. - - - Object options - - - (optional) - - - - - - - - - - - - - - - - -	- - Roo.util.Observable - -
	- - - purgeListeners - - () - - - - - - - Removes all listeners for this object - - - - - - Removes all listeners for this object - - - - - - - - - - - - - - - - - - - -	- - Roo.util.Observable - -
	- - - removeListener - - (String *eventName, Function handler, Object scope) - - - - - - - Removes a listener - - - - - - Removes a listener - - - - - - - - Parameters: - - - String eventName* - - - The type of event to listen for - - - Function handler - - - The handler to remove - - - Object scope - - - (optional) The scope (this object) for the handler - - - - - - - - - - - - - - - - -	- - Roo.util.Observable - -
	- - - render - - (String/HTMLElement/Element *container) - - - - - - - If this is a lazy rendering component, render it to its container element. - - - - - - If this is a lazy rendering component, render it to its container element. - - - - - - - - Parameters: - - - String/HTMLElement/Element container* - - - (optional) The element this component should be rendered into. If it is being applied to existing markup, this should be left off. - - - - - - - - - - - - - - - - -	- - Roo.Component - -
	- - - setDisabled - - (Boolean *disabled) - - - - - - - Convenience function for setting disabled/enabled by boolean. - - - - - - Convenience function for setting disabled/enabled by boolean. - - - - - - - - Parameters: - - - Boolean disabled* - - - - - - - - - - - - - - - - - - - -	- - Roo.Component - -
	- - - setValue - - (Date *value) - - - - - - - Sets the value of the date field - - - - - - Sets the value of the date field - - - - - - - - Parameters: - - - Date value* - - - The date to set - - - - - - - - - - - - - - - - -	- - Roo.DatePicker - -
	- - - setVisible - - (Boolean *visible) - - - : - - - Roo.Component - - - - - - - - - Convenience function to hide or show this component by boolean. - - - - - - Convenience function to hide or show this component by boolean. - - - - - - - - Parameters: - - - Boolean visible* - - - True to show, false to hide - - - - - - - - - Returns: - - Roo.Component this - - - - - - - - - - - - -	- - Roo.Component - -
	- - - show - - () - - - : - - - Roo.Component - - - - - - - - - Show this component. - - - - - - Show this component. - - - - - - - - - - - - Returns: - - Roo.Component this - - - - - - - - - - - - -	- - Roo.Component - -
	- - - un - - (String *eventName, Function handler, Object scope) - - - - - - - Removes a listener (shorthand for removeListener) - - - - - - Removes a listener (shorthand for removeListener) - - - - - - - - Parameters: - - - String eventName* - - - The type of event to listen for - - - Function handler - - - The handler to remove - - - Object scope - - - (optional) The scope (this object) for the handler - - - - - - - - - - - - - - - - -	- - Roo.util.Observable - -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Events
Event		Defined By
	- - - - beforedestroy (Roo.Component *this) - - - - - - Fires before the component is destroyed. - - - - - - Fires before the component is destroyed. Return false to stop the destroy. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - beforehide (Roo.Component *this) - - - - - - Fires before the component is hidden. - - - - - - Fires before the component is hidden. Return false to stop the hide. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - beforerender (Roo.Component *this) - - - - - - Fires before the component is rendered. - - - - - - Fires before the component is rendered. Return false to stop the render. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - beforeshow (Roo.Component *this) - - - - - - Fires before the component is shown. - - - - - - Fires before the component is shown. Return false to stop the show. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - destroy (Roo.Component *this) - - - - - - Fires after the component is destroyed. - - - - - - Fires after the component is destroyed. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - disable (Roo.Component *this) - - - - - - Fires after the component is disabled. - - - - - - Fires after the component is disabled. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - enable (Roo.Component *this) - - - - - - Fires after the component is enabled. - - - - - - Fires after the component is enabled. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - hide (Roo.Component *this) - - - - - - Fires after the component is hidden. - - - - - - Fires after the component is hidden. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - monthchange (DatePicker *this, Date date) - - - - - - Fires when the displayed month changes - - - - - - Fires when the displayed month changes - - - - - - - Parameters: - - - DatePicker this* - - - - - - Date date - - - The selected month - - - - - - - - - - - - - - - - -	- Roo.DatePicker -
	- - - - render (Roo.Component *this) - - - - - - Fires after the component is rendered. - - - - - - Fires after the component is rendered. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -
	- - - - select (DatePicker *this, Date date) - - - - - - Fires when a date is selected - - - - - - Fires when a date is selected - - - - - - - Parameters: - - - DatePicker this* - - - - - - Date date - - - The selected date - - - - - - - - - - - - - - - - -	- Roo.DatePicker -
	- - - - show (Roo.Component *this) - - - - - - Fires after the component is shown. - - - - - - Fires after the component is shown. - - - - - - - Parameters: - - - Roo.Component this* - - - - - - - - - - - - - - - - - - - -	- Roo.Component -

- - - - - - -

- - Documentation generated by Introspection Doc Generator on Fri Jul 13 2018 14:10:53 GMT+0800 (HKT) - Based on - JsDoc Toolkit -

- -