X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/c930e9176a5a85509c5b0230e2bff5c22a591432..25ef3491bd9ae007ff1fc2b0d7943e6eaaccf775:/docs/source/FieldLabeler.html diff --git a/docs/source/FieldLabeler.html b/docs/source/FieldLabeler.html new file mode 100644 index 00000000..3f3814f2 --- /dev/null +++ b/docs/source/FieldLabeler.html @@ -0,0 +1,129 @@ + + + The source code + + + + +
Ext.ns("Ext.ux");
+
+
/** + * @class Ext.ux.FieldLabeler + *

A plugin for Field Components which renders standard Ext form wrapping and labels + * round the Field at render time regardless of the layout of the Container.

+ *

Usage:

+ *

+    {
+        xtype: 'combo',
+        plugins: [ Ext.ux.FieldLabeler ],
+        triggerAction: 'all',
+        fieldLabel: 'Select type',
+        store: typeStore
+    }
+ * 
+ */ +Ext.ux.FieldLabeler = (function(){ + +// Pulls a named property down from the first ancestor Container it's found in + function getParentProperty(propName) { + for (var p = this.ownerCt; p; p = p.ownerCt) { + if (p[propName]) { + return p[propName]; + } + } + } + + return { + +// Add behaviour at important points in the Field's lifecycle. + init: function(f) { + f.onRender = f.onRender.createSequence(this.onRender); + f.onResize = f.onResize.createSequence(this.onResize); + f.onDestroy = f.onDestroy.createSequence(this.onDestroy); + }, + + onRender: function() { +// Do nothing if being rendered by a form layout + if (this.ownerCt) { + if (this.ownerCt.layout instanceof Ext.layout.FormLayout) { + return; + } + if (this.nextSibling()) { + this.margins = '0 0 5 0'; + } + } + + this.resizeEl = this.el.wrap({ + cls: 'x-form-element' + }); + this.positionEl = this.itemCt = this.resizeEl.wrap({ + cls: 'x-form-item ' + }); + this.actionMode = 'itemCt'; + +// If we are hiding labels, then we're done! + if (!Ext.isDefined(this.hideLabels)) { + this.hideLabels = getParentProperty.call(this, "hideLabels"); + } + if (this.hideLabels) { + this.resizeEl.setStyle('padding-left', '0px'); + return; + } + +// Collect info we need to render the label. + if (!Ext.isDefined(this.labelSeparator)) { + this.labelSeparator = getParentProperty.call(this, "labelSeparator"); + } + if (!Ext.isDefined(this.labelPad)) { + this.labelPad = getParentProperty.call(this, "labelPad"); + } + if (!Ext.isDefined(this.labelAlign)) { + this.labelAlign = getParentProperty.call(this, "labelAlign") || 'left'; + } + this.itemCt.addClass('x-form-label-' + this.labelAlign); + + if(this.labelAlign == 'top'){ + if (!this.labelWidth) { + this.labelWidth = 'auto'; + } + this.resizeEl.setStyle('padding-left', '0px'); + } else { + if (!Ext.isDefined(this.labelWidth)) { + this.labelWidth = getParentProperty.call(this, "labelWidth") || 100; + } + this.resizeEl.setStyle('padding-left', (this.labelWidth + (this.labelPad || 5)) + 'px'); + this.labelWidth += 'px'; + } + + this.label = this.itemCt.insertFirst({ + tag: 'label', + cls: 'x-form-item-label', + style: { + width: this.labelWidth + }, + html: this.fieldLabel + (this.labelSeparator || ':') + }); + }, + +// private +// Ensure the input field is sized to fit in the content area of the resizeEl (to the right of its padding-left) + onResize: function() { + this.el.setWidth(this.resizeEl.getWidth(true)); + if (this.el.dom.tagName.toLowerCase() == 'textarea') { + var h = this.resizeEl.getHeight(true); + if (!this.hideLabels && (this.labelAlign == 'top')) { + h -= this.label.getHeight(); + } + this.el.setHeight(h); + } + }, + +// private +// Ensure that we clean up on destroy. + onDestroy: function() { + this.itemCt.remove(); + } + }; +})();
+ + \ No newline at end of file