img Object

Embeds an image or a video clip in the document.

Members Table

The following table lists the members exposed by the img object.

Attributes/Properties

Attribute	Property	Description
ACCESSKEY	accessKey	Sets or retrieves the access key for the object.
ALIGN	align	Sets or retrieves how the object is aligned with adjacent text.
ALT	alt	Sets or retrieves a text alternative to the graphic.
aria-activedescendant	ariaActivedescendant	Gets or sets the currently active child element.
aria-busy	ariaBusy	Gets or sets a value indicating whether a live region is finished updating.
aria-checked	ariaChecked	Sets or retrieves the checked state of this element.
aria-controls	ariaControls	Gets or sets the list of elements that are controlled by the current element.
aria-describedby	ariaDescribedby	Gets or sets a list of elements that describe the current object.
aria-disabled	ariaDisabled	Sets or retrieves the disabled state of this element.
aria-expanded	ariaExpanded	Sets or retrieves the expanded state of this element.
aria-flowto	ariaFlowto	Gets or sets the recommended reading order of content.
aria-haspopup	ariaHaspopup	Sets or retrieves a value indicating whether this element may display a pop-up window.
aria-hidden	ariaHidden	Sets or retrieves the hidden state of this element.
aria-invalid	ariaInvalid	Sets or retrieves the error state of this element.
aria-labelledby	ariaLabelledby	Gets or sets a list of elements that provide a label for the current object.
aria-level	ariaLevel	Sets or retrieves the level of this element.
aria-live	ariaLive	Gets or sets how assistive technology should announce updates to live regions.
aria-multiselectable	ariaMultiselectable	Sets or retrieves the multiple-selection state of this element.
aria-owns	ariaOwns	Gets or sets a list of child objects, including elements that are not direct descendants of the current object.
aria-posinset	ariaPosinset	Sets or retrieves the current position of an item within a set.
aria-pressed	ariaPressed	Sets or retrieves the pressed state of a button that can be toggled.
aria-readonly	ariaReadonly	Sets or retrieves the read-only state of this element.
aria-relevant	ariaRelevant	Gets or sets which changes to a live region are relevant.
aria-required	ariaRequired	Sets or retrieves the form-completion requirement of this element.
aria-secret	ariaSecret	Sets or retrieves the secret state of this element.
aria-selected	ariaSelected	Sets or retrieves the selection state of this element.
aria-setsize	ariaSetsize	Sets or retrieves the set size of this element.
aria-valuemax	ariaValuemax	Gets or sets the maximum value that a user can provide.
aria-valuemin	ariaValuemin	Gets or sets the minimum value that a user can provide.
aria-valuenow	ariaValuenow	Gets or sets the current value of the element.
ATOMICSELECTION		Specifies whether the element and its contents must be selected as a whole, indivisible unit.
	attributes	Retrieves a collection of attributes of the object.
BORDER	border	Sets or retrieves the width of the border to draw around the object.
	canHaveChildren	Gets a value indicating whether the object can contain child objects.
canHaveHTML	canHaveHTML	Gets the value indicating whether the object can contain rich HTML markup.
	childElementCount	Retrieves the number of immediate child nodes of the current element or a zero if the element does not contain any child nodes. childElementCount does not return all child nodes, only child nodes that are nodeType =1, or element nodes.
CLASS	className	Sets or retrieves the class of the object.
	clientHeight	Retrieves the height of the object including padding, but not including margin, border, or scroll bar.
	clientLeft	Retrieves the distance between the offsetLeft property and the true left side of the client area.
	clientTop	Retrieves the distance between the offsetTop property and the true top of the client area.
	clientWidth	Retrieves the width of the object including padding, but not including margin, border, or scroll bar.
	complete	Retrieves whether the object is fully loaded.
	constructor	Returns a reference to the constructor of an object.
DATAFLD	dataFld	Sets or retrieves a field of a given data source, as specified by the dataSrc property, to bind to the specified object.
DATASRC	dataSrc	Sets or retrieves the source of the data for data binding.
DIR	dir	Sets or retrieves the reading order of the object.
DYNSRC	dynsrc	Sets or retrieves the address of a video clip or VRML world to display in the window.
	fileCreatedDate	Retrieves the date the file was created.
	fileModifiedDate	Retrieves the date the file was last modified.
	fileSize	Retrieves the file size.
	fileUpdatedDate	Retrieves the date the file was last updated.
	firstChild	Gets a reference to the first child in the childNodes collection of the object.
	firstElementChild	Retrieves a reference to the first child element, or null if there are no child elements.
