<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>
</head>
<body onload="prettyPrint();">
<pre class="prettyprint lang-js">/*!
- * Ext JS Library 3.0.3
- * Copyright(c) 2006-2009 Ext JS, LLC
+ * Ext JS Library 3.2.1
+ * Copyright(c) 2006-2010 Ext JS, Inc.
* licensing@extjs.com
* http://www.extjs.com/license
*/
-<div id="cls-Ext.form.CheckboxGroup"></div>/**\r
- * @class Ext.form.CheckboxGroup\r
- * @extends Ext.form.Field\r
- * <p>A grouping container for {@link Ext.form.Checkbox} controls.</p>\r
- * <p>Sample usage:</p>\r
- * <pre><code>\r
-var myCheckboxGroup = new Ext.form.CheckboxGroup({\r
- id:'myGroup',\r
- xtype: 'checkboxgroup',\r
- fieldLabel: 'Single Column',\r
- itemCls: 'x-check-group-alt',\r
- // Put all controls in a single column with width 100%\r
- columns: 1,\r
- items: [\r
- {boxLabel: 'Item 1', name: 'cb-col-1'},\r
- {boxLabel: 'Item 2', name: 'cb-col-2', checked: true},\r
- {boxLabel: 'Item 3', name: 'cb-col-3'}\r
- ]\r
-});\r
- * </code></pre>\r
- * @constructor\r
- * Creates a new CheckboxGroup\r
- * @param {Object} config Configuration options\r
- * @xtype checkboxgroup\r
- */\r
-Ext.form.CheckboxGroup = Ext.extend(Ext.form.Field, {\r
- <div id="cfg-Ext.form.CheckboxGroup-items"></div>/**\r
- * @cfg {Array} items An Array of {@link Ext.form.Checkbox Checkbox}es or Checkbox config objects\r
- * to arrange in the group.\r
- */\r
- <div id="cfg-Ext.form.CheckboxGroup-columns"></div>/**\r
- * @cfg {String/Number/Array} columns Specifies the number of columns to use when displaying grouped\r
- * checkbox/radio controls using automatic layout. This config can take several types of values:\r
- * <ul><li><b>'auto'</b> : <p class="sub-desc">The controls will be rendered one per column on one row and the width\r
- * of each column will be evenly distributed based on the width of the overall field container. This is the default.</p></li>\r
- * <li><b>Number</b> : <p class="sub-desc">If you specific a number (e.g., 3) that number of columns will be \r
- * created and the contained controls will be automatically distributed based on the value of {@link #vertical}.</p></li>\r
- * <li><b>Array</b> : Object<p class="sub-desc">You can also specify an array of column widths, mixing integer\r
- * (fixed width) and float (percentage width) values as needed (e.g., [100, .25, .75]). Any integer values will\r
- * be rendered first, then any float values will be calculated as a percentage of the remaining space. Float\r
- * values do not have to add up to 1 (100%) although if you want the controls to take up the entire field\r
- * container you should do so.</p></li></ul>\r
- */\r
- columns : 'auto',\r
- <div id="cfg-Ext.form.CheckboxGroup-vertical"></div>/**\r
- * @cfg {Boolean} vertical True to distribute contained controls across columns, completely filling each column \r
- * top to bottom before starting on the next column. The number of controls in each column will be automatically\r
- * calculated to keep columns as even as possible. The default value is false, so that controls will be added\r
- * to columns one at a time, completely filling each row left to right before starting on the next row.\r
- */\r
- vertical : false,\r
- <div id="cfg-Ext.form.CheckboxGroup-allowBlank"></div>/**\r
- * @cfg {Boolean} allowBlank False to validate that at least one item in the group is checked (defaults to true).\r
- * If no items are selected at validation time, {@link @blankText} will be used as the error text.\r
- */\r
- allowBlank : true,\r
- <div id="cfg-Ext.form.CheckboxGroup-blankText"></div>/**\r
- * @cfg {String} blankText Error text to display if the {@link #allowBlank} validation fails (defaults to "You must \r
- * select at least one item in this group")\r
- */\r
- blankText : "You must select at least one item in this group",\r
- \r
- // private\r
- defaultType : 'checkbox',\r
- \r
- // private\r
- groupCls : 'x-form-check-group',\r
- \r
- // private\r
- initComponent: function(){\r
- this.addEvents(\r
- <div id="event-Ext.form.CheckboxGroup-change"></div>/**\r
- * @event change\r
- * Fires when the state of a child checkbox changes.\r
- * @param {Ext.form.CheckboxGroup} this\r
- * @param {Array} checked An array containing the checked boxes.\r
- */\r
- 'change'\r
- ); \r
- Ext.form.CheckboxGroup.superclass.initComponent.call(this);\r
- },\r
- \r
- // private\r
- onRender : function(ct, position){\r
- if(!this.el){\r
- var panelCfg = {\r
- id: this.id,\r
- cls: this.groupCls,\r
- layout: 'column',\r
- border: false,\r
- renderTo: ct,\r
- bufferResize: false // Default this to false, since it doesn't really have a proper ownerCt.\r
- };\r
- var colCfg = {\r
- defaultType: this.defaultType,\r
- layout: 'form',\r
- border: false,\r
- defaults: {\r
- hideLabel: true,\r
- anchor: '100%'\r
- }\r
- };\r
- \r
- if(this.items[0].items){\r
- \r
- // The container has standard ColumnLayout configs, so pass them in directly\r
- \r
- Ext.apply(panelCfg, {\r
- layoutConfig: {columns: this.items.length},\r
- defaults: this.defaults,\r
- items: this.items\r
- });\r
- for(var i=0, len=this.items.length; i<len; i++){\r
- Ext.applyIf(this.items[i], colCfg);\r
- }\r
- \r
- }else{\r
- \r
- // The container has field item configs, so we have to generate the column\r
- // panels first then move the items into the columns as needed.\r
- \r
- var numCols, cols = [];\r
- \r
- if(typeof this.columns == 'string'){ // 'auto' so create a col per item\r
- this.columns = this.items.length;\r
- }\r
- if(!Ext.isArray(this.columns)){\r
- var cs = [];\r
- for(var i=0; i<this.columns; i++){\r
- cs.push((100/this.columns)*.01); // distribute by even %\r
- }\r
- this.columns = cs;\r
- }\r
- \r
- numCols = this.columns.length;\r
- \r
- // Generate the column configs with the correct width setting\r
- for(var i=0; i<numCols; i++){\r
- var cc = Ext.apply({items:[]}, colCfg);\r
- cc[this.columns[i] <= 1 ? 'columnWidth' : 'width'] = this.columns[i];\r
- if(this.defaults){\r
- cc.defaults = Ext.apply(cc.defaults || {}, this.defaults)\r
- }\r
- cols.push(cc);\r
- };\r
- \r
- // Distribute the original items into the columns\r
- if(this.vertical){\r
- var rows = Math.ceil(this.items.length / numCols), ri = 0;\r
- for(var i=0, len=this.items.length; i<len; i++){\r
- if(i>0 && i%rows==0){\r
- ri++;\r
- }\r
- if(this.items[i].fieldLabel){\r
- this.items[i].hideLabel = false;\r
- }\r
- cols[ri].items.push(this.items[i]);\r
- };\r
- }else{\r
- for(var i=0, len=this.items.length; i<len; i++){\r
- var ci = i % numCols;\r
- if(this.items[i].fieldLabel){\r
- this.items[i].hideLabel = false;\r
- }\r
- cols[ci].items.push(this.items[i]);\r
- };\r
- }\r
- \r
- Ext.apply(panelCfg, {\r
- layoutConfig: {columns: numCols},\r
- items: cols\r
- });\r
- }\r
- \r
- this.panel = new Ext.Panel(panelCfg);\r
- this.panel.ownerCt = this;\r
- this.el = this.panel.getEl();\r
- \r
- if(this.forId && this.itemCls){\r
- var l = this.el.up(this.itemCls).child('label', true);\r
- if(l){\r
- l.setAttribute('htmlFor', this.forId);\r
- }\r
- }\r
- \r
- var fields = this.panel.findBy(function(c){\r
- return c.isFormField;\r
- }, this);\r
- \r
- this.items = new Ext.util.MixedCollection();\r
- this.items.addAll(fields);\r
- }\r
- Ext.form.CheckboxGroup.superclass.onRender.call(this, ct, position);\r
- },\r
- \r
- initValue : function(){\r
- if(this.value){\r
- this.setValue.apply(this, this.buffered ? this.value : [this.value]);\r
- delete this.buffered;\r
- delete this.value;\r
- }\r
- },\r
- \r
- afterRender : function(){\r
- Ext.form.CheckboxGroup.superclass.afterRender.call(this);\r
- this.eachItem(function(item){\r
- item.on('check', this.fireChecked, this);\r
- item.inGroup = true;\r
- });\r
- },\r
- \r
- // private\r
- doLayout: function(){\r
- //ugly method required to layout hidden items\r
- if(this.rendered){\r
- this.panel.forceLayout = this.ownerCt.forceLayout;\r
- this.panel.doLayout();\r
- }\r
- },\r
- \r
- // private\r
- fireChecked: function(){\r
- var arr = [];\r
- this.eachItem(function(item){\r
- if(item.checked){\r
- arr.push(item);\r
- }\r
- });\r
- this.fireEvent('change', this, arr);\r
- },\r
- \r
- // private\r
- validateValue : function(value){\r
- if(!this.allowBlank){\r
- var blank = true;\r
- this.eachItem(function(f){\r
- if(f.checked){\r
- return (blank = false);\r
- }\r
- });\r
- if(blank){\r
- this.markInvalid(this.blankText);\r
- return false;\r
- }\r
- }\r
- return true;\r
- },\r
- \r
- // private\r
- isDirty: function(){\r
- //override the behaviour to check sub items.\r
- if (this.disabled || !this.rendered) {\r
- return false;\r
- }\r
-\r
- var dirty = false;\r
- this.eachItem(function(item){\r
- if(item.isDirty()){\r
- dirty = true;\r
- return false;\r
- }\r
- });\r
- return dirty;\r
- },\r
- \r
- // private\r
- onDisable : function(){\r
- this.eachItem(function(item){\r
- item.disable();\r
- });\r
- },\r
-\r
- // private\r
- onEnable : function(){\r
- this.eachItem(function(item){\r
- item.enable();\r
- });\r
- },\r
- \r
- // private\r
- doLayout: function(){\r
- if(this.rendered){\r
- this.panel.forceLayout = this.ownerCt.forceLayout;\r
- this.panel.doLayout();\r
- }\r
- },\r
- \r
- // private\r
- onResize : function(w, h){\r
- this.panel.setSize(w, h);\r
- this.panel.doLayout();\r
- },\r
- \r
- // inherit docs from Field\r
- reset : function(){\r
- Ext.form.CheckboxGroup.superclass.reset.call(this);\r
- this.eachItem(function(c){\r
- if(c.reset){\r
- c.reset();\r
- }\r
- });\r
- },\r
- \r
- <div id="method-Ext.form.CheckboxGroup-setValue"></div>/**\r
- * {@link Ext.form.Checkbox#setValue Set the value(s)} of an item or items\r
- * in the group. Examples illustrating how this method may be called:\r
- * <pre><code>\r
-// call with name and value\r
-myCheckboxGroup.setValue('cb-col-1', true);\r
-// call with an array of boolean values \r
-myCheckboxGroup.setValue([true, false, false]);\r
-// call with an object literal specifying item:value pairs\r
-myCheckboxGroup.setValue({\r
- 'cb-col-2': false,\r
- 'cb-col-3': true\r
-});\r
-// use comma separated string to set items with name to true (checked)\r
-myCheckboxGroup.setValue('cb-col-1,cb-col-3');\r
- * </code></pre>\r
- * See {@link Ext.form.Checkbox#setValue} for additional information.\r
- * @param {Mixed} id The checkbox to check, or as described by example shown.\r
- * @param {Boolean} value (optional) The value to set the item.\r
- * @return {Ext.form.CheckboxGroup} this\r
- */\r
- setValue: function(){\r
- if(this.rendered){\r
- this.onSetValue.apply(this, arguments);\r
- }else{\r
- this.buffered = true;\r
- this.value = arguments;\r
- }\r
- return this;\r
- },\r
- \r
- onSetValue: function(id, value){\r
- if(arguments.length == 1){\r
- if(Ext.isArray(id)){\r
- // an array of boolean values\r
- Ext.each(id, function(val, idx){\r
- var item = this.items.itemAt(idx);\r
- if(item){\r
- item.setValue(val);\r
- }\r
- }, this);\r
- }else if(Ext.isObject(id)){\r
- // set of name/value pairs\r
- for(var i in id){\r
- var f = this.getBox(i);\r
- if(f){\r
- f.setValue(id[i]);\r
- }\r
- }\r
- }else{\r
- this.setValueForItem(id);\r
- }\r
- }else{\r
- var f = this.getBox(id);\r
- if(f){\r
- f.setValue(value);\r
- }\r
- }\r
- },\r
- \r
- // private\r
- onDestroy: function(){\r
- Ext.destroy(this.panel);\r
- Ext.form.CheckboxGroup.superclass.onDestroy.call(this);\r
-\r
- },\r
- \r
- setValueForItem : function(val){\r
- val = String(val).split(',');\r
- this.eachItem(function(item){\r
- if(val.indexOf(item.inputValue)> -1){\r
- item.setValue(true);\r
- }\r
- });\r
- },\r
- \r
- // private\r
- getBox : function(id){\r
- var box = null;\r
- this.eachItem(function(f){\r
- if(id == f || f.dataIndex == id || f.id == id || f.getName() == id){\r
- box = f;\r
- return false;\r
- }\r
- });\r
- return box;\r
- },\r
- \r
- <div id="method-Ext.form.CheckboxGroup-getValue"></div>/**\r
- * Gets an array of the selected {@link Ext.form.Checkbox} in the group.\r
- * @return {Array} An array of the selected checkboxes.\r
- */\r
- getValue : function(){\r
- var out = [];\r
- this.eachItem(function(item){\r
- if(item.checked){\r
- out.push(item);\r
- }\r
- });\r
- return out;\r
- },\r
- \r
- // private\r
- eachItem: function(fn){\r
- if(this.items && this.items.each){\r
- this.items.each(fn, this);\r
- }\r
- },\r
- \r
- <div id="cfg-Ext.form.CheckboxGroup-name"></div>/**\r
- * @cfg {String} name\r
- * @hide\r
- */\r
-\r
- <div id="method-Ext.form.CheckboxGroup-getRawValue"></div>/**\r
- * @method getRawValue\r
- * @hide\r
- */\r
- getRawValue : Ext.emptyFn,\r
- \r
- <div id="method-Ext.form.CheckboxGroup-setRawValue"></div>/**\r
- * @method setRawValue\r
- * @hide\r
- */\r
- setRawValue : Ext.emptyFn\r
- \r
-});\r
-\r
-Ext.reg('checkboxgroup', Ext.form.CheckboxGroup);\r
-</pre>
+<div id="cls-Ext.form.CheckboxGroup"></div>/**
+ * @class Ext.form.CheckboxGroup
+ * @extends Ext.form.Field
+ * <p>A grouping container for {@link Ext.form.Checkbox} controls.</p>
+ * <p>Sample usage:</p>
+ * <pre><code>
+var myCheckboxGroup = new Ext.form.CheckboxGroup({
+ id:'myGroup',
+ xtype: 'checkboxgroup',
+ fieldLabel: 'Single Column',
+ itemCls: 'x-check-group-alt',
+ // Put all controls in a single column with width 100%
+ columns: 1,
+ items: [
+ {boxLabel: 'Item 1', name: 'cb-col-1'},
+ {boxLabel: 'Item 2', name: 'cb-col-2', checked: true},
+ {boxLabel: 'Item 3', name: 'cb-col-3'}
+ ]
+});
+ * </code></pre>
+ * @constructor
+ * Creates a new CheckboxGroup
+ * @param {Object} config Configuration options
+ * @xtype checkboxgroup
+ */
+Ext.form.CheckboxGroup = Ext.extend(Ext.form.Field, {
+ <div id="cfg-Ext.form.CheckboxGroup-items"></div>/**
+ * @cfg {Array} items An Array of {@link Ext.form.Checkbox Checkbox}es or Checkbox config objects
+ * to arrange in the group.
+ */
+ <div id="cfg-Ext.form.CheckboxGroup-columns"></div>/**
+ * @cfg {String/Number/Array} columns Specifies the number of columns to use when displaying grouped
+ * checkbox/radio controls using automatic layout. This config can take several types of values:
+ * <ul><li><b>'auto'</b> : <p class="sub-desc">The controls will be rendered one per column on one row and the width
+ * of each column will be evenly distributed based on the width of the overall field container. This is the default.</p></li>
+ * <li><b>Number</b> : <p class="sub-desc">If you specific a number (e.g., 3) that number of columns will be
+ * created and the contained controls will be automatically distributed based on the value of {@link #vertical}.</p></li>
+ * <li><b>Array</b> : Object<p class="sub-desc">You can also specify an array of column widths, mixing integer
+ * (fixed width) and float (percentage width) values as needed (e.g., [100, .25, .75]). Any integer values will
+ * be rendered first, then any float values will be calculated as a percentage of the remaining space. Float
+ * values do not have to add up to 1 (100%) although if you want the controls to take up the entire field
+ * container you should do so.</p></li></ul>
+ */
+ columns : 'auto',
+ <div id="cfg-Ext.form.CheckboxGroup-vertical"></div>/**
+ * @cfg {Boolean} vertical True to distribute contained controls across columns, completely filling each column
+ * top to bottom before starting on the next column. The number of controls in each column will be automatically
+ * calculated to keep columns as even as possible. The default value is false, so that controls will be added
+ * to columns one at a time, completely filling each row left to right before starting on the next row.
+ */
+ vertical : false,
+ <div id="cfg-Ext.form.CheckboxGroup-allowBlank"></div>/**
+ * @cfg {Boolean} allowBlank False to validate that at least one item in the group is checked (defaults to true).
+ * If no items are selected at validation time, {@link @blankText} will be used as the error text.
+ */
+ allowBlank : true,
+ <div id="cfg-Ext.form.CheckboxGroup-blankText"></div>/**
+ * @cfg {String} blankText Error text to display if the {@link #allowBlank} validation fails (defaults to "You must
+ * select at least one item in this group")
+ */
+ blankText : "You must select at least one item in this group",
+
+ // private
+ defaultType : 'checkbox',
+
+ // private
+ groupCls : 'x-form-check-group',
+
+ // private
+ initComponent: function(){
+ this.addEvents(
+ <div id="event-Ext.form.CheckboxGroup-change"></div>/**
+ * @event change
+ * Fires when the state of a child checkbox changes.
+ * @param {Ext.form.CheckboxGroup} this
+ * @param {Array} checked An array containing the checked boxes.
+ */
+ 'change'
+ );
+ this.on('change', this.validate, this);
+ Ext.form.CheckboxGroup.superclass.initComponent.call(this);
+ },
+
+ // private
+ onRender : function(ct, position){
+ if(!this.el){
+ var panelCfg = {
+ autoEl: {
+ id: this.id
+ },
+ cls: this.groupCls,
+ layout: 'column',
+ renderTo: ct,
+ bufferResize: false // Default this to false, since it doesn't really have a proper ownerCt.
+ };
+ var colCfg = {
+ xtype: 'container',
+ defaultType: this.defaultType,
+ layout: 'form',
+ defaults: {
+ hideLabel: true,
+ anchor: '100%'
+ }
+ };
+
+ if(this.items[0].items){
+
+ // The container has standard ColumnLayout configs, so pass them in directly
+
+ Ext.apply(panelCfg, {
+ layoutConfig: {columns: this.items.length},
+ defaults: this.defaults,
+ items: this.items
+ });
+ for(var i=0, len=this.items.length; i<len; i++){
+ Ext.applyIf(this.items[i], colCfg);
+ }
+
+ }else{
+
+ // The container has field item configs, so we have to generate the column
+ // panels first then move the items into the columns as needed.
+
+ var numCols, cols = [];
+
+ if(typeof this.columns == 'string'){ // 'auto' so create a col per item
+ this.columns = this.items.length;
+ }
+ if(!Ext.isArray(this.columns)){
+ var cs = [];
+ for(var i=0; i<this.columns; i++){
+ cs.push((100/this.columns)*.01); // distribute by even %
+ }
+ this.columns = cs;
+ }
+
+ numCols = this.columns.length;
+
+ // Generate the column configs with the correct width setting
+ for(var i=0; i<numCols; i++){
+ var cc = Ext.apply({items:[]}, colCfg);
+ cc[this.columns[i] <= 1 ? 'columnWidth' : 'width'] = this.columns[i];
+ if(this.defaults){
+ cc.defaults = Ext.apply(cc.defaults || {}, this.defaults);
+ }
+ cols.push(cc);
+ };
+
+ // Distribute the original items into the columns
+ if(this.vertical){
+ var rows = Math.ceil(this.items.length / numCols), ri = 0;
+ for(var i=0, len=this.items.length; i<len; i++){
+ if(i>0 && i%rows==0){
+ ri++;
+ }
+ if(this.items[i].fieldLabel){
+ this.items[i].hideLabel = false;
+ }
+ cols[ri].items.push(this.items[i]);
+ };
+ }else{
+ for(var i=0, len=this.items.length; i<len; i++){
+ var ci = i % numCols;
+ if(this.items[i].fieldLabel){
+ this.items[i].hideLabel = false;
+ }
+ cols[ci].items.push(this.items[i]);
+ };
+ }
+
+ Ext.apply(panelCfg, {
+ layoutConfig: {columns: numCols},
+ items: cols
+ });
+ }
+
+ this.panel = new Ext.Container(panelCfg);
+ this.panel.ownerCt = this;
+ this.el = this.panel.getEl();
+
+ if(this.forId && this.itemCls){
+ var l = this.el.up(this.itemCls).child('label', true);
+ if(l){
+ l.setAttribute('htmlFor', this.forId);
+ }
+ }
+
+ var fields = this.panel.findBy(function(c){
+ return c.isFormField;
+ }, this);
+
+ this.items = new Ext.util.MixedCollection();
+ this.items.addAll(fields);
+ }
+ Ext.form.CheckboxGroup.superclass.onRender.call(this, ct, position);
+ },
+
+ initValue : function(){
+ if(this.value){
+ this.setValue.apply(this, this.buffered ? this.value : [this.value]);
+ delete this.buffered;
+ delete this.value;
+ }
+ },
+
+ afterRender : function(){
+ Ext.form.CheckboxGroup.superclass.afterRender.call(this);
+ this.eachItem(function(item){
+ item.on('check', this.fireChecked, this);
+ item.inGroup = true;
+ });
+ },
+
+ // private
+ doLayout: function(){
+ //ugly method required to layout hidden items
+ if(this.rendered){
+ this.panel.forceLayout = this.ownerCt.forceLayout;
+ this.panel.doLayout();
+ }
+ },
+
+ // private
+ fireChecked: function(){
+ var arr = [];
+ this.eachItem(function(item){
+ if(item.checked){
+ arr.push(item);
+ }
+ });
+ this.fireEvent('change', this, arr);
+ },
+
+ <div id="method-Ext.form.CheckboxGroup-getErrors"></div>/**
+ * Runs CheckboxGroup's validations and returns an array of any errors. The only error by default
+ * is if allowBlank is set to true and no items are checked.
+ * @return {Array} Array of all validation errors
+ */
+ getErrors: function() {
+ var errors = Ext.form.CheckboxGroup.superclass.getErrors.apply(this, arguments);
+
+ if (!this.allowBlank) {
+ var blank = true;
+
+ this.eachItem(function(f){
+ if (f.checked) {
+ return (blank = false);
+ }
+ });
+
+ if (blank) errors.push(this.blankText);
+ }
+
+ return errors;
+ },
+
+ // private
+ isDirty: function(){
+ //override the behaviour to check sub items.
+ if (this.disabled || !this.rendered) {
+ return false;
+ }
+
+ var dirty = false;
+
+ this.eachItem(function(item){
+ if(item.isDirty()){
+ dirty = true;
+ return false;
+ }
+ });
+
+ return dirty;
+ },
+
+ // private
+ setReadOnly : function(readOnly){
+ if(this.rendered){
+ this.eachItem(function(item){
+ item.setReadOnly(readOnly);
+ });
+ }
+ this.readOnly = readOnly;
+ },
+
+ // private
+ onDisable : function(){
+ this.eachItem(function(item){
+ item.disable();
+ });
+ },
+
+ // private
+ onEnable : function(){
+ this.eachItem(function(item){
+ item.enable();
+ });
+ },
+
+ // private
+ onResize : function(w, h){
+ this.panel.setSize(w, h);
+ this.panel.doLayout();
+ },
+
+ // inherit docs from Field
+ reset : function(){
+ if (this.originalValue) {
+ // Clear all items
+ this.eachItem(function(c){
+ if(c.setValue){
+ c.setValue(false);
+ c.originalValue = c.getValue();
+ }
+ });
+ // Set items stored in originalValue, ugly - set a flag to reset the originalValue
+ // during the horrible onSetValue. This will allow trackResetOnLoad to function.
+ this.resetOriginal = true;
+ this.setValue(this.originalValue);
+ delete this.resetOriginal;
+ } else {
+ this.eachItem(function(c){
+ if(c.reset){
+ c.reset();
+ }
+ });
+ }
+ // Defer the clearInvalid so if BaseForm's collection is being iterated it will be called AFTER it is complete.
+ // Important because reset is being called on both the group and the individual items.
+ (function() {
+ this.clearInvalid();
+ }).defer(50, this);
+ },
+
+ <div id="method-Ext.form.CheckboxGroup-setValue"></div>/**
+ * {@link Ext.form.Checkbox#setValue Set the value(s)} of an item or items
+ * in the group. Examples illustrating how this method may be called:
+ * <pre><code>
+// call with name and value
+myCheckboxGroup.setValue('cb-col-1', true);
+// call with an array of boolean values
+myCheckboxGroup.setValue([true, false, false]);
+// call with an object literal specifying item:value pairs
+myCheckboxGroup.setValue({
+ 'cb-col-2': false,
+ 'cb-col-3': true
+});
+// use comma separated string to set items with name to true (checked)
+myCheckboxGroup.setValue('cb-col-1,cb-col-3');
+ * </code></pre>
+ * See {@link Ext.form.Checkbox#setValue} for additional information.
+ * @param {Mixed} id The checkbox to check, or as described by example shown.
+ * @param {Boolean} value (optional) The value to set the item.
+ * @return {Ext.form.CheckboxGroup} this
+ */
+ setValue: function(){
+ if(this.rendered){
+ this.onSetValue.apply(this, arguments);
+ }else{
+ this.buffered = true;
+ this.value = arguments;
+ }
+ return this;
+ },
+
+ /**
+ * @private
+ * Sets the values of one or more of the items within the CheckboxGroup
+ * @param {String|Array|Object} id Can take multiple forms. Can be optionally:
+ * <ul>
+ * <li>An ID string to be used with a second argument</li>
+ * <li>An array of the form ['some', 'list', 'of', 'ids', 'to', 'mark', 'checked']</li>
+ * <li>An array in the form [true, true, false, true, false] etc, where each item relates to the check status of
+ * the checkbox at the same index</li>
+ * <li>An object containing ids of the checkboxes as keys and check values as properties</li>
+ * </ul>
+ * @param {String} value The value to set the field to if the first argument was a string
+ */
+ onSetValue: function(id, value){
+ if(arguments.length == 1){
+ if(Ext.isArray(id)){
+ Ext.each(id, function(val, idx){
+ if (Ext.isObject(val) && val.setValue){ // array of checkbox components to be checked
+ val.setValue(true);
+ if (this.resetOriginal === true) {
+ val.originalValue = val.getValue();
+ }
+ } else { // an array of boolean values
+ var item = this.items.itemAt(idx);
+ if(item){
+ item.setValue(val);
+ }
+ }
+ }, this);
+ }else if(Ext.isObject(id)){
+ // set of name/value pairs
+ for(var i in id){
+ var f = this.getBox(i);
+ if(f){
+ f.setValue(id[i]);
+ }
+ }
+ }else{
+ this.setValueForItem(id);
+ }
+ }else{
+ var f = this.getBox(id);
+ if(f){
+ f.setValue(value);
+ }
+ }
+ },
+
+ // private
+ beforeDestroy: function(){
+ Ext.destroy(this.panel);
+ Ext.form.CheckboxGroup.superclass.beforeDestroy.call(this);
+
+ },
+
+ setValueForItem : function(val){
+ val = String(val).split(',');
+ this.eachItem(function(item){
+ if(val.indexOf(item.inputValue)> -1){
+ item.setValue(true);
+ }
+ });
+ },
+
+ // private
+ getBox : function(id){
+ var box = null;
+ this.eachItem(function(f){
+ if(id == f || f.dataIndex == id || f.id == id || f.getName() == id){
+ box = f;
+ return false;
+ }
+ });
+ return box;
+ },
+
+ <div id="method-Ext.form.CheckboxGroup-getValue"></div>/**
+ * Gets an array of the selected {@link Ext.form.Checkbox} in the group.
+ * @return {Array} An array of the selected checkboxes.
+ */
+ getValue : function(){
+ var out = [];
+ this.eachItem(function(item){
+ if(item.checked){
+ out.push(item);
+ }
+ });
+ return out;
+ },
+
+ /**
+ * @private
+ * Convenience function which passes the given function to every item in the composite
+ * @param {Function} fn The function to call
+ * @param {Object} scope Optional scope object
+ */
+ eachItem: function(fn, scope) {
+ if(this.items && this.items.each){
+ this.items.each(fn, scope || this);
+ }
+ },
+
+ <div id="cfg-Ext.form.CheckboxGroup-name"></div>/**
+ * @cfg {String} name
+ * @hide
+ */
+
+ <div id="method-Ext.form.CheckboxGroup-getRawValue"></div>/**
+ * @method getRawValue
+ * @hide
+ */
+ getRawValue : Ext.emptyFn,
+
+ <div id="method-Ext.form.CheckboxGroup-setRawValue"></div>/**
+ * @method setRawValue
+ * @hide
+ */
+ setRawValue : Ext.emptyFn
+
+});
+
+Ext.reg('checkboxgroup', Ext.form.CheckboxGroup);
+</pre>
</body>
</html>
\ No newline at end of file
git.ithinksw.org / extjs.git / blobdiff