Tomahawk selectManyListbox tag
This component lets you select more than one options from a set of available options.
This component lets you select more than one options from a set of available options.
Tomahawk
selectManyListbox
tag

This component lets you select more than one options from a set of available
options. It renders an html "select" element of specified
size with "multiple" attribute. size is used to
specify how many options are to be displayed at a time. If size is not specified
then it displays all the choices i.e. its default value is equal to no.
of available options. If we set this size to "1" then drop
down list is rendered. Instead of doing this we can use "selectManyMenu"
tag of JSF. If size is specified less than the total no. of available
options then scroll bar is rendered which can be used to see all the
options by moving it. Options are added by the use of f:selectItem or
f:selectItems.
Code Description :
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%>
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%>
<%@ taglib uri="http://myfaces.apache.org/tomahawk" prefix="t"%>
<f:view>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1">
<title>t:selectOneListbox example</title>
<style type="text/css">
<!--
body{
background-color:#fff2f2;
margin-top:30;
}
-->
</style>
</head>
<body >
<h:form><center>
<t:selectManyListbox id="smlb"
title="Press control key to select more than one banks." size="3">
<f:selectItem id="si1" itemLabel="SBI" itemValue="11" />
<f:selectItem id="si2" itemLabel="HDFC" itemValue="22" />
<f:selectItem id="si3" itemLabel="HSBC" itemValue="33" />
<f:selectItem id="si4" itemLabel="ICICI" itemValue="44" />
<f:selectItem id="si5" itemLabel="UTI" itemValue="55" />
<f:selectItem id="si6" itemLabel="PNB" itemValue="66" />
</t:selectManyListbox>
</center></h:form>
</body>
</html>
</f:view>
|
Rendered Output :

