- Demonstration: Toolbar and Fileupload
- Java API: Toolbarbutton
- Style Guide: Toolbarbutton
The behavior of Toolbarbutton is similar to the button except the appearance is different. The button component uses HTML BUTTON tag, while the toolbarbutton component uses HTML DIV tag.
A toolbarbutton could be placed outside a toolbar. However toolbarbuttons change their appearance if they are placed inside a toolbar.
Toolbarbutton supports getHref(). If getHref() is not null, the onClick handler is ignored and this element is degenerated to HTML's A tag.
Within ZK 5, the file upload has been redesigned so it can be integrated with any widget. For example, the toolbarbutton can now be used to upload a file. In addition to this, the display of the upload status has been enhanced and can be customized easily.
<window title="toolbar demo" border="normal" width="300px"> <caption> <toolbarbutton label="button3" image="/img/network.gif" /> <space /> <toolbarbutton label="button4" image="/img/network.gif" dir="reverse" /> </caption> <toolbar> <toolbarbutton label="button1" image="/img/network.gif" /> <space /> <toolbarbutton label="button2" image="/img/network.gif" /> </toolbar> <hbox> <toolbarbutton label="button5" image="/img/network.gif" orient="vertical" /> <space /> <toolbarbutton label="button6" image="/img/network.gif" orient="vertical" dir="reverse" /> </hbox> </window>
Toolbarbutton support toggle mode since ZK 6.0.0 . (mode="toggle" )
In the toggle mode , the toolbarbutton will be persistent checked after user clicked it, and will be released after next click. It will fire CheckEvent when state changed.
Any toolbarbutton can be used to upload files. All you need to do is:
- Specify the upload attribute with true
- Handles the onUpload event.
<toolbarbutton upload="true" label="Fileupload" onUpload="myProcessUpload(event.getMedia())"/>
- Any Button can be used to upload files too.
Denotes when toolbarbutton is checked , only available in toggle mode . (since ZK 6.0.0)
- Inherited Supported Events: Button
|6.0.0||2/10||Introduce Toggle Mode to Toobarbutton|