Upgrade to ExtJS 4.0.0 - Released 04/26/2011
[extjs.git] / src / widgets / form / TriggerField.js
diff --git a/src/widgets/form/TriggerField.js b/src/widgets/form/TriggerField.js
deleted file mode 100644 (file)
index efdcab1..0000000
+++ /dev/null
@@ -1,348 +0,0 @@
-/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
- * licensing@extjs.com
- * http://www.extjs.com/license
- */
-/**\r
- * @class Ext.form.TriggerField\r
- * @extends Ext.form.TextField\r
- * Provides a convenient wrapper for TextFields that adds a clickable trigger button (looks like a combobox by default).\r
- * The trigger has no default action, so you must assign a function to implement the trigger click handler by\r
- * overriding {@link #onTriggerClick}. You can create a TriggerField directly, as it renders exactly like a combobox\r
- * for which you can provide a custom implementation.  For example:\r
- * <pre><code>\r
-var trigger = new Ext.form.TriggerField();\r
-trigger.onTriggerClick = myTriggerFn;\r
-trigger.applyToMarkup('my-field');\r
-</code></pre>\r
- *\r
- * However, in general you will most likely want to use TriggerField as the base class for a reusable component.\r
- * {@link Ext.form.DateField} and {@link Ext.form.ComboBox} are perfect examples of this.\r
- * \r
- * @constructor\r
- * Create a new TriggerField.\r
- * @param {Object} config Configuration options (valid {@Ext.form.TextField} config options will also be applied\r
- * to the base TextField)\r
- * @xtype trigger\r
- */\r
-Ext.form.TriggerField = Ext.extend(Ext.form.TextField,  {\r
-    /**\r
-     * @cfg {String} triggerClass\r
-     * An additional CSS class used to style the trigger button.  The trigger will always get the\r
-     * class <tt>'x-form-trigger'</tt> by default and <tt>triggerClass</tt> will be <b>appended</b> if specified.\r
-     */\r
-    /**\r
-     * @cfg {Mixed} triggerConfig\r
-     * <p>A {@link Ext.DomHelper DomHelper} config object specifying the structure of the\r
-     * trigger element for this Field. (Optional).</p>\r
-     * <p>Specify this when you need a customized element to act as the trigger button for a TriggerField.</p>\r
-     * <p>Note that when using this option, it is the developer's responsibility to ensure correct sizing, positioning\r
-     * and appearance of the trigger.  Defaults to:</p>\r
-     * <pre><code>{tag: "img", src: Ext.BLANK_IMAGE_URL, cls: "x-form-trigger " + this.triggerClass}</code></pre>\r
-     */\r
-    /**\r
-     * @cfg {String/Object} autoCreate <p>A {@link Ext.DomHelper DomHelper} element spec, or true for a default\r
-     * element spec. Used to create the {@link Ext.Component#getEl Element} which will encapsulate this Component.\r
-     * See <tt>{@link Ext.Component#autoEl autoEl}</tt> for details.  Defaults to:</p>\r
-     * <pre><code>{tag: "input", type: "text", size: "16", autocomplete: "off"}</code></pre>\r
-     */\r
-    defaultAutoCreate : {tag: "input", type: "text", size: "16", autocomplete: "off"},\r
-    /**\r
-     * @cfg {Boolean} hideTrigger <tt>true</tt> to hide the trigger element and display only the base\r
-     * text field (defaults to <tt>false</tt>)\r
-     */\r
-    hideTrigger:false,\r
-    /**\r
-     * @cfg {Boolean} editable <tt>false</tt> to prevent the user from typing text directly into the field,\r
-     * the field will only respond to a click on the trigger to set the value. (defaults to <tt>true</tt>)\r
-     */\r
-    editable: true,\r
-    /**\r
-     * @cfg {String} wrapFocusClass The class added to the to the wrap of the trigger element. Defaults to\r
-     * <tt>x-trigger-wrap-focus</tt>.\r
-     */\r
-    wrapFocusClass: 'x-trigger-wrap-focus',\r
-    /**\r
-     * @hide \r
-     * @method autoSize\r
-     */\r
-    autoSize: Ext.emptyFn,\r
-    // private\r
-    monitorTab : true,\r
-    // private\r
-    deferHeight : true,\r
-    // private\r
-    mimicing : false,\r
-    \r
-    actionMode: 'wrap',\r
-    \r
-    defaultTriggerWidth: 17,\r
-\r
-    // private\r
-    onResize : function(w, h){\r
-        Ext.form.TriggerField.superclass.onResize.call(this, w, h);\r
-        var tw = this.getTriggerWidth();\r
-        if(Ext.isNumber(w)){\r
-            this.el.setWidth(w - tw);\r
-        }\r
-        this.wrap.setWidth(this.el.getWidth() + tw);\r
-    },\r
-    \r
-    getTriggerWidth: function(){\r
-        var tw = this.trigger.getWidth();\r
-        if(!this.hideTrigger && tw === 0){\r
-            tw = this.defaultTriggerWidth;\r
-        }\r
-        return tw;\r
-    },\r
-\r
-    // private\r
-    alignErrorIcon : function(){\r
-        if(this.wrap){\r
-            this.errorIcon.alignTo(this.wrap, 'tl-tr', [2, 0]);\r
-        }\r
-    },\r
-\r
-    // private\r
-    onRender : function(ct, position){\r
-        this.doc = Ext.isIE ? Ext.getBody() : Ext.getDoc();\r
-        Ext.form.TriggerField.superclass.onRender.call(this, ct, position);\r
-\r
-        this.wrap = this.el.wrap({cls: 'x-form-field-wrap x-form-field-trigger-wrap'});\r
-        this.trigger = this.wrap.createChild(this.triggerConfig ||\r
-                {tag: "img", src: Ext.BLANK_IMAGE_URL, cls: "x-form-trigger " + this.triggerClass});\r
-        if(this.hideTrigger){\r
-            this.trigger.setDisplayed(false);\r
-        }\r
-        this.initTrigger();\r
-        if(!this.width){\r
-            this.wrap.setWidth(this.el.getWidth()+this.trigger.getWidth());\r
-        }\r
-        if(!this.editable){\r
-            this.editable = true;\r
-            this.setEditable(false);\r
-        }\r
-        this.resizeEl = this.positionEl = this.wrap;\r
-    },\r
-\r
-    afterRender : function(){\r
-        Ext.form.TriggerField.superclass.afterRender.call(this);\r
-    },\r
-\r
-    // private\r
-    initTrigger : function(){\r
-        this.mon(this.trigger, 'click', this.onTriggerClick, this, {preventDefault:true});\r
-        this.trigger.addClassOnOver('x-form-trigger-over');\r
-        this.trigger.addClassOnClick('x-form-trigger-click');\r
-    },\r
-\r
-    // private\r
-    onDestroy : function(){\r
-        Ext.destroy(this.trigger, this.wrap);\r
-        if (this.mimicing){\r
-            this.doc.un('mousedown', this.mimicBlur, this);\r
-        }\r
-        Ext.form.TriggerField.superclass.onDestroy.call(this);\r
-    },\r
-\r
-    // private\r
-    onFocus : function(){\r
-        Ext.form.TriggerField.superclass.onFocus.call(this);\r
-        if(!this.mimicing){\r
-            this.wrap.addClass(this.wrapFocusClass);\r
-            this.mimicing = true;\r
-            this.doc.on('mousedown', this.mimicBlur, this, {delay: 10});\r
-            if(this.monitorTab){\r
-                this.on('specialkey', this.checkTab, this);\r
-            }\r
-        }\r
-    },\r
-\r
-    // private\r
-    checkTab : function(me, e){\r
-        if(e.getKey() == e.TAB){\r
-            this.triggerBlur();\r
-        }\r
-    },\r
-\r
-    // private\r
-    onBlur : Ext.emptyFn,\r
-\r
-    // private\r
-    mimicBlur : function(e){\r
-        if(!this.isDestroyed && !this.wrap.contains(e.target) && this.validateBlur(e)){\r
-            this.triggerBlur();\r
-        }\r
-    },\r
-\r
-    // private\r
-    triggerBlur : function(){\r
-        this.mimicing = false;\r
-        this.doc.un('mousedown', this.mimicBlur, this);\r
-        if(this.monitorTab && this.el){\r
-            this.un('specialkey', this.checkTab, this);\r
-        }\r
-        Ext.form.TriggerField.superclass.onBlur.call(this);\r
-        if(this.wrap){\r
-            this.wrap.removeClass(this.wrapFocusClass);\r
-        }\r
-    },\r
-\r
-    beforeBlur : Ext.emptyFn, \r
-    \r
-    /**\r
-     * Allow or prevent the user from directly editing the field text.  If false is passed,\r
-     * the user will only be able to modify the field using the trigger.  This method\r
-     * is the runtime equivalent of setting the 'editable' config option at config time.\r
-     * @param {Boolean} value True to allow the user to directly edit the field text\r
-     */\r
-    setEditable : function(value){\r
-        if(value == this.editable){\r
-            return;\r
-        }\r
-        this.editable = value;\r
-        if(!value){\r
-            this.el.addClass('x-trigger-noedit').on('click', this.onTriggerClick, this).dom.setAttribute('readOnly', true);\r
-        }else{\r
-            this.el.removeClass('x-trigger-noedit').un('click', this.onTriggerClick,  this).dom.removeAttribute('readOnly');\r
-        }\r
-    },\r
-\r
-    // private\r
-    // This should be overriden by any subclass that needs to check whether or not the field can be blurred.\r
-    validateBlur : function(e){\r
-        return true;\r
-    },\r
-\r
-    /**\r
-     * The function that should handle the trigger's click event.  This method does nothing by default\r
-     * until overridden by an implementing function.  See Ext.form.ComboBox and Ext.form.DateField for\r
-     * sample implementations.\r
-     * @method\r
-     * @param {EventObject} e\r
-     */\r
-    onTriggerClick : Ext.emptyFn\r
-\r
-    /**\r
-     * @cfg {Boolean} grow @hide\r
-     */\r
-    /**\r
-     * @cfg {Number} growMin @hide\r
-     */\r
-    /**\r
-     * @cfg {Number} growMax @hide\r
-     */\r
-});\r
-\r
-/**\r
- * @class Ext.form.TwinTriggerField\r
- * @extends Ext.form.TriggerField\r
- * TwinTriggerField is not a public class to be used directly.  It is meant as an abstract base class\r
- * to be extended by an implementing class.  For an example of implementing this class, see the custom\r
- * SearchField implementation here:\r
- * <a href="http://extjs.com/deploy/ext/examples/form/custom.html">http://extjs.com/deploy/ext/examples/form/custom.html</a>\r
- */\r
-Ext.form.TwinTriggerField = Ext.extend(Ext.form.TriggerField, {\r
-    /**\r
-     * @cfg {Mixed} triggerConfig\r
-     * <p>A {@link Ext.DomHelper DomHelper} config object specifying the structure of the trigger elements\r
-     * for this Field. (Optional).</p>\r
-     * <p>Specify this when you need a customized element to contain the two trigger elements for this Field.\r
-     * Each trigger element must be marked by the CSS class <tt>x-form-trigger</tt> (also see\r
-     * <tt>{@link #trigger1Class}</tt> and <tt>{@link #trigger2Class}</tt>).</p>\r
-     * <p>Note that when using this option, it is the developer's responsibility to ensure correct sizing,\r
-     * positioning and appearance of the triggers.</p>\r
-     */\r
-    /**\r
-     * @cfg {String} trigger1Class\r
-     * An additional CSS class used to style the trigger button.  The trigger will always get the\r
-     * class <tt>'x-form-trigger'</tt> by default and <tt>triggerClass</tt> will be <b>appended</b> if specified.\r
-     */\r
-    /**\r
-     * @cfg {String} trigger2Class\r
-     * An additional CSS class used to style the trigger button.  The trigger will always get the\r
-     * class <tt>'x-form-trigger'</tt> by default and <tt>triggerClass</tt> will be <b>appended</b> if specified.\r
-     */\r
-\r
-    initComponent : function(){\r
-        Ext.form.TwinTriggerField.superclass.initComponent.call(this);\r
-\r
-        this.triggerConfig = {\r
-            tag:'span', cls:'x-form-twin-triggers', cn:[\r
-            {tag: "img", src: Ext.BLANK_IMAGE_URL, cls: "x-form-trigger " + this.trigger1Class},\r
-            {tag: "img", src: Ext.BLANK_IMAGE_URL, cls: "x-form-trigger " + this.trigger2Class}\r
-        ]};\r
-    },\r
-\r
-    getTrigger : function(index){\r
-        return this.triggers[index];\r
-    },\r
-\r
-    initTrigger : function(){\r
-        var ts = this.trigger.select('.x-form-trigger', true);\r
-        var triggerField = this;\r
-        ts.each(function(t, all, index){\r
-            var triggerIndex = 'Trigger'+(index+1);\r
-            t.hide = function(){\r
-                var w = triggerField.wrap.getWidth();\r
-                this.dom.style.display = 'none';\r
-                triggerField.el.setWidth(w-triggerField.trigger.getWidth());\r
-                this['hidden' + triggerIndex] = true;\r
-            };\r
-            t.show = function(){\r
-                var w = triggerField.wrap.getWidth();\r
-                this.dom.style.display = '';\r
-                triggerField.el.setWidth(w-triggerField.trigger.getWidth());\r
-                this['hidden' + triggerIndex] = false;\r
-            };\r
-            \r
-            if(this['hide'+triggerIndex]){\r
-                t.dom.style.display = 'none';\r
-                this['hidden' + triggerIndex] = true;\r
-            }\r
-            this.mon(t, 'click', this['on'+triggerIndex+'Click'], this, {preventDefault:true});\r
-            t.addClassOnOver('x-form-trigger-over');\r
-            t.addClassOnClick('x-form-trigger-click');\r
-        }, this);\r
-        this.triggers = ts.elements;\r
-    },\r
-    \r
-    getTriggerWidth: function(){\r
-        var tw = 0;\r
-        Ext.each(this.triggers, function(t, index){\r
-            var triggerIndex = 'Trigger' + (index + 1),\r
-                w = t.getWidth();\r
-            if(w === 0 && !this['hidden' + triggerIndex]){\r
-                tw += this.defaultTriggerWidth;\r
-            }else{\r
-                tw += w;\r
-            }\r
-        }, this);\r
-        return tw;\r
-    },\r
-    \r
-    // private\r
-    onDestroy : function() {\r
-        Ext.destroy(this.triggers);\r
-        Ext.form.TwinTriggerField.superclass.onDestroy.call(this);\r
-    },\r
-\r
-    /**\r
-     * The function that should handle the trigger's click event.  This method does nothing by default\r
-     * until overridden by an implementing function. See {@link Ext.form.TriggerField#onTriggerClick}\r
-     * for additional information.  \r
-     * @method\r
-     * @param {EventObject} e\r
-     */\r
-    onTrigger1Click : Ext.emptyFn,\r
-    /**\r
-     * The function that should handle the trigger's click event.  This method does nothing by default\r
-     * until overridden by an implementing function. See {@link Ext.form.TriggerField#onTriggerClick}\r
-     * for additional information.  \r
-     * @method\r
-     * @param {EventObject} e\r
-     */\r
-    onTrigger2Click : Ext.emptyFn\r
-});\r
-Ext.reg('trigger', Ext.form.TriggerField);
\ No newline at end of file