The list-style-position
CSS property sets the position of the ::marker
relative to a list item.
It is often more convenient to use the shorthand list-style
.
Note: This property is applied to list items, i.e. elements with
by default this includes display
: list-item;<li>
elements. Because this property is inherited, it can be set on the parent element (normally <ol>
or <ul>
) to let it apply to all list items.
Note: There is variance among browsers regarding behavior 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 bug 36854.
/* Keyword values */ list-style-position: inside; list-style-position: outside; /* Global values */ list-style-position: inherit; list-style-position: initial; list-style-position: unset;
The list-style-position
property is specified as one of the keyword values listed below.
inside
::marker
is the first element among the list item's contents.outside
::marker
is outside the principal block box.inside | outside
<ul class="inside">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="outside">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="inside-img">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>
.inside { list-style-position: inside; list-style-type: square; } .outside { list-style-position: outside; list-style-type: circle; } .inside-img { list-style-position: inside; list-style-image: url("https://mdn.mozillademos.org/files/11979/starsolid.gif"); }
Specification | Status | Comment |
---|---|---|
CSS Lists 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. |
Initial value | outside |
---|---|
Applies to | list items |
Inherited | yes |
Media | visual |
Computed value | as specified |
Animation type | discrete |
Canonical order | the unique non-ambiguous order defined by the formal grammar |
Desktop | ||||||
---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | |
Basic support | 1 | 12 | 1 | 4 | 3.5 | 1 |
Mobile | |||||||
---|---|---|---|---|---|---|---|
Android webview | Chrome for Android | Edge Mobile | Firefox for Android | Opera for Android | iOS Safari | Samsung Internet | |
Basic support | Yes | Yes | 12 | 4 | ? | ? | Yes |
© 2005–2018 Mozilla Developer Network and individual 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