Sets or retrieves the indentation of the first line of text in the object.
Syntax
HTML { text-indent : sIndent } Scripting[ sIndent = ] object.style.textIndent
Possible Values
sIndentString that specifies or receives one of the following values:lengthFloating-point number, followed by an absolute units designator (cm, mm, in, pt, or pc) or a relative units designator (em, ex, or px). For more information about the supported length units, see CSS Length Units Reference.percentageInteger, followed by a percent sign (%). This value is a percentage of the width of the parent object.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 0. The Cascading Style Sheets (CSS) attribute is inherited. DHTML expressions can be used in place of the preceding value(s). As of Internet Explorer 8, expressions are not supported in IE8 mode. For more information, see About Dynamic Properties.
cm
mm
in
pt
pc
em
ex
px
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 0. The Cascading Style Sheets (CSS) attribute is inherited.
DHTML expressions can be used in place of the preceding value(s). As of Internet Explorer 8, expressions are not supported in IE8 mode. For more information, see About Dynamic Properties.
Remarks
The property can be negative. An indent is not inserted in the middle of an object that was broken by another object, such as br in HTML.
Examples
The following examples use the text-indent attribute and the textIndent property to indent the object's text. This example uses calls to an embedded style sheet to change the indent on the text when an onclick event occurs. The text was originally indented 2 centimeters using div as a selector in the style sheet. <STYLE> DIV { text-indent:2cm } .click1 { text-indent:50% } .click2 { text-indent: } </STYLE> </HEAD> <BODY> <DIV onclick="this.className='click1'" ondblclick="this.className='click2'"> . . . </DIV> This feature requires Microsoft Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample. This example uses inline scripting to indent the text within the div when an onmouseover event occurs. <DIV onmouseover=this.style.textIndent="2cm" : </DIV> This feature requires Microsoft Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
This example uses calls to an embedded style sheet to change the indent on the text when an onclick event occurs. The text was originally indented 2 centimeters using div as a selector in the style sheet.
<STYLE> DIV { text-indent:2cm } .click1 { text-indent:50% } .click2 { text-indent: } </STYLE> </HEAD> <BODY> <DIV onclick="this.className='click1'" ondblclick="this.className='click2'"> . . . </DIV>
This example uses inline scripting to indent the text within the div when an onmouseover event occurs.
<DIV onmouseover=this.style.textIndent="2cm" : </DIV>
Standards Information
This property is defined in Cascading Style Sheets (CSS), Level 1 (CSS1) .
Applies To
BLOCKQUOTE, BODY, BUTTON, CENTER, currentStyle, DD, DFN, DIR, DIV, DL, DT, FIELDSET, FORM, hn, HR, ISINDEX, LI, LISTING, MARQUEE, MENU, OL, P, PLAINTEXT, PRE, runtimeStyle, style, TABLE, TD, TH, TR, UL, XMP, CSSCurrentStyleDeclaration Constructor, CSSRuleStyleDeclaration Constructor, CSSStyleDeclaration Constructor