Renders an <img> tag.
The src may be provided in one of three ways, in precedence order:
- Direct child <ao:src> tag.
- As the src attribute
- The body of this tag, after trimming, is valid RFC 3986 URI or RFC 3987 IRI.
usemap is not set, the alt value is required either as an attribute or a nested
Any attribute that has no namespace and begins with
param. is added to the src as a URL parameter.
The parameter name is the part of the attribute name following
When a parameter value is
null it is not added.
If the value is an
or array, then each non-null element is coerced to
as a separate parameter in iteration order. Otherwise, the value itself is
coerced to String
for the parameter value.
The src for the image. The src is modified in several ways to make things much easier to work with.
A nested <ao:src> tag will override this value.
In order to make relative paths predictable, relative paths are interpreted from the current JSP page.
In order to keep paths app-relative, if starts with a /, the context path will be prepended to the path.
In order to simplify things behind URL mapping schemes, the src is always written starting with '/'. This avoids any need to include any <ao:base> tags.
URL rewriting is performed as needed via HttpServletResponse.encodeURL.
To support paths in different character sets, a Unicode to ASCII URI encoding is performed on every character that is not defined in RFC 3986: Reserved Characters. To avoid ambiguity, any dynamic parameters or anchors in the URL must have been correctly encoded by the caller.
If the src represents a local resource, a parameter of "lastModified=#####" may be
automatically added with the timestamp of the local resource to the nearest second.
May be one of
In auto mode, last modified stamping may be disabled by the client with
In auto mode, last modified stamping is not performed on Canonical URLs.
Specifies an image as a client-side image-map.
This is expected to be used along with a <ao:map> tag.
Specifies an image as a server-side image-map.