Selectbox"

From Documentation
(Created page with "{{ZKComponentReferencePageHeader}} = Selectbox = *Demonstration: N/A *Java API: <javadoc>org.zkoss.zul.Selectbox</javadoc> *JavaScript API: <javadoc directory="jsdoc">zul.wgt.S...")
 
Line 12: Line 12:
  
 
= Example =
 
= Example =
 +
[[Image:Selectbox-Example1.png]]
  
 
<source lang="xml" >
 
<source lang="xml" >
Line 75: Line 76:
 
</zk>
 
</zk>
 
</source>
 
</source>
 +
 
=Supported Events=
 
=Supported Events=
  

Revision as of 03:52, 4 October 2011

Selectbox

Employment/Purpose

Selectbox is a lightweight dropdown list and it can support ListModel, Renderer, and Databinding as well. The benefit of it is not to create child widgets for each data, so the memory usage is much lower at the server.

Example

Selectbox-Example1.png

<zk>
	<zscript>
		<![CDATA[
		String[] userName = { "Tony", "Ryan", "Jumper", "Wing", "Sam" };
		ListModelList model = new ListModelList(userName);
	]]></zscript>
	<selectbox model="${model}" onSelect='alert(model.get(event.getData()));'>
		<template name="model">
			Name is ${each}
		</template>
	</selectbox>
</zk>

Databinding

Here is the example for Databinding.

<?init class="org.zkoss.zkplus.databind.AnnotateDataBinderInit"?>
<zk>
        <zscript>
                <![CDATA[

        public class MyUserBean{
                private String[] userList = { "Tony", "Ryan", "Jumper", "Wing", "Sam" };
                private int index = 0;
                public List getUserList(){
                        return Arrays.asList(userList);
                }
                public void setUserList(){
                }
                public void setIndex(int ind){
                        index=ind;
                }
                public int getIndex(){
                        return index;
                }
                public String getCurrentName(){
                        return userList[index];
                }
        }
        
        MyUserBean mybean = new MyUserBean();

        org.zkoss.zul.OptionRenderer render = new org.zkoss.zul.OptionRenderer() {

                public String render(Object data) throws Exception {
                        return data.toString();
                }
        };
]]></zscript>

        <div>
        Select User:
        <selectbox id="box" model="@{mybean.userList}" itemRenderer="${render}"
                selectedIndex="@{mybean.index}" />

        </div>
        Selected:
        <label id="val" value="@{mybean.currentName }" />
</zk>

Supported Events

Name
Event Type
onSelect
Event: SelectEvent

Notifies one that the user has selected a new item in the selectbox.

Supported Children

*NONE

Use Cases

Version Description Example Location
     

Version History

Last Update : 2011/10/04


Version Date Content
6.0.0 October 4, 2011 Add the new Selectbox component



Last Update : 2011/10/04

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.