To perform client-side validation on user input, set the clientvalidate attribute of this tag to "onsubmit" or "onblur", set the clientvalidate attribute of the form tag to "true", and include one of the following validation tags to specify the type of validation to perform:

validatecc, validatedate, validatelength, validatepattern, validaterange, validaterequired, validatesummary, validatewith. These tags validate user input by either requiring a field to be filled or testing that an entered value conforms to a specified format, length, pattern or falls within a specified range. Be sure to set the name attribute of the validation tag equal to the name attribute of this tag to identify which Web control input to validate.

Note If you do not include one of these validation tags, no validation is performed.

Contexts

Valid in:

form

<domino:input
name="control name"
format="format for displaying"
editformat="format for editing"
timezone="time zone"
locale="<languageCode>_<countryCode>"
itemname="Domino item name"
datatype="text|number|date|datetime|readers|authors|names"
clientvalidate="onblur|onsubmit|none"
defaultformula="formula determining default value"
defaultvalue="simple value to use as default value"
multivalue="true|false"
mveditseparator="blank|comma|colon|semicolon"
mvdisplayseparator="blank|comma|semicolon"
value=""
debug="true|false"
onfailure="inline|exception"
time="true|false"
The standard HTML tag attributes listed below>

clientvalidate

Indicates when to validate user input. Must be one of the following: onsubmit, onblur, none. Default is onsubmit. This attribute runs client-side validation before the form is submitted to the server. If you set this attribute to onsubmit or onblur, you must also include a validation tag that specifies the type of validation to perform. Optional.

Specifies the type of item being added to a new document as well as the automatic validation being performed on the server. Must be one of the following:

Value	Description:
text	Does not validate or convert the value entered.
number	Validates and converts the value entered to a number.
date	Validates and converts the value entered to a date.
datetime	Validates and converts the value entered to a datetime field with the format: 10/02/99 10:10 PM.
readers	Does not validate or convert the value entered. Treats the item as a readers field.
authors	Does not validate or convert the value entered. Treats the item as an authors field.
names	Does not validate or convert the value entered. Treats the item as a names field.

Default is text. The tag tries to save the data as the data type specified but can be overridden by the document. Optional.

Enables you to supply the default value of the item using a Notes formula. If you supply a schema attribute for the form tag that contains this tag, the default value of the item in the referenced form takes precedence over the value derived using this formula. Optional.

Default value for the item specified as a simple value. The string you supply is converted based on the datatype, locale, mveditseparator, and multivalue attribute values you supply. Supply default date values in ISO format, because the browser client's locale can change. If you supply a schema attribute for the form tag that contains this tag, the default value of the item in the referenced form takes precedence over the value specified in this attribute. Optional.

Format to use to display the text when the form is in edit mode or to display date-time and number values when the form is in display or read mode. If no editformat is supplied, the specifications in the format attribute are used.

Format to use to display the text when the form is in display or read mode, as specified by the keywords supplied. See Formatting JSP content for a list of available formatting keywords. If no format is supplied, dates use the DATE TIME format and numbers use the NUMBER format. Text is turned into a string using the Java toString() method and is automatically escaped for HTML.

Name of the item in the document that this input field is associated with. This attribute is useful if the itemname and name of the control on the page need to be different, due to invalid characters in the itemname for example. By default, this attribute equals the value of the name attribute. Optional.

Locale to use to format the input control that displays and defines how to interpret number and date values. 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. Optional.

Boolean value. If true, indicates that the input field supports multiple values. The mveditseparator attribute defines what characters to use to separate multiple values in a multi-value field during data entry and the mvdisplayseparator attribute defines what characters to use to separate multiple values when the multi-value field is displayed. Default is false. Optional.

Indicates what character to use to separate multiple values when displaying a multiple value field in either read or edit mode. Must be one of the following: blank, comma, colon, semicolon. Default is semicolon. Optional.

Indicates what character to use to separate multiple values in a multi-value field during data entry. Must be one or more of the following: blank, comma, semicolon. To specify multiple separators, separate each with a comma. Default is comma, semicolon. If the value specified in the mvdisplayseparator attribute is not specified here as well, it is automatically added. Optional.

Name of the control on the Web page. The itemname of the control in the document defaults to this value. Required.

Time zone to use to display the date. If you do not specify a value, defaults to the time zone of the server (not the browser). Optional.

Label for the input control. Standard HTML value attribute that is usually overwritten by the value of the item in the document, but is used by the checkbox and radio tags to indicated the value the checkbox or radio button control represents. Optional.

HTML Attributes

Domino supports the following HTML tag attributes:

type

The following options for the type HTML attribute cannot be used with the Domino input tag; use the custom tag specified in the following table instead:

Option	Replacement tag
checkbox	checkbox
file	attachments
image	(not available) Use a standard HTML <input> tag instead.
radio	radio

Optional.

accesskey

class

dir

disabled

id

lang

language

maxlength

onafterupdate

onbeforeupdate

onblur

onchange

onclick

ondblclick

ondragstart

onfocus

onhelp

onkeydown

onkeypress

onkeyup

onmousedown

onmousemove

onmouseout

onmouseover

onmouseup

onselect

onselectstart

readonly

size

src

style

tabindex

title

(type)

If you want to validate the data supplied by a user in an input control and plan to use a localized messages file as the source for that error message, you must add an entry for that input control in the properties file. An example of the format you can use for the entry is as follows:

name

where name equals the name attribute of the input tag the message refers to. The message you add to the properties file serves as the default message if no message or msgkey attribute value is supplied with the validation tag.

See Creating localized message files and Handling errors for more details.

Note You cannot validate the checkbox and radio tags. If your JSP requires that a value be selected for a radio or checkbox control, be sure to supply a default value for the tag.

See Also

The Domtags tag library

Glossary