direction Attribute | direction Property | Internet Development Index |
Sets or retrieves the reading order of the object.
Syntax
HTML { direction : sDirection } Scripting object.style.direction(v) [ = sDirection ]
Possible Values
sDirection String that specifies or receives one of the following values.
ltr Default. Content flows left to right. rtl Content flows right to left. inherit Content flow is inherited. The property is read/write for all objects except the following, for which it is read-only: currentStyle. The property has a default value of ltr. The Cascading Style Sheets (CSS) attribute is inherited.
Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.
Remarks
The property does not affect alphanumeric characters in Latin documents. These characters always render ltr. However, the property does affect punctuation characters in Latin documents.
The property pertains only to the directional flow of an element's content. It has no effect on properties such as left or right, margin-left or margin-right. The margin-left property, for example, sets or retrieves the width of the margin on the left side of the document regardless of the value of the direction property.
Example
The following example demonstrates how to set and retrieve the value of the direction property. When the user sets the value of the direction property of a div element, the value of the property is retrieved in a span element.
<HTML> <HEAD> <SCRIPT> function fnSwitch() { oDiv.style.direction = event.srcElement.innerText; DirSpan.innerText = oDiv.style.direction; } </SCRIPT> </HEAD> <BODY> <H1>direction Property Sample</H1> <H2>direction: <SPAN id="DirSpan" style="color:red"></SPAN> </H2> [ <A onclick=fnSwitch()>ltr</A> | <A onclick=fnSwitch()>rtl</A> | <A onclick=fnSwitch()>inherit</A> ]</P> <DIV id="oDiv">The quick brown fox jumps over the lazy yellow dog. The quick brown fox jumps over the lazy yellow dog. The quick brown fox jumps over the lazy yellow dog. The quick brown fox jumps over the lazy yellow dog. The quick brown fox jumps over the lazy yellow dog.</DIV> </BODY> </HTML>
Standards Information
This property is defined in Cascading Style Sheets (CSS), Level 2 (CSS2) .
Applies To
A, ACRONYM, ADDRESS, B, BDO, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, currentStyle, CUSTOM, DD, defaults, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, hn, I, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LEGEND, LI, LISTING, MENU, NOBR, OBJECT, OL, OPTION, P, PLAINTEXT, PRE, Q, RT, RUBY, runtimeStyle, S, SAMP, SELECT, SMALL, SPAN, STRIKE, STRONG, style, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TR, TT, U, UL, VAR, XMP
See Also
dir, HTML Character Sets