aside element | aside object

Represents content that is tangentially related to the other content of a document, and which could be considered separately.

HTML information

Closing Tag	required
CSS Display	block

DOM Information

Inheritance Hierarchy

Node

Element

aside

Members

The aside object has these types of members:

Methods
Properties

Methods

The aside object has these methods.

Method	Description
addBehavior	Attaches a behavior to the element.
appendChild	Appends an element as a child to the object.
applyElement	Makes the element either a child or parent of another element.
attachEvent	Note attachEvent is no longer supported. Starting with IE11, use addEventListener. For info, see Compatibility changes. 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.
componentFromPoint	Returns the component located at the specified coordinates via certain events.
contains	Checks whether the given element is contained within the object.
getAttributeNodeNS	Gets an attribute object that matches the specified namespace and name.
getAttributeNS	Gets the value of the specified attribute within the specified namespace.
getElementsByClassName	Gets a collection of objects that are based on the value of the class attribute.
getElementsByTagNameNS	Gets a collection of objects that are based on the specified element names within a specified namespace.
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.
insertAdjacentHTML	Inserts the given HTML text into the element at the location.
insertAdjacentText	Inserts the given text into the element at the specified location.
msMatchesSelector	Determines whether an object matches the specified selector.
normalize	Merges adjacent DOM objects to produce a normalized document object model.
removeAttributeNS	Removes the specified attribute from the object.
removeBehavior	Detaches a behavior from the element.
removeNode	Removes the object from the document hierarchy.
replaceAdjacentText	Replaces the text adjacent to the element.
replaceNode	Replaces the object with another element.
setActive	Sets the object as active without setting focus to 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.
swapNode	Exchanges the location of two objects in the document hierarchy.

Properties

The aside object has these properties.

Property	Description
accessKey	Sets or retrieves the access key for the object.
attributes	Retrieves a collection of attributes of the object.
canHaveChildren	Gets a value indicating whether the object can contain child objects.
className	Sets or retrieves the class of the object.
constructor	Returns a reference to the constructor of an object.
innerHTML	Sets or retrieves 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.
isTextEdit	Retrieves whether a TextRange object can be created using the object.
lang	Sets or retrieves the language to use.
language	Sets or retrieves the language in which the current script is written. Note This has been superceded by the type attribute for the script element. If you are using javascript alone, you don't need to specify a type or language with the script element.
offsetHeight	Retrieves the height 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.
offsetWidth	Retrieves the width of the object relative to the layout or coordinate parent, as specified by the offsetParent property.
outerHTML	Sets or retrieves the object and its content in HTML.
outerText	Sets or retrieves the text of the object.
parentElement	Retrieves the parent object in the object hierarchy.
parentTextEdit	Retrieves the container object in the document hierarchy that can be used to create a TextRange containing the original object.
recordNumber	Retrieves the ordinal record from the data set that generated the object.
role	Sets or retrieves the role for this element.
scopeName	Gets the namespace defined for the element. This property is not supported for Windows apps using JavaScript.
sourceIndex	Retrieves the ordinal position of the object, in source order, as the object appears in the document's all collection.
tagName	Retrieves the tag name of the object.
tagUrn	Sets or gets the URN specified in the namespace declaration. This property is not supported for Windows apps using JavaScript.
title	Sets or retrieves advisory information (a ToolTip) for the object.
uniqueNumber	Retrieves the element's unique number.
x-ms-format-detection	Determines whether data formats within content are automatically detected and (if found) converted to clickable links.

Standards information

There are no standards that apply here.

Remarks

Windows Internet Explorer 9. The aside element is only supported for webpages displayed in IE9 Standards mode. For more information, see Defining Document Compatibility.

Examples

The following example shows how an aside is used to mark up background material on Switzerland in a much longer news story on Europe.

JavaScript


<aside>
 <h1>Switzerland</h1>
 <p>Switzerland, a land-locked country in the middle of geographic
 Europe, has not joined the geopolitical European Union, though it is
 a signatory to a number of European treaties.</p>
</aside>