GALLERYIMG	galleryImg	Obsolete. Sets or retrieves whether the My Pictures image toolbar is visible for the current image.
HEIGHT	height	Gets or sets the height of the object.
HIDEFOCUS	hideFocus	Sets or gets the value that indicates whether the object visibly shows that it has focus.
HREF	href	Sets or retrieves a destination URL or an anchor point.
HSPACE	hspace	Sets or retrieves the horizontal margin for the object.
ID	id	Sets or retrieves the string identifying the object.
	innerHTML	Gets or sets the HTML between the start and end tags of the object.
	innerText	Sets or retrieves the text between the start and end tags of the object.
	isContentEditable	Gets the value that indicates whether the user can edit the contents of the object.
	isDisabled	Gets the value that indicates whether the user can interact with the object.
ISMAP	isMap	Sets or retrieves whether the image is a server-side image map.
	isMultiLine	Retrieves the value indicating whether the content of the object contains one or more lines.
	isTextEdit	Retrieves whether a TextRange object can be created using the object.
LANG	lang	Sets or retrieves the language to use.
LANGUAGE	language	Sets or retrieves the language in which the current script is written.
	lastChild	Gets a reference to the last child in the childNodes collection of an object.
	lastElementChild	Retrieves a reference to the last child element or null if there are no child elements.
	localName	Retrieves the local name of the fully qualified XML declaration for a node.
http://msdn.microsoft.com/en-us/library/ms534132(v=vs.85).aspx	longDesc	Gets or sets a Uniform Resource Identifier (URI) to a long description of the object.
LOOP	loop	Sets or retrieves the number of times a sound or video clip will loop when activated.
LOWSRC	lowsrc	Sets or retrieves a lower resolution image to display.
NAME	name	Gets or sets the name of the object.
	nameProp	Retrieves the file name specified in the href or src property of the object.
	namespaceURI	Retrieves the namespace URI of the fully qualified XML declaration for a node.
	naturalHeight	The original height of the image resource before sizing.
	naturalWidth	The original width of the image resource before sizing.
	nextElementSibling	Retrieves a reference to the sibling element that immediately follows or null if the element does not have any sibling elements that follow it.
	nextSibling	Retrieves a reference to the next child of the parent for the object.
	nodeName	Gets the name of a particular type of node.
	nodeType	Retrieves the type of the requested node.
	nodeValue	Gets or sets the value of a node.
	offsetHeight	Retrieves the height of the object relative to the layout or coordinate parent, as specified by the offsetParent property.
	offsetLeft	Retrieves the calculated left position of the object relative to the layout or coordinate parent, as specified by the offsetParent property.
	offsetParent	Retrieves a reference to the container object that defines the offsetTop and offsetLeft properties of the object.
	offsetTop	Retrieves the calculated top position of the object relative to the layout or coordinate parent, as specified by the offsetParent property.
	offsetWidth	Retrieves the width of the object relative to the layout or coordinate parent, as specified by the offsetParent property.
	onOffBehavior	This property is deprecated. Gets an object that indicates whether the specified Microsoft DirectAnimation behavior is running.
	outerHTML	Sets or retrieves the object and its content in HTML.
	outerText	Sets or retrieves the text of the object.
	ownerDocument	Retrieves the document object associated with the node.
	parentElement	Retrieves the parent object in the object hierarchy.
	parentNode	Retrieves the parent object in the document hierarchy.
	parentTextEdit	Retrieves the container object in the document hierarchy that can be used to create a TextRange containing the original object.
	prefix	Retrieves the local name of the fully qualified XML declaration for a node.
	previousElementSibling	Retrieves a reference to the immediately preceding sibling element or null if the element does not have any preceding siblings.
	previousSibling	Gets a reference to the previous child of the parent for the object.
	protocol	Sets or retrieves the protocol portion of a URL.
	readyState	Retrieves a value that indicates the current state of the object.
	recordNumber	Retrieves the ordinal record from the data set that generated the object.
role	role	Sets or retrieves the role for this element.
	scopeName	Gets the namespace defined for the element.
	scrollHeight	Retrieves the scrolling height of the object.
	scrollLeft	Sets or retrieves the distance between the left edge of the object and the leftmost portion of the content currently visible in the window.
	scrollTop	Sets or retrieves the distance between the top of the object and the topmost portion of the content currently visible in the window.
	scrollWidth	Retrieves the scrolling width of the object.
	sourceIndex	Retrieves the ordinal position of the object, in source order, as the object appears in the document's all collection.
SRC	src	Sets or retrieves a URL to be loaded by the object.
start	start	Sets or retrieves when a video clip file should begin playing.
STYLE		Sets an inline style for the element.
TABINDEX	tabIndex	Sets or retrieves the index that defines the tab order for the object.
	tagName	Retrieves the tag name of the object.
	tagUrn	Sets or gets the Uniform Resource Name (URN) specified in the namespace declaration.
	textContent	Sets or retrieves the text content of an object and any child objects.
TITLE	title	Sets or retrieves advisory information (a ToolTip) for the object.
	uniqueID	Retrieves an autogenerated, unique identifier for the object.
	uniqueNumber	Retrieves the element's unique number.
