CSS - list-style-position
The list-style-position
property specifies the position of the marker box in the principal block box.
Examples
HTML
<ul class="one"> List 1 <li>List Item 1-1</li> <li>List Item 1-2</li> <li>List Item 1-3</li> <li>List Item 1-4</li> </ul> <ul class="two"> List 2 <li>List Item 2-1</li> <li>List Item 2-2</li> <li>List Item 2-3</li> <li>List Item 2-4</li> </ul> <ul class="three"> List 3 <li>List Item 3-1</li> <li>List Item 3-2</li> <li>List Item 3-3</li> <li>List Item 3-4</li> </ul>
CSS
.one { list-style:square inside; } .two { list-style-position: outside; list-style-type: circle; } .three { list-style-image: url("https://mdn.mozillademos.org/files/11979/starsolid.gif"); list-style-position: inherit; }
Result
Syntax
/* Keyword values */ list-style-position: inside; list-style-position: outside; /* Global values */ list-style-position: inherit; list-style-position: initial; list-style-position: unset;
Values
outside
- The marker box is outside the principal block box.
inside
- The marker box is the first inline box in the principal block box, after which the element's content flows.
Formal syntax
inside <a href="css/value_definition_syntax#single_bar" title="Single bar">|</a> outside
Description
The list-style-position
property specifies the position of the marker box in the principal block box.
It is often more convenient to use the shorthand list-style
.
Initial value | outside |
---|---|
Applies to | list items |
Inherited | yes |
Media | visual |
Computed value | as specified |
Animatable | no |
Canonical order | the unique non-ambiguous order defined by the formal grammar |
Browser Compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 1.0 | 1.0 (1.0) | 4.0 | 3.5 | 1.0 (85) |
Feature | Android | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | ? | ? | ? | ? | ? |
N.B. There is variance among browsers regarding behaviour when a block element is placed first within a list element declared as list-style-position:inside
. Chrome and Safari both place this element on the same line as the marker box, whereas Firefox, Internet Explorer and Opera place it on the next line. For more information on this, see this Mozilla Bug report and an example.
See Also
Specifications
Specification | Status | Comment |
---|---|---|
CSS Lists and Counters Module Level 3 The definition of 'list-style-position' in that specification. |
Working Draft | No change. |
CSS Level 2 (Revision 1) The definition of 'list-style-position' in that specification. |
Recommendation | Initial definition. |
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/css/list-style-position