HtmlBasedComponent"

From Documentation
 
(20 intermediate revisions by 6 users not shown)
Line 3: Line 3:
 
= Html Based Component =
 
= Html Based Component =
  
*Demonstration: Most of ZK Components are Html Based Component.
+
*Demonstration: N/A
*Java API: <javadoc>org.zkoss.zk.ui,HtmlBasedComponent</javadoc>
+
*Java API: <javadoc>org.zkoss.zk.ui.HtmlBasedComponent</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zk.Widget</javadoc>
 
*JavaScript API: <javadoc directory="jsdoc">zk.Widget</javadoc>
  
 
= Employment/Purpose =
 
= Employment/Purpose =
 +
A skeletal implementation for HTML based components. It simplifies to implement methods common to HTML based components.
  
  
 +
=Supported Events=
  
= Example =
+
{| class='wikitable' | width="100%"
 +
! <center>Name</center>
 +
! <center>Event Type</center>
 +
|-
 +
| <center><code>onDrop</code></center>
 +
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.DropEvent</javadoc>
 +
Denotes a user has dropped the dragged target to a component.
 +
|-
 +
| <center><code>onClick</code></center>
 +
| '''Event:''' <javadoc> org.zkoss.zk.ui.event.MouseEvent</javadoc>
  
 +
Denotes a user has clicked a component.
 +
|-
 +
| <center><code>onDoubleClick</code></center>
 +
| '''Event:''' <javadoc> org.zkoss.zk.ui.event.MouseEvent</javadoc>
 +
Denotes a user has double-clicked a component.
 +
|-
 +
| <center><code>onRightClick</code></center>
 +
| '''Event:''' <javadoc> org.zkoss.zk.ui.event.MouseEvent</javadoc>
 +
Denotes a user has right-clicked a component.
 +
|-
 +
| <center><code>onMouseOver</code></center>
 +
| '''Event:''' <javadoc> org.zkoss.zk.ui.event.MoveEvent</javadoc>
 +
{{versionSince| 5.0.3}} Denotes a user has hovered over the component.
 +
|-
 +
| <center><code>onMouseOut</code></center>
 +
| '''Event:''' <javadoc> org.zkoss.zk.ui.event.MoveEvent</javadoc>
 +
{{versionSince| 5.0.3}} Denotes a user has moved out a component.
 +
|-
 +
| <center><code>onOK </code></center>
 +
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.KeyEvent</javadoc>
  
 +
Denotes a user has pressed the '''ENTER''' key.
  
 +
|-
 +
| <center><code>onCancel </code></center>
 +
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.KeyEvent</javadoc>
  
 +
Denotes a user has pressed the '''ESC''' key.
  
=Supported events=
+
|-
 +
| <center><code>onCtrlKey</code></center>
 +
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.KeyEvent</javadoc>
  
{| border="1" | width="100%"
+
Denotes a user has pressed a special key, such as PgUp, Home, and a key combined with the Ctrl or Alt key. Refer to the <code>ctrlKeys</code> Property section below for details.
! <center>Name</center>
+
|-
! <center>Event Type</center>
+
| <center><code>onAfterSize</code></center>
 +
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.AfterSizeEvent</javadoc>
 +
It's fired after
 +
* a user resizes a sizable component in a browser
 +
* a component calculates its size in a browser
 
|-
 
|-
| Text
+
| <center><code>onCreate</code></center>
| Text
+
| '''Event:''' <javadoc>org.zkoss.zk.ui.event.CreateEvent</javadoc>
 
|}
 
|}
  
Line 31: Line 73:
 
  *ALL
 
  *ALL
  
=Use cases=
 
 
{| border='1px' | width="100%"
 
! Version !! Description !! Example Location
 
|-
 
| 5.0+
 
| Text
 
| Text
 
|}
 
  
 
=Version History=
 
=Version History=
  
{| border='1px' | width="100%"
+
{| class='wikitable' | width="100%"
 
! Version !! Date !! Content
 
! Version !! Date !! Content
 
|-
 
|-
| 5.x.x
+
| 5.0.3
| x/x/20xx
+
| June 2010
| Initialization
+
| The onMouseOver and onMouseOut events are supported.
 
|}
 
|}
  
 
{{ZKComponentReferencePageFooter}}
 
{{ZKComponentReferencePageFooter}}

Latest revision as of 02:48, 10 June 2022


HtmlBasedComponent

Html Based Component

Employment/Purpose

A skeletal implementation for HTML based components. It simplifies to implement methods common to HTML based components.


Supported Events

Name
Event Type
onDrop
Event: DropEvent

Denotes a user has dropped the dragged target to a component.

onClick
Event: MouseEvent

Denotes a user has clicked a component.

onDoubleClick
Event: MouseEvent

Denotes a user has double-clicked a component.

onRightClick
Event: MouseEvent

Denotes a user has right-clicked a component.

onMouseOver
Event: MoveEvent

Since 5.0.3 Denotes a user has hovered over the component.

onMouseOut
Event: MoveEvent

Since 5.0.3 Denotes a user has moved out a component.

onOK
Event: KeyEvent

Denotes a user has pressed the ENTER key.

onCancel
Event: KeyEvent

Denotes a user has pressed the ESC key.

onCtrlKey
Event: KeyEvent

Denotes a user has pressed a special key, such as PgUp, Home, and a key combined with the Ctrl or Alt key. Refer to the ctrlKeys Property section below for details.

onAfterSize
Event: AfterSizeEvent

It's fired after

  • a user resizes a sizable component in a browser
  • a component calculates its size in a browser
onCreate
Event: CreateEvent

Supported Children

*ALL


Version History

Version Date Content
5.0.3 June 2010 The onMouseOver and onMouseOut events are supported.



Last Update : 2022/06/10

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