If you are running the JSP remotely (the Domino server and the hosting Web server are located on two separate machines), a textarea control replaces the richtext control. Its height and width are specified by the cols and rows attributes.

Note For the tag to function properly, you must select the "Store contents as HTML and MIME" checkbox on the Control tab of the field properties box for the Rich text field you are referencing.

Note If you are using client-side JavaScript to control the submission of the form containing this tag, you must use the form.performSubmit() method instead of form.submit() or the richtext control will not function properly.

Contexts

Valid in:

form

<domino:richtext
name="name of the Web control"
itemname="name of the item in a document"
control="ie5|applet|check"
locale="<languageCode>_<countryCode>"
clientvalidate="onblur|onsubmit|none"
width="percentage of window height"
height="pixels"
rows="height if running remotely"
cols="width if running remotely"
codepath="path to the editing files"
debug="true|false"
onfailure="inline|exception"
time="true|false"
The standard HTML tag attributes listed below>

The following attributes are optional:

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.

Specifies the path for the edit control files (dhtmled.js and domec.js) and to the editor applet. Do not include the ending slash (/) or the editctrl subdirectory in the codepath attribute. For example:

<domino:richtext name="body" codepath="components/editor" width='<%=width%>' height='<%=height%>' tabindex="30"/>

Width of the control if the JSP is running remotely (the Domino server and hosting Web server are located on different machines). The control is rendered as a textarea tag instead of a richtext tag since the hosting machine does not have access to the edit control files.

Type of client-side editing control to use to display the tag. Must be one of the following options:

Attribute Name	Description
ie5	Displays the Microsoft Internet Explorer 5 rich text control. This option does not display in Netscape or other browsers.
applet	Displays the Rich Text Java applet, which is the standard Domino editing applet. Java must be enabled on the client browser.
check	Checks for browser type and displays appropriate control.

Default is check.

Height of the control as a percentage of the window height or in pixels. This value is passed through as HTML to the <applet> or <object> tag. Default is 300 pixels.

Name of the item in the document that this rich text control 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.

Locale to use to localize the applet or IE5 rich text control rendered on the page. 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.

Name of the control on the Web page. Default is the value of the itemname attribute.

Height of the control if the JSP is running remotely (the Domino server and hosting Web server are located on different machines). The control is rendered as a textarea tag instead of a richtext tag, since the hosting machine does not have access to the edit control files.

Width of the control as a percentage of the window width or in pixels. This value is passed through as HTML to the <applet> or <object> tag. Default is 100%.

HTML Attributes

Domino supports the following HTML tag attributes. See the Common HTML tag attributes section for their definitions.

accesskey

tabindex

title

The Domtags tag library

Glossary