HTMLImageElement : HTMLElement
Return to: HTML DOM Level 5 index

Represents an image.

Platform Support

Mozilla Chrome Safari Opera IE Netscape
1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+

Constructors

Constructor Action Mozilla Chrome Safari Opera IE Netscape
HTMLImageElement Constructor() : HTMLImageElement
Creates an instance of the HTMLImageElement.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+

HTMLImageElement() : HTMLImageElement

Creates an instance of the HTMLImageElement.

Returns
HTMLImageElement

Visibility
internal

Properties

Property Action Mozilla Chrome Safari Opera IE Netscape
alt : String
Specifies the img element's fallback content.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG
src : String
Specifies a valid non-empty URL potentially surrounded by spaces referencing a non-interactive, optionally animated, image resource that is neither paged nor scripted.
Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG
useMap : String
Indicates that the image has an associated image map.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG
isMap : Boolean
Indicates by its presence that the element provides access to a server-side image map.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG
width : Number
Specifies the width of the image.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG
height : Number
Specifies the height of the image.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG
naturalWidth : Number
Specifies the intrinsic width of the image.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG
naturalHeight : Number
Specifies the intrinsic height of the image.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG
complete : Boolean
Specifies whether the image was successfully fetched from the source attribute, and is a supported image type.
 Show Details 1.0+ 5.0+ 1.0+ 4.0+ 2.0+ 1.0+
Availability

WhatWG

Inherited Functions

Method Action Mozilla Chrome Safari Opera IE Netscape
getElementsByClassName(String classNames) : NodeList
Returns a NodeList containing all the Element nodes with the specified classNames.
 Show Details 1.9+ 5.0+ 3.1+ 9.51+ no no

Parameters
String classNames (one-or-more)A string representing the class name(s) of the elements to return. Multiple class names should be separated by spaces.

Returns
NodeList

Using getElementsByClassName

                        	                    document.getElementById("useCases").getElementsByClassName("question");

Would return a NodeList of all elements inside the element with the id "useCases" to which the class "question" applies.

                        	                    document.getElementById("useCases").getElementsByClassName("question issue");

Would return a NodeList of all elements inside the element with the id "useCases" to which both the classes "question" and "issue" apply.

Remarks

Returns a list of child elements to which the specified className applies. The returned NodeList is sorted in tree order (the order the elements were found during a depth-first preorder traversal through the node tree).

See Also

Document.getElementsByClassName|Element.getElementsByClassName|HTMLDocument.getElementsByClassName

Availability

HTML 5|W3C|W3C

References

HTMLImageElement

Availability

JavaScript 1.2|WhatWG

text_javascript aptana_docs