The list-style-image
CSS property sets an image to be used as the list item marker.
It is often more convenient to use the shorthand list-style
.
The list-style-image
CSS property sets an image to be used as the list item marker.
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.
/* Keyword values */ list-style-image: none; /* <url> values */ list-style-image: url("starsolid.gif"); /* valid image values */ list-style-image: linear-gradient(to left bottom, red, blue); /* Global values */ list-style-image: inherit; list-style-image: initial; list-style-image: revert; list-style-image: revert-layer; list-style-image: unset;
<image>
A valid image to use as the marker.
none
Specifies that no image is used as the marker. If this value is set, the marker defined in list-style-type
will be used instead.
Initial value | none |
---|---|
Applies to | list items |
Inherited | yes |
Computed value | |
Animation type | discrete |
list-style-image =
<image> |
none
<image> =
<url> |
<gradient>
<url> =
url( <string> <url-modifier>* ) |
src( <string> <url-modifier>* )
<ul> <li>Item 1</li> <li>Item 2</li> </ul>
ul { list-style-image: url("starsolid.gif"); }
<ul> <li>Item 1</li> <li>Item 2</li> </ul>
ul { font-size: 200%; list-style-image: linear-gradient(to left bottom, red, blue); }
Specification |
---|
CSS Lists and Counters Module Level 3 # image-markers |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
list-style-image |
1 | 12 | 1Before Firefox 86, this property did not accept an<image> type, and required the URL of an image. |
4 | 7 | 1 | 4.4 | 18 | 4Before Firefox 86, this property did not accept an<image> type, and required the URL of an image. |
10.1 | 1 | 1.0 |
list-style
, list-style-type
, list-style-position
url()
function
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/list-style-image