UNSELECTABLE		Specifies that an element cannot be selected.
USEMAP	useMap	Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.
	vrml	Sets or retrieves the URL of the virtual reality modeling language (VRML) world to be displayed in the window.
VSPACE	vspace	Sets or retrieves the vertical margin for the object.
WIDTH	width	Sets or retrieves the calculated width of the object.

Behaviors

Behavior	Description
clientCaps	Obsolete. Provides information about features supported by Internet Explorer, as well as a way for installing browser components on demand.
download	Downloads a file and notifies a specified callback function when the download is complete.
homePage	Contains information about a user's homepage.
httpFolder	Contains scripting features that enable browser navigation to a folder view.
imageRollover	Provides rollover effects for images.
saveFavorite	Enables the object to persist data in a favorite Web site.
saveHistory	Enables the object to persist data in the browser history.
saveSnapshot	Enables the object to persist data when a Web page is saved.
time	Provides an active timeline for an HTML element.
time2	Provides an active timeline for an HTML element or group of elements.
userData	Enables the object to persist data in user data.

Collections

Collection	Description
all	Returns a reference to the collection of elements contained by the object.
attributes	Retrieves the collection of attributes belonging to the object.
behaviorUrns	Returns a collection of Uniform Resource Name (URN) strings identifying the behaviors attached to the element.
childNodes	Retrieves a collection of HTML Elements and TextNode objects that are direct descendants of the specified object.
children	Retrieves a collection of DHTML Objects that are direct descendants of the object.
filters	Retrieves the collection of filters that have been applied to the object.

Events

Event	Event Property	Description
abort	onabort	Fires when the user aborts the download.
	onactivate	Fires when the object is set as the active element.
	onafterupdate	Fires on a databound object after successfully updating the associated data in the data source object.
	onbeforeactivate	Fires immediately before the object is set as the active element.
	onbeforecopy	Fires on the source object before the selection is copied to the system clipboard.
	onbeforecut	Fires on the source object before the selection is deleted from the document.
	onbeforedeactivate	Fires immediately before the activeElement is changed from the current object to another object in the parent document.
	onbeforepaste	Fires on the target object before the selection is pasted from the system clipboard to the document.
	onbeforeupdate	Fires on a databound object before updating the associated data in the data source object.
blur	onblur	Fires when the object loses the input focus.
	oncellchange	Fires when data changes in the data provider.
change	onchange	Fires when the contents of the object or selection have changed.
click	onclick	Fires when the user clicks the left mouse button on the object.
contextmenu	oncontextmenu	Fires when the user clicks the right mouse button in the client area, opening the context menu.
	oncontrolselect	Fires when the user is about to make a control selection of the object.
	oncopy	Fires on the source element when the user copies the object or selection, adding it to the system clipboard.
	oncut	Fires on the source element when the object or selection is removed from the document and added to the system clipboard.
	ondataavailable	Fires periodically as data arrives from data source objects that asynchronously transmit their data.
	ondatasetchanged	Fires when the data set exposed by a data source object changes.
	ondatasetcomplete	Fires to indicate that all data is available from the data source object.
dblclick	ondblclick	Fires when the user double-clicks the object.
	ondeactivate	Fires when the activeElement is changed from the current object to another object in the parent document.
drag	ondrag	Fires on the source object continuously during a drag operation.
dragend	ondragend	Fires on the source object when the user releases the mouse at the close of a drag operation.
dragenter	ondragenter	Fires on the target element when the user drags the object to a valid drop target.
dragleave	ondragleave	Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.
dragover	ondragover	Fires on the target element continuously while the user drags the object over a valid drop target.
dragstart	ondragstart	Fires on the source object when the user starts to drag a text selection or selected object.
drop	ondrop	Fires on the target object when the mouse button is released during a drag-and-drop operation.
error	onerror	Fires when an error occurs during object loading.
	onerrorupdate	Fires on a databound object when an error occurs while updating the associated data in the data source object.
	onfilterchange	Fires when a visual filter changes state or completes a transition.
focus	onfocus	Fires when the object receives focus.
focusin	onfocusin	Fires for an element just prior to setting focus on that element.
focusout	onfocusout	Fires for the current element with focus immediately after moving focus to another element.
	onhelp	Fires when the user presses the F1 key while the client is the active window.
input	oninput	Occurs when the text content of an element is changed through the user interface.
keydown	onkeydown	Fires when the user presses a key.
keypress	onkeypress	Fires when the user presses an alphanumeric key.
keyup	onkeyup	Fires when the user releases a key.
	onlayoutcomplete	Fires when the print or print preview layout process finishes filling the current LayoutRect object with content from the source document.
load	onload	Fires immediately after the client loads the object.
	onlosecapture	Fires when the object loses the mouse capture.
