docs/source/Hidden.html

   1 <!DOCTYPE html><html><head><title>Sencha Documentation Project</title><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../prettify.css" type="text/css"><link rel="stylesheet" href="../prettify_sa.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script></head><body onload="prettyPrint()"><pre class="prettyprint"><pre><span id='Ext-form.field.Hidden-method-constructor'><span id='Ext-form.field.Hidden'>/**
   2 </span></span> * @class Ext.form.field.Hidden
   3  * @extends Ext.form.field.Base
   4  * &lt;p&gt;A basic hidden field for storing hidden values in forms that need to be passed in the form submit.&lt;/p&gt;
   5  * &lt;p&gt;This creates an actual input element with type=&quot;submit&quot; in the DOM. While its label is
   6  * {@link #hideLabel not rendered} by default, it is still a real component and may be sized according to
   7  * its owner container's layout.&lt;/p&gt;
   8  * &lt;p&gt;Because of this, in most cases it is more convenient and less problematic to simply
   9  * {@link Ext.form.action.Action#params pass hidden parameters} directly when
  10  * {@link Ext.form.Basic#submit submitting the form}.&lt;/p&gt;
  11  * &lt;p&gt;Example:&lt;/p&gt;
  12  * &lt;pre&gt;&lt;code&gt;new Ext.form.Panel({
  13     title: 'My Form',
  14     items: [{
  15         xtype: 'textfield',
  16         fieldLabel: 'Text Field',
  17         name: 'text_field',
  18         value: 'value from text field'
  19     }, {
  20         xtype: 'hiddenfield',
  21         name: 'hidden_field_1',
  22         value: 'value from hidden field'
  23     }],
  24
  25     buttons: [{
  26         text: 'Submit',
  27         handler: function() {
  28             this.up('form').getForm().submit({
  29                 params: {
  30                     hidden_field_2: 'value from submit call'
  31                 }
  32             });
  33         }
  34     }]
  35 });&lt;/code&gt;&lt;/pre&gt;
  36  * &lt;p&gt;Submitting the above form will result in three values sent to the server:
  37  * &lt;code&gt;text_field=value+from+text+field&amp;hidden_field_1=value+from+hidden+field&amp;&lt;br&gt;hidden_field_2=value+from+submit+call&lt;/code&gt;&lt;/p&gt;
  38  *
  39  * @constructor
  40  * Create a new Hidden field.
  41  * @param {Object} config Configuration options
  42  *
  43  * @xtype hiddenfield
  44  */
  45 Ext.define('Ext.form.field.Hidden', {
  46     extend:'Ext.form.field.Base',
  47     alias: ['widget.hiddenfield', 'widget.hidden'],
  48     alternateClassName: 'Ext.form.Hidden',
  49
  50     // private
  51     inputType : 'hidden',
  52     hideLabel: true,
  53
  54     initComponent: function(){
  55         this.formItemCls += '-hidden';
  56         this.callParent();
  57     },
  58
  59     // These are all private overrides
  60     initEvents: Ext.emptyFn,
  61     setSize : Ext.emptyFn,
  62     setWidth : Ext.emptyFn,
  63     setHeight : Ext.emptyFn,
  64     setPosition : Ext.emptyFn,
  65     setPagePosition : Ext.emptyFn,
  66     markInvalid : Ext.emptyFn,
  67     clearInvalid : Ext.emptyFn
  68 });
  69 </pre></pre></body></html>