Typography
list-style-image
Replacing the list item marker with an image.
Overview
| Class | Declarations |
|---|---|
list-style-image:url(<…>) | list-style-image: url(<…>);
|
list-style-image:linear-gradient(<…>) | list-style-image: linear-gradient(<…>);
|
list-style-image:radial-gradient(<…>) | list-style-image: radial-gradient(<…>);
|
list-style-image:repeating-linear-gradient(<…>) | list-style-image: repeating-linear-gradient(<…>);
|
list-style-image:repeating-radial-gradient(<…>) | list-style-image: repeating-radial-gradient(<…>);
|
list-style-image:conic-gradient(<…>) | list-style-image: conic-gradient(<…>);
|
Examples
Use an image marker
Use list-style-image:url(*) when each list item should use an image marker.
<ul class="list-style-image:url(/marker.svg)"> <li>Custom marker</li></ul>Generated CSS
@layer utilities { .list-style-image\:url\(\/marker\.svg\) { list-style-image: url(/marker.svg) }}Use a gradient marker
Gradient functions can also be used when a generated marker is more appropriate than an asset.
<ul class="list-style-image:linear-gradient(var(--color-blue-60)|var(--color-blue-40))"> <li>Gradient marker</li></ul>Fall back to type markers
Use list-style:disc or another type utility when image markers are not desired in a condition.
<ul class="list-style-image:url(/marker.svg) list-style:disc@print"> <li>Printable marker</li></ul>Apply conditionally
Apply styles based on different states using selectors and conditional queries.
<ul class="list-style-image:url(/marker.svg):hover list-style:disc@sm list-style:disc@print">...</ul>