X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/6746dc89c47ed01b165cc1152533605f97eb8e8d..HEAD:/src/form/field/Display.js?ds=sidebyside 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,