jQuery maphilight documentation

The method that adds hilight behavior to an imagemap.

Arguments:

options (optional)

A set of key/value pairs that configures the map. All options are optional.

All options can be overridden with the jQuery data method, per-img and per-area.

The metadata plugin is also supported.

Order of inheritance:

1. $(area).data('maphilight')
2. $(area).metadata()
3. $(img).data('maphilight')
4. $(img).metadata()
5. $(img).maphilight(options)

Example: to make one particular hilight green:

<area ... class="{fillColor:'00ff00'}">

Options:

fill (Boolean. Default: true)

Whether to fill the shape

fillColor (String. Default: '000000')

The color to fill the shape with

fillOpacity (Number. Default: 0.2)

The opacity of the fill (0 = fully transparent, 1 = fully opaque)

stroke (Boolean. Default: true)

Whether to outline the shape

strokeColor (String. Default: 'ff0000')

The color of the outline

strokeOpacity (Number. Default: 1)

The opacity of the outline (0 = fully transparent, 1 = fully opaque)

strokeWidth (Number. Default: 1)

The thickness of the outline

fade (Boolean. Default: true)

Whether to fade in the shapes on mouseover

alwaysOn (Boolean. Default: false)

Whether to always show the hilighted areas

neverOn (Boolean. Default: false)

Whether to never show the hilighted areas

(This only makes sense to use as per-area metadata, of course.)

groupBy (String or Array. Default: false)

The name of an attribute to group areas by, or a selector for elements in the map to group. Or an array of the same

If this is present then all areas in the map which have the same attribute value as the hovered area will hilight as well

wrapClass (String/bool. Default: false)

If true, applies the class on the <img> to the wrapper div maphilight created.

If a string, that string is used as a class on the wrapper div.

shadow (Boolean. Default: false)

Whether to apply a shadow to the shape. (Only works with canvas-supporting browsers. So, everything but IE below version 9.)

shadowPosition (String. Default: 'outside')

Where to position the shadow. Can be 'outside', 'inside', or 'both'.

shadowFrom (String/bool. Default: false)

What to use to cast the shadow. Can be 'stroke' or 'fill'. If false, choose a value based on the shadow position. (Generally it looks better if it's being cast from a fill when it's outside the shape, and from a stroke when it's inside the shape.)

shadowX (Number. Default: 0)

Horizontal offset of the shadow from the shape.

shadowY (Number. Default: 0)

Vertical offset of the shadow from the shape.

shadowRadius (Number. Default: 6)

Size of the shadow.

shadowColor (String. Default: '000000')

Color of the shadow.

shadowOpacity (Number. Default: 0.8)

Opacity of the shadow.