Enum Class FormControlOutputStyle
- All Implemented Interfaces:
Serializable
,Comparable<FormControlOutputStyle>
,Constable
A form control's output style is set using the FormControl.setOutputStyle(FormControlOutputStyle)
method.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final class
Contains static properties that configure theDISPLAY_VALUE
form control output style.Nested classes/interfaces inherited from class java.lang.Enum
Enum.EnumDesc<E extends Enum<E>>
-
Enum Constant Summary
Enum ConstantsEnum ConstantDescriptionThe normal output element is replaced with a simple representation of the form control's submission value(s).Normal display of the output element.Remove the output element from the output document completely. -
Method Summary
Modifier and TypeMethodDescriptionReturns a string representation of this object useful for debugging purposes.static FormControlOutputStyle
Returns the enum constant of this class with the specified name.static FormControlOutputStyle[]
values()
Returns an array containing the constants of this enum class, in the order they are declared.
-
Enum Constant Details
-
NORMAL
Normal display of the output element.This is the default display style.
-
REMOVE
Remove the output element from the output document completely. -
DISPLAY_VALUE
The normal output element is replaced with a simple representation of the form control's submission value(s).The implementation of this functionality is highly subjective, but provides a more aesthetic way of displaying a read-only version of a form without having to resort to using disabled controls.
The representation is dependent on the form control type, and can be configured using the static properties of the
ConfigDisplayValue
nested class.Unless specified otherwise below, the normal output element is replaced with a display value element having the name specified in the static
ConfigDisplayValue.ElementName
property (div
by default). The attributes specified in the staticConfigDisplayValue.AttributeNames
list (id
,class
andstyle
by default) are copied from the normal output element into the display value element.Details of the content of the display value element or other representation of the control value are as follows:
TEXT
,FILE
- The content of the display value element is the
re-encoded value of the
normal output element's
value
attribute. TEXTAREA
- The content of the display value element is the content of the
TEXTAREA
element re-encoded with white space formatting. CHECKBOX
,RADIO
- The normal output element is replaced with the
un-encoded content specified in the
ConfigDisplayValue.CheckedHTML
orConfigDisplayValue.UncheckedHTML
static property, depending on whether the normal output element contains achecked
attribute. If the relevant static property has a value ofnull
(the default), the output element is simply a disabled version of the form control. Attempting to determine which labels might apply to which checkbox or radio button, allowing only the selected controls to be displayed, would require a very complex and inexact algorithm, so is best left to the developer to implement if required. SELECT_SINGLE
,SELECT_MULTIPLE
- The content of the display value element is the
re-encoded label of the currently selected option.
In the case of a
SELECT_MULTIPLE
control, all labels of selected options are listed, separated by the text specified in the staticConfigDisplayValue.MultipleValueSeparator
property (",
" by default). PASSWORD
- The content of the display value element is the
encoded character specified in the
ConfigDisplayValue.PasswordChar
static property ('*
' by default), repeated n times, where n is the number of characters in the control's submission value. HIDDEN
- The output element is removed completely.
BUTTON
,SUBMIT
,IMAGE
- The output element is a disabled version of the original form control.
If the submission value of the control is
null
or an empty string, the display value element is given the un-encoded content specified in theConfigDisplayValue.EmptyHTML
static property.
-
-
Method Details
-
values
Returns an array containing the constants of this enum class, in the order they are declared.- Returns:
- an array containing the constants of this enum class, in the order they are declared
-
valueOf
Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)- Parameters:
name
- the name of the enum constant to be returned.- Returns:
- the enum constant with the specified name
- Throws:
IllegalArgumentException
- if this enum class has no constant with the specified nameNullPointerException
- if the argument is null
-
getDebugInfo
Returns a string representation of this object useful for debugging purposes.This is equivalent to
Enum.toString()
.- Returns:
- a string representation of this object useful for debugging purposes.
-