Upgrade to ExtJS 4.0.1 - Released 05/18/2011
[extjs.git] / docs / source / DatePicker.html
index d26f7af..6bf30a8 100644 (file)
+<!DOCTYPE html>
 <html>
 <head>
-  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   <title>The source code</title>
-    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
-    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+  <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
+  <script type="text/javascript" src="../prettify/prettify.js"></script>
+  <style type="text/css">
+    .highlight { display: block; background-color: #ddd; }
+  </style>
+  <script type="text/javascript">
+    function highlight() {
+      document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
+    }
+  </script>
 </head>
-<body  onload="prettyPrint();">
-    <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.2.0
- * Copyright(c) 2006-2010 Ext JS, Inc.
- * licensing@extjs.com
- * http://www.extjs.com/license
- */
-<div id="cls-Ext.DatePicker"></div>/**
- * @class Ext.DatePicker
- * @extends Ext.Component
- * <p>A popup date picker. This class is used by the {@link Ext.form.DateField DateField} class
- * to allow browsing and selection of valid dates.</p>
- * <p>All the string values documented below may be overridden by including an Ext locale file in
- * your page.</p>
- * @constructor
- * Create a new DatePicker
- * @param {Object} config The config object
- * @xtype datepicker
+<body onload="prettyPrint(); highlight();">
+  <pre class="prettyprint lang-js"><span id='Ext-menu-DatePicker'>/**
+</span> * @class Ext.menu.DatePicker
+ * @extends Ext.menu.Menu
+ * &lt;p&gt;A menu containing an {@link Ext.picker.Date} Component.&lt;/p&gt;
+ * &lt;p&gt;Notes:&lt;/p&gt;&lt;div class=&quot;mdetail-params&quot;&gt;&lt;ul&gt;
+ * &lt;li&gt;Although not listed here, the &lt;b&gt;constructor&lt;/b&gt; for this class
+ * accepts all of the configuration options of &lt;b&gt;{@link Ext.picker.Date}&lt;/b&gt;.&lt;/li&gt;
+ * &lt;li&gt;If subclassing DateMenu, any configuration options for the DatePicker must be
+ * applied to the &lt;tt&gt;&lt;b&gt;initialConfig&lt;/b&gt;&lt;/tt&gt; property of the DateMenu.
+ * Applying {@link Ext.picker.Date DatePicker} configuration settings to
+ * &lt;b&gt;&lt;tt&gt;this&lt;/tt&gt;&lt;/b&gt; will &lt;b&gt;not&lt;/b&gt; affect the DatePicker's configuration.&lt;/li&gt;
+ * &lt;/ul&gt;&lt;/div&gt;
+ * {@img Ext.menu.DatePicker/Ext.menu.DatePicker.png Ext.menu.DatePicker component}
+ * __Example Usage__
+     var dateMenu = Ext.create('Ext.menu.DatePicker', {
+        handler: function(dp, date){
+            Ext.Msg.alert('Date Selected', 'You choose {0}.', Ext.Date.format(date, 'M j, Y'));
+
+        }
+    });
+
+    Ext.create('Ext.menu.Menu', {
+               width: 100,
+               height: 90,
+               floating: false,  // usually you want this set to True (default)
+               renderTo: Ext.getBody(),  // usually rendered by it's containing component
+               items: [{
+                   text: 'choose a date',
+                   menu: dateMenu
+               },{
+            iconCls: 'add16',
+                   text: 'icon item'
+               },{
+                   text: 'regular item'
+               }]
+       });
+
+ * @xtype datemenu
+ * @author Nicolas Ferrero
  */
-Ext.DatePicker = Ext.extend(Ext.BoxComponent, {
-    <div id="cfg-Ext.DatePicker-todayText"></div>/**
-     * @cfg {String} todayText
-     * The text to display on the button that selects the current date (defaults to <code>'Today'</code>)
-     */
-    todayText : 'Today',
-    <div id="cfg-Ext.DatePicker-okText"></div>/**
-     * @cfg {String} okText
-     * The text to display on the ok button (defaults to <code>'&#160;OK&#160;'</code> to give the user extra clicking room)
-     */
-    okText : '&#160;OK&#160;',
-    <div id="cfg-Ext.DatePicker-cancelText"></div>/**
-     * @cfg {String} cancelText
-     * The text to display on the cancel button (defaults to <code>'Cancel'</code>)
-     */
-    cancelText : 'Cancel',
-    <div id="cfg-Ext.DatePicker-handler"></div>/**
-     * @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>
-     * <li><code>picker</code> : DatePicker<div class="sub-desc">This DatePicker.</div></li>
-     * <li><code>date</code> : Date<div class="sub-desc">The selected date.</div></li>
-     * </ul></div>
-     */
-    <div id="cfg-Ext.DatePicker-scope"></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.
-     */
-    <div id="cfg-Ext.DatePicker-todayTip"></div>/**
-     * @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)',
-    <div id="cfg-Ext.DatePicker-minText"></div>/**
-     * @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',
-    <div id="cfg-Ext.DatePicker-maxText"></div>/**
-     * @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',
-    <div id="cfg-Ext.DatePicker-format"></div>/**
-     * @cfg {String} format
-     * The default date format string which can be overriden for localization support.  The format must be
-     * valid according to {@link Date#parseDate} (defaults to <code>'m/d/y'</code>).
-     */
-    format : 'm/d/y',
-    <div id="cfg-Ext.DatePicker-disabledDaysText"></div>/**
-     * @cfg {String} disabledDaysText
-     * The tooltip to display when the date falls on a disabled day (defaults to <code>'Disabled'</code>)
-     */
-    disabledDaysText : 'Disabled',
-    <div id="cfg-Ext.DatePicker-disabledDatesText"></div>/**
-     * @cfg {String} disabledDatesText
-     * The tooltip text to display when the date falls on a disabled date (defaults to <code>'Disabled'</code>)
-     */
-    disabledDatesText : 'Disabled',
-    <div id="cfg-Ext.DatePicker-monthNames"></div>/**
-     * @cfg {Array} monthNames
-     * An array of textual month names which can be overriden for localization support (defaults to Date.monthNames)
-     */
-    monthNames : Date.monthNames,
-    <div id="cfg-Ext.DatePicker-dayNames"></div>/**
-     * @cfg {Array} dayNames
-     * An array of textual day names which can be overriden for localization support (defaults to Date.dayNames)
-     */
-    dayNames : Date.dayNames,
-    <div id="cfg-Ext.DatePicker-nextText"></div>/**
-     * @cfg {String} nextText
-     * The next month navigation button tooltip (defaults to <code>'Next Month (Control+Right)'</code>)
-     */
-    nextText : 'Next Month (Control+Right)',
-    <div id="cfg-Ext.DatePicker-prevText"></div>/**
-     * @cfg {String} prevText
-     * The previous month navigation button tooltip (defaults to <code>'Previous Month (Control+Left)'</code>)
-     */
-    prevText : 'Previous Month (Control+Left)',
-    <div id="cfg-Ext.DatePicker-monthYearText"></div>/**
-     * @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)',
-    <div id="cfg-Ext.DatePicker-startDay"></div>/**
-     * @cfg {Number} startDay
-     * Day index at which the week should begin, 0-based (defaults to 0, which is Sunday)
-     */
-    startDay : 0,
-    <div id="cfg-Ext.DatePicker-showToday"></div>/**
-     * @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,
-    <div id="cfg-Ext.DatePicker-minDate"></div>/**
-     * @cfg {Date} minDate
-     * Minimum allowable date (JavaScript date object, defaults to null)
-     */
-    <div id="cfg-Ext.DatePicker-maxDate"></div>/**
-     * @cfg {Date} maxDate
-     * Maximum allowable date (JavaScript date object, defaults to null)
-     */
-    <div id="cfg-Ext.DatePicker-disabledDays"></div>/**
-     * @cfg {Array} disabledDays
-     * An array of days to disable, 0-based. For example, [0, 6] disables Sunday and Saturday (defaults to null).
-     */
-    <div id="cfg-Ext.DatePicker-disabledDatesRE"></div>/**
-     * @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.
-     */
-    <div id="cfg-Ext.DatePicker-disabledDates"></div>/**
-     * @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:
-     * <ul>
-     * <li>['03/08/2003', '09/16/2003'] would disable those exact dates</li>
-     * <li>['03/08', '09/16'] would disable those days for every year</li>
-     * <li>['^03/08'] would only match the beginning (useful if you are using short years)</li>
-     * <li>['03/../2006'] would disable every day in March 2006</li>
-     * <li>['^03'] would disable every day in every March</li>
-     * </ul>
-     * Note that the format of the dates included in the array should exactly match the {@link #format} config.
-     * In order to support regular expressions, if you are using a date format that has '.' in it, you will have to
-     * escape the dot when restricting dates. For example: ['03\\.08\\.03'].
-     */
-
-    // private
-    // Set by other components to stop the picker focus being updated when the value changes.
-    focusOnSelect: true,
-
-    // default value used to initialise each date in the DatePicker
-    // (note: 12 noon was chosen because it steers well clear of all DST timezone changes)
-    initHour: 12, // 24-hour format
+ Ext.define('Ext.menu.DatePicker', {
+     extend: 'Ext.menu.Menu',
 
-    // private
-    initComponent : function(){
-        Ext.DatePicker.superclass.initComponent.call(this);
-
-        this.value = this.value ?
-                 this.value.clearTime(true) : new Date().clearTime();
-
-        this.addEvents(
-            <div id="event-Ext.DatePicker-select"></div>/**
-             * @event select
-             * Fires when a date is selected
-             * @param {DatePicker} this DatePicker
-             * @param {Date} date The selected date
-             */
-            'select'
-        );
-
-        if(this.handler){
-            this.on('select', this.handler,  this.scope || this);
-        }
+     alias: 'widget.datemenu',
 
-        this.initDisabledDays();
-    },
-
-    // private
-    initDisabledDays : function(){
-        if(!this.disabledDatesRE && this.disabledDates){
-            var dd = this.disabledDates,
-                len = dd.length - 1,
-                re = '(?:';
-
-            Ext.each(dd, function(d, i){
-                re += Ext.isDate(d) ? '^' + Ext.escapeRe(d.dateFormat(this.format)) + '$' : dd[i];
-                if(i != len){
-                    re += '|';
-                }
-            }, this);
-            this.disabledDatesRE = new RegExp(re + ')');
-        }
-    },
+     requires: [
+        'Ext.picker.Date'
+     ],
 
-    <div id="method-Ext.DatePicker-setDisabledDates"></div>/**
-     * 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.
+<span id='Ext-menu-DatePicker-cfg-hideOnClick'>    /**
+</span>     * @cfg {Boolean} hideOnClick
+     * False to continue showing the menu after a date is selected, defaults to true.
      */
-    setDisabledDates : function(dd){
-        if(Ext.isArray(dd)){
-            this.disabledDates = dd;
-            this.disabledDatesRE = null;
-        }else{
-            this.disabledDatesRE = dd;
-        }
-        this.initDisabledDays();
-        this.update(this.value, true);
-    },
+    hideOnClick : true,
 
-    <div id="method-Ext.DatePicker-setDisabledDays"></div>/**
-     * 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.
+<span id='Ext-menu-DatePicker-cfg-pickerId'>    /**
+</span>     * @cfg {String} pickerId
+     * An id to assign to the underlying date picker. Defaults to &lt;tt&gt;null&lt;/tt&gt;.
      */
-    setDisabledDays : function(dd){
-        this.disabledDays = dd;
-        this.update(this.value, true);
-    },
+    pickerId : null,
 
-    <div id="method-Ext.DatePicker-setMinDate"></div>/**
-     * Replaces any existing {@link #minDate} with the new value and refreshes the DatePicker.
-     * @param {Date} value The minimum date that can be selected
+<span id='Ext-menu-DatePicker-cfg-maxHeight'>    /**
+</span>     * @cfg {Number} maxHeight
+     * @hide
      */
-    setMinDate : function(dt){
-        this.minDate = dt;
-        this.update(this.value, true);
-    },
 
-    <div id="method-Ext.DatePicker-setMaxDate"></div>/**
-     * Replaces any existing {@link #maxDate} with the new value and refreshes the DatePicker.
-     * @param {Date} value The maximum date that can be selected
+<span id='Ext-menu-DatePicker-property-picker'>    /**
+</span>     * The {@link Ext.picker.Date} instance for this DateMenu
+     * @property picker
+     * @type Ext.picker.Date
      */
-    setMaxDate : function(dt){
-        this.maxDate = dt;
-        this.update(this.value, true);
-    },
 
-    <div id="method-Ext.DatePicker-setValue"></div>/**
-     * Sets the value of the date field
-     * @param {Date} value The date to set
+<span id='Ext-menu-DatePicker-event-click'>    /**
+</span>     * @event click
+     * @hide
      */
-    setValue : function(value){
-        this.value = value.clearTime(true);
-        this.update(this.value);
-    },
 
-    <div id="method-Ext.DatePicker-getValue"></div>/**
-     * Gets the current selected value of the date field
-     * @return {Date} The selected date
+<span id='Ext-menu-DatePicker-event-itemclick'>    /**
+</span>     * @event itemclick
+     * @hide
      */
-    getValue : function(){
-        return this.value;
-    },
-
-    // private
-    focus : function(){
-        this.update(this.activeDate);
-    },
-
-    // private
-    onEnable: function(initial){
-        Ext.DatePicker.superclass.onEnable.call(this);
-        this.doDisabled(false);
-        this.update(initial ? this.value : this.activeDate);
-        if(Ext.isIE){
-            this.el.repaint();
-        }
-
-    },
-
-    // private
-    onDisable : function(){
-        Ext.DatePicker.superclass.onDisable.call(this);
-        this.doDisabled(true);
-        if(Ext.isIE && !Ext.isIE8){
-            /* Really strange problem in IE6/7, when disabled, have to explicitly
-             * repaint each of the nodes to get them to display correctly, simply
-             * calling repaint on the main element doesn't appear to be enough.
-             */
-             Ext.each([].concat(this.textNodes, this.el.query('th span')), function(el){
-                 Ext.fly(el).repaint();
-             });
-        }
-    },
-
-    // private
-    doDisabled : function(disabled){
-        this.keyNav.setDisabled(disabled);
-        this.prevRepeater.setDisabled(disabled);
-        this.nextRepeater.setDisabled(disabled);
-        if(this.showToday){
-            this.todayKeyListener.setDisabled(disabled);
-            this.todayBtn.setDisabled(disabled);
-        }
-    },
-
-    // private
-    onRender : function(container, position){
-        var m = [
-             '<table cellspacing="0">',
-                '<tr><td class="x-date-left"><a href="#" title="', this.prevText ,'">&#160;</a></td><td class="x-date-middle" align="center"></td><td class="x-date-right"><a href="#" title="', this.nextText ,'">&#160;</a></td></tr>',
-                '<tr><td colspan="3"><table class="x-date-inner" cellspacing="0"><thead><tr>'],
-                dn = this.dayNames,
-                i;
-        for(i = 0; i < 7; i++){
-            var d = this.startDay+i;
-            if(d > 6){
-                d = d-7;
-            }
-            m.push('<th><span>', dn[d].substr(0,1), '</span></th>');
-        }
-        m[m.length] = '</tr></thead><tbody><tr>';
-        for(i = 0; i < 42; i++) {
-            if(i % 7 === 0 && i !== 0){
-                m[m.length] = '</tr><tr>';
-            }
-            m[m.length] = '<td><a href="#" hidefocus="on" class="x-date-date" tabIndex="1"><em><span></span></em></a></td>';
-        }
-        m.push('</tr></tbody></table></td></tr>',
-                this.showToday ? '<tr><td colspan="3" class="x-date-bottom" align="center"></td></tr>' : '',
-                '</table><div class="x-date-mp"></div>');
-
-        var el = document.createElement('div');
-        el.className = 'x-date-picker';
-        el.innerHTML = m.join('');
-
-        container.dom.insertBefore(el, position);
-
-        this.el = Ext.get(el);
-        this.eventEl = Ext.get(el.firstChild);
-
-        this.prevRepeater = new Ext.util.ClickRepeater(this.el.child('td.x-date-left a'), {
-            handler: this.showPrevMonth,
-            scope: this,
-            preventDefault:true,
-            stopDefault:true
-        });
-
-        this.nextRepeater = new Ext.util.ClickRepeater(this.el.child('td.x-date-right a'), {
-            handler: this.showNextMonth,
-            scope: this,
-            preventDefault:true,
-            stopDefault:true
-        });
-
-        this.monthPicker = this.el.down('div.x-date-mp');
-        this.monthPicker.enableDisplayMode('block');
-
-        this.keyNav = new Ext.KeyNav(this.eventEl, {
-            'left' : function(e){
-                if(e.ctrlKey){
-                    this.showPrevMonth();
-                }else{
-                    this.update(this.activeDate.add('d', -1));
-                }
-            },
-
-            'right' : function(e){
-                if(e.ctrlKey){
-                    this.showNextMonth();
-                }else{
-                    this.update(this.activeDate.add('d', 1));
-                }
-            },
-
-            'up' : function(e){
-                if(e.ctrlKey){
-                    this.showNextYear();
-                }else{
-                    this.update(this.activeDate.add('d', -7));
-                }
-            },
-
-            'down' : function(e){
-                if(e.ctrlKey){
-                    this.showPrevYear();
-                }else{
-                    this.update(this.activeDate.add('d', 7));
-                }
-            },
-
-            'pageUp' : function(e){
-                this.showNextMonth();
-            },
 
-            'pageDown' : function(e){
-                this.showPrevMonth();
-            },
-
-            'enter' : function(e){
-                e.stopPropagation();
-                return true;
-            },
-
-            scope : this
-        });
-
-        this.el.unselectable();
-
-        this.cells = this.el.select('table.x-date-inner tbody td');
-        this.textNodes = this.el.query('table.x-date-inner tbody span');
-
-        this.mbtn = new Ext.Button({
-            text: '&#160;',
-            tooltip: this.monthYearText,
-            renderTo: this.el.child('td.x-date-middle', true)
-        });
-        this.mbtn.el.child('em').addClass('x-btn-arrow');
-
-        if(this.showToday){
-            this.todayKeyListener = this.eventEl.addKeyListener(Ext.EventObject.SPACE, this.selectToday,  this);
-            var today = (new Date()).dateFormat(this.format);
-            this.todayBtn = new Ext.Button({
-                renderTo: this.el.child('td.x-date-bottom', true),
-                text: String.format(this.todayText, today),
-                tooltip: String.format(this.todayTip, today),
-                handler: this.selectToday,
-                scope: this
-            });
-        }
-        this.mon(this.eventEl, 'mousewheel', this.handleMouseWheel, this);
-        this.mon(this.eventEl, 'click', this.handleDateClick,  this, {delegate: 'a.x-date-date'});
-        this.mon(this.mbtn, 'click', this.showMonthPicker, this);
-        this.onEnable(true);
-    },
-
-    // private
-    createMonthPicker : function(){
-        if(!this.monthPicker.dom.firstChild){
-            var buf = ['<table border="0" cellspacing="0">'];
-            for(var i = 0; i < 6; i++){
-                buf.push(
-                    '<tr><td class="x-date-mp-month"><a href="#">', Date.getShortMonthName(i), '</a></td>',
-                    '<td class="x-date-mp-month x-date-mp-sep"><a href="#">', Date.getShortMonthName(i + 6), '</a></td>',
-                    i === 0 ?
-                    '<td class="x-date-mp-ybtn" align="center"><a class="x-date-mp-prev"></a></td><td class="x-date-mp-ybtn" align="center"><a class="x-date-mp-next"></a></td></tr>' :
-                    '<td class="x-date-mp-year"><a href="#"></a></td><td class="x-date-mp-year"><a href="#"></a></td></tr>'
-                );
-            }
-            buf.push(
-                '<tr class="x-date-mp-btns"><td colspan="4"><button type="button" class="x-date-mp-ok">',
-                    this.okText,
-                    '</button><button type="button" class="x-date-mp-cancel">',
-                    this.cancelText,
-                    '</button></td></tr>',
-                '</table>'
-            );
-            this.monthPicker.update(buf.join(''));
-
-            this.mon(this.monthPicker, 'click', this.onMonthClick, this);
-            this.mon(this.monthPicker, 'dblclick', this.onMonthDblClick, this);
-
-            this.mpMonths = this.monthPicker.select('td.x-date-mp-month');
-            this.mpYears = this.monthPicker.select('td.x-date-mp-year');
-
-            this.mpMonths.each(function(m, a, i){
-                i += 1;
-                if((i%2) === 0){
-                    m.dom.xmonth = 5 + Math.round(i * 0.5);
-                }else{
-                    m.dom.xmonth = Math.round((i-1) * 0.5);
-                }
-            });
-        }
-    },
-
-    // private
-    showMonthPicker : function(){
-        if(!this.disabled){
-            this.createMonthPicker();
-            var size = this.el.getSize();
-            this.monthPicker.setSize(size);
-            this.monthPicker.child('table').setSize(size);
-
-            this.mpSelMonth = (this.activeDate || this.value).getMonth();
-            this.updateMPMonth(this.mpSelMonth);
-            this.mpSelYear = (this.activeDate || this.value).getFullYear();
-            this.updateMPYear(this.mpSelYear);
-
-            this.monthPicker.slideIn('t', {duration:0.2});
-        }
-    },
-
-    // private
-    updateMPYear : function(y){
-        this.mpyear = y;
-        var ys = this.mpYears.elements;
-        for(var i = 1; i <= 10; i++){
-            var td = ys[i-1], y2;
-            if((i%2) === 0){
-                y2 = y + Math.round(i * 0.5);
-                td.firstChild.innerHTML = y2;
-                td.xyear = y2;
-            }else{
-                y2 = y - (5-Math.round(i * 0.5));
-                td.firstChild.innerHTML = y2;
-                td.xyear = y2;
-            }
-            this.mpYears.item(i-1)[y2 == this.mpSelYear ? 'addClass' : 'removeClass']('x-date-mp-sel');
-        }
-    },
-
-    // private
-    updateMPMonth : function(sm){
-        this.mpMonths.each(function(m, a, i){
-            m[m.dom.xmonth == sm ? 'addClass' : 'removeClass']('x-date-mp-sel');
+    initComponent : function(){
+        var me = this;
+
+        Ext.apply(me, {
+            showSeparator: false,
+            plain: true,
+            items: Ext.applyIf({
+                cls: Ext.baseCSSPrefix + 'menu-date-item',
+                id: me.pickerId,
+                xtype: 'datepicker'
+            }, me.initialConfig)
         });
-    },
-
-    // private
-    selectMPMonth : function(m){
-
-    },
-
-    // private
-    onMonthClick : function(e, t){
-        e.stopEvent();
-        var el = new Ext.Element(t), pn;
-        if(el.is('button.x-date-mp-cancel')){
-            this.hideMonthPicker();
-        }
-        else if(el.is('button.x-date-mp-ok')){
-            var d = new Date(this.mpSelYear, this.mpSelMonth, (this.activeDate || this.value).getDate());
-            if(d.getMonth() != this.mpSelMonth){
-                // 'fix' the JS rolling date conversion if needed
-                d = new Date(this.mpSelYear, this.mpSelMonth, 1).getLastDateOfMonth();
-            }
-            this.update(d);
-            this.hideMonthPicker();
-        }
-        else if((pn = el.up('td.x-date-mp-month', 2))){
-            this.mpMonths.removeClass('x-date-mp-sel');
-            pn.addClass('x-date-mp-sel');
-            this.mpSelMonth = pn.dom.xmonth;
-        }
-        else if((pn = el.up('td.x-date-mp-year', 2))){
-            this.mpYears.removeClass('x-date-mp-sel');
-            pn.addClass('x-date-mp-sel');
-            this.mpSelYear = pn.dom.xyear;
-        }
-        else if(el.is('a.x-date-mp-prev')){
-            this.updateMPYear(this.mpyear-10);
-        }
-        else if(el.is('a.x-date-mp-next')){
-            this.updateMPYear(this.mpyear+10);
-        }
-    },
-
-    // private
-    onMonthDblClick : function(e, t){
-        e.stopEvent();
-        var el = new Ext.Element(t), pn;
-        if((pn = el.up('td.x-date-mp-month', 2))){
-            this.update(new Date(this.mpSelYear, pn.dom.xmonth, (this.activeDate || this.value).getDate()));
-            this.hideMonthPicker();
-        }
-        else if((pn = el.up('td.x-date-mp-year', 2))){
-            this.update(new Date(pn.dom.xyear, this.mpSelMonth, (this.activeDate || this.value).getDate()));
-            this.hideMonthPicker();
-        }
-    },
-
-    // private
-    hideMonthPicker : function(disableAnim){
-        if(this.monthPicker){
-            if(disableAnim === true){
-                this.monthPicker.hide();
-            }else{
-                this.monthPicker.slideOut('t', {duration:0.2});
-            }
-        }
-    },
-
-    // private
-    showPrevMonth : function(e){
-        this.update(this.activeDate.add('mo', -1));
-    },
-
-    // private
-    showNextMonth : function(e){
-        this.update(this.activeDate.add('mo', 1));
-    },
-
-    // private
-    showPrevYear : function(){
-        this.update(this.activeDate.add('y', -1));
-    },
-
-    // private
-    showNextYear : function(){
-        this.update(this.activeDate.add('y', 1));
-    },
-
-    // private
-    handleMouseWheel : function(e){
-        e.stopEvent();
-        if(!this.disabled){
-            var delta = e.getWheelDelta();
-            if(delta > 0){
-                this.showPrevMonth();
-            } else if(delta < 0){
-                this.showNextMonth();
-            }
-        }
-    },
-
-    // private
-    handleDateClick : function(e, t){
-        e.stopEvent();
-        if(!this.disabled && t.dateValue && !Ext.fly(t.parentNode).hasClass('x-date-disabled')){
-            this.cancelFocus = this.focusOnSelect === false;
-            this.setValue(new Date(t.dateValue));
-            delete this.cancelFocus;
-            this.fireEvent('select', this, this.value);
-        }
-    },
-
-    // private
-    selectToday : function(){
-        if(this.todayBtn && !this.todayBtn.disabled){
-            this.setValue(new Date().clearTime());
-            this.fireEvent('select', this, this.value);
-        }
-    },
-
-    // private
-    update : function(date, forceRefresh){
-        if(this.rendered){
-            var vd = this.activeDate, vis = this.isVisible();
-            this.activeDate = date;
-            if(!forceRefresh && vd && this.el){
-                var t = date.getTime();
-                if(vd.getMonth() == date.getMonth() && vd.getFullYear() == date.getFullYear()){
-                    this.cells.removeClass('x-date-selected');
-                    this.cells.each(function(c){
-                       if(c.dom.firstChild.dateValue == t){
-                           c.addClass('x-date-selected');
-                           if(vis && !this.cancelFocus){
-                               Ext.fly(c.dom.firstChild).focus(50);
-                           }
-                           return false;
-                       }
-                    }, this);
-                    return;
-                }
-            }
-            var days = date.getDaysInMonth(),
-                firstOfMonth = date.getFirstDateOfMonth(),
-                startingPos = firstOfMonth.getDay()-this.startDay;
 
-            if(startingPos < 0){
-                startingPos += 7;
-            }
-            days += startingPos;
+        me.callParent(arguments);
 
-            var pm = date.add('mo', -1),
-                prevStart = pm.getDaysInMonth()-startingPos,
-                cells = this.cells.elements,
-                textEls = this.textNodes,
-                // convert everything to numbers so it's fast
-                d = (new Date(pm.getFullYear(), pm.getMonth(), prevStart, this.initHour)),
-                today = new Date().clearTime().getTime(),
-                sel = date.clearTime(true).getTime(),
-                min = this.minDate ? this.minDate.clearTime(true) : Number.NEGATIVE_INFINITY,
-                max = this.maxDate ? this.maxDate.clearTime(true) : Number.POSITIVE_INFINITY,
-                ddMatch = this.disabledDatesRE,
-                ddText = this.disabledDatesText,
-                ddays = this.disabledDays ? this.disabledDays.join('') : false,
-                ddaysText = this.disabledDaysText,
-                format = this.format;
+        me.picker = me.down('datepicker');
+<span id='Ext-menu-DatePicker-event-select'>        /**
+</span>         * @event select
+         * Fires when a date is selected from the {@link #picker Ext.picker.Date}
+         * @param {Ext.picker.Date} picker The {@link #picker Ext.picker.Date}
+         * @param {Date} date The selected date
+         */
+        me.relayEvents(me.picker, ['select']);
 
-            if(this.showToday){
-                var td = new Date().clearTime(),
-                    disable = (td < min || td > max ||
-                    (ddMatch && format && ddMatch.test(td.dateFormat(format))) ||
-                    (ddays && ddays.indexOf(td.getDay()) != -1));
-
-                if(!this.disabled){
-                    this.todayBtn.setDisabled(disable);
-                    this.todayKeyListener[disable ? 'disable' : 'enable']();
-                }
-            }
-
-            var setCellClass = function(cal, cell){
-                cell.title = '';
-                var t = d.clearTime(true).getTime();
-                cell.firstChild.dateValue = t;
-                if(t == today){
-                    cell.className += ' x-date-today';
-                    cell.title = cal.todayText;
-                }
-                if(t == sel){
-                    cell.className += ' x-date-selected';
-                    if(vis){
-                        Ext.fly(cell.firstChild).focus(50);
-                    }
-                }
-                // disabling
-                if(t < min) {
-                    cell.className = ' x-date-disabled';
-                    cell.title = cal.minText;
-                    return;
-                }
-                if(t > max) {
-                    cell.className = ' x-date-disabled';
-                    cell.title = cal.maxText;
-                    return;
-                }
-                if(ddays){
-                    if(ddays.indexOf(d.getDay()) != -1){
-                        cell.title = ddaysText;
-                        cell.className = ' x-date-disabled';
-                    }
-                }
-                if(ddMatch && format){
-                    var fvalue = d.dateFormat(format);
-                    if(ddMatch.test(fvalue)){
-                        cell.title = ddText.replace('%0', fvalue);
-                        cell.className = ' x-date-disabled';
-                    }
-                }
-            };
-
-            var i = 0;
-            for(; i < startingPos; i++) {
-                textEls[i].innerHTML = (++prevStart);
-                d.setDate(d.getDate()+1);
-                cells[i].className = 'x-date-prevday';
-                setCellClass(this, cells[i]);
-            }
-            for(; i < days; i++){
-                var intDay = i - startingPos + 1;
-                textEls[i].innerHTML = (intDay);
-                d.setDate(d.getDate()+1);
-                cells[i].className = 'x-date-active';
-                setCellClass(this, cells[i]);
-            }
-            var extraDays = 0;
-            for(; i < 42; i++) {
-                 textEls[i].innerHTML = (++extraDays);
-                 d.setDate(d.getDate()+1);
-                 cells[i].className = 'x-date-nextday';
-                 setCellClass(this, cells[i]);
-            }
-
-            this.mbtn.setText(this.monthNames[date.getMonth()] + ' ' + date.getFullYear());
-
-            if(!this.internalRender){
-                var main = this.el.dom.firstChild,
-                    w = main.offsetWidth;
-                this.el.setWidth(w + this.el.getBorderWidth('lr'));
-                Ext.fly(main).setWidth(w);
-                this.internalRender = true;
-                // opera does not respect the auto grow header center column
-                // then, after it gets a width opera refuses to recalculate
-                // without a second pass
-                if(Ext.isOpera && !this.secondPass){
-                    main.rows[0].cells[1].style.width = (w - (main.rows[0].cells[0].offsetWidth+main.rows[0].cells[2].offsetWidth)) + 'px';
-                    this.secondPass = true;
-                    this.update.defer(10, this, [date]);
-                }
-            }
+        if (me.hideOnClick) {
+            me.on('select', me.hidePickerOnSelect, me);
         }
     },
 
-    // private
-    beforeDestroy : function() {
-        if(this.rendered){
-            Ext.destroy(
-                this.keyNav,
-                this.monthPicker,
-                this.eventEl,
-                this.mbtn,
-                this.nextRepeater,
-                this.prevRepeater,
-                this.cells.el,
-                this.todayBtn
-            );
-            delete this.textNodes;
-            delete this.cells.elements;
-        }
+    hidePickerOnSelect: function() {
+        Ext.menu.Manager.hideAll();
     }
-
-    <div id="cfg-Ext.DatePicker-autoEl"></div>/**
-     * @cfg {String} autoEl @hide
-     */
-});
-
-Ext.reg('datepicker', Ext.DatePicker);
-</pre>    
+ });</pre>
 </body>
-</html>
\ No newline at end of file
+</html>