Specifies that the value supplied by the user to a specified input field must be valid compared to a constant value or another input field value. If validation fails, the body of this tag is evaluated.

Be sure the clientvalidate attribute of the input tag you are validating does not equal "none." The clientvalidate attribute of the form tag containing the input tag should be set to "true."

Note You cannot use this tag to validate the radio and checkbox tags.

Contexts

Valid in:

form

<domino:validatewith
name="input tag name"
value="comparison value"
otherfield="name of the other input tag to compare to"
operation="EQ|NE|LT|GT|LE|GE|=|<>|<|>|<=|>="
type="string|number"
casesensitive="true|false"
message="message to display if validation fails"
msgkey="message bundle key"
bundle="name of .properties file bundle"
locale="<languageCode>_<countryCode>
alert="true|false"
onalert="alert dialog box message"
debug="true|false"
onfailure="inline|exception"
time="true|false"
The HTML tag attributes listed below>

alert

If true and client-side validation is enabled (form tag's clientvalidate attribute = true), displays a pop-up alert dialog box when a validation error is encountered. The contents of the dialog box are supplied by a search performed in the following sequence:

1) onalert attribute value

2) msgkey attribute value

3) message attribute value

4) body of this tag


Default is false. Optional.

Name of the message bundle to use if the msgkey attribute is specified. The default search sequence is followed and if no message is found, the default resource bundle name, messages, is used. You cannot specify a value for this attribute without specifying a value for the msgkey attribute. Optional.

Boolean value. True indicate that the validation should perform a case-sensitive comparison. Default is false. Optional.

Locale to use to locate the proper message bundle. If specified, overrides the locale that the browser specifies in the AcceptLang string. Use the following syntax: "<languageCode>_<countryCode>". See Locale codes for more details. By default, uses the first locale specified in the AcceptLang string for the browser. You cannot supply a value for this attribute unless you also specify a value for the msgkey attribute. Optional.

Message that the validatesummary tag displays if validation fails. The content of this attribute is treated as pass-thru HTML. Optional.

Name of a key in the associated message bundle. Optional.

Name of the input tag to perform validation on (equals the name attribute of the corresponding input tag). Required.

Message to display in the alert dialog box that displays when client side validation fails. Supplying a value for this attribute automatically sets the alert attribute to true. Optional.

Specifies the comparison operator to use. Must be one of the following:

Value	OR	Means
EQ	=	equal
NE	<>	not equal
LT	<	less than
GT	>	greater than
LE	<=	less than or equal to
GE	>=	greater than or equal to

Default is EQ. Optional.

Name of the other input tag to compare the current input tag to. If specified, the user input, when compared to the field specified here, must prove the operator supplied in the operation attribute true. You cannot specify a value for this attribute if you have specified a value for the value attribute; the attributes are mutually exclusive. Optional.

Data type of the values to compare. Must be either string or number. Default is string. Optional.

Value to compare the input tag to. If specified, the user input, when compared to this value, must prove the operator supplied in the operation attribute true. You cannot specify a value for this attribute if you have specified a value for the otherfield attribute; the attributes are mutually exclusive. Optional.

HTML Attributes

See the Common HTML tag attributes section for definitions of the following standard HTML tag attributes:

class

style

The Domtags tag library

Glossary