Talɣa:Annotated image

Template documentation[create]

Syntax

{{Annotated image
| image = 
| image-width = 
| image-left = 
| image-top = 
| width = 
| height = 
| float = 
| annotations = 
{{Annotation | left (in px)| top (in px) | text | text-align=left | font-size=12 | font-weight=bold | font-family=Times New Roman | background-color=#ffcccee | color=blue}}
| caption = 
}}

Parameters

All parameters have names; there are no nameless "numbered" parameters.

Two of the parameters, image and imagemap, are mutually exclusive: use one of them, not both.

In the following list, those parameters required by the template are shown in bold.

Parameter	Allowed values	Default value	Function and notes
caption	wikitext		Caption accompanying image.
alt	text	empty	Alt text for people whose vision of the image is impaired (see WP:ALT).
Either  image or  imagemap	valid image filenamea or valid X/HTML imagemap		Specify either image or imagemap, but not both.
width	positive integer	–	Total width (in pixels) of the box containing the image and annotations. Must be at least as large as the image's displayed width (which can be set using image-width).
height	positive integer	–	Total height (in pixels) of the box containing the image and annotations. Must be at least as large as the image's displayed height. If the displayed width of the image is changed by specifying image-width, the image's displayed height and any additional "margins" for annotations will need to be calculated.
image-left	integer	(zero)	X-coordinate of the image's top left corner (in pixels), relative to the top left corner of the box containing the image and annotations. Negative values crop the image.
image-top	integer	(zero)	Y-coordinate of the image's top left corner (in pixels), relative to the top left corner of the box containing the image and annotations. Negative values crop the image.
image-width	positive integer		Width of the image (in pixels).
annotations			Annotations for the image. May be left empty (i.e. |... |annotations= |...) to crop an image only.
float	right left center none	right	To specify whether or not the template floats to the right or left of adjacent content.
outer-css	any valid CSS	–	Additional CSS applied to the outermost box. Does not override any other parameters specified for the outer box (i.e. best used only as "a last resort").
image-bg-color	any valid CSS color	white	Background of the box in which the image is displayed. For example, a dark background for a relatively dark image on which relatively lightly colored annotations are placed.
image-css	any valid CSS	–	Additional CSS applied to the (inner box carrying the) image. Does not override any other parameters specified for this box (i.e. best used only as "a last resort").
annot-text-align	left right center	left	Sets a default text-alignment for all the contained annotations. Can be overridden per annotation.
annot-background-color	any valid CSS color	transparent	Sets a default background-color for all the contained annotations. Can be overridden per annotation.
annot-font-family	any valid CSS font-family	–	Sets a default font-family for all the contained annotations. Can be overridden per annotation.
annot-font-size	positive integer	–	Sets a default font-size (in pixels) for all the contained annotations. Can be overridden per annotation.
annot-font-weight	any valid CSS font-weight	–	Sets a default font-weight for all the contained annotations. Can be overridden per annotation.
annot-font-style	any valid CSS font-style	–	Sets a default font-style (e.g. "italic") for all the contained annotations. Can be overridden per annotation.
annot-line-height	any valid CSS line-height	–	Sets a default line-height (line spacing) for all the contained annotations. Can be overridden per annotation.
annot-color	any valid CSS color	–	Sets a default color for all the contained annotations. Can be overridden per annotation.

^a SVG images allowed.

Pitfall

There is one pitfall, although it is mainly about using one browser in the correct way (Microsoft Internet Explorer, of course). Internet Explorer has two ways of scaling up text to ease readability:

• Text resizing, which appears in Internet Explorer's View menu, affects text but not images. This method can disrupt annotated images, as the text is scaled up but the image content and frame are not. Firefox and Opera do not use this mechanism.
• Zoom also scales the image as well as text annotations, and thus does not disrupt the relative sizes and locations of annotations in annotated images. Netscape and its Mozilla derivatives, Firefox and Opera have had zoom for years, and it is more useful, as it also scales text implemented as part of an image, e.g., as in the Wikipedia logo. The zoom control sequences (CTRL + to increase, CTRL - to decrease) are the same in Firefox, Opera and Internet Explorer. In Firefox and Opera, there also menu items for zoom, which show the control sequences. In Internet Explorer 7 only text resizing appears in the menu; in order to learn zoom, users must look up some external source.