Inserts a line break.

Members Table

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

Attributes/Properties

Attribute	Property	Description
	ariaBusy	Sets or retrieves the busy state of this element.
	ariaChecked	Sets or retrieves the checked state of this element.
	ariaDisabled	Sets or retrieves the disabled state of this element.
	ariaExpanded	Sets or retrieves the expanded state of this element.
	ariaHaspopup	Sets or retrieves a value indicating whether this element may display a pop-up window.
	ariaHidden	Sets or retrieves the hidden state of this element.
	ariaInvalid	Sets or retrieves the invalid state of this element.
	ariaLevel	Sets or retrieves the level of this element.
	ariaMultiselect	Sets or retrieves the multiple-selection state of this element.
	ariaPosinset	Sets or retrieves the current position of an item within a set.
	ariaPressed	Sets or retrieves the pressed state of a button that can be toggled.
	ariaReadonly	Sets or retrieves the read-only state of this element.
	ariaRequired	Sets or retrieves the form-completion requirement of this element.
	ariaSecret	Sets or retrieves the secret state of this element.
	ariaSelected	Sets or retrieves the selection state of this element.
	ariaSetsize	Sets or retrieves the set size of this element.
	attributes	Retrieves a collection of attributes of the object.
	canHaveHTML	Sets or retrieves the value indicating whether the object can contain rich HTML markup.
CLASS	className	Sets or retrieves the class of the object.
CLEAR	clear	Sets or retrieves the side on which floating objects are not to be positioned when a line break is inserted into the document.
ID	id	Retrieves the string identifying 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.
	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.
	nextSibling	Retrieves a reference to the next child of the parent for the object.
	nodeName	Retrieves the name of a particular type of node.
	nodeType	Retrieves the type of the requested node.
	nodeValue	Sets or retrieves 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.
	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.
	previousSibling	Retrieves a reference to the previous child of the parent for the object.
	readyState	Retrieves the current state of the object.
	role	Sets or retrieves the role for this element.
	scopeName	Gets the namespace defined for the element.
	sourceIndex	Retrieves the ordinal position of the object, in source order, as the object appears in the document's all collection.
STYLE		Sets an inline style for the element.
	tagName	Retrieves the tag name of the object.
	tagUrn	Sets or gets the Uniform Resource Name (URN) specified in the namespace declaration.
	uniqueID	Retrieves an autogenerated, unique identifier for the object.

Behaviors

Behavior	Description
clientCaps	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.

Collections

Collection	Description
attributes	Retrieves a collection of attributes of the object.
behaviorUrns	Returns a collection of Uniform Resource Name (URN) strings identifying the behaviors attached to the element.

Events

Event	Description
onlayoutcomplete	Fires when the print or print preview layout process finishes filling the current LayoutRect object with content from the source document.
onlosecapture	Fires when the object loses the mouse capture.
onreadystatechange	Fires when the state of the object has changed.

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.
clearAttributes	Removes all attributes and values from the object.
cloneNode	Copies a reference to the object from the document hierarchy.
componentFromPoint	Returns the component located at the specified coordinates via certain events.
detachEvent	Unbinds the specified function from the event, so that the function stops receiving notifications when the event fires.
dragDrop	Initiates a drag event.
fireEvent	Fires a specified event on the object.
getAdjacentText	Returns the adjacent text string.
getAttribute	Retrieves the value of the specified attribute.
getAttribute	Retrieves the value of the specified attribute.
getAttributeNode	Gets an attribute object referenced by the attribute.name property.
getElementsByTagName	Retrieves a collection of objects based on the specified element name.
getExpression	Retrieves the expression for the given property.
hasAttribute	Determines whether an attribute with the specified name exists.
hasChildNodes	Returns a value that indicates whether the object has children.
insertAdjacentElement	Inserts an element at the specified location.
mergeAttributes	Copies all read/write attributes to the specified element.
normalize	Merges adjacent TextNode objects to produce a normalized document object model.
releaseCapture	Removes mouse capture from the object in the current document.
removeAttribute	Removes the given attribute from the object.
removeAttribute	Removes the given attribute from the object.
removeAttributeNode	Removes an attribute object from the object.
removeBehavior	Detaches a behavior from the element.
removeExpression	Removes the expression from the specified property.
replaceAdjacentText	Replaces the text adjacent to the element.
scrollIntoView	Causes the object to scroll into view, aligning it either at the top or bottom of the window.
setAttribute	Sets the value of the specified attribute.
setAttribute	Sets the value of the specified attribute.
setAttributeNode	Sets an attribute object node as part of the object.
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.

Styles

Style attribute	Style property	Description
:after	:after	Defines generated content that appears after an element.
:before	:before	Defines generated content that appears before an element.
display	display	Sets or retrieves whether the object is rendered.

Remarks

This element is not rendered.

This element does not require a closing tag.

Standards Information

This object is defined in HTML 3.2  and is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .