A mixin which allows a component to be configured and decorated with a label and/or error message as is +common for form fields. This is used by e.g. Ext.form.field.Base and Ext.form.FieldContainer +to let them be managed by the Field layout.
+ +*NOTE**: This mixin is mainly for internal library use and most users should not need to use it directly. It +is more likely you will want to use one of the component classes that import this mixin, such as +Ext.form.field.Base or Ext.form.FieldContainer.
+ +Use of this mixin does not make a component a field in the logical sense, meaning it does not provide any +logic or state related to values or validation; that is handled by the related Ext.form.field.Field +mixin. These two mixins may be used separately (for example Ext.form.FieldContainer is Labelable but not a +Field), or in combination (for example Ext.form.field.Base implements both and has logic for connecting the +two.)
+ +Component classes which use this mixin should use the Field layout +or a derivation thereof to properly size and position the label and message according to the component config. +They must also call the initLabelable method during component initialization to ensure the mixin gets +set up correctly.
+The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.
+The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.
+The CSS class to be applied to the special clearing div rendered directly after the field +contents wrapper to provide field clearing (defaults to 'x-clear').
+The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.
+The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.
+An extra CSS class to be applied to the body content element in addition to fieldBodyCls. +Defaults to empty.
+An extra CSS class to be applied to the body content element in addition to fieldBodyCls. +Defaults to empty.
+A CSS class to be applied to the outermost element to denote that it is participating in the form +field layout. Defaults to 'x-form-item'.
+The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')
+The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')
+The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.
+The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.
+If specified, then the component will be displayed with this value as its active error when +first rendered. Defaults to undefined. Use setActiveError or unsetActiveError to +change it after component creation.
+The template used to format the Array of error messages passed to setActiveErrors +into a single HTML string. By default this renders each message as an item in an unordered list.
+Whether to adjust the component's body area to make room for 'side' or 'under' +error messages. Defaults to true.
+Whether to adjust the component's body area to make room for 'side' or 'under' +error messages. Defaults to true.
+The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.
+The CSS class to be applied to the body content element. Defaults to 'x-form-item-body'.
+The CSS class to be applied to the special clearing div rendered directly after the field +contents wrapper to provide field clearing (defaults to 'x-clear').
+The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.
+The CSS class to be applied to the error message element. Defaults to 'x-form-error-msg'.
+An extra CSS class to be applied to the body content element in addition to fieldBodyCls. +Defaults to empty.
+An extra CSS class to be applied to the body content element in addition to fieldBodyCls. +Defaults to empty.
+The label for the field. It gets appended with the labelSeparator, and its position +and sizing is determined by the labelAlign, labelWidth, and labelPad +configs. Defaults to undefined.
+A CSS class to be applied to the outermost element to denote that it is participating in the form +field layout. Defaults to 'x-form-item'.
+When set to true, the label element (fieldLabel and labelSeparator) will be +automatically hidden if the fieldLabel is empty. Setting this to false will cause the empty +label element to be rendered and space to be reserved for it; this is useful if you want a field without a label +to line up with other labeled fields in the same form. Defaults to true.
+ + +If you wish to unconditionall hide the label even if a non-empty fieldLabel is configured, then set +the hideLabel config to true.
+ +Set to true to completely hide the label element (fieldLabel and labelSeparator). +Defaults to false.
+ + +Also see hideEmptyLabel, which controls whether space will be reserved for an empty fieldLabel.
+ +The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')
+The CSS class to use when marking the component invalid (defaults to 'x-form-invalid')
+Controls the position and alignment of the fieldLabel. Valid values are:
+ + +The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.
+The CSS class to be applied to the label element. Defaults to 'x-form-item-label'.
+The amount of space in pixels between the fieldLabel and the input field. Defaults to 5.
+The amount of space in pixels between the fieldLabel and the input field. Defaults to 5.
+Character(s) to be inserted at the end of the label text.
+Character(s) to be inserted at the end of the label text.
+A CSS style specification string to apply directly to this field's label. Defaults to undefined.
+ +A CSS style specification string to apply directly to this field's label. Defaults to undefined.
+ +The width of the fieldLabel in pixels. Only applicable if the labelAlign is set +to "left" or "right". Defaults to 100.
+The width of the fieldLabel in pixels. Only applicable if the labelAlign is set +to "left" or "right". Defaults to 100.
+The rendering template for the field decorations. Component classes using this mixin should include +logic to use this as their renderTpl, and implement the +getSubTplMarkup method to generate the field body content.
+The location where the error message text should display. +Must be one of the following values:
+ + +qtip Display a quick tip containing the message when the user hovers over the field. This is the default.
+title Display the message in a default browser title attribute popup.under Add a block div beneath the field containing the error message.side Add an error icon to the right of the field, displaying the message in a popup on hover.none Don't display any error message. This might be useful if you are implementing custom error display.[element id] Add the error message directly to the innerHTML of the specified element.true to disable displaying any error message set on this object. +Defaults to false.
+true to disable displaying any error message set on this object. +Defaults to false.
+The div Element wrapping the component's contents. Only available after the component has been rendered.
+The div Element wrapping the component's contents. Only available after the component has been rendered.
+The div Element that will contain the component's error message(s). Note that depending on the +configured msgTarget, this element may be hidden in favor of some other form of +presentation, but will always be present in the DOM for use by assistive technologies.
+Flag denoting that this object is labelable as a field. Always true.
+Flag denoting that this object is labelable as a field. Always true.
+Gets the active error message for this component, if any. This does not trigger +validation on its own, it merely returns any message that the component may already hold.
+The active error message on the component; if there is no error, an empty string is returned.
+Gets an Array of any active error messages currently applied to the field. This does not trigger +validation on its own, it merely returns any messages that the component may already hold.
+The active error messages on the component; if there are no errors, an empty Array is returned.
+Returns the label for the field. Defaults to simply returning the fieldLabel config. Can be +overridden to provide
+Returns the label for the field. Defaults to simply returning the fieldLabel config. Can be +overridden to provide
+The configured field label, or empty string if not defined
+Get the input id, if any, for this component. This is used as the "for" attribute on the label element. +Implementing subclasses may also use this as e.g. the id for their own input element.
+The input id
+Tells whether the field currently has an active error message. This does not trigger +validation on its own, it merely looks for any message that the component may already hold.
+Performs initialization of this mixin. Component classes using this mixin should call this method +during their own initialization.
+Sets the active error message to the given string. This replaces the entire error message +contents with the given string. Also see setActiveErrors which accepts an Array of +messages and formats them according to the activeErrorsTpl.
+The error message
+Set the active error message to an Array of error messages. The messages are formatted into +a single message string using the activeErrorsTpl. Also see setActiveError +which allows setting the entire error contents with a single string.
+The error messages
+Applies a set of default configuration values to this Labelable instance. For each of the +properties in the given object, check if this component hasOwnProperty that config; if not +then it's inheriting a default value from its prototype and we should apply the default value.
+The defaults to apply to the object.
+Fires when the active error message is changed via setActiveError.
+Fires when the active error message is changed via setActiveError.
+The active error message
+