Html Source Code :
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;
charset=iso-8859-1">
<title>t:selectOneListbox example</title>
<style type="text/css">
<!--
body{
background-color:#fff2f2;
margin-top:30;
}
-->
</style>
</head>
<body>
<form id="_idJsp0" name="_idJsp0" method="post"
action="/tomahawk_tags/pages/selectManyListbox.jsf;
jsessionid=EF20BAE1F3387A9EE69C42B23DFDE6B3"
enctype="application/x-www-form-urlencoded">
<center>
<select id="_idJsp0:smlb" name="_idJsp0:smlb"
multiple="multiple" size="3"
title="Press control key to select more than one banks.">
<option value="11">SBI</option>
<option value="22">HDFC</option>
<option value="33">HSBC</option>
<option value="44">ICICI</option>
<option value="55">UTI</option>
<option value="66">PNB</option>
</select>
</center>
<input type="hidden" name="_idJsp0_SUBMIT" value="1" />
<input type="hidden" name="javax.faces.ViewState"
id="javax.faces.ViewState"
value="rO0ABXVyABNbTGphdmEubGFuZy5PYmplY3Q7kM5YnxBzKWwCAAB
4cAAAAAN0AAExcHQAHC9wYWdlcy9zZWxlY3RNYW55TGlzdGJveC5qc3A=" />
</form>
<!-- MYFACES JAVASCRIPT -->
</body>
</html>
|
This tag contains attributes given below :
- id : This is the value which is used to
uniquely identify the component within the closest container like form or
subview. The main thing to remember is that its value must be a static
value.
- binding : This attribute is used to specify
the property of the backing bean with which this component instance is to be
bound.
- rendered : Its default value is true.
If this attribute is set to true then this component is presented in
the page to the user. If false, then this component is not rendered.
- value : The initial value of the component is
set to this attribute.
- converter : This attribute is used to specify
the converter for the component.
- immediate : This attribute is a boolean
attribute that is used to identify the phase during which the value change
event should be fired. In normal processing of the event, if immediate
attribute is not set to true, the value change event is fired during the
invoke application phase but if immediate attribute is set to true then the
event is fired at the end of apply request value phase.
- required : This is a boolean attribute. If it
is set to true then it is necessary for the component to have the value
otherwise an error message is rendered to the user for the
component.
- validator : It takes the method binding
expression. This expression represents the validator method. This method is
called at the time of validation of the component.
- valueChangeListener : This also takes a
method binding expression. This expression represents value change listener
method. This method will be called when new value is set for this component.
you can change the phase of the life cycle when this method should be fired
by the use of immediate attribute discussed above.
- dir : It is used to set the direction of the
text to be displayed. It can take two values LTR(left to right) and RTL
(right to left).
- lang : It is used to set the base language of
the component when displayed.
- style : It is used to set the CSS style
definition for the component.
- title : It is the standard html attribute. It
is used to set the tooltip text for this component.
- styleClass : It is used to set the CSS class
for the component. It is same as html class attribute.
- onclick : Script to be invoked when the
element is clicked.
- ondblclick : It is used for Java Script code
to be invoked when the element is double-clicked.
- onmousedown : It is used for Java Script code
to be invoked when the pointing device is pressed over this element.
- onmouseup : It is used for Java Script code
to be invoked when the pointing device is released over this element.
- onmouseover : It is used for Java Script code
to be invoked when the pointing device is moved into this element.
- onmousemove : It is used for Java Script code
to be invoked when the pointing device is moved while it is in this element.
- onmouseout : It is used for Java Script code
to be invoked when the pointing device is moved out of this element.
- onkeypress : It is used for Java Script code
to be invoked when a key is pressed over this element.
- onkeydown : It is used for Java Script code
to be invoked when a key is pressed down over this element.
- onkeyup : It is used for Java Script code to
be invoked when a key is released over this element.
- disabled : Its a
boolean attribute. This is used to disable the element to receive focus,
when it is set to true.
- onblur : This attribute sets JavaScript code
to execute when the component loses the focus.
- onfocus : This attribute sets JavaScript code
to execute when the component receives the focus.
- onchange : This attribute sets JavaScript
code to execute when the element is modified.
- readonly : Its a boolean attribute. It is
used to indicate the user that its value can't be modified, if it is set to
true.
- tabindex : This is a standard html attribute.
It is used to set the order of receiving the focus on the movement of TAB
key by the user.
- size : It is used to determine how many
options have to be shown at a time from the list of available options. If it
is not specified then all are shown. If size is set to less than the number
of available options then scroll bar is rendered.
- enabledClass : This specifies the CSS class
to be used for the enabled choices.
- disabledClass : This specifies the CSS
class to be used for the enabled choices.
- escape : This specifies whether the rendered
markup should be rendered.
- enabledOnUserRole : If the current user has
one of the roles listed in the enabledOnUserRole attribute then enabling or
disabling of the component is decided on the base of "disabled"
attribute. If disabled attribute is set to true then component is disabled
otherwise enabled. If the user is not in the above list then the component
is rendered disabled.
- visibleOnUserRole : If the current user has
one of the roles listed in the visibleOnUserRole attribute then processing
of the component is decided on the base of "rendered" attribute.
If the rendered attribute is set to true then component is not rendered
otherwise displayed on the page. On the other hand if the current user
is not in the above list then the component is not processed.
- forceId : This is a boolean attribute with
default value false. If this attribute is set to true, the tag is forced to
render the id for the component exactly as mentioned in the id attribute of
the tag. The benefit of this attribute is that we can reference component by
id in the javascript. If we don't use this attribute with the true value
then the id for the component is presented in different format.
- forceIdIndex : This is a boolean attribute
with default value true. If this value is true then the the component
displays the index number in its id value if the component is in a list. If
this attribute is set to false then this component will not append index
number as suffix . If forcrId is set to false then its value is ignored.
- displayValueOnly : This is boolean attribute
with the default value false. If this value is set to true then only the
value of the component is rendered not the widget of the component.
- displayValueOnlyStyle : This attribute is
used to specify the style used when displayValueOnly is true.
- displayValueOnlyStyleClass : This attribute
is used to specify the style class used when displayValueOnly is true.
Ads