Summary
An element that displays an image, much like the HTML img
element. The src
attribute can be used to specify the URL of the image.
More information is available in the XUL tutorial.
Note: Prior to Gecko 8.0, images did not shrink down with the same ratio in both directions when specifying maximum sizes using maxheight
or maxwidth
. The new behavior aligns more with the HTML <img>
element and shrinks both the width and height down proportionally.
- Properties
- accessibleType, src
- Style classes
- alert-icon, error-icon, message-icon, question-icon
Examples
<image src='Firefoxlogo.png' width='135' height='130'/>
Attributes
image.onload
- Type: script code
- This event handler will be called on the
image
element when the image has finished loading. This applies whether the image is applied via thesrc
attribute or thelist-style-image
style property. If you change the image, the event will fire again when the new image loads. This event will not bubble up the element tree.
-
src
- Type: URI
- The URI of the content to appear in the element.
validate
- Type: one of the values below
- This attribute indicates whether to load the image from the cache or not. This would be useful if the images are stored remotely or you plan on swapping the image frequently. The following values are accepted, or leave out the attribute entirely for default handling:
-
always
- The image is always checked to see whether it should be reloaded.
never
- The image will be loaded from the cache if possible.
Properties
-
accessibleType
- Type: integer
- A value indicating the type of accessibility object for the element.
Inherited Properties |
Methods
Style classes
-
alert-icon
-
Class that adds an alert icon. This typically looks like an exclamation mark. This and the other icon classes may be used by
image
elements or other elements which can have an image.
-
error-icon
- Class that adds an error icon. This will typically be a red "X" icon.
-
message-icon
- Class that adds a message box icon.
-
question-icon
- Class that adds a question icon, which usually looks like a question mark.
Related
See also the image
and icon
attributes.