Component Description
This component is similar to a WOTextField and needs to be
placed within a WOForm. When the user clicks on one of the form's
submit buttons, the text in the field is tested according to the
following rules:
- If
inputIsRequired is
set to YES, the text must not be the empty string.
- If
requiredText is
not the empty string, the text must contain it.
If the text conforms to these rules, JSValidatedField submits
the form. Otherwise it displays a message and does not submit the
form.
Synopsis
JSValidatedField { inputText=aVariable;
errorMessage=aString; formName=aString;
[fieldSize=fieldSize;]
[inputIsRequired="YES"|"NO";] [requiredText=requiredText;]
};
Bindings
- inputText
- The variable into which the entered data is stored.
- errorMessage
- The message to display if the validation fails.
- formName
- The name of the form that contains the JSValidatedField.
- fieldSize
- Specifies the width of the text field.
- inputIsRequired
- If YES, this field must be nonempty before JSValidate
Field allows the user to submit the form.
- requiredText
- A string that the entered text must contain before JSValidateField
allows the user to submit the form.