Toolbar"

From Documentation
 
(8 intermediate revisions by 2 users not shown)
Line 9: Line 9:
  
 
= Employment/Purpose =
 
= Employment/Purpose =
A <tt>toolbar</tt> is used to place a series of buttons, such as <tt>toolbarbutton </tt>or <tt>button. </tt>The toolbar buttons could be used without toolbars, so a toolbar could be used without tool buttons. However, the tool buttons change their appearance if they are placed inside a toolbar.
+
A <code>toolbar</code> is used to place a series of buttons, such as <code>toolbarbutton </code>or <code>button. </code>The toolbar buttons could be used without toolbars, so a toolbar could be used without tool buttons. However, the tool buttons change their appearance if they are placed inside a toolbar.
  
The toolbar has two orientation: <tt>horizontal </tt>and <tt>vertical. </tt>It controls how the buttons are placed.
+
The toolbar has two orientation: <code>horizontal </code>and <code>vertical. </code>It controls how the buttons are placed.
  
 
See also : [[ZK_Component_Reference/Essential_Components/Button | Button]], [[ZK_Component_Reference/Essential_Components/Toolbarbutton | Toolbarbutton]]
 
See also : [[ZK_Component_Reference/Essential_Components/Button | Button]], [[ZK_Component_Reference/Essential_Components/Toolbarbutton | Toolbarbutton]]
Line 36: Line 36:
  
 
= overflowPopup =
 
= overflowPopup =
[ since 8.6.0 ]
+
{{versionSince| 8.6.0}}
  
When overflowPopup="true", a toolbar will have a <tt>...</tt> symbol that shows a popup which contains those buttons weren't able to fit in the toolbar.
+
When <code>overflowPopup="true"</code>, a toolbar will have a <code>...</code> symbol that shows a popup that contains those buttons not fitting in the toolbar.
  
 
Default: false.
 
Default: false.
Line 44: Line 44:
 
[[File:Toolbar-overflowPopup.png]]
 
[[File:Toolbar-overflowPopup.png]]
 
<source lang="xml" >
 
<source lang="xml" >
<toolbar overflowPopup="true" width="350px" style="border: 1px black solid;">
+
    <toolbar overflowPopup="true" width="350px" style="border: 1px black solid;">
<toolbarbutton label="one" image="img/home.gif"/>
+
        <toolbarbutton label="one" iconSclass="z-icon-home"/>
<toolbarbutton label="two" image="img/home.gif"/>
+
        <toolbarbutton label="two" iconSclass="z-icon-home"/>
<toolbarbutton label="three" image="img/home.gif"/>
+
        <toolbarbutton label="three" iconSclass="z-icon-home"/>
<toolbarbutton label="four" image="img/home.gif"/>
+
        <toolbarbutton label="four" iconSclass="z-icon-home"/>
<toolbarbutton label="five" image="img/home.gif"/>
+
        <toolbarbutton label="five" iconSclass="z-icon-home"/>
<toolbarbutton label="six" image="img/home.gif"/>
+
        <toolbarbutton label="six" iconSclass="z-icon-home"/>
</toolbar>
+
    </toolbar>
 +
</source>
 +
 
 +
= overflowPopupIconSclass =
 +
{{versionSince| 9.6.0}}
 +
 
 +