mousedown	onmousedown	Fires when the user clicks the object with either mouse button.
	onmouseenter	Fires when the user moves the mouse pointer into the object.
	onmouseleave	Fires when the user moves the mouse pointer outside the boundaries of the object.
mousemove	onmousemove	Fires when the user moves the mouse over the object.
mouseout	onmouseout	Fires when the user moves the mouse pointer outside the boundaries of the object.
mouseover	onmouseover	Fires when the user moves the mouse pointer into the object.
mouseup	onmouseup	Fires when the user releases a mouse button while the mouse is over the object.
mousewheel	onmousewheel	Fires when the wheel button is rotated.
	onmove	Fires when the object moves.
	onmoveend	Fires when the object stops moving.
	onmovestart	Fires when the object starts to move.
	onpaste	Fires on the target object when the user pastes data, transferring the data from the system clipboard to the document.
	onpropertychange	Fires when a property changes on the object.
readystatechange	onreadystatechange	Fires when the state of the object has changed.
	onreset	Fires when the user resets a form.
http://msdn.microsoft.com/en-us/library/ms536959(v=vs.85).aspx	onresize	Fires when the size of the object is about to change.
	onresizeend	Fires when the user finishes changing the dimensions of the object in a control selection.
	onresizestart	Fires when the user begins to change the dimensions of the object in a control selection.
	onrowenter	Fires to indicate that the current row has changed in the data source and new data values are available on the object.
	onrowexit	Fires just before the data source control changes the current row in the object.
	onrowsdelete	Fires when rows are about to be deleted from the recordset.
	onrowsinserted	Fires just after new rows are inserted in the current recordset.
scroll	onscroll	Fires when the user repositions the scroll box in the scroll bar on the object.
select	onselect	Fires when the current selection changes.
	onselectstart	Fires when the object is being selected.
	ontimeerror	Fires whenever a time-specific error occurs, usually as a result of setting a property to an invalid value.

Filters

Filter property	Description
Alpha	Adjusts the opacity of the content of the object.
AlphaImageLoader	Displays an image within the boundaries of the object and between the object background and content, with options to clip or resize the image. When loading a Portable Network Graphics (PNG) image, tranparency from zero to 100 percent is supported.
Barn	Reveals new content of the object with a motion that resembles doors opening or closing.
BasicImage	Adjusts the color processing, image rotation, or opacity of the content of the object.
BlendTrans	Reveals new content of the object by fading the original content.
Blinds	Reveals new content of the object with a motion that appears to open or close blinds.
Blur	Blurs the content of the object so that it appears out of focus.
CheckerBoard	Reveals new content of the object by uncovering squares placed like a checkerboard over the original content.
Chroma	Displays a specific color of the content of the object as transparent.
Compositor	Displays new content of the object as a logical color combination of the new and original content. The color and alpha values of each version of the content are evaluated to determine the final color on the output image.
DropShadow	Creates a solid silhouette of the content of the object, offset in the specified direction. This creates the illusion that the content is floating and casting a shadow.
Emboss	Displays the content of the object as an embossed texture using grayscale values.
Engrave	Displays the content of the object as an engraved texture using grayscale values.
Fade	Reveals new content of the object by fading out the original content.
FlipH	Displays the content of the object flipped across the horizontal axis.
FlipV	Displays the content of the object flipped across the vertical axis.
Glow	Adds radiance around the outside edges of the content of the object so that it appears to glow.
Gradient	Displays a color gradient between the object's background and content.
GradientWipe	Reveals new content of the object by passing a gradient band over the original content.
Gray	Displays the content of the object in grayscale.
ICMFilter	Converts the color content of the object based on an Image Color Management (ICM) profile. This enables improved display of specific content, or simulated display for hardware devices, such as printers or monitors.
Inset	Reveals new content of the object diagonally.
Invert	Reverses the hue, saturation, and brightness values of the content of the object.
Iris	Reveals new content of the object with an iris effect, similar to the opening of a camera aperture.
Light	Creates the effect of a light shining on the content of the object.
MaskFilter	Displays transparent pixels of the object content as a color mask, and makes the nontransparent pixels transparent.
Matrix	Resizes, rotates, or reverses the content of the object using matrix transformation.
MotionBlur	Causes the content of the object to appear to be in motion.
Pixelate	Displays the content of the object as squares that take on the average color value of the pixels they replace. This filtered display can be used as a transition.
RadialWipe	Reveals new content of the object with a radial wipe, like a windshield-wiper blade.
RandomBars	Reveals new content of the object by exposing random lines of pixels.
RandomDissolve	Reveals new content of the object by exposing random pixels.
Redirect	Not supported.
RevealTrans	Reveals new content of the object using one of 24 predefined Transition effects.
Shadow	Creates a solid silhouette of the content of the object, offset in the specified direction. This creates the illusion of a shadow.
Slide	Reveals new content of the object by sliding sections of the image into place.
Spiral	Reveals new content of the object with a spiral motion.
Stretch	Reveals new content of the object with a stretching motion to cover the original content. One option resembles a cube rotating from one face to another.
Strips	Reveals new content of the object by moving successive strips into place, like a diagonal saw blade passing across the original content.
Wave	Performs a sine wave distortion of the content of the object along the vertical axis.
Wheel	Reveals new content of the object with a rotating motion, like spokes of a wheel covering the original content.
Xray	Changes the color depth of the content of the object and displays it in black and white.
Zigzag	Reveals new content of the object with a forward and back motion that moves down the object.

