IMG
Description
The IMG element allows an image file to be inserted within
an HTML document along with the text.
The ALT attribute defines parsed character data
that will be displayed if the image
is not or cannot be displayed by the browser.
The SRC attribute identifies a for retrieving the image.
The ISMAP attribute is only meaningful if the IMG element is
within the contents of an A element, and a responding cgi-bin program
has been established at the URL identified by the HREF attribute
of the A element.
If a single A element spans both an image and text,
the cgi-bin program will receive the HREF input values, if any,
if the text is selected, or the x,y cursor pixel coordinates
relative to 0,0 as the the upper-left corner of the image
if the image is selected.
Minimum Attributes
<IMG SRC="...">
All Possible Attributes
<IMG SRC="..."
ALT="..."
ISMAP
LANG="..."
DIR=lrt|rtl
ID="..."
CLASS="..."
MD="..."
ALIGN=bottom|middle|top|left|right|texttop|absmiddle|baseline|absbottom
HEIGHT=value
WIDTH=value
UNITS="..."
BORDER=value
LOWSRC="..."
HSPACE=value
VSPACE=value
USEMAP="..."
DYNSRC="..."
START=fileopen|mouseover
CONTROLS
LOOP=number|INFINITE|-1
LOOPDELAY=number>
Elements Allowed Within...
The IMG element is defined as having no content.
Allowed In Content Of...
Any element that permits members of group
Variations
The attributes BORDER, HEIGHT, WIDTH, HSPACE, VSPACE, and LOWSRC
are Netscape 1.1 extensions.
The attributes DYNSRC, START, CONTROLS, LOOP, and LOOPDELAY are
MS Internet Explorer 2.0 extensions.
The LANG and DIR attributes are introduced with the
internationalization proposal and relate to the value of
the ALT attribute.
Version 3 proposes adding the WIDTH and HEIGHT attributes.
RFC 1866 defines only bottom|middle|top
as values for the ALIGN attribute.
The additional values for the ALIGN attribute are Netscape extensions,
and include the capability to define floating images.
Version 3 proposes adding only the (left|right) values for ALIGN
to identify images that imply that text can float around the image.
Some image capable browsers will display the ALT
text until the full image is retrieved.
RFC 1866 states that
Level 0 conformance must accept the element, but Level 1
conformance is required before it displays the image.
Version 3 proposes the UNITS attribute for use by the WIDTH and HEIGHT
attributes to define units other than pixels.
RFC 1866 states that an IMG element with an ISMAP element must
only exist in the content of an A element with an HREF attribute.
Version 3 proposes a element
as an advanced alternative to the IMG element,
for more sophisticated multi-part overlay images,
more control over text that is the equivalent of ALT,
and with a proposed SHAPE attribute on the A element
a method to perform the common use of the ISMAP attribute
without the need for a responding cgi-bin program.
The USEMAP is part of an alternate proposal for client-side
image mapes.
It is implemented as a Netscape 2.0 extension.
USEMAP specifies a URL with a "#NAME" suffix
to identify a file and MAP name, and is used with the MAP element.
DYNSRC is defined by MS Internet Explorer 2.0 as the
address of a video clip or VRML world to be displayed if your
browser is capable, otherwise display SRC.
START is defined by MS Internet Explorer 2.0 as when the
videoclip or VRML world is to be displayed. If START=mouseover,
the SRC image is displayed until the mouse cursor is over that image.
CONTROLS is defined by MS Internet Explorer 2.0 as displaying a set
of controls under the animation.
LOOP is defined by MS Internet Explorer 2.0 as how many times a
video clip will loop when activated.
If LOOP=-1 or LOOP=INFINITE,
it will loop indefinately.
LOOPDELAY is defined by MS Internet Explorer 2.0 as how long,
in milliseconds, a video clip will wait between replays.
Sandia Requirements
The ALT attribute and a value describing the image is required.
If known, the BORDER, HEIGHT, and WIDTH attributes are recommended
as they improve download performance on some browsers.
If used, the HEIGHT and WIDTH attributes shall specify the actual
size of the stored image in pixels.
