docs/source/Checkbox.html

   1 <html>\r
   2 <head>\r
   3   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    \r
   4   <title>The source code</title>\r
   5     <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
   6     <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
   7 </head>\r
   8 <body  onload="prettyPrint();">\r
   9     <pre class="prettyprint lang-js"><div id="cls-Ext.form.Checkbox"></div>/**
  10  * @class Ext.form.Checkbox
  11  * @extends Ext.form.Field
  12  * Single checkbox field.  Can be used as a direct replacement for traditional checkbox fields.
  13  * @constructor
  14  * Creates a new Checkbox
  15  * @param {Object} config Configuration options
  16  * @xtype checkbox
  17  */
  18 Ext.form.Checkbox = Ext.extend(Ext.form.Field,  {
  19     <div id="cfg-Ext.form.Checkbox-focusClass"></div>/**
  20      * @cfg {String} focusClass The CSS class to use when the checkbox receives focus (defaults to undefined)
  21      */
  22     focusClass : undefined,
  23     <div id="cfg-Ext.form.Checkbox-fieldClass"></div>/**
  24      * @cfg {String} fieldClass The default CSS class for the checkbox (defaults to 'x-form-field')
  25      */
  26     fieldClass : 'x-form-field',
  27     <div id="cfg-Ext.form.Checkbox-checked"></div>/**
  28      * @cfg {Boolean} checked <tt>true</tt> if the checkbox should render initially checked (defaults to <tt>false</tt>)
  29      */
  30     checked : false,
  31     <div id="cfg-Ext.form.Checkbox-autoCreate"></div>/**
  32      * @cfg {String/Object} autoCreate A DomHelper element spec, or true for a default element spec (defaults to
  33      * {tag: 'input', type: 'checkbox', autocomplete: 'off'})
  34      */
  35     defaultAutoCreate : { tag: 'input', type: 'checkbox', autocomplete: 'off'},
  36     <div id="cfg-Ext.form.Checkbox-boxLabel"></div>/**
  37      * @cfg {String} boxLabel The text that appears beside the checkbox
  38      */
  39     <div id="cfg-Ext.form.Checkbox-inputValue"></div>/**
  40      * @cfg {String} inputValue The value that should go into the generated input element's value attribute
  41      */
  42     <div id="cfg-Ext.form.Checkbox-handler"></div>/**
  43      * @cfg {Function} handler A function called when the {@link #checked} value changes (can be used instead of
  44      * handling the check event). The handler is passed the following parameters:
  45      * <div class="mdetail-params"><ul>
  46      * <li><b>checkbox</b> : Ext.form.Checkbox<div class="sub-desc">The Checkbox being toggled.</div></li>
  47      * <li><b>checked</b> : Boolean<div class="sub-desc">The new checked state of the checkbox.</div></li>
  48      * </ul></div>
  49      */
  50     <div id="cfg-Ext.form.Checkbox-scope"></div>/**
  51      * @cfg {Object} scope An object to use as the scope ('this' reference) of the {@link #handler} function
  52      * (defaults to this Checkbox).
  53      */
  54
  55     // private
  56     actionMode : 'wrap',
  57
  58         // private
  59     initComponent : function(){
  60         Ext.form.Checkbox.superclass.initComponent.call(this);
  61         this.addEvents(
  62             <div id="event-Ext.form.Checkbox-check"></div>/**
  63              * @event check
  64              * Fires when the checkbox is checked or unchecked.
  65              * @param {Ext.form.Checkbox} this This checkbox
  66              * @param {Boolean} checked The new checked value
  67              */
  68             'check'
  69         );
  70     },
  71
  72     // private
  73     onResize : function(){
  74         Ext.form.Checkbox.superclass.onResize.apply(this, arguments);
  75         if(!this.boxLabel && !this.fieldLabel){
  76             this.el.alignTo(this.wrap, 'c-c');
  77         }
  78     },
  79
  80     // private
  81     initEvents : function(){
  82         Ext.form.Checkbox.superclass.initEvents.call(this);
  83         this.mon(this.el, {
  84             scope: this,
  85             click: this.onClick,
  86             change: this.onClick
  87         });
  88     },
  89
  90     <div id="method-Ext.form.Checkbox-markInvalid"></div>/**
  91      * @hide
  92      * Overridden and disabled. The editor element does not support standard valid/invalid marking.
  93      * @method
  94      */
  95     markInvalid : Ext.emptyFn,
  96     <div id="method-Ext.form.Checkbox-clearInvalid"></div>/**
  97      * @hide
  98      * Overridden and disabled. The editor element does not support standard valid/invalid marking.
  99      * @method
 100      */
 101     clearInvalid : Ext.emptyFn,
 102
 103     // private
 104     onRender : function(ct, position){
 105         Ext.form.Checkbox.superclass.onRender.call(this, ct, position);
 106         if(this.inputValue !== undefined){
 107             this.el.dom.value = this.inputValue;
 108         }
 109         this.wrap = this.el.wrap({cls: 'x-form-check-wrap'});
 110         if(this.boxLabel){
 111             this.wrap.createChild({tag: 'label', htmlFor: this.el.id, cls: 'x-form-cb-label', html: this.boxLabel});
 112         }
 113         if(this.checked){
 114             this.setValue(true);
 115         }else{
 116             this.checked = this.el.dom.checked;
 117         }
 118         // Need to repaint for IE, otherwise positioning is broken
 119         if(Ext.isIE){
 120             this.wrap.repaint();
 121         }
 122         this.resizeEl = this.positionEl = this.wrap;
 123         if(Ext.isEmpty(this.boxLabel)){
 124             this.el.addClass('x-form-check-nolabel');
 125         }
 126     },
 127
 128     // private
 129     onDestroy : function(){
 130         Ext.destroy(this.wrap);
 131         Ext.form.Checkbox.superclass.onDestroy.call(this);
 132     },
 133
 134     // private
 135     initValue : function() {
 136         this.originalValue = this.getValue();
 137     },
 138
 139     <div id="method-Ext.form.Checkbox-getValue"></div>/**
 140      * Returns the checked state of the checkbox.
 141      * @return {Boolean} True if checked, else false
 142      */
 143     getValue : function(){
 144         if(this.rendered){
 145             return this.el.dom.checked;
 146         }
 147         return this.checked;
 148     },
 149
 150         // private
 151     onClick : function(){
 152         if(this.el.dom.checked != this.checked){
 153             this.setValue(this.el.dom.checked);
 154         }
 155     },
 156
 157     <div id="method-Ext.form.Checkbox-setValue"></div>/**
 158      * Sets the checked state of the checkbox, fires the 'check' event, and calls a
 159      * <code>{@link #handler}</code> (if configured).
 160      * @param {Boolean/String} checked The following values will check the checkbox:
 161      * <code>true, 'true', '1', or 'on'</code>. Any other value will uncheck the checkbox.
 162      * @return {Ext.form.Field} this
 163      */
 164     setValue : function(v){
 165         var checked = this.checked ;
 166         this.checked = (v === true || v === 'true' || v == '1' || String(v).toLowerCase() == 'on');
 167         if(this.rendered){
 168             this.el.dom.checked = this.checked;
 169             this.el.dom.defaultChecked = this.checked;
 170         }
 171         if(checked != this.checked){
 172             this.fireEvent('check', this, this.checked);
 173             if(this.handler){
 174                 this.handler.call(this.scope || this, this, this.checked);
 175             }
 176         }
 177         return this;
 178     }
 179 });
 180 Ext.reg('checkbox', Ext.form.Checkbox);
 181 </pre>    \r
 182 </body>\r
 183 </html>