list-style-type Attribute | listStyleType

HTML (DHTML)

list-style-type Attribute | listStyleType Property

Internet Development Index

Sets or retrieves the predefined type of the line-item marker for the object.

Syntax

HTML { list-style-type : sType }
Scriptingobject.style.listStyleType [ = sType ]

Possible Values

sTypeString that specifies or receives one of the following values.
discDefault. Solid circles.
circleOutlined circles.
squareSolid squares.
decimal1, 2, 3, 4, and so on.
lower-romani, ii, iii, iv, and so on.
upper-romanI, II, III, IV, and so on.
lower-alphaa, b, c, d, and so on.
upper-alphaA, B, C, D, and so on.
noneNo marker is shown.

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 disc. 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 listStyleType property determines the appearance of the list-item marker if the value of the list-style-image attribute is set to none, or if the image pointed to by the URL cannot be displayed.

The listStyleType property can be applied to any element when margin and display:list-item are applied. The display:list-item property is available as of Microsoft® Internet Explorer 6 and later.

If the left margin of a line item is set to 0 using one of the margin properties, the list-item markers do not show. The margin should be set to a minimum of 30 points.

Examples

The following examples use the list-style-type attribute and the listStyleType property to set the markers.

This example uses ul as a selector in an embedded (global) style sheet to change the marker type to circle.

<STYLE>
UL { list-style-type:circle }
</STYLE>
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 change the marker type on when an onmouseover event occurs.

<UL onmouseover="this.style.listStyleType='circle'">
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.

Standards Information

This property is defined in Cascading Style Sheets (CSS), Level 1 (CSS1) Non-Microsoft link.

Applies To

currentStyle, LI, OL, runtimeStyle, style, UL