Specifies that a value must be supplied by the user to a specified input field. 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. If a value must be supplied, be sure to specify a default value for these tags.

Contexts

Valid in:

form

<domino:validaterequired
name="input tag name"
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

Boolean value. 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 supply a value for this attribute unless you also specify a value for the msgkey attribute. 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 is supplied to the validatesummary tag for display 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.

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