TriggerField.js
上传用户:dawnssy
上传日期:2022-08-06
资源大小:9345k
文件大小:14k
源码类别:

JavaScript

开发平台:

JavaScript

  1. /*!
  2.  * Ext JS Library 3.1.0
  3.  * Copyright(c) 2006-2009 Ext JS, LLC
  4.  * licensing@extjs.com
  5.  * http://www.extjs.com/license
  6.  */
  7. /**
  8.  * @class Ext.form.TriggerField
  9.  * @extends Ext.form.TextField
  10.  * Provides a convenient wrapper for TextFields that adds a clickable trigger button (looks like a combobox by default).
  11.  * The trigger has no default action, so you must assign a function to implement the trigger click handler by
  12.  * overriding {@link #onTriggerClick}. You can create a TriggerField directly, as it renders exactly like a combobox
  13.  * for which you can provide a custom implementation.  For example:
  14.  * <pre><code>
  15. var trigger = new Ext.form.TriggerField();
  16. trigger.onTriggerClick = myTriggerFn;
  17. trigger.applyToMarkup('my-field');
  18. </code></pre>
  19.  *
  20.  * However, in general you will most likely want to use TriggerField as the base class for a reusable component.
  21.  * {@link Ext.form.DateField} and {@link Ext.form.ComboBox} are perfect examples of this.
  22.  *
  23.  * @constructor
  24.  * Create a new TriggerField.
  25.  * @param {Object} config Configuration options (valid {@Ext.form.TextField} config options will also be applied
  26.  * to the base TextField)
  27.  * @xtype trigger
  28.  */
  29. Ext.form.TriggerField = Ext.extend(Ext.form.TextField,  {
  30.     /**
  31.      * @cfg {String} triggerClass
  32.      * An additional CSS class used to style the trigger button.  The trigger will always get the
  33.      * class <tt>'x-form-trigger'</tt> by default and <tt>triggerClass</tt> will be <b>appended</b> if specified.
  34.      */
  35.     /**
  36.      * @cfg {Mixed} triggerConfig
  37.      * <p>A {@link Ext.DomHelper DomHelper} config object specifying the structure of the
  38.      * trigger element for this Field. (Optional).</p>
  39.      * <p>Specify this when you need a customized element to act as the trigger button for a TriggerField.</p>
  40.      * <p>Note that when using this option, it is the developer's responsibility to ensure correct sizing, positioning
  41.      * and appearance of the trigger.  Defaults to:</p>
  42.      * <pre><code>{tag: "img", src: Ext.BLANK_IMAGE_URL, cls: "x-form-trigger " + this.triggerClass}</code></pre>
  43.      */
  44.     /**
  45.      * @cfg {String/Object} autoCreate <p>A {@link Ext.DomHelper DomHelper} element spec, or true for a default
  46.      * element spec. Used to create the {@link Ext.Component#getEl Element} which will encapsulate this Component.
  47.      * See <tt>{@link Ext.Component#autoEl autoEl}</tt> for details.  Defaults to:</p>
  48.      * <pre><code>{tag: "input", type: "text", size: "16", autocomplete: "off"}</code></pre>
  49.      */
  50.     defaultAutoCreate : {tag: "input", type: "text", size: "16", autocomplete: "off"},
  51.     /**
  52.      * @cfg {Boolean} hideTrigger <tt>true</tt> to hide the trigger element and display only the base
  53.      * text field (defaults to <tt>false</tt>)
  54.      */
  55.     hideTrigger:false,
  56.     /**
  57.      * @cfg {Boolean} editable <tt>false</tt> to prevent the user from typing text directly into the field,
  58.      * the field will only respond to a click on the trigger to set the value. (defaults to <tt>true</tt>).
  59.      */
  60.     editable: true,
  61.     /**
  62.      * @cfg {Boolean} readOnly <tt>true</tt> to prevent the user from changing the field, and
  63.      * hides the trigger.  Superceeds the editable and hideTrigger options if the value is true.
  64.      * (defaults to <tt>false</tt>)
  65.      */
  66.     readOnly: false,
  67.     /**
  68.      * @cfg {String} wrapFocusClass The class added to the to the wrap of the trigger element. Defaults to
  69.      * <tt>x-trigger-wrap-focus</tt>.
  70.      */
  71.     wrapFocusClass: 'x-trigger-wrap-focus',
  72.     /**
  73.      * @hide
  74.      * @method autoSize
  75.      */
  76.     autoSize: Ext.emptyFn,
  77.     // private
  78.     monitorTab : true,
  79.     // private
  80.     deferHeight : true,
  81.     // private
  82.     mimicing : false,
  83.     actionMode: 'wrap',
  84.     removeMode: 'container',
  85.     defaultTriggerWidth: 17,
  86.     // private
  87.     onResize : function(w, h){
  88.         Ext.form.TriggerField.superclass.onResize.call(this, w, h);
  89.         var tw = this.getTriggerWidth();
  90.         if(Ext.isNumber(w)){
  91.             this.el.setWidth(w - tw);
  92.         }
  93.         this.wrap.setWidth(this.el.getWidth() + tw);
  94.     },
  95.     getTriggerWidth: function(){
  96.         var tw = this.trigger.getWidth();
  97.         if(!this.hideTrigger && tw === 0){
  98.             tw = this.defaultTriggerWidth;
  99.         }
  100.         return tw;
  101.     },
  102.     // private
  103.     alignErrorIcon : function(){
  104.         if(this.wrap){
  105.             this.errorIcon.alignTo(this.wrap, 'tl-tr', [2, 0]);
  106.         }
  107.     },
  108.     // private
  109.     onRender : function(ct, position){
  110.         this.doc = Ext.isIE ? Ext.getBody() : Ext.getDoc();
  111.         Ext.form.TriggerField.superclass.onRender.call(this, ct, position);
  112.         this.wrap = this.el.wrap({cls: 'x-form-field-wrap x-form-field-trigger-wrap'});
  113.         this.trigger = this.wrap.createChild(this.triggerConfig ||
  114.                 {tag: "img", src: Ext.BLANK_IMAGE_URL, cls: "x-form-trigger " + this.triggerClass});
  115.         this.initTrigger();
  116.         if(!this.width){
  117.             this.wrap.setWidth(this.el.getWidth()+this.trigger.getWidth());
  118.         }
  119.         this.resizeEl = this.positionEl = this.wrap;
  120.         this.updateEditState();
  121.     },
  122.     updateEditState: function(){
  123.         if(this.rendered){
  124.             if (this.readOnly) {
  125.                 this.el.dom.readOnly = true;
  126.                 this.el.addClass('x-trigger-noedit');
  127.                 this.mun(this.el, 'click', this.onTriggerClick, this);
  128.                 this.trigger.setDisplayed(false);
  129.             } else {
  130.                 if (!this.editable) {
  131.                     this.el.dom.readOnly = true;
  132.                     this.el.addClass('x-trigger-noedit');
  133.                     this.mon(this.el, 'click', this.onTriggerClick, this);
  134.                 } else {
  135.                     this.el.dom.readOnly = false;
  136.                     this.el.removeClass('x-trigger-noedit');
  137.                     this.mun(this.el, 'click', this.onTriggerClick, this);
  138.                 }
  139.                 this.trigger.setDisplayed(!this.hideTrigger);
  140.             }
  141.             this.onResize(this.width || this.wrap.getWidth());
  142.         }
  143.     },
  144.     setHideTrigger: function(hideTrigger){
  145.         if(hideTrigger != this.hideTrigger){
  146.             this.hideTrigger = hideTrigger;
  147.             this.updateEditState();
  148.         }
  149.     },
  150.     /**
  151.      * @param {Boolean} value True to allow the user to directly edit the field text
  152.      * Allow or prevent the user from directly editing the field text.  If false is passed,
  153.      * the user will only be able to modify the field using the trigger.  Will also add
  154.      * a click event to the text field which will call the trigger. This method
  155.      * is the runtime equivalent of setting the 'editable' config option at config time.
  156.      */
  157.     setEditable: function(editable){
  158.         if(editable != this.editable){
  159.             this.editable = editable;
  160.             this.updateEditState();
  161.         }
  162.     },
  163.     /**
  164.      * @param {Boolean} value True to prevent the user changing the field and explicitly
  165.      * hide the trigger.
  166.      * Setting this to true will superceed settings editable and hideTrigger.
  167.      * Setting this to false will defer back to editable and hideTrigger. This method
  168.      * is the runtime equivalent of setting the 'readOnly' config option at config time.
  169.      */
  170.     setReadOnly: function(readOnly){
  171.         if(readOnly != this.readOnly){
  172.             this.readOnly = readOnly;
  173.             this.updateEditState();
  174.         }
  175.     },
  176.     afterRender : function(){
  177.         Ext.form.TriggerField.superclass.afterRender.call(this);
  178.     },
  179.     // private
  180.     initTrigger : function(){
  181.         this.mon(this.trigger, 'click', this.onTriggerClick, this, {preventDefault:true});
  182.         this.trigger.addClassOnOver('x-form-trigger-over');
  183.         this.trigger.addClassOnClick('x-form-trigger-click');
  184.     },
  185.     // private
  186.     onDestroy : function(){
  187.         Ext.destroy(this.trigger, this.wrap);
  188.         if (this.mimicing){
  189.             this.doc.un('mousedown', this.mimicBlur, this);
  190.         }
  191.         delete this.doc;
  192.         Ext.form.TriggerField.superclass.onDestroy.call(this);
  193.     },
  194.     // private
  195.     onFocus : function(){
  196.         Ext.form.TriggerField.superclass.onFocus.call(this);
  197.         if(!this.mimicing){
  198.             this.wrap.addClass(this.wrapFocusClass);
  199.             this.mimicing = true;
  200.             this.doc.on('mousedown', this.mimicBlur, this, {delay: 10});
  201.             if(this.monitorTab){
  202.                 this.on('specialkey', this.checkTab, this);
  203.             }
  204.         }
  205.     },
  206.     // private
  207.     checkTab : function(me, e){
  208.         if(e.getKey() == e.TAB){
  209.             this.triggerBlur();
  210.         }
  211.     },
  212.     // private
  213.     onBlur : Ext.emptyFn,
  214.     // private
  215.     mimicBlur : function(e){
  216.         if(!this.isDestroyed && !this.wrap.contains(e.target) && this.validateBlur(e)){
  217.             this.triggerBlur();
  218.         }
  219.     },
  220.     // private
  221.     triggerBlur : function(){
  222.         this.mimicing = false;
  223.         this.doc.un('mousedown', this.mimicBlur, this);
  224.         if(this.monitorTab && this.el){
  225.             this.un('specialkey', this.checkTab, this);
  226.         }
  227.         Ext.form.TriggerField.superclass.onBlur.call(this);
  228.         if(this.wrap){
  229.             this.wrap.removeClass(this.wrapFocusClass);
  230.         }
  231.     },
  232.     beforeBlur : Ext.emptyFn,
  233.     // private
  234.     // This should be overriden by any subclass that needs to check whether or not the field can be blurred.
  235.     validateBlur : function(e){
  236.         return true;
  237.     },
  238.     /**
  239.      * The function that should handle the trigger's click event.  This method does nothing by default
  240.      * until overridden by an implementing function.  See Ext.form.ComboBox and Ext.form.DateField for
  241.      * sample implementations.
  242.      * @method
  243.      * @param {EventObject} e
  244.      */
  245.     onTriggerClick : Ext.emptyFn
  246.     /**
  247.      * @cfg {Boolean} grow @hide
  248.      */
  249.     /**
  250.      * @cfg {Number} growMin @hide
  251.      */
  252.     /**
  253.      * @cfg {Number} growMax @hide
  254.      */
  255. });
  256. /**
  257.  * @class Ext.form.TwinTriggerField
  258.  * @extends Ext.form.TriggerField
  259.  * TwinTriggerField is not a public class to be used directly.  It is meant as an abstract base class
  260.  * to be extended by an implementing class.  For an example of implementing this class, see the custom
  261.  * SearchField implementation here:
  262.  * <a href="http://extjs.com/deploy/ext/examples/form/custom.html">http://extjs.com/deploy/ext/examples/form/custom.html</a>
  263.  */
  264. Ext.form.TwinTriggerField = Ext.extend(Ext.form.TriggerField, {
  265.     /**
  266.      * @cfg {Mixed} triggerConfig
  267.      * <p>A {@link Ext.DomHelper DomHelper} config object specifying the structure of the trigger elements
  268.      * for this Field. (Optional).</p>
  269.      * <p>Specify this when you need a customized element to contain the two trigger elements for this Field.
  270.      * Each trigger element must be marked by the CSS class <tt>x-form-trigger</tt> (also see
  271.      * <tt>{@link #trigger1Class}</tt> and <tt>{@link #trigger2Class}</tt>).</p>
  272.      * <p>Note that when using this option, it is the developer's responsibility to ensure correct sizing,
  273.      * positioning and appearance of the triggers.</p>
  274.      */
  275.     /**
  276.      * @cfg {String} trigger1Class
  277.      * An additional CSS class used to style the trigger button.  The trigger will always get the
  278.      * class <tt>'x-form-trigger'</tt> by default and <tt>triggerClass</tt> will be <b>appended</b> if specified.
  279.      */
  280.     /**
  281.      * @cfg {String} trigger2Class
  282.      * An additional CSS class used to style the trigger button.  The trigger will always get the
  283.      * class <tt>'x-form-trigger'</tt> by default and <tt>triggerClass</tt> will be <b>appended</b> if specified.
  284.      */
  285.     initComponent : function(){
  286.         Ext.form.TwinTriggerField.superclass.initComponent.call(this);
  287.         this.triggerConfig = {
  288.             tag:'span', cls:'x-form-twin-triggers', cn:[
  289.             {tag: "img", src: Ext.BLANK_IMAGE_URL, cls: "x-form-trigger " + this.trigger1Class},
  290.             {tag: "img", src: Ext.BLANK_IMAGE_URL, cls: "x-form-trigger " + this.trigger2Class}
  291.         ]};
  292.     },
  293.     getTrigger : function(index){
  294.         return this.triggers[index];
  295.     },
  296.     initTrigger : function(){
  297.         var ts = this.trigger.select('.x-form-trigger', true);
  298.         var triggerField = this;
  299.         ts.each(function(t, all, index){
  300.             var triggerIndex = 'Trigger'+(index+1);
  301.             t.hide = function(){
  302.                 var w = triggerField.wrap.getWidth();
  303.                 this.dom.style.display = 'none';
  304.                 triggerField.el.setWidth(w-triggerField.trigger.getWidth());
  305.                 this['hidden' + triggerIndex] = true;
  306.             };
  307.             t.show = function(){
  308.                 var w = triggerField.wrap.getWidth();
  309.                 this.dom.style.display = '';
  310.                 triggerField.el.setWidth(w-triggerField.trigger.getWidth());
  311.                 this['hidden' + triggerIndex] = false;
  312.             };
  313.             if(this['hide'+triggerIndex]){
  314.                 t.dom.style.display = 'none';
  315.                 this['hidden' + triggerIndex] = true;
  316.             }
  317.             this.mon(t, 'click', this['on'+triggerIndex+'Click'], this, {preventDefault:true});
  318.             t.addClassOnOver('x-form-trigger-over');
  319.             t.addClassOnClick('x-form-trigger-click');
  320.         }, this);
  321.         this.triggers = ts.elements;
  322.     },
  323.     getTriggerWidth: function(){
  324.         var tw = 0;
  325.         Ext.each(this.triggers, function(t, index){
  326.             var triggerIndex = 'Trigger' + (index + 1),
  327.                 w = t.getWidth();
  328.             if(w === 0 && !this['hidden' + triggerIndex]){
  329.                 tw += this.defaultTriggerWidth;
  330.             }else{
  331.                 tw += w;
  332.             }
  333.         }, this);
  334.         return tw;
  335.     },
  336.     // private
  337.     onDestroy : function() {
  338.         Ext.destroy(this.triggers);
  339.         Ext.form.TwinTriggerField.superclass.onDestroy.call(this);
  340.     },
  341.     /**
  342.      * The function that should handle the trigger's click event.  This method does nothing by default
  343.      * until overridden by an implementing function. See {@link Ext.form.TriggerField#onTriggerClick}
  344.      * for additional information.
  345.      * @method
  346.      * @param {EventObject} e
  347.      */
  348.     onTrigger1Click : Ext.emptyFn,
  349.     /**
  350.      * The function that should handle the trigger's click event.  This method does nothing by default
  351.      * until overridden by an implementing function. See {@link Ext.form.TriggerField#onTriggerClick}
  352.      * for additional information.
  353.      * @method
  354.      * @param {EventObject} e
  355.      */
  356.     onTrigger2Click : Ext.emptyFn
  357. });
  358. Ext.reg('trigger', Ext.form.TriggerField);