+<!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="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+ <script type="text/javascript" src="../resources/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-CheckboxGroup'>/**
+</span> * A {@link Ext.form.FieldContainer field container} which has a specialized layout for arranging
+ * {@link Ext.form.field.Checkbox} 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 checkboxes as a whole.
+ *
+ * # Validation
+ *
+ * Individual checkbox fields themselves have no default validation behavior, but
+ * sometimes you want to require a user to select at least one of a group of checkboxes. CheckboxGroup
+ * allows this by setting the config `{@link #allowBlank}:false`; when the user does not check at
+ * least one of the checkboxes, the entire group will be highlighted as invalid and the
+ * {@link #blankText error message} will be displayed according to the {@link #msgTarget} config.
+ *
+ * # Layout
+ *
+ * The default layout for CheckboxGroup makes it easy to arrange the checkboxes 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 checkbox components at any depth will still be managed by the CheckboxGroup's validation.
+ *
+ * @example
+ * Ext.create('Ext.form.Panel', {
+ * title: 'Checkbox Group',
+ * width: 300,
+ * height: 125,
+ * bodyPadding: 10,
+ * renderTo: Ext.getBody(),
+ * items:[{
+ * xtype: 'checkboxgroup',
+ * 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.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
+Ext.define('Ext.form.CheckboxGroup', {
+ extend:'Ext.form.FieldContainer',
+ mixins: {
+ field: 'Ext.form.field.Field'
+ },
+ alias: 'widget.checkboxgroup',
+ requires: ['Ext.layout.container.CheckboxGroup', 'Ext.form.field.Base'],
+
+<span id='Ext-form-CheckboxGroup-cfg-name'> /**
+</span> * @cfg {String} name
+ * @hide
+ */
+
+<span id='Ext-form-CheckboxGroup-cfg-items'> /**
+</span> * @cfg {Ext.form.field.Checkbox[]/Object[]} items
+ * An Array of {@link Ext.form.field.Checkbox Checkbox}es or Checkbox config objects to arrange in the group.
+ */
+
+<span id='Ext-form-CheckboxGroup-cfg-columns'> /**
+</span> * @cfg {String/Number/Number[]} 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:
+ *
+ * - 'auto' - 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.
+ * - Number - 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}.
+ * - Array - 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.
+ */
+ columns : 'auto',
+
+<span id='Ext-form-CheckboxGroup-cfg-vertical'> /**
+</span> * @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,
+
+<span id='Ext-form-CheckboxGroup-cfg-allowBlank'> /**
+</span> * @cfg {Boolean} allowBlank
+ * False to validate that at least one item in the group is checked. If no items are selected at
+ * validation time, {@link #blankText} will be used as the error text.
+ */
+ allowBlank : true,
+
+<span id='Ext-form-CheckboxGroup-cfg-blankText'> /**
+</span> * @cfg {String} blankText
+ * Error text to display if the {@link #allowBlank} validation fails
+ */
+ blankText : "You must select at least one item in this group",
+
+ // private
+ defaultType : 'checkboxfield',
+
+ // private
+ groupCls : Ext.baseCSSPrefix + 'form-check-group',
+
+<span id='Ext-form-CheckboxGroup-cfg-fieldBodyCls'> /**
+</span> * @cfg {String} fieldBodyCls
+ * An extra CSS class to be applied to the body content element in addition to {@link #baseBodyCls}.
+ * Defaults to 'x-form-checkboxgroup-body'.
+ */
+ fieldBodyCls: Ext.baseCSSPrefix + 'form-checkboxgroup-body',
+
+ // private
+ layout: 'checkboxgroup',
+
+ initComponent: function() {
+ var me = this;
+ me.callParent();
+ me.initField();
+ },
+
+<span id='Ext-form-CheckboxGroup-method-initValue'> /**
+</span> * Initializes the field's value based on the initial config. If the {@link #value} config is specified then we use
+ * that to set the value; otherwise we initialize the originalValue by querying the values of all sub-checkboxes
+ * after they have been initialized.
+ * @protected
+ */
+ initValue: function() {
+ var me = this,
+ valueCfg = me.value;
+ me.originalValue = me.lastValue = valueCfg || me.getValue();
+ if (valueCfg) {
+ me.setValue(valueCfg);
+ }
+ },
+
+<span id='Ext-form-CheckboxGroup-method-onFieldAdded'> /**
+</span> * When a checkbox is added to the group, monitor it for changes
+ * @param {Object} field
+ * @protected
+ */
+ onFieldAdded: function(field) {
+ var me = this;
+ if (field.isCheckbox) {
+ me.mon(field, 'change', me.checkChange, me);
+ }
+ me.callParent(arguments);
+ },
+
+ onFieldRemoved: function(field) {
+ var me = this;
+ if (field.isCheckbox) {
+ me.mun(field, 'change', me.checkChange, me);
+ }
+ me.callParent(arguments);
+ },
+
+ // private override - the group value is a complex object, compare using object serialization
+ isEqual: function(value1, value2) {
+ var toQueryString = Ext.Object.toQueryString;
+ return toQueryString(value1) === toQueryString(value2);
+ },
+
+<span id='Ext-form-CheckboxGroup-method-getErrors'> /**
+</span> * 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 {String[]} Array of all validation errors
+ */
+ getErrors: function() {
+ var errors = [];
+ if (!this.allowBlank && Ext.isEmpty(this.getChecked())) {
+ errors.push(this.blankText);
+ }
+ return errors;
+ },
+
+<span id='Ext-form-CheckboxGroup-method-getBoxes'> /**
+</span> * @private Returns all checkbox components within the container
+ */
+ getBoxes: function() {
+ return this.query('[isCheckbox]');
+ },
+
+<span id='Ext-form-CheckboxGroup-method-eachBox'> /**
+</span> * @private Convenience function which calls the given function for every checkbox in the group
+ * @param {Function} fn The function to call
+ * @param {Object} scope (Optional) scope object
+ */
+ eachBox: function(fn, scope) {
+ Ext.Array.forEach(this.getBoxes(), fn, scope || this);
+ },
+
+<span id='Ext-form-CheckboxGroup-method-getChecked'> /**
+</span> * Returns an Array of all checkboxes in the container which are currently checked
+ * @return {Ext.form.field.Checkbox[]} Array of Ext.form.field.Checkbox components
+ */
+ getChecked: function() {
+ return Ext.Array.filter(this.getBoxes(), function(cb) {
+ return cb.getValue();
+ });
+ },
+
+ // private override
+ isDirty: function(){
+ return Ext.Array.some(this.getBoxes(), function(cb) {
+ return cb.isDirty();
+ });
+ },
+
+ // private override
+ setReadOnly: function(readOnly) {
+ this.eachBox(function(cb) {
+ cb.setReadOnly(readOnly);
+ });
+ this.readOnly = readOnly;
+ },
+
+<span id='Ext-form-CheckboxGroup-method-reset'> /**
+</span> * Resets the checked state of all {@link Ext.form.field.Checkbox checkboxes} in the group to their originally
+ * loaded values and clears any validation messages.
+ * See {@link Ext.form.Basic}.{@link Ext.form.Basic#trackResetOnLoad trackResetOnLoad}
+ */
+ reset: function() {
+ var me = this,
+ hadError = me.hasActiveError(),
+ preventMark = me.preventMark;
+ me.preventMark = true;
+ me.batchChanges(function() {
+ me.eachBox(function(cb) {
+ cb.reset();
+ });
+ });
+ me.preventMark = preventMark;
+ me.unsetActiveError();
+ if (hadError) {
+ me.doComponentLayout();
+ }
+ },
+
+ // private override
+ resetOriginalValue: function() {
+ // Defer resetting of originalValue until after all sub-checkboxes have been reset so we get
+ // the correct data from getValue()
+ Ext.defer(function() {
+ this.callParent();
+ }, 1, this);
+ },
+
+
+<span id='Ext-form-CheckboxGroup-method-setValue'> /**
+</span> * Sets the value(s) of all checkboxes in the group. The expected format is an Object of name-value pairs
+ * corresponding to the names of the checkboxes in the group. Each pair can have either a single or multiple values:
+ *
+ * - A single Boolean or String value will be passed to the `setValue` method of the checkbox with that name.
+ * See the rules in {@link Ext.form.field.Checkbox#setValue} for accepted values.
+ * - An Array of String values will be matched against the {@link Ext.form.field.Checkbox#inputValue inputValue}
+ * of checkboxes in the group with that name; those checkboxes whose inputValue exists in the array will be
+ * checked and others will be unchecked.
+ *
+ * If a checkbox's name is not in the mapping at all, it will be unchecked.
+ *
+ * An example:
+ *
+ * var myCheckboxGroup = new Ext.form.CheckboxGroup({
+ * columns: 3,
+ * items: [{
+ * name: 'cb1',
+ * boxLabel: 'Single 1'
+ * }, {
+ * name: 'cb2',
+ * boxLabel: 'Single 2'
+ * }, {
+ * name: 'cb3',
+ * boxLabel: 'Single 3'
+ * }, {
+ * name: 'cbGroup',
+ * boxLabel: 'Grouped 1'
+ * inputValue: 'value1'
+ * }, {
+ * name: 'cbGroup',
+ * boxLabel: 'Grouped 2'
+ * inputValue: 'value2'
+ * }, {
+ * name: 'cbGroup',
+ * boxLabel: 'Grouped 3'
+ * inputValue: 'value3'
+ * }]
+ * });
+ *
+ * myCheckboxGroup.setValue({
+ * cb1: true,
+ * cb3: false,
+ * cbGroup: ['value1', 'value3']
+ * });
+ *
+ * The above code will cause the checkbox named 'cb1' to be checked, as well as the first and third checkboxes named
+ * 'cbGroup'. The other three checkboxes will be unchecked.
+ *
+ * @param {Object} value The mapping of checkbox names to values.
+ * @return {Ext.form.CheckboxGroup} this
+ */
+ setValue: function(value) {
+ var me = this;
+ me.batchChanges(function() {
+ me.eachBox(function(cb) {
+ var name = cb.getName(),
+ cbValue = false;
+ if (value && name in value) {
+ if (Ext.isArray(value[name])) {
+ cbValue = Ext.Array.contains(value[name], cb.inputValue);
+ } else {
+ // single value, let the checkbox's own setValue handle conversion
+ cbValue = value[name];
+ }
+ }
+ cb.setValue(cbValue);
+ });
+ });
+ return me;
+ },
+
+
+<span id='Ext-form-CheckboxGroup-method-getValue'> /**
+</span> * Returns an object containing the values of all checked checkboxes within the group. Each key-value pair in the
+ * object corresponds to a checkbox {@link Ext.form.field.Checkbox#name name}. If there is only one checked checkbox
+ * with a particular name, the value of that pair will be the String {@link Ext.form.field.Checkbox#inputValue
+ * inputValue} of that checkbox. If there are multiple checked checkboxes with that name, the value of that pair
+ * will be an Array of the selected inputValues.
+ *
+ * The object format returned from this method can also be passed directly to the {@link #setValue} method.
+ *
+ * NOTE: In Ext 3, this method returned an array of Checkbox components; this was changed to make it more consistent
+ * with other field components and with the {@link #setValue} argument signature. If you need the old behavior in
+ * Ext 4+, use the {@link #getChecked} method instead.
+ */
+ getValue: function() {
+ var values = {};
+ this.eachBox(function(cb) {
+ var name = cb.getName(),
+ inputValue = cb.inputValue,
+ bucket;
+ if (cb.getValue()) {
+ if (name in values) {
+ bucket = values[name];
+ if (!Ext.isArray(bucket)) {
+ bucket = values[name] = [bucket];
+ }
+ bucket.push(inputValue);
+ } else {
+ values[name] = inputValue;
+ }
+ }
+ });
+ return values;
+ },
+
+ /*
+ * Don't return any data for submit; the form will get the info from the individual checkboxes themselves.
+ */
+ getSubmitData: function() {
+ return null;
+ },
+
+ /*
+ * Don't return any data for the model; the form will get the info from the individual checkboxes themselves.
+ */
+ getModelData: function() {
+ return null;
+ },
+
+ validate: function() {
+ var me = this,
+ errors = me.getErrors(),
+ isValid = Ext.isEmpty(errors),
+ wasValid = !me.hasActiveError();
+
+ if (isValid) {
+ me.unsetActiveError();
+ } else {
+ me.setActiveError(errors);
+ }
+ if (isValid !== wasValid) {
+ me.fireEvent('validitychange', me, isValid);
+ me.doComponentLayout();
+ }
+
+ return isValid;
+ }
+
+}, function() {
+
+ this.borrow(Ext.form.field.Base, ['markInvalid', 'clearInvalid']);
+
+});
+
</pre>
</body>
-</html>
\ No newline at end of file
+</html>
git.ithinksw.org / extjs.git / blobdiff