Methods

Method	Description
addBehavior	Attaches a behavior to the element.
applyElement	Makes the element either a child or parent of another element.
attachEvent	Binds the specified function to an event, so that the function gets called whenever the event fires on the object.
blur	Causes the element to lose focus and fires the onblur event.
clearAttributes	Removes all attributes and values from the object.
click	Simulates a click by causing the onclick event to fire.
cloneNode	Copies a reference to the object from the document hierarchy.
compareDocumentPosition	Compares the position of two nodes in a document.
componentFromPoint	Returns the component located at the specified coordinates via certain events.
contains	Checks whether the given element is contained within the object.
detachEvent	Unbinds the specified function from the event, so that the function stops receiving notifications when the event fires.
doScroll	Simulates a click on a scroll bar component.
dragDrop	Initiates a drag event.
fireEvent	Fires a specified event on the object.
focus	Causes the element to receive the focus and executes the code specified by the onfocus event.
getAdjacentText	Returns the adjacent text string.
getAttribute	Retrieves the value of the specified attribute.
getAttributeNode	Retrieves an attribute object referenced by the attribute.name property.
getAttributeNodeNS	Gets an attribute object that matches the specified namespace and name.
getAttributeNS	Gets the value of the specified attribute within the specified namespace.
getBoundingClientRect	Retrieves an object that specifies the bounds of a collection of TextRectangle objects.
getClientRects	Retrieves a collection of rectangles that describes the layout of the contents of an object or range within the client. Each rectangle describes a single line.
getElementsByClassName	Gets a collection of objects that are based on the value of the CLASS attribute.
getElementsByTagName	Retrieves a collection of objects based on the specified element name.
getElementsByTagNameNS	Gets a collection of objects that are based on the specified element names within a specified namespace.
getExpression	Retrieves the expression for the given property.
hasAttribute	Determines whether an attribute with the specified name exists.
hasAttributeNS	Determines whether an attribute that has the specified namespace and name exists.
hasAttributes	Determines whether one or more attributes exist for the object.
hasChildNodes	Returns a value that indicates whether the object has children.
insertAdjacentElement	Inserts an element at the specified location.
insertAdjacentHTML	Inserts the given HTML text into the element at the location.
insertAdjacentText	Inserts the given text into the element at the specified location.
isDefaultNamespace	Indicates whether or not a namespace is the default namespace for a document.
isEqualNode	Determines if two nodes are equal.
isSameNode	Determines if two node references refer to the same node.
isSupported	Returns a value indicating whether or not the object supports a specific Document Object Model (DOM) standard.
lookupNamespaceURI	Gets the URI of the namespace associated with a namespace prefix, if any.
lookupPrefix	Gets the namespace prefix associated with a URI, if any.
mergeAttributes	Copies all read/write attributes to the specified element.
msMatchesSelector	Determines whether an object matches the specified selector.
normalize	Merges adjacent DOM objects to produce a normalized document object model.
querySelector	Retrieves the first DOM element node from descendants of the starting element node that match any selector within the supplied selector string.
querySelectorAll	Retrieves all DOM element nodes from descendants of the starting element node that match any selector within the supplied selector strings.
releaseCapture	Removes mouse capture from the object in the current document.
removeAttribute	Removes an attribute from an object.
removeAttributeNode	Removes an attribute object from the object.
removeAttributeNS	Removes the specified attribute from the object.
removeBehavior	Detaches a behavior from the element.
removeExpression	Removes the expression from the specified property.
removeNode	Removes the object from the document hierarchy.
replaceAdjacentText	Replaces the text adjacent to the element.
replaceNode	Replaces the object with another element.
scrollIntoView	Causes the object to scroll into view, aligning it either at the top or bottom of the window.
setActive	Sets the object as active without setting focus to the object.
setAttribute	Sets the value of the specified attribute.
setAttributeNode	Sets an attribute object node as part of the object.
setAttributeNodeNS	Sets an attribute object as part of the object.
setAttributeNS	Sets the value of the specified attribute within the specified namespace.
setCapture	Sets the mouse capture to the object that belongs to the current document.
setExpression	Sets an expression for the specified object.
swapNode	Exchanges the location of two objects in the document hierarchy.

