From Documentation

Jump to: navigation, search




Defines the columns of a grid.

Each child of a columns element should be a org.zkoss.zul.Column element.


ZKComRef Grid Example.png

<window title="Grid Demo" border="normal" width="360px">
	<zscript> class Comp implements Comparator { private boolean _asc;
		public Comp(boolean asc) { _asc = asc; } public int compare(Object o1,
		Object o2) { String s1 = o1.getChildren().get(0).getValue(), s2 =
		o2.getChildren().get(0).getValue(); int v = s1.compareTo(s2); return
		_asc ? v: -v; } } Comp asc = new Comp(true), dsc = new Comp(false);
		<columns sizable="true">
			<column label="Type" sortAscending="&#36;{asc}"
				sortDescending="&#36;{dsc}" width="50px"/>
			<column label="Content" />
				<label value="File:" />
				<textbox width="99%" />
				<label value="Type:" />
					<listbox rows="1" mold="select">
						<listitem label="Java Files,(*.java)" />
						<listitem label="All Files,(*.*)" />
					<button label="Browse..." />
				<label value="Options:" />
				<textbox rows="3" width="99%" />



By default, the none is assumed, you can specify the auto to appear a default menu for the columns. Or you can provide your own menupopup for the component.


ZKComRef Grid Columns Menu.png

		<columns menupopup="auto">
			<column label="Author" sort="auto"/>
			<column label="Title" sort="auto"/>
			<column label="Publisher" sort="auto"/>
			<column label="Hardcover" sort="auto"/>

Customized Menupopup

ZKComRef Grid Columns Customized Menu.png

<window title="Column's Menu Demo" border="normal" width="500px">
	<menupopup id="editPopup">
        <menuitem label="Group" image="~./zul/img/grid/menu-group.png"/>
        <menuitem label="Sort Ascending" image="~./zul/img/grid/menu-arrowup.png"/>
        <menuitem label="Sort Descending" image="~./zul/img/grid/menu-arrowdown.png"/>
		<columns sizable="true" menupopup="editPopup">
			<column id="col" label="Type" sortAscending="&#36;{asc}" sortDescending="&#36;{dsc}"/>
			<column id="col1" label="Type1" sortAscending="&#36;{asc}" sortDescending="&#36;{dsc}"/>
			<column id="col2" label="Content"/>

As you can see, the example above specify a customized menupopup to the columns as its column menu.


Specifies whether the user is allowed to size a column of a grid (by dragging the vertical bar between two adjacent columns).

Notice that, in additions to dragging, the end user could double-click on the vertical bar between two adjacent columns, such that the grid will automatically resize the column to fit its contents. In other words, all sizable column provides the auto-fitting functionality.

Supported Events

Event Type
None None

Supported Children

* Column

Use Cases


Version History

Last Update : 2011/1/19

Version Date Content

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