This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Child pages
  • Form Tags

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin


Please make sure you have read the Tag Syntax document and understand how tag attribute syntax works.


The xhtml theme renders out a two-column table. If a different layout is needed, do not write your own HTML. Create a new theme or utilize the simple theme.


Template-Related Attributes


Javascript-Related Attributes


Tooltip Related Attributes


General Attributes


Some tag attributes may not be utilized by all, or any, of the templates. For example, the form tag supports the tabindex attribute, but none of the themes render the tabindex.

Value/Name Relationship


Likewise, a form control could be populated by calling a JavaBean accessor, like getPostalCode. In the expression language, we can refer to the JavaBean property by name. An expression like "%{postalCode}" would in turn call getPostalCode.


However, since the tags imply a relationship between the name and value, the value attribute is optional. If a value is not specified, by default, the JavaBean accessor is used instead.


While most attributes are exposed to the underlying templates as the same key as the attribute (${parameters.label}), the value attribute is not. Instead, it can be accessed via the nameValue key (${parameters.nameValue}). The nameValue key indicates that the value may have been generated from the name attribute rather than explicitly defined in the value attribute.



The default ID is the action name. For example, "updateAddress".


The default ID is the form's name concatenated with the tag name. For example, "updateAddress_postalCode".

Form labelposition propagation

When labelposition attribute was defined for <s:form> tag it will be propagated to all form elements, but if form element defines its own labelposition it will take precedence over <s:form>'s attribute. Since 2.3.17.

Required Attribute

The required attribute on many UI tags defaults to true only if you have client-side validation enabled, and a validator is associated with that particular field.



Form Tag Reference

titleEntering push and pop zone

All tags that push something onto the value stack (like i18n or bean tags) will pop those objects from the stack when its processing completes. If a bean is instantiated with the bean tag (<saf:bean name="br.univap.fcc.sgpw.util.FormattersHelper">) that bean will be available on the value stack only until the tag closes.

  1. checkbox - renders a checkbox input field
  2. checkboxlist - renders a list of checkboxes
  3. combobox - renders a widget that fills a text box from a select
  4. datepicker - renders a date selection widget using JavaScript and DOM
  5. doubleselect - renders a double select widget, where the second drop down depends on the first
  6. head - renders the HEAD section for specific themes, such as CSS and JavaScript imports
  7. file - renders a file input field
  8. form - renders an input form
  9. hidden - renders a hidden form field
  10. label - renders renders a label
  11. optiontransferselect- renders an option transfer select component which is basically two select box with buttons in between allowing entries of each select to get transfer between each other.
  12. optgroup - render an optgroup tag to be used within a select tag
  13. password - renders a password textfield
  14. radio - renders a radio button
  15. reset - renders a reset form button
  16. select - renders a select
  17. submit - renders a submit button
  18. textarea - renders a textarea
  19. textfield - renders a textfield
  20. timepicker - renders a timepicker
  21. token - renders a hidden field to stop double-submission of containing forms
  22. updownselect - renders a select component with buttons to move the elements in the select component up and down

Next: Non Form Tags

Next: UI Tag Reference