+<!DOCTYPE html>
<html>
<head>
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>The source code</title>
- <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
- <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+ <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
+ <script type="text/javascript" src="../prettify/prettify.js"></script>
+ <style type="text/css">
+ .highlight { display: block; background-color: #ddd; }
+ </style>
+ <script type="text/javascript">
+ function highlight() {
+ document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
+ }
+ </script>
</head>
-<body onload="prettyPrint();">
- <pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
- * licensing@extjs.com
- * http://www.extjs.com/license
+<body onload="prettyPrint(); highlight();">
+ <pre class="prettyprint lang-js"><span id='Ext-form-RadioGroup'>/**
+</span> * A {@link Ext.form.FieldContainer field container} which has a specialized layout for arranging
+ * {@link Ext.form.field.Radio} controls into columns, and provides convenience {@link Ext.form.field.Field}
+ * methods for {@link #getValue getting}, {@link #setValue setting}, and {@link #validate validating} the
+ * group of radio buttons as a whole.
+ *
+ * # Validation
+ *
+ * Individual radio buttons themselves have no default validation behavior, but
+ * sometimes you want to require a user to select one of a group of radios. RadioGroup
+ * allows this by setting the config `{@link #allowBlank}:false`; when the user does not check at
+ * one of the radio buttons, the entire group will be highlighted as invalid and the
+ * {@link #blankText error message} will be displayed according to the {@link #msgTarget} config.</p>
+ *
+ * # Layout
+ *
+ * The default layout for RadioGroup makes it easy to arrange the radio buttons into
+ * columns; see the {@link #columns} and {@link #vertical} config documentation for details. You may also
+ * use a completely different layout by setting the {@link #layout} to one of the other supported layout
+ * types; for instance you may wish to use a custom arrangement of hbox and vbox containers. In that case
+ * the Radio components at any depth will still be managed by the RadioGroup's validation.
+ *
+ * {@img Ext.form.RadioGroup/Ext.form.RadioGroup.png Ext.form.RadioGroup component}
+ *
+ * # Example usage
+ *
+ * Ext.create('Ext.form.Panel', {
+ * title: 'RadioGroup Example',
+ * width: 300,
+ * height: 125,
+ * bodyPadding: 10,
+ * renderTo: Ext.getBody(),
+ * items:[{
+ * xtype: 'radiogroup',
+ * fieldLabel: 'Two Columns',
+ * // Arrange radio buttons into two columns, distributed vertically
+ * columns: 2,
+ * vertical: true,
+ * items: [
+ * {boxLabel: 'Item 1', name: 'rb', inputValue: '1'},
+ * {boxLabel: 'Item 2', name: 'rb', inputValue: '2', checked: true},
+ * {boxLabel: 'Item 3', name: 'rb', inputValue: '3'},
+ * {boxLabel: 'Item 4', name: 'rb', inputValue: '4'},
+ * {boxLabel: 'Item 5', name: 'rb', inputValue: '5'},
+ * {boxLabel: 'Item 6', name: 'rb', inputValue: '6'}
+ * ]
+ * }]
+ * });
+ *
*/
-<div id="cls-Ext.form.RadioGroup"></div>/**\r
- * @class Ext.form.RadioGroup\r
- * @extends Ext.form.CheckboxGroup\r
- * A grouping container for {@link Ext.form.Radio} controls.\r
- * @constructor\r
- * Creates a new RadioGroup\r
- * @param {Object} config Configuration options\r
- * @xtype radiogroup\r
- */\r
-Ext.form.RadioGroup = Ext.extend(Ext.form.CheckboxGroup, {\r
- <div id="cfg-Ext.form.RadioGroup-allowBlank"></div>/**\r
- * @cfg {Boolean} allowBlank True to allow every item in the group to be blank (defaults to true).\r
- * If allowBlank = false and no items are selected at validation time, {@link @blankText} will\r
- * be used as the error text.\r
- */\r
- allowBlank : true,\r
- <div id="cfg-Ext.form.RadioGroup-blankText"></div>/**\r
- * @cfg {String} blankText Error text to display if the {@link #allowBlank} validation fails\r
- * (defaults to 'You must select one item in this group')\r
- */\r
- blankText : 'You must select one item in this group',\r
- \r
- // private\r
- defaultType : 'radio',\r
- \r
- // private\r
- groupCls : 'x-form-radio-group',\r
- \r
- <div id="event-Ext.form.RadioGroup-change"></div>/**\r
- * @event change\r
- * Fires when the state of a child radio changes.\r
- * @param {Ext.form.RadioGroup} this\r
- * @param {Ext.form.Radio} checked The checked radio\r
- */\r
- \r
- <div id="method-Ext.form.RadioGroup-getValue"></div>/**\r
- * Gets the selected {@link Ext.form.Radio} in the group, if it exists.\r
- * @return {Ext.form.Radio} The selected radio.\r
- */\r
- getValue : function(){\r
- var out = null;\r
- this.eachItem(function(item){\r
- if(item.checked){\r
- out = item;\r
- return false;\r
- }\r
- });\r
- return out;\r
- },\r
- \r
- <div id="method-Ext.form.RadioGroup-onSetValue"></div>/**\r
- * Sets the checked radio in the group.\r
- * @param {String/Ext.form.Radio} id The radio to check.\r
- * @param {Boolean} value The value to set the radio.\r
- * @return {Ext.form.RadioGroup} this\r
- */\r
- onSetValue : function(id, value){\r
- if(arguments.length > 1){\r
- var f = this.getBox(id);\r
- if(f){\r
- f.setValue(value);\r
- if(f.checked){\r
- this.eachItem(function(item){\r
- if (item !== f){\r
- item.setValue(false);\r
- }\r
- });\r
- }\r
- }\r
- }else{\r
- this.setValueForItem(id);\r
- }\r
- },\r
- \r
- setValueForItem : function(val){\r
- val = String(val).split(',')[0];\r
- this.eachItem(function(item){\r
- item.setValue(val == item.inputValue);\r
- });\r
- },\r
- \r
- // private\r
- fireChecked : function(){\r
- if(!this.checkTask){\r
- this.checkTask = new Ext.util.DelayedTask(this.bufferChecked, this);\r
- }\r
- this.checkTask.delay(10);\r
- },\r
- \r
- // private\r
- bufferChecked : function(){\r
- var out = null;\r
- this.eachItem(function(item){\r
- if(item.checked){\r
- out = item;\r
- return false;\r
- }\r
- });\r
- this.fireEvent('change', this, out);\r
- },\r
- \r
- onDestroy : function(){\r
- if(this.checkTask){\r
- this.checkTask.cancel();\r
- this.checkTask = null;\r
- }\r
- Ext.form.RadioGroup.superclass.onDestroy.call(this);\r
- }\r
-\r
-});\r
-\r
-Ext.reg('radiogroup', Ext.form.RadioGroup);\r
+Ext.define('Ext.form.RadioGroup', {
+ extend: 'Ext.form.CheckboxGroup',
+ alias: 'widget.radiogroup',
+
+<span id='Ext-form-RadioGroup-cfg-items'> /**
+</span> * @cfg {Array} items An Array of {@link Ext.form.field.Radio Radio}s or Radio config objects
+ * to arrange in the group.
+ */
+<span id='Ext-form-RadioGroup-cfg-allowBlank'> /**
+</span> * @cfg {Boolean} allowBlank True to allow every item in the group to be blank (defaults to true).
+ * If allowBlank = false and no items are selected at validation time, {@link #blankText} will
+ * be used as the error text.
+ */
+ allowBlank : true,
+<span id='Ext-form-RadioGroup-cfg-blankText'> /**
+</span> * @cfg {String} blankText Error text to display if the {@link #allowBlank} validation fails
+ * (defaults to 'You must select one item in this group')
+ */
+ blankText : 'You must select one item in this group',
+
+ // private
+ defaultType : 'radiofield',
+
+ // private
+ groupCls : Ext.baseCSSPrefix + 'form-radio-group',
+
+ getBoxes: function() {
+ return this.query('[isRadio]');
+ }
+
+});
</pre>
</body>
-</html>
\ No newline at end of file
+</html>
git.ithinksw.org / extjs.git / blobdiff