Tag Library
The Calyxo Forms custom tag library contains tags to render input fields. In a JSP file, just associate the prefix you want to use for the tags with URI http://calyxo.odysseus.de/jsp/forms:
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.0" xmlns:forms="http://calyxo.odysseus.de/jsp/forms"> ... </jsp:root>
Since the tag library descriptor is contained in the Calyxo Forms jar file, it is already available to applications. The container will automatically find it. For documentation purposes, a copy is located in CALYXO_HOME/calyxo-forms/conf/share/calyxo-forms.tld.
All attributes may be expressed using runtime expressions. Most of the attributes are optional. If an attribute is required for a specific tag, this is mentioned in the corresponding attribute description (and indicated by an attribute name printed in bold).
General Tags
| Name | Description |
|---|---|
| debug | Renders an HTML table showing the current form validation result. |
HTML Tags
| Name | Description |
|---|---|
| form | Defines an HTML form. |
| text | Renders a text input field. |
| password | Renders a password input field. |
| hidden | Renders a hidden input field. |
| textarea | Renders a textarea input field. |
| checkbox | Renders a checkbox input field. |
| radio | Renders a radio button input field. |
| group | Container for checkbox or radio items. |
| checkboxitem | Renders a checkbox input field contained in a group. |
| radioitem | Renders a radio button input field contained in a group. |
| select | Renders a menu or selection list. |
| option | Renders a select option. |
| listoption | Renders a select option obtained from a list model. |
| listoptions | Renders a set of select options obtained from a list model. |
Attribute groups
We use the following abbreviations to refer to groups of HTML attributes. The first three (%coreattrs, %i18n, %events) have the same meaning as in the HTML 4.01 specification, whereas the last one (%input) is only used within this documentation.
| Abbreviation | HTML Attributes |
|---|---|
| %coreattrs | id, class, style, title |
| %i18n | lang, dir |
| %events |
onclick, ondblclick
onmousedown, onmouseup, onmouseover, onmousemove, onmouseout onkeydown, onkeyup, onkeypress |
| %input |
accesskey, alt, disabled, readonly, tabindex
onfocus, onblur, onchange |
All of them are mapped to the HTML attribute of the same name. Usually their values are not modified, but there are two minor exceptions from this rule: the attributes disabled and readonly. If their value is set to an arbitrary string, this is mapped to an HTML attribute containing the attribute name (i.e., disabled="disabled" or readonly="readonly").