Upgrade to ExtJS 4.0.2 - Released 06/09/2011
[extjs.git] / docs / source / Hidden.html
1 <!DOCTYPE html>
2 <html>
3 <head>
4   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5   <title>The source code</title>
6   <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
7   <script type="text/javascript" src="../prettify/prettify.js"></script>
8   <style type="text/css">
9     .highlight { display: block; background-color: #ddd; }
10   </style>
11   <script type="text/javascript">
12     function highlight() {
13       document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
14     }
15   </script>
16 </head>
17 <body onload="prettyPrint(); highlight();">
18   <pre class="prettyprint lang-js"><span id='Ext-form-field-Hidden'>/**
19 </span> * @class Ext.form.field.Hidden
20  * @extends Ext.form.field.Base
21  * &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;
22  * &lt;p&gt;This creates an actual input element with type=&quot;submit&quot; in the DOM. While its label is
23  * {@link #hideLabel not rendered} by default, it is still a real component and may be sized according to
24  * its owner container's layout.&lt;/p&gt;
25  * &lt;p&gt;Because of this, in most cases it is more convenient and less problematic to simply
26  * {@link Ext.form.action.Action#params pass hidden parameters} directly when
27  * {@link Ext.form.Basic#submit submitting the form}.&lt;/p&gt;
28  * &lt;p&gt;Example:&lt;/p&gt;
29  * &lt;pre&gt;&lt;code&gt;new Ext.form.Panel({
30     title: 'My Form',
31     items: [{
32         xtype: 'textfield',
33         fieldLabel: 'Text Field',
34         name: 'text_field',
35         value: 'value from text field'
36     }, {
37         xtype: 'hiddenfield',
38         name: 'hidden_field_1',
39         value: 'value from hidden field'
40     }],
41
42     buttons: [{
43         text: 'Submit',
44         handler: function() {
45             this.up('form').getForm().submit({
46                 params: {
47                     hidden_field_2: 'value from submit call'
48                 }
49             });
50         }
51     }]
52 });&lt;/code&gt;&lt;/pre&gt;
53  * &lt;p&gt;Submitting the above form will result in three values sent to the server:
54  * &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;
55  *
56  */
57 Ext.define('Ext.form.field.Hidden', {
58     extend:'Ext.form.field.Base',
59     alias: ['widget.hiddenfield', 'widget.hidden'],
60     alternateClassName: 'Ext.form.Hidden',
61
62     // private
63     inputType : 'hidden',
64     hideLabel: true,
65     
66     initComponent: function(){
67         this.formItemCls += '-hidden';
68         this.callParent();    
69     },
70
71     // These are all private overrides
72     initEvents: Ext.emptyFn,
73     setSize : Ext.emptyFn,
74     setWidth : Ext.emptyFn,
75     setHeight : Ext.emptyFn,
76     setPosition : Ext.emptyFn,
77     setPagePosition : Ext.emptyFn,
78     markInvalid : Ext.emptyFn,
79     clearInvalid : Ext.emptyFn
80 });
81 </pre>
82 </body>
83 </html>