ZK Component Reference/Essential Components/Button

Button

• Demonstration: Button
• Java API: Button
• JavaScript API: Button

Employment/Purpose

You could assign a label and an image to a button by the label and image properties. If both are specified, the dir property control which is displayed up front, and the orient property controls whether the layout is horizontal or vertical.

Example

 <button label="Left" image="/img/folder.gif" width="125px"/>
 <button label="Right" image="/img/folder.gif" dir="reverse" width="125px"/>
 <button label="Above" image="/img/folder.gif" orient="vertical" width="125px"/>
 <button label="Below" image="/img/folder.gif" orient="vertical" dir="reverse" width="125px"/>

Supported events

Name	Event Type
onClick	MouseEvent Description: Denotes user has clicked the component.
onRightClick	MouseEvent Description: Denotes user has right-clicked the component.
onDoubleClick	MouseEvent Description: Denotes user has double-clicked the component.
onFocus	Event Description: Denotes when a component gets the focus.
onBlur	Event Description: Denotes when a component loses the focus.

Supported Children

*NONE

Use cases

Version	Description	Example Location
5.0+	Get dynamically generated Button reference in onClick Event	http://www.zkoss.org/forum/listComment/8780
5.0+	How to fire onClick Event on a Button	http://www.zkoss.org/forum/listComment/1716

Version History

Version	Date	Content
5.0.1	4/27/2010	Initialization