ZK Component Reference/Data/Listbox/Listheader

Listheader

• Demonstration: Listbox (Sorting)
• Java API: Listheader
• JavaScript API: Listheader
• Style Guide: Listheader

Employment/Purpose

The list header which defines the attributes and header of a columen of a list box. Its parent must be Listhead.

Example

 <window title="listbox demo" border="normal" width="250px">
         <listbox id="box">
             <listhead sizable="true">
                 <listheader label="name" sort="auto"/>
                 <listheader label="gender" sort="auto"/>
             </listhead>
             <listitem>
                 <listcell label="Mary"/>
                 <listcell label="FEMALE"/>
             </listitem>
             <listitem>
                 <listcell label="John"/>
                 <listcell label="MALE"/>
             </listitem>
             <listitem>
                 <listcell label="Jane"/>
                 <listcell label="FEMALE"/>
             </listitem>
             <listitem>
                 <listcell label="Henry"/>
                 <listcell label="MALE"/>
             </listitem>
             <listfoot >
                 <listfooter><label value="This is footer1"/></listfooter>
                 <listfooter><label value="This is footer2"/></listfooter>
             </listfoot>
         </listbox>        
 </window>

Supported Events

Name	Event Type
onSort	Event: SortEvent Denotes user has sorted the row of this column.
onGroup	Event: SortEvent [ZK PE] [Since 6.1.0] Denotes user has grouped all the cells under a column.
onUngroup	Event: SortEvent [ZK EE] [Since 6.1.0] Denotes user has ungrouped all the cells under a column.

• Inherited Supported Events: HeaderElement

Supported Children

*ALL

Use Cases

Version	Description	Example Location
5.0	Multiline Listheader	http://www.zkoss.org/forum/listComment/6864

Version History

Version	Date	Content
6.1.0	June 2012	ZK-120: Provide menupopup="auto" for listbox
6.1.0	June 2012	ZK-147: Support ungroup for grid's column menu