Template:HoverImage/doc

Documentation
This template displays a default image, then substitutes another image when the reader hovers over it (e.g. if visual users place their mouse over the image). It is primarily intended for showing an undoctored image to the casual reader, but highlighting certain aspects on close inspection.

This template may hide useful information from the reader, so should be used with caution.

Bear in mind that the casual reader may not hover over the image, so will not see the intended effect. In addition, it may be difficult to follow links to the default image, as this will change on hovering. For this reason the images should be similar to each other (see examples below).

Usage
The template is intended to mimic the wikitext convention for images. The first two parameters are the names of the default and hover-revealed images respectively. All other parameters are the same as for images, and are applied simultaneously to both images, apart from the caption. If there is more than one potential caption, then the first caption is used for the default image and the last for the replacement image.

Examples
(Extra text has been added to show how text wrapping around images works)

Limitations

 * No more than 8 additional parameters after the image names. This should be enough for all the image options
 * This template my need updating if the image syntax changes (e.g. more named parameters allowed)
 * It may be useful to have a similar template that overlays one or more (different-sizes) pictures or text on top of the default image (e.g. for adding arrows to an image on hovering). A suggested name for this template is Template:HoverOverlay, but this has not yet been coded.
 * Requires a web browser that supports the :hover pseudoclass on elements other than &lt;a&gt; (e.g. does not work for Internet Explorer 6)