Objects

Object	Description
currentStyle	Represents the cascaded format and style of the object as specified by global style sheets, inline styles, and HTML attributes.
runtimeStyle	Represents the cascaded format and style of the object that overrides the format and style specified in global style sheets, inline styles, and HTML attributes.
style	Represents the current settings of all possible inline styles for a given element.

Prototypes

Object	Description
HTMLImageElement Constructor	Defines the properties and methods inherited by objects in the HTMLImageElement Constructor prototype chain.

Styles

Style attribute	Style property	Description
:active	:active	Sets the style of an element when it is engaged or active.
:after	:after	Defines generated content that appears after an element.
:before	:before	Defines generated content that appears before an element.
:checked	:checked	Applies one or more styles to the form control element that is selected.
:disabled	:disabled	Applies one or more styles to the form control element that is disabled.
:empty	:empty	Applies one or more styles to the element that has no child elements (including text nodes).
:enabled	:enabled	Applies one or more styles to the form control element that is enabled.
:first-child	:first-child	Applies one or more styles to any element that is the first child of its parent.
:first-of-type	:first-of-type	Applies one or more styles to the element that is the first sibling element of its type.
:focus	:focus	Sets the style of an element when it gains focus.
:hover	:hover	Sets the style of an element when the user hovers the mouse pointer over the element.
:indeterminate	:indeterminate	Applies one or more styles to radio buttons and check boxes whose toggle states cannot be determined—they are neither checked (selected) nor unchecked (cleared).
:lang	:lang(C)	In a document, selects the elements that are in a given language.
:last-child	:last-child	Applies one or more styles to the element that is the last child element of its parent element.
:last-of-type	:last-of-type	Applies one or more styles to the element that is the last sibling element of its type.
:not(s)	:not(s)	Applies one or more styles to elements that do not match the simple selector s.
:nth-child(n)	:nth-child(n)	Applies one or more styles to the element that is the n-th child of its parent element.
:nth-last-child(n)	:nth-last-child(n)	Applies one or more styles to the element that is the n-th child of its parent element, counting from the last one.
:nth-last-of-type(n)	:nth-last-of-type(n)	Applies one or more styles to the element that is the n-th sibling of its type, counting from the last one.
:nth-of-type(n)	:nth-of-type(n)	Applies one or more styles to the element that is the n-th sibling of its type.
:only-child	:only-child	Applies one or more styles to the element that is the last sibling element of its type.
:only-of-type	:only-of-type	Applies one or more styles to the element that is the only sibling element of its type.
:root	:root	Applies one or more styles to the element that is the root element of the document.
:target	:target	Applies one or more styles to the target element of of the referring URI.
background	background	Gets or sets up to five separate background properties of the object.
background-attachment	backgroundAttachment	Gets or sets how the background image is attached to the object within the document.
background-clip	backgroundClip	Gets or sets the background painting area.
background-color	backgroundColor	Gets or sets the color behind the content of the object.
background-image	backgroundImage	Gets or sets the background image of the object.
background-origin	backgroundOrigin	Gets or sets the background positioning area of a box or multiple boxes.
background-position	backgroundPosition	Sets or retrieves the position of the background of the object.
-ms-background-position-x	backgroundPositionX	Gets or sets the x-coordinate of the backgroundPosition property.
-ms-background-position-y	backgroundPositionY	Gets or sets the y-coordinate of the backgroundPosition property.
background-repeat	backgroundRepeat	Gets or sets how the backgroundImage property of the object is tiled.
background-size	backgroundSize	Gets or sets the size of the background images.
-ms-behavior	behavior	Gets or sets the location of the Dynamic HTML (DHTML) behavior.
border	border	Sets or retrieves the properties to draw around the object.
border-bottom	borderBottom	Sets or retrieves the properties of the bottom border of the object.
border-bottom-color	borderBottomColor	Gets or sets the color of the bottom border of the object.
border-bottom-left-radius	borderBottomLeftRadius	Gets or sets one or two values that define the radii of the quarter ellipse that defines the shape of the lower-left corner for the outer border edge of the current box.
border-bottom-right-radius	borderBottomRightRadius	Gets or sets one or two values that define the radii of the quarter ellipse that defines the shape of the lower-right corner for the outer border edge of the current box.
border-bottom-style	borderBottomStyle	Gets or sets the style of the bottom border of the object.
border-bottom-width	borderBottomWidth	Gets or sets the width of the bottom border of the object.
border-color	borderColor	Gets or sets the border color of the object.
border-left	borderLeft	Sets or retrieves the properties of the left border of the object.
border-left-color	borderLeftColor	Gets or sets the color of the left border of the object.
border-left-style	borderLeftStyle	Gets or sets the style of the left border of the object.
border-left-width	borderLeftWidth	Gets or sets the width of the left border of the object.
border-radius	borderRadius	Gets or sets one or more values that define the radii of a quarter ellipse that defines the shape of the corners for the outer border edge of the current box.
border-right	borderRight	Sets or retrieves the properties of the right border of the object.
border-right-color	borderRightColor	Gets or sets the color of the right border of the object.
border-right-style	borderRightStyle	Gets or sets the style of the right border of the object.
border-right-width	borderRightWidth	Gets or sets the width of the right border of the object.
border-style	borderStyle	Gets or sets the style of the left, right, top, and bottom borders of the object.
border-top	borderTop	Sets or retrieves the properties of the top border of the object.
border-top-color	borderTopColor	Gets or sets the color of the top border of the object.
border-top-left-radius	borderTopLeftRadius	Gets or sets one or two values that define the radii of the quarter ellipse that defines the shape of the upper-left corner for the outer border edge of the current box.
border-top-right-radius	borderTopRightRadius	Gets or sets one or two values that define the radii of the quarter ellipse that defines the shape of the upper-right corner for the outer border edge of the current box.
border-top-style	borderTopStyle	Gets or sets the style of the top border of the object.
border-top-width	borderTopWidth	Gets or sets the width of the top border of the object.
border-width	borderWidth	Gets or sets the width of the left, right, top, and bottom borders of the object.
bottom	bottom	Gets or sets the bottom position of the object in relation to the bottom of the next positioned object in the document hierarchy.
box-shadow	boxShadow	Gets or sets a comma-separated list of shadows that attaches one or more drop shadows to the current box.
box-sizing	boxSizing	Gets or sets the box model to use for object sizing.
clear	clear	Gets or sets whether the object allows floating objects on its left side, right side, or both, so that the next text displays past the floating objects.
clip	clip	Sets or retrieves which part of a positioned object is visible.
content	content	Gets or sets generated content to insert before or after an element.
counter-increment	counterIncrement	Gets or sets a list of counters to increment.
counter-reset	counterReset	Gets or sets a list of counters to create or reset to zero.
cursor	cursor	Gets or sets the type of cursor to display as the mouse pointer moves over the object.
direction	direction	Gets or sets the reading order of the object.
display	display	Gets or sets whether the object is rendered.
-ms-filter	filter	Gets or sets the filter or collection of filters that are applied to the object.
font	font	Sets or retrieves a combination of separate font properties of the object. Alternatively, sets or retrieves one or more of six user-preference fonts.
font-family	fontFamily	Gets or sets the name of the font used for text in the object.
font-size-adjust	fontSizeAdjust	Gets or sets a value that specifies an aspect value for an element that will effectively preserve the x-height of the first choice font, whether it is substituted or not.
font-stretch	fontStretch	Gets or sets a value that indicates a normal, condensed, or expanded face of a font family.
font-style	fontStyle	Gets or sets the font style of the object as italic, normal, or oblique.
font-variant	fontVariant	Gets or sets whether the text of the object is in small capital letters.
	fontWeight	Gets the numeric weight of the font of the object.
