Text
A simple text field, corresponding to an HTML <input type="text"> element.
Properties
type |
"text" |
whitespace |
(optional) How to handle whitespace in the entered text. |
validationRegExp |
(optional) A regular expression used for validation. |
validationRegExpOptions |
(optional) Options used for the regular expression. Consider using "i" for case insensitivity. |
validationFailureMessage |
(optional) A message to display when the text fails to match the regular expression. |
htmlPrefix |
(optional) Literal HTML output directly before the <input> element. |
htmlSuffix |
(optional) Literal HTML output directly before the <input> element. |
All the common properties are supported.
Whitespace handling options
The whitespace property can be set to:
"trim" |
Remove leading and trailing whitespace |
"minimise" |
Remove leading and trailing whitespace, and replace multiple whitespace characters with a single space |
"minimize" |
Remove leading and trailing whitespace, and replace multiple whitespace characters with a single space (US English alias for "minimise") |
Using these options will remove all the text if the entered text is nothing but whitespace, at which point the "required" property will determine whether the field validates successfully.