From Documentation

Jump to: navigation, search



  • Demonstration: N/A
  • Java API: Imagemap
  • JavaScript API: Imagemap
  • Style Guide: N/A


A imagemap component is a special image. It accepts whatever properties an image component accepts. However, unlike image, if a user clicks on the image, an onClick event is sent back to the server with the coordinates of the mouse position. In contrast, the onClick event sent by image doesn't contain the coordinates.

The coordinates of the mouse position are screen pixels counted from the upper-left corner of the image beginning with (0, 0). It is stored as instance of org.zkoss.zk.ui.event .MouseEvent. Once the application receives the onClick event, it could examine the coordinates of the mouse position from the getX and getY methods.

Note: Don't try to use css background as your image , the image map need a real image or it wont work.


<imagemap src="/img/sun.jpg" onClick="alert(event.x + &quot;, &quot; +event.y)"/>

For example, if a user clicks 208 pixels over and 205 pixels down from the upper-left corner of the image displayed from the following statement, then the user gets the result as depicted below.

ZKComRef Imagemap.png

Supported Events

Event Type
None None
  • Inherited Supported Events: Image

Supported Children

* Area

Use Cases

Version Description Example Location
3.6 How to get area clicked from Imagemap onClick Event
3.6 Imagemap with hyperlink

Version History

Last Update : 2011/1/21

Version Date Content

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