font-weight	fontWeight	Gets or sets the weight of the font of the object.
	hasLayout	Gets a value that indicates whether the object has layout.
height	height	Gets or sets the height of the object.
-ms-layout-grid	layoutGrid	Sets or retrieves the composite document grid properties that specify the layout of text characters.
-ms-layout-grid-mode	layoutGridMode	Gets or sets whether the text layout grid uses two dimensions.
left	left	Gets or sets the position of the object relative to the left edge of the next positioned object in the document hierarchy.
letter-spacing	letterSpacing	Gets or sets the amount of additional space between letters in the object.
line-height	lineHeight	Gets or sets the distance between lines in the object.
margin	margin	Gets or sets the width of the top, right, bottom, and left margins of the object.
margin-bottom	marginBottom	Gets or sets the height of the bottom margin of the object.
margin-left	marginLeft	Gets or sets the width of the left margin of the object.
margin-right	marginRight	Gets or sets the width of the right margin of the object.
margin-top	marginTop	Gets or sets the height of the top margin of the object.
max-height	maxHeight	Gets or sets the maximum height for an element.
max-width	maxWidth	Gets or sets the maximum width for an element.
min-height	minHeight	Gets or sets the minimum height for an element.
min-width	minWidth	Gets or sets the minimum width for an element.
-ms-block-progression	msBlockProgression	Gets or sets the block progression and layout orientation.
-ms-interpolation-mode	msInterpolationMode	Obsolete. Gets or sets the interpolation (resampling) method used to stretch images.
-ms-transform	msTransform	Gets or sets a list of one or more transform functions that specify how to translate, rotate, or scale an element in 2-D space.
-ms-transform-origin	msTransformOrigin	Gets or sets one or two values that establish the origin of transformation for an element.
opacity	opacity	Gets or sets a value that specifies object or group opacity in Cascading Style Sheets (CSS) or Scalable Vector Graphics (SVG).
outline	outline	Gets or sets the color, style, and width of the outline frame.
outline-color	outlineColor	Gets or sets the color of the outline frame.
outline-style	outlineStyle	Gets or sets the style of the outline frame.
outline-width	outlineWidth	Gets or sets the width of the outline frame.
padding	padding	Gets or sets the amount of space to insert between the object and its margin or, if there is a border, between the object and its border.
padding-bottom	paddingBottom	Gets or sets the amount of space to insert between the bottom border of the object and the content.
padding-left	paddingLeft	Gets or sets the amount of space to insert between the left border of the object and the content.
padding-right	paddingRight	Gets or sets the amount of space to insert between the right border of the object and the content.
padding-top	paddingTop	Gets or sets the amount of space to insert between the top border of the object and the content.
	pixelBottom	Sets or retrieves the bottom position of the object.
	pixelHeight	Sets or retrieves the height of the object.
	pixelLeft	Sets or retrieves the left position of the object.
	pixelRight	Sets or retrieves the right position of the object.
	pixelTop	Sets or retrieves the top position of the object.
	pixelWidth	Sets or retrieves the width of the object.
	posBottom	Sets or retrieves the bottom position of the object in the units specified by the bottom attribute.
	posHeight	Sets or retrieves the height of the object in the units specified by the height attribute.
position	position	Gets or sets the type of positioning used for the object.
	posLeft	Sets or retrieves the left position of the object in the units specified by the left attribute.
	posRight	Sets or retrieves the right position of the object in the units specified by the right attribute.
	posTop	Sets or retrieves the top position of the object in the units specified by the top attribute.
	posWidth	Sets or retrieves the width of the object in the units specified by the width attribute.
quotes	quotes	Gets or sets the pairs of strings to be used as quotes in generated content.
right	right	Gets or sets the position of the object relative to the right edge of the next positioned object in the document hierarchy.
float	styleFloat	Gets or sets on which side of the object the text will flow.
-ms-text-autospace	textAutospace	Gets or sets the autospacing and narrow space width adjustment of text.
-ms-text-underline-position	textUnderlinePosition	Gets or sets the position of the underline decoration that is set through the textDecoration property of the object.
top	top	Gets or sets the position of the object relative to the top of the next positioned object in the document hierarchy.
unicode-bidi	unicodeBidi	Gets or sets the level of embedding with respect to the bidirectional algorithm.
vertical-align	verticalAlign	Gets or sets the vertical alignment of the object.
visibility	visibility	Gets or sets whether the content of the object is displayed.
word-spacing	wordSpacing	Gets or sets the amount of additional space between words in the object.
-ms-word-wrap	wordWrap	Gets or sets whether to break words when the content exceeds the boundaries of its container.
-ms-zoom	zoom	Gets or sets the magnification scale of the object.

Remarks

This element does not fire the onfocus event when it receives the input focus, unless it has been associated with a MAP element.

The following image and video file formats are supported:

• .avi—Audio-Visual Interleaved (AVI)
• .bmp—Windows Bitmap (BMP)
• .emf—Windows Enhanced Metafile (EMF)
• .gif—Graphics Interchange Format (GIF)
• .jpg, .jpeg—Joint Photographic Experts Group (JPEG)
• .mov—Apple QuickTime Movie (MOV)
• .mpg, .mpeg—Motion Picture Experts Group (MPEG)
• .png—Portable Network Graphics (PNG)
• .wmf—Windows Metafile (WMF)

When using the IMG element to display a static image, specify the URL of the image file with the SRC attribute. When using the IMG element to display a video clip or VRML world, specify the URL with the DYNSRC attribute.

Internet Explorer 8 and later. In IE8 Standards mode, the title attribute is preferred over the alt attribute when specified as a pop-up tooltip for an img element. In addition, the value of the longDesc attribute depends on the current document compatibility mode.

The X Bitmap (XBM) file format is no longer supported as of Microsoft Internet Explorer 6 for Windows XP Service Pack 2 (SP2).

  Internet Explorer 9. Setting the CLASS attribute of an image to msPinSite enables the user to drag the image to the Windows taskbar to pin the site. For more information, see Introduction to Pinned Sites.

This element is an inline element.

This element does not require a closing tag.

Example

The following example shows how to use the img element to embed a bitmap image (.bmp) on a page.

<img src="mygraphic.bmp" onmouseout="alert('Out');" onmouseover="alert('Over');" 
style="filter:progid:DXImageTransform.Microsoft.Alpha(opacity=50);">

Standards Information

This object is defined in HTML 3.2 and is defined in DOM Level 1.

See Also

Alpha, How to Apply a Transition on an Image, input type=image, Build Flexible, Lightweight XML-Based Images for ASP.NET Using Scalable Vector Graphics