When overflowPopup="true", you can customize a toolbar <code>...</code> symbol just specify the <code>overflowPopupIconSclass</code> attribute. For a complete list of icons, please refer to [http://fontawesome.io/cheatsheet/ FontAwesome Cheatsheet].
 +
 
 +
Default: <code>...</code> symbol
 +
 
 +
[[File:Toolbar-overflowPopupIconSclass.png]]
 +
<source lang="xml" >
 +
    <toolbar overflowPopup="true" overflowPopupIconSclass="z-icon-plus-square" width="350px" style="border: 1px black solid;">
 +
        <toolbarbutton label="one" iconSclass="z-icon-home"/>
 +
        <toolbarbutton label="two" iconSclass="z-icon-home"/>
 +
        <toolbarbutton label="three" iconSclass="z-icon-home"/>
 +
        <toolbarbutton label="four" iconSclass="z-icon-home"/>
 +
        <toolbarbutton label="five" iconSclass="z-icon-home"/>
 +
        <toolbarbutton label="six" iconSclass="z-icon-home"/>
 +
    </toolbar>
 
</source>
 
</source>
  
 
=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 67: Line 86:
 
=Supported Molds=
 
=Supported Molds=
 
Available molds of a component are defined in lang.xml embedded in zul.jar. It is suggested to set mold to panel while toolbar is in the footer of a panel.
 
Available molds of a component are defined in lang.xml embedded in zul.jar. It is suggested to set mold to panel while toolbar is in the footer of a panel.
{| border="1" | width="100%"
+
{| class='wikitable' | width="100%"
 
! <center>Name</center>
 
! <center>Name</center>
 
! <center>Snapshot</center>
 
! <center>Snapshot</center>
Line 82: Line 101:
 
  *ALL
 
  *ALL
  
=Use Cases=
 
 
{| border='1px' | width="100%"
 
! Version !! Description !! Example Location
 
|-
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
|}
 
 
=Version History=
 
{{LastUpdated}}
 
{| border='1px' | width="100%"
 
! Version !! Date !! Content
 
|-
 
| &nbsp;
 
| &nbsp;
 
| &nbsp;
 
|}
 
  
 
{{ZKComponentReferencePageFooter}}
 
{{ZKComponentReferencePageFooter}}

Latest revision as of 08:37, 11 April 2024

Toolbar

Employment/Purpose

A toolbar is used to place a series of buttons, such as toolbarbutton or button. The toolbar buttons could be used without toolbars, so a toolbar could be used without tool buttons. However, the tool buttons change their appearance if they are placed inside a toolbar.

The toolbar has two orientation: horizontal and vertical. It controls how the buttons are placed.

See also : Button, Toolbarbutton

Example

ZKComRef Toolbar Example.png


<window title="Toolbar window" border="normal" width="300px">
    <toolbar>
        <toolbarbutton label="Left" />
        <space />
        <toolbarbutton label="Right" image="/img/network.gif"
            dir="reverse" />
    </toolbar>
    <toolbar orient="vertical">
        <button label="Left" image="/img/network.gif" width="125px" />
        <toolbarbutton label="Right" image="/img/network.gif"
            dir="reverse" />
    </toolbar>
</window>

overflowPopup

Since 8.6.0

When overflowPopup="true", a toolbar will have a ... symbol that shows a popup that contains those buttons not fitting in the toolbar.

Default: false.

Toolbar-overflowPopup.png

    <toolbar overflowPopup="true" width="350px" style="border: 1px black solid;">
        <toolbarbutton label="one" iconSclass="z-icon-home"/>
        <toolbarbutton label="two" iconSclass="z-icon-home"/>
        <toolbarbutton label="three" iconSclass="z-icon-home"/>
        <toolbarbutton label="four" iconSclass="z-icon-home"/>
        <toolbarbutton label="five" iconSclass="z-icon-home"/>
        <toolbarbutton label="six" iconSclass="z-icon-home"/>
    </toolbar>

overflowPopupIconSclass

Since 9.6.0

When overflowPopup="true", you can customize a toolbar ... symbol just specify the overflowPopupIconSclass attribute. For a complete list of icons, please refer to FontAwesome Cheatsheet.

Default: ... symbol

Toolbar-overflowPopupIconSclass.png

    <toolbar overflowPopup="true" overflowPopupIconSclass="z-icon-plus-square" width="350px" style="border: 1px black solid;">
        <toolbarbutton label="one" iconSclass="z-icon-home"/>
        <toolbarbutton label="two" iconSclass="z-icon-home"/>
        <toolbarbutton label="three" iconSclass="z-icon-home"/>
        <toolbarbutton label="four" iconSclass="z-icon-home"/>
        <toolbarbutton label="five" iconSclass="z-icon-home"/>
        <toolbarbutton label="six" iconSclass="z-icon-home"/>
    </toolbar>

Supported Events

Name
Event Type
None None

Supported Molds

Available molds of a component are defined in lang.xml embedded in zul.jar. It is suggested to set mold to panel while toolbar is in the footer of a panel.

Name
Snapshot
default
Toolbar mold default.png
panel
Toolbar mold panel.png

Supported Children

*ALL



Last Update : 2024/04/11

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