X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/6746dc89c47ed01b165cc1152533605f97eb8e8d..HEAD:/src/form/field/Display.js diff --git a/src/form/field/Display.js b/src/form/field/Display.js index 14238c51..32d02cd3 100644 --- a/src/form/field/Display.js +++ b/src/form/field/Display.js @@ -13,39 +13,38 @@ If you are unsure which license is appropriate for your use, please contact the */ /** - * @class Ext.form.field.Display - * @extends Ext.form.field.Base - *

A display-only text field which is not validated and not submitted. This is useful for when you want - * to display a value from a form's {@link Ext.form.Basic#load loaded data} but do not want to allow the - * user to edit or submit that value. The value can be optionally {@link #htmlEncode HTML encoded} if it contains - * HTML markup that you do not want to be rendered.

- *

If you have more complex content, or need to include components within the displayed content, also - * consider using a {@link Ext.form.FieldContainer} instead.

- * {@img Ext.form.Display/Ext.form.Display.png Ext.form.Display component} - *

Example:

- *

-    Ext.create('Ext.form.Panel', {
-        width: 175,
-        height: 120,
-        bodyPadding: 10,
-        title: 'Final Score',
-        items: [{
-            xtype: 'displayfield',
-            fieldLabel: 'Home',
-            name: 'home_score',
-            value: '10'
-        }, {
-            xtype: 'displayfield',
-            fieldLabel: 'Visitor',
-            name: 'visitor_score',
-            value: '11'
-        }],
-        buttons: [{
-            text: 'Update',
-        }],
-        renderTo: Ext.getBody()
-    });
-
+ * A display-only text field which is not validated and not submitted. This is useful for when you want to display a + * value from a form's {@link Ext.form.Basic#load loaded data} but do not want to allow the user to edit or submit that + * value. The value can be optionally {@link #htmlEncode HTML encoded} if it contains HTML markup that you do not want + * to be rendered. + * + * If you have more complex content, or need to include components within the displayed content, also consider using a + * {@link Ext.form.FieldContainer} instead. + * + * Example: + * + * @example + * Ext.create('Ext.form.Panel', { + * renderTo: Ext.getBody(), + * width: 175, + * height: 120, + * bodyPadding: 10, + * title: 'Final Score', + * items: [{ + * xtype: 'displayfield', + * fieldLabel: 'Home', + * name: 'home_score', + * value: '10' + * }, { + * xtype: 'displayfield', + * fieldLabel: 'Visitor', + * name: 'visitor_score', + * value: '11' + * }], + * buttons: [{ + * text: 'Update', + * }] + * }); */ Ext.define('Ext.form.field.Display', { extend:'Ext.form.field.Base', @@ -61,14 +60,15 @@ Ext.define('Ext.form.field.Display', { ], /** - * @cfg {String} fieldCls The default CSS class for the field (defaults to "x-form-display-field") + * @cfg {String} [fieldCls="x-form-display-field"] + * The default CSS class for the field. */ fieldCls: Ext.baseCSSPrefix + 'form-display-field', /** - * @cfg {Boolean} htmlEncode false to skip HTML-encoding the text when rendering it (defaults to - * false). This might be useful if you want to include tags in the field's innerHTML rather than - * rendering them as string literals per the default logic. + * @cfg {Boolean} htmlEncode + * false to skip HTML-encoding the text when rendering it. This might be useful if you want to + * include tags in the field's innerHTML rather than rendering them as string literals per the default logic. */ htmlEncode: false,