Microsoft Developer Network

Inserts a soft line break into a block of NOBR text.

Members Table

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

Attributes/Properties

Show: Attributes/Properties Behaviors Collections Methods Objects Styles

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. 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. 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. role   Sets or retrieves the role for this element. scopeName Gets the namespace defined for the element. tagUrn Sets or gets the Uniform Resource Name (URN) specified in the namespace declaration. 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. Collection Description behaviorUrns Returns a collection of Uniform Resource Name (URN) strings identifying the behaviors attached to the element. Method Description addBehavior Attaches a behavior to the element. componentFromPoint Returns the component located at the specified coordinates via certain events. fireEvent Fires a specified event on the object. 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. hasAttribute   Determines whether an attribute with the specified name exists. normalize Merges adjacent TextNode objects to produce a normalized document object model. 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. 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. Object Description currentStyle Represents the cascaded format and style of the object as specified by global style sheets, inline styles, and HTML attributes. Style attribute Style property Description behavior behavior Sets or retrieves the location of the Dynamic HTML (DHTML) behavior.

Remarks

A soft line break is a point inside a NOBR section at which a line break is permitted but not required.

This element is not rendered.

This element does not require a closing tag.

Example

This example uses the WBR element to create line breaks. In contrast, the NOBR element does not break lines.

<NOBR>This line of text will not break, no matter how narrow the window gets.</NOBR>
<NOBR>This one, however,<WBR> will break after the word "however," 
if the window gets small enough.</NOBR>

Standards Information

This object is an extension to HTML .

See Also

br