Edit on GitHub << back to Tag Reference

# inputtransferselect

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

## Description

Create a input transfer select component which is basically an text input and `<select ...>` tag with buttons in the middle of them allowing text to be added to the transfer select. Will auto-select all its elements upon its containing form submission.

> NOTE: The id and doubleId need not be supplied as they will generated provided that the inputtransferselect tag is being used in a form tag. The generated id and doubleId will be `<form_id>_<inputtransferselect_doubleName>` and `<form_id>_<inputtransferselect_doubleName>` respectively.

Renders an input form

## Attributes

#### Dynamic Attributes Allowed: false
#### Name | #### Required | #### Default | #### Evaluated | #### Type | #### Description
--- | --- | --- | --- | --- | ---
accesskey | false |  | false | String | Set the html accesskey attribute on rendered html element
addLabel | false |  | false | String | the label used for the add button
allowRemoveAll | false |  | false | String | Determine whether the remove all button will display
allowUpDown | false |  | false | String | Determine whether items in the list can be reordered
buttonCssClass | false |  | false | String | the css class used for rendering buttons
buttonCssStyle | false |  | false | String | the css style used for rendering buttons
cssClass | false |  | false | String | The css class to use for element
cssErrorClass | false |  | false | String | The css error class to use for element
cssErrorStyle | false |  | false | String | The css error style definitions for element to use
cssStyle | false |  | false | String | The css style definitions for element to use
disabled | false |  | false | String | Set the html disabled attribute on rendered html element
downLabel | false |  | false | String | the label used for the down button
errorPosition | false |  | false | String | Define error position of form element (top|bottom)
headerKey | false |  | false | String | the header key of the select box
headerValue | false |  | false | String | the header value of the select box
id | false |  | false | String | HTML id attribute
javascriptTooltip | false | false | false | Boolean | Use JavaScript to generate tooltips
key | false |  | false | String | Set the key (name, value, label) for this particular component
label | false |  | false | String | Label expression used for rendering an element specific label
labelPosition | false |  | false | String | Define label position of form element (top/left)
labelSeparator | false | : | false | String | String that will be appended to the label
leftTitle | false |  | false | String | the left hand title
list | true |  | false | String | Iterable source to populate from. If the list is a Map (key, value), the Map key will become the option 'value' parameter and the Map value will become the option body.
listCssClass | false |  | false | String | Property of list objects to get css class from
listCssStyle | false |  | false | String | Property of list objects to get css style from
listKey | false |  | false | String | Property of list objects to get field value from
listLabelKey | false |  | false | String | Property of list objects to be used to lookup for localised version of field label
listTitle | false |  | false | String | Property of list objects to get title from
listValue | false |  | false | String | Property of list objects to get field content from
listValueKey | false |  | false | String | Property of list objects to get field value label from
multiple | false |  | false | String | Determine whether or not multiple entries are shown
name | false |  | false | String | The name to set for element
onblur | false |  | false | String | Set the html onblur attribute on rendered html element
onchange | false |  | false | String | Set the html onchange attribute on rendered html element
onclick | false |  | false | String | Set the html onclick attribute on rendered html element
ondblclick | false |  | false | String | Set the html ondblclick attribute on rendered html element
onfocus | false |  | false | String | Set the html onfocus attribute on rendered html element
onkeydown | false |  | false | String | Set the html onkeydown attribute on rendered html element
onkeypress | false |  | false | String | Set the html onkeypress attribute on rendered html element
onkeyup | false |  | false | String | Set the html onkeyup attribute on rendered html element
onmousedown | false |  | false | String | Set the html onmousedown attribute on rendered html element
onmousemove | false |  | false | String | Set the html onmousemove attribute on rendered html element
onmouseout | false |  | false | String | Set the html onmouseout attribute on rendered html element
onmouseover | false |  | false | String | Set the html onmouseover attribute on rendered html element
onmouseup | false |  | false | String | Set the html onmouseup attribute on rendered html element
onselect | false |  | false | String | Set the html onselect attribute on rendered html element
performClearTagStateForTagPoolingServers | false | false | false | Boolean | Whether to clear all tag state during doEndTag() processing (if applicable)
removeAllLabel | false |  | false | String | the label used for the remove all button
removeLabel | false |  | false | String | the label used for the remove button
requiredLabel | false | false | false | Boolean | If set to true, the rendered element will indicate that input is required
requiredPosition | false |  | false | String | Define required position of required form element (left|right)
rightTitle | false |  | false | String | the right hand title
size | false |  | false | String | the size of the select box
style | false |  | false | String | The css style definitions for element to use - it's an alias of cssStyle attribute.
tabindex | false |  | false | String | Set the html tabindex attribute on rendered html element
template | false |  | false | String | The template (other than default) to use for rendering the element
templateDir | false |  | false | String | The template directory.
theme | false |  | false | String | The theme (other than default) to use for rendering the element
title | false |  | false | String | Set the html title attribute on rendered html element
tooltip | false |  | false | String | Set the tooltip of this particular component
tooltipConfig | false |  | false | String | Deprecated. Use individual tooltip configuration attributes instead.
tooltipCssClass | false | StrutsTTClassic | false | String | CSS class applied to JavaScrip tooltips
tooltipDelay | false | Classic | false | String | Delay in milliseconds, before showing JavaScript tooltips
tooltipIconPath | false |  | false | String | Icon path used for image that will have the tooltip
upLabel | false |  | false | String | the label used for the up button
value | false |  | false | String | Preset the value of input element.

## Dynamic attributes

The tag supports dynamic attributes but if you want to add the attributes to the input control which is generated by the tag use the `input-` prefix as below:

    <s:inputtransferselect ... input-control-id="id2"/>

The prefix will be stripped while generating the second control.

## Example

    <s:inputtransferselect
         label="Favourite Cartoons Characters"
         name="cartoons"
         list="{'Popeye', 'He-Man', 'Spiderman'}"
     />