Specifies that the length of the value in the name attribute of the input tag must be within the range specified. If validation fails, the body of the tag displays and the message or msgkey value is supplied to the validatesummary tag.

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."

Contexts

Valid in:

form

<domino:validatelength
name="input tag name"
max="maximum length"
min="minimum length"
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.

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.

If specified, the number of characters entered into the input field must be less than or equal to this value. A value for either this or the min attribute is required; you can supply values for both.

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

If specified, the number of characters entered into the input field must be greater than or equal to this value. A value for either this or the max attribute is required; you can supply values for both.

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.

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