Upgrade to ExtJS 3.2.1 - Released 04/27/2010
[extjs.git] / docs / source / Radio.html
1 <html>
2 <head>
3   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />    
4   <title>The source code</title>
5     <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
6     <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
7 </head>
8 <body  onload="prettyPrint();">
9     <pre class="prettyprint lang-js">/*!
10  * Ext JS Library 3.2.1
11  * Copyright(c) 2006-2010 Ext JS, Inc.
12  * licensing@extjs.com
13  * http://www.extjs.com/license
14  */
15 <div id="cls-Ext.form.Radio"></div>/**
16  * @class Ext.form.Radio
17  * @extends Ext.form.Checkbox
18  * Single radio field.  Same as Checkbox, but provided as a convenience for automatically setting the input type.
19  * Radio grouping is handled automatically by the browser if you give each radio in a group the same name.
20  * @constructor
21  * Creates a new Radio
22  * @param {Object} config Configuration options
23  * @xtype radio
24  */
25 Ext.form.Radio = Ext.extend(Ext.form.Checkbox, {
26     inputType: 'radio',
27
28     <div id="method-Ext.form.Radio-markInvalid"></div>/**
29      * Overridden and disabled. The editor element does not support standard valid/invalid marking. @hide
30      * @method
31      */
32     markInvalid : Ext.emptyFn,
33     <div id="method-Ext.form.Radio-clearInvalid"></div>/**
34      * Overridden and disabled. The editor element does not support standard valid/invalid marking. @hide
35      * @method
36      */
37     clearInvalid : Ext.emptyFn,
38
39     <div id="method-Ext.form.Radio-getGroupValue"></div>/**
40      * If this radio is part of a group, it will return the selected value
41      * @return {String}
42      */
43     getGroupValue : function(){
44         var p = this.el.up('form') || Ext.getBody();
45         var c = p.child('input[name='+this.el.dom.name+']:checked', true);
46         return c ? c.value : null;
47     },
48
49     // private
50     onClick : function(){
51         if(this.el.dom.checked != this.checked){
52                         var els = this.getCheckEl().select('input[name=' + this.el.dom.name + ']');
53                         els.each(function(el){
54                                 if(el.dom.id == this.id){
55                                         this.setValue(true);
56                                 }else{
57                                         Ext.getCmp(el.dom.id).setValue(false);
58                                 }
59                         }, this);
60                 }
61     },
62
63     <div id="method-Ext.form.Radio-setValue"></div>/**
64      * Sets either the checked/unchecked status of this Radio, or, if a string value
65      * is passed, checks a sibling Radio of the same name whose value is the value specified.
66      * @param value {String/Boolean} Checked value, or the value of the sibling radio button to check.
67      * @return {Ext.form.Field} this
68      */
69     setValue : function(v){
70         if (typeof v == 'boolean') {
71             Ext.form.Radio.superclass.setValue.call(this, v);
72         } else if (this.rendered) {
73             var r = this.getCheckEl().child('input[name=' + this.el.dom.name + '][value=' + v + ']', true);
74             if(r){
75                 Ext.getCmp(r.id).setValue(true);
76             }
77         }
78         return this;
79     },
80
81     // private
82     getCheckEl: function(){
83         if(this.inGroup){
84             return this.el.up('.x-form-radio-group')
85         }
86         return this.el.up('form') || Ext.getBody();
87     }
88 });
89 Ext.reg('radio', Ext.form.Radio);
90 </pre>    
91 </body>
92 </html>