org.apache.struts2.components

This tag enables developers to call actions directly from a JSP page by specifying the action name and an optional namespace.

Examples

 
 <s:actionerror />
 <s:form ....

Examples

 
 <s:actionmessage />
 <s:form ....

THE FOLLOWING IS ONLY VALID WHEN AJAX IS CONFIGURED

• href
• errorText
• listenTopics
• notifyTopics
• executeScripts
• loadingText
• listenTopics
• handler
• formId
• formFilter
• targets
• showErrorTransportText
• targets
• indicator

The autocomplete tag is a combobox that can autocomplete text entered on the input box. When used on the "simple" theme, the autocompleter can be used like the ComboBox. When used on the "ajax" theme, the list can be retieved from an action.

Instantiates a class that conforms to the JavaBeans specification.

The date tag will allow you to format a Date in a quick and easy way. You can specify a custom format (eg.

Renders a date/time picker in a dropdown container.

A stand-alone DateTimePicker widget that makes it easy to select a date/time, or increment by week, month, and/or year.

It is possible to customize the user-visible formatting with either the 'formatLength' (long, short, medium or full) or 'displayFormat' attributes.

It creates a HTML <DIV /> that obtains it's content via a remote XMLHttpRequest call via the dojo framework.

Perform basic condition flow.

Perform basic condition flow.

Renders HTML an input form.

The remote form allows the form to be submitted without the page being refreshed.

Perform basic condition flow.

Iterator will iterate over a value.

Examples

In this example, a label is rendered.

Component for MergeIteratorTag, which job is to merge iterators and successive call to the merged iterator will cause each merge iterator to have a chance to expose its element, subsequently next call will allow the next iterator to expose its element.

This tag can be used to parameterize other tags.

The parameters can be added with or without a name as key. If the tag provides a name attribute the parameters are added using the Component.addParameter(StringObject) addParamter method. For unnamed parameters the Tag must implement the UnnamedParametric interface defined in this class (e.g.

Examples

In this example, a password control is displayed.

• default (String) - The default value to be used if value attribute is null
• escape (Boolean) - Escape HTML.

Push value on stack for simplified usage.

• value* (Object) - value to be pushed into the top of the stack

Examples

 
 <s:push value="user">
 <s:propery value="firstName" />
 <s:propery value="lastName" />
 </s:push>
 
 

 
 <s:push value="myObject">                              ----- (1)
 <s:bean name="jp.SomeBean" id="myBean"/>        ----- (2)
 <s:param name="myParam" value="top"/>        ----- (3)
 </s:bean>
 </s:push>
 
 

 
 when in (1), myObject is at the top of the stack
 when in (2), jp.SomeBean is in the top of stack, also in stack's context with key myBean
 when in (3), top will get the jp.SomeBean instance
 
 

 
 <s:push value="myObject">                                       ---(A)
 <s:bean name="jp.SomeBean" id="myBean"/>                   ---(B)
 <s:param name="myParam" value="top.mySomeOtherValue"/>  ---(C)
 </s:bean>
 </s:push>
 
 

 
 when in (A), myObject is at the top of the stack
 when in (B), jp.SomeBean is at the top of the stack, also in context with key myBean
 when in (C), top refers to jp.SomeBean instance.

Examples

In this example, a radio control is displayed with a list of genders.

Examples

 
 <s:select label="Pets"
 name="petIds"
 list="petDao.pets"
 listKey="id"
 listValue="name"
 multiple="true"
 size="3"
 required="true"
 />
 <s:select label="Months"
 name="months"
 headerKey="-1" headerValue="Select Month"
 list="#{'01':'Jan', '02':'Feb', [...]}"
 value="selectedMonth"
 required="true"
 />
 // The month id (01, 02, ...) returned by the getSelectedMonth() call
 // against the stack will be auto-selected
 
 

Note: For any of the tags that use lists (select probably being the most ubiquitous), which uses the OGNL list notation (see the "months" example above), it should be noted that the map key created (in the months example, the '01', '02', etc.) is typed.

The set tag assigns a value to a variable in a specified scope.

The message must be in a resource bundle with the same name as the action that it is associated with.

Examples

In this example, a text control for the "user" property is rendered.

Either of the following combinations should be used depending on if the tree is to be constrcted dynamically or statically.

Attribute	Theme	Data Types	Description
cssClass	simple	String	define html class attribute
cssStyle	simple	String	define html style attribute
title	simple	String	define html title attribute
disabled	simple	String	define html disabled attribute
label	xhtml	String	define label of form element
labelPosition	xhtml	String	define label position of form element (top/left), default to left
requiredposition	xhtml	String	define required label position of form element (left/right), default to right
name	simple	String	Form Element's field name mapping
required	xhtml	Boolean	add * to label (true to add false otherwise)
tabIndex	simple	String	define html tabindex attribute
value	simple	Object	define value of form element

Attribute	Theme	Data Types	Description
onclick	simple	String	html javascript onclick attribute
ondbclick	simple	String	html javascript ondbclick attribute
onmousedown	simple	String	html javascript onmousedown attribute
onmouseup	simple	String	html javascript onmouseup attribute
onmouseover	simple	String	html javascript onmouseover attribute
onmouseout	simple	String	html javascript onmouseout attribute
onfocus	simple	String	html javascript onfocus attribute
onblur	simple	String	html javascript onblur attribute
onkeypress	simple	String	html javascript onkeypress attribute
onkeyup	simple	String	html javascript onkeyup attribute
onkeydown	simple	String	html javascript onkeydown attribute
onselect	simple	String	html javascript onselect attribute
onchange	simple	String	html javascript onchange attribute

Attribute	Data Type	Default	Description
tooltip	String	none	Set the tooltip of this particular component
jsTooltipEnabled	String	false	Enable js tooltip rendering
tooltipIcon	String	/struts/static/tooltip/tooltip.gif	The url to the tooltip icon
tooltipDelay	String	500	Tooltip shows up after the specified timeout (miliseconds).
UIBeanTest.java	Class
UIComponentTest.java	Class	Test case common for all UI component in general.
UpDownSelect.java	Class	Create a Select component with buttons to move the elements in the select component up and down.
URL.java	Class	This tag is used to create a URL. You can use the "param" tag inside the body to provide additional request parameters. NOTE: By default request parameters will be separated using escaped ampersands (i.e., &amp;). This is necessary for XHTML compliance, however, when using the URL generated by this tag with the <s:property> tag, the escapeAmp attribute should be used to disable ampersand escaping. NOTE: When includeParams is 'all' or 'get', the parameter defined in param tag will take precedence and will not be overriden if they exists in the parameter submitted.
URLTest.java	Class	Verifies correct operation of parameter merging.