Documentation for HTML:IMAGE



HTML4.0:IMAGE [function]: (IMAGE-URL ALTERNATIVE-TEXT &KEY ALIGNMENT ACCEPT-COORDINATES-AT-URL CLIENT-SIDE-IMAGE-MAP BORDER VERTICAL-SPACE HORIZONTAL-SPACE WIDTH HEIGHT NAME DESCRIPTION CLASS ID TITLE STYLE LANGUAGE DIRECTION EVENTS (STREAM *OUTPUT-STREAM*))
Inserts an image into HTML.

IMAGE-URL is the URL for an image.

ALTERNATIVE-TEXT is the text to display when the image is not loaded.

ACCEPT-COORDINATES-URL can be:
   
     * URL to which coordinates will be returned when the user clicks on the image.

     * T, indicating that returned coordinates should go to a search URL version of
     IMAGE-URL
                
     * :NO-URL, indicating not to emit an anchor for accepting the returns but to
     mark the IMG as a coordinate search.

CLIENT-SIDE-IMAGE-MAP indicates the client side image map to use.  Normally, this is a named URL
(/url.html#map-name) and often, all client side image maps are served from a single url. The
function WRITE-CLIENT-SIDE-IMAGE-MAP writes a client side image map from a server-side image map URL
(CERN or NCSA formats).

Allow browsers to layout the display before the image has loaded and thus eliminate the delay for
the user otherwise incurred.

WIDTH is width of the image in pixels.

HEIGHT is the height of the image in pixels.

NAME (deprecated in XHTML 1.0) is names the element so that it may be referred to from style sheets
or scripts. This argument has been included for backwards compatibility, and HTML 4.0.1 applications
should use the ID. In XHTML, application must ID for this purpose.

DESCRIPTION provides a longer description of the image which supplements the short one in
alternative-text.

CLASS is the class for the element
ID is an element identifier.
TITLE is a string used as an element title.
STYLE specifies inline parameters to use in the default style sheet language.
LANGUAGE is the two-digit language code for the displayed content (see RFC 1766)
DIRECTION is the base directionality of neutral text and can be either :LEFT-TO-RIGHT or
:RIGHT-TO-LEFT.

EVENTS are a set of image related events. They can be any of the intrinsic events: :KEY-DOWN,
:KEY-PRESS, :KEY-UP, :MOUSE-CLICK, :MOUSE-DOUBLE-CLICK, :MOUSE-DOWN, :MOUSE-MOVE, :MOUSE-OUT,
:MOUSE-OVER, :MOUSE-UP.

ALIGNMENT (deprecated) can be:

     HTML2 Arugments

          :TOP    -- align with the tallest item on the line.
          :MIDDLE -- align with the baseline with the middle of the image.
          :BOTTOM -- align with the baseline of the current line with the image.
        
     Text Flow Options

          :LEFT -- float down and over to the next available space on :the left
          margin, and subsequent text wraps around the right side of the image.

          :RIGHT -- float down and over to the next available space on the right
          margin, and subsequent text wraps around the left side of the image.

BORDER (deprecated) is an integer indicating the thickness of the border with which to surround the
image.

VERTICAL-SPACE (deprecated) is an integer indicating the amount of vertical space above and below a
floating image.

HORIZONTAL-SPACE (deprecated) is an integer indicating the amount of horizontal space above and
below a floating image.

HTML4.0:IMAGE [class] :
[Undocumented]
CL-HTTP/70.216 (LispWorks; 2.1.7)