Columns"

From Documentation
 
(13 intermediate revisions by 5 users not shown)
Line 6: Line 6:
 
*Java API: <javadoc>org.zkoss.zul.Columns</javadoc>
 
*Java API: <javadoc>org.zkoss.zul.Columns</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.grid.Columns</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zul.grid.Columns</javadoc>
*Style Guide: [http://books.zkoss.org/wiki/ZK_Style_Guide/XUL_Component_Specification/Column Columns]
+
*Style Guide: [[ZK_Style_Guide/XUL_Component_Specification/Column| Columns]]
  
 
= Employment/Purpose =
 
= Employment/Purpose =
Line 18: Line 18:
 
= Example =
 
= Example =
  
[[Image:grid.png]]
+
[[Image:ZKComRef_Grid_Example.png‎]]  
  
 +
<syntaxhighlight lang="xml" >
 +
    <grid>
 +
        <columns sizable="true">
 +
            <column label="Type" hflex="min"/>
 +
            <column label="Content"/>
 +
        </columns>
 +
        <rows>
 +
            <row>
 +
                <label value="File:"/>
 +
                <textbox width="99%"/>
 +
            </row>
 +
            <row>
 +
                <label value="Type:"/>
 +
                <hbox>
 +
                    <listbox rows="1" mold="select">
 +
                        <listitem label="Java Files,(*.java)"/>
 +
                        <listitem label="All Files,(*.*)"/>
 +
                    </listbox>
 +
                    <button label="Browse..."/>
 +
                </hbox>
 +
            </row>
 +
            <row>
 +
                <label value="Options:"/>
 +
                <textbox rows="3" width="99%"/>
 +
            </row>
 +
        </rows>
 +
    </grid>
 +
</syntaxhighlight>
  
<source lang="xml" >
+
=Properties=
 
+
==Menupopup==
<window title="Grid Demo" border="normal" width="360px">
+
By default, the <code>none</code> is assumed, you can specify the <code>auto</code> to show a default menu on each column. Or you can provide your own menupopup for each column.
<zscript> class Comp implements Comparator { private boolean _asc;
+
===Auto===
public Comp(boolean asc) { _asc = asc; } public int compare(Object o1,
+
[[Image:ZKComRef_Grid_Columns_Menu.png]]
Object o2) { String s1 = o1.getChildren().get(0).getValue(), s2 =
+
<source lang="xml" highlight="2">
o2.getChildren().get(0).getValue(); int v = s1.compareTo(s2); return
+
<grid>
_asc ? v: -v; } } Comp asc = new Comp(true), dsc = new Comp(false);
+
<columns menupopup="auto">
</zscript>
+
<column label="Author" sort="auto"/>
 +
<column label="Title" sort="auto"/>
 +
<column label="Publisher" sort="auto"/>
 +
<column label="Hardcover" sort="auto"/>
 +
</columns>
 +
</source>
 +
===Customized Menupopup===
 +
[[Image:ZKComRef_Grid_Columns_Customized_Menu.png]]
 +
<source lang="xml" highlight="2,8">
 +
<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"/>
 +
</menupopup>
 
<grid>
 
<grid>
<columns sizable="true">
+
<columns sizable="true" menupopup="editPopup">
<column label="Type" sortAscending="&#36;{asc}"
+
<column id="col" label="Type" sortAscending="&#36;{asc}" sortDescending="&#36;{dsc}"/>
sortDescending="&#36;{dsc}" width="50px"/>
+
<column id="col1" label="Type1" sortAscending="&#36;{asc}" sortDescending="&#36;{dsc}"/>
<column label="Content" />
+
<column id="col2" label="Content"/>
 
</columns>
 
</columns>
<rows>
 
<row>
 
<label value="File:" />
 
<textbox width="99%" />
 
</row>
 
<row>
 
<label value="Type:" />
 
<hbox>
 
<listbox rows="1" mold="select">
 
<listitem label="Java Files,(*.java)" />
 
<listitem label="All Files,(*.*)" />
 
</listbox>
 
<button label="Browse..." />
 
</hbox>
 
</row>
 
<row>
 
<label value="Options:" />
 
<textbox rows="3" width="99%" />
 
</row>
 
</rows>
 
 
</grid>
 
</grid>
 
</window>
 
</window>
 
</source>
 
</source>
 +
 +
As you can see, the example above specify a customized menupopup to the columns as its column menu.
 +
 +
== Sizable ==
 +
 +
Specifies whether a user is allowed to resize a column's width by dragging the vertical bar between two adjacent columns.
 +
 +
[[File:Sizable.png|center]]
 +
 +
=== Double-Click to Auto-Fit ===
 +
In additions to dragging, an end user can 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 feature.
  
 
=Supported Events=
 
=Supported Events=
  
{| border="1" | width="100%"
+
{| class='wikitable' | width="100%"
 
! <center>Name</center>
 
! <center>Name</center>
 
! <center>Event Type</center>
 
! <center>Event Type</center>
Line 82: Line 115:
  
 
=Version History=
 
=Version History=
 +
{{LastUpdated}}
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-

Latest revision as of 03:17, 21 February 2023

Columns

Employment/Purpose

Defines the columns of a grid.

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


Example

ZKComRef Grid Example.png

    <grid>
        <columns sizable="true">
            <column label="Type" hflex="min"/>
            <column label="Content"/>
        </columns>
        <rows>
            <row>
                <label value="File:"/>
                <textbox width="99%"/>
            </row>
            <row>
                <label value="Type:"/>
                <hbox>
                    <listbox rows="1" mold="select">
                        <listitem label="Java Files,(*.java)"/>
                        <listitem label="All Files,(*.*)"/>
                    </listbox>
                    <button label="Browse..."/>
                </hbox>
            </row>
            <row>
                <label value="Options:"/>
                <textbox rows="3" width="99%"/>
            </row>
        </rows>
    </grid>

Properties

Menupopup

By default, the none is assumed, you can specify the auto to show a default menu on each column. Or you can provide your own menupopup for each column.

Auto

ZKComRef Grid Columns Menu.png

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

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"/>
	</menupopup>
	<grid>
		<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"/>
		</columns>
	</grid>
</window>

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

Sizable

Specifies whether a user is allowed to resize a column's width by dragging the vertical bar between two adjacent columns.

Sizable.png

Double-Click to Auto-Fit

In additions to dragging, an end user can 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 feature.

Supported Events

Name
Event Type
None None

Supported Children

* Column

Use Cases

Grid

Version History

Last Update : 2023/02/21


Version Date Content
     



Last Update : 2023/02/21

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