au.id.jericho.lib.html
Class FormControlOutputStyle.ConfigDisplayValue
java.lang.Object
au.id.jericho.lib.html.FormControlOutputStyle.ConfigDisplayValue
- FormControlOutputStyle
public static final class FormControlOutputStyle.ConfigDisplayValue
extends java.lang.Object
Contains static properties that configure the
FormControlOutputStyle.ConfigDisplayValue
form control output style.
None of the properties should be assigned a
null
value.
See the documentation of the
FormControlOutputStyle.ConfigDisplayValue
output style for details on how these properties are used.
AttributeNames
public static List AttributeNames
Defines the names of the
attributes that are copied from the normal form control
output element to a
display value element.
The names included in the list by default are "
id
", "
class
" and "
style
".
These attributes are usually all that is needed to identify the elements in style sheets or specify the styles directly.
The default list is modifiable.
CheckedHTML
public static String CheckedHTML
Defines the HTML which replaces the normal
output element
of a
CHECKBOX
or
RADIO
form control if it contains a
checked
attribute.
If this property is
null
, the
output element is simply a
disabled version of the form control.
The HTML is not
encoded before output.
The default value is
null
.
ElementName
public static String ElementName
Defines the
name of
display value elements.
The default value is "
div
".
Although all form control
elements are
inline-level elements, the default replacement is the
block-level DIV
element, which allows
richer stylesheet formatting than the most common alternative, the
SPAN
element,
such as the ability to set its
width
and
height
.
This has the undesired effect in some cases of displaying the value on a new line, whereas the original form control
was not on a new line. In practical use however, many form controls are placed inside table cells for better control
over their positioning. In this case replacing the original inline form control with the block
DIV
element does not alter its position.
EmptyHTML
public static String EmptyHTML
MultipleValueSeparator
public static String MultipleValueSeparator
Defines the text that is used to separate multiple values in a
display value element.
This property is only relevant to
SELECT_MULTIPLE
form controls, and is only used
if multiple items in the control are selected.
The default value is "
,
".
PasswordChar
public static char PasswordChar
Defines the character used to represent the value of a
PASSWORD
form control
in a
display value element.
The character is repeated
n times, where
n is the number of characters in the control's
submission value.
The resulting string is
encoded before output.
The default password character is '
*
'.
UncheckedHTML
public static String UncheckedHTML
Defines the HTML which replaces the normal
output element
of a
CHECKBOX
or
RADIO
form control if it does not contain a
checked
attribute.
If this property is
null
, the
output element is simply a
disabled version of the form control.
The HTML is not
encoded before output.
The default value is
null
.