A Horizontal Rule element is a divider between sections of text such as a full width horizontal rule or equivalent graphic.

Example of use:

<ADDRESS>August 20<SUP>th</SUP>, 1996, Swansea</ADDRESS>

would render as :

August 20th, 1996, Swansea

The <HR> element specifies that a horizontal rule of some sort (The default being a shaded engraved line) be drawn across the page. Recent browsers have added new attributes to this element, which can be used to describe the colouring, size and position of the horizontal rule.

<HR SIZE=number>
The SIZE attributes lets the author give an indication of how thick they wish the horizontal rule to be.

<HR WIDTH=number|percent>
The default horizontal rule is always as wide as the page. With the WIDTH attribute, the author can specify an exact width in pixels, or a relative width measured in percent of document width.

<HR ALIGN=left|right|center>
Now that horizontal rules do not have to be the width of the page it is necessary to allow the author to specify whether they should be pushed up against the left margin, the right margin, or centred in the page.

For those times when a solid bar is required, the NOSHADE attribute lets the author specify that the horizontal rule should not be shaded at all.

<HR COLOR>=name|#rrggbb
Internet Explorer allows the specifying of the hard rule colour. Accepted values are any of the Internet Explorer supported colour names (see <BODY BGCOLOR=...>, or any acceptable rrggbb hex triplet.

TITLE="informational ToolTip"
The Internet Explorer 4.0 (and above) specific TITLE attribute is used for informational purposes. If present, the value of the TITLE attribute is presented as a ToolTip when the users mouse hovers over the <HR> section.

LANG="language setting"
The LANG attribute can be used to specify what language the <HR> element is using. It accepts any valid ISO standard language abbreviation (for example "en" for English, "de" for German etc.) For more details, see the Document Localisation section for more details.

LANGUAGE="Scripting language"
The LANGUAGE attribute can be used to expressly specify which scripting language Internet Explorer 4.0 uses to interpret any scripting information used in the <HR> element. It can accept values of vbscript, vbs, javascript or jscript. The first two specify the scripting language as Visual Basic Script, the latter two specify it as using Javascript (the default scripting language used if no LANGUAGE attribute is set.

CLASS="Style Sheet class name"
The CLASS attribute is used to specify the <HR> element as using a particular style sheet class. See the Style Sheets topic for details.

STYLE="In line style setting"
As well as using previously defined style sheet settings, the <HR> element can have in-line stylings attached to it. See the Style Sheets topic for details.

ID="Unique element identifier"
The ID attribute can be used to either reference a unique style sheet identifier, or to provide a unique name for the <HR> element for scripting purposes. Any <HR> element with an ID attribute can be directly manipulated in script by referencing its ID attribute, rather than working through the All collection to determine the element. See the Scripting introduction topic for more information.


<HR SIZE="5">
<HR WIDTH="50%">
<HR WIDTH="50%" ALIGN="right">
<HR WIDTH="50%" ALIGN="center" NOSHADE>

would render as :

Every <HR> element in a document is an object that can be manipulated through scripting. Note that scripting of the <HR> element/object is only supported by Internet Explorer 4.0 in its Dynamic HTML object model. Netscape does not support direct scripting of the <HR> element at all.

<HR...> Properties
Of the standard Dynamic HTML properties, the <HR...> element/object supports the following: className, document, id, isTextEdit, lang, language, offsetHeight, offsetLeft, offsetParent, offsetTop, offsetWidth, outerHTML, outerText, parentElement, parentTextEdit, sourceIndex, style, tagName and title. Details of these can be found in the standard Dynamic HTML properties topics.
It also supports the align, color, noShade, size and width properties, which directly reflect the attribute values (described above).

<HR...> Methods
The <HR...> element/object supports all of the standard Dynamic HTML methods (i.e. click, contains, getAttribute, insertAdjacentHTML, insertAdjacentText, removeAttribute, scrollIntoView and setAttribute). Details of these can be found in the standard Dynamic HTML Methods topics.

<HR...> Events
The <HR...> element/object supports all of the standard Dynamic HTML events (i.e. onclick, ondblclick, ondragstart, onfilterchange, onhelp, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup and onselectstart). Details of these can be found in the standard Dynamic HTML events topics.