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

NameDescription
debug Renders an HTML table showing the current form validation result.

HTML Tags

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

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