CSS свойство list-style-image

Определение и применение

CSS свойство list-style-image позволяет задать изображение в качестве маркера элемента списка.

Попробуйте значения list-style-image

Вместо стандартного маркера используется маленький красный ромб. При none работает list-style-type: disc. Изображение встроено и не загружается с внешнего сервера.

Значение свойства

list-style-image: none

HTML и CSS примера
HTML
<ul class="demo-target">
  <li>Структура страницы</li>
  <li>Оформление длинного пункта списка на нескольких строках</li>
  <li>Поведение элементов</li>
</ul>
CSS
.demo-target {
  box-sizing: border-box;
  width: 100%;
  max-width: 300px;
  padding: 16px 16px 16px 42px;
  border: 2px solid #245a85;
  background: #fff3d6;
  color: #172c3d;
  font: 18px/1.5 system-ui;
  margin: 0;
  --marker: url("data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 width=%2212%22 height=%2212%22%3E%3Cpath fill=%22%23b53625%22 d=%22M6 0 12 6 6 12 0 6Z%22/%3E%3C/svg%3E");
  list-style-image: none;
}

Поддержка браузерами

Спецификация: CSS lists

Поддерживается во всех основных браузерах с 2015 года.

Показать браузеры
Совместимостьcss.properties.list-style-image
ВозможностьКомпьютерыМобильные
ChromeEdgeFirefoxOperaSafariChrome AndroidFirefox for AndroidOpera AndroidSafari on iOSSamsung BrowserWebView AndroidWebView on iOS
list-style-image✓1✓12✓1✓7✓1✓18✓4✓10.1✓1✓1.0✓4.4✓1
none✓1✓12✓1✓15✓1✓18✓4✓14✓1✓1.0✓4.4✓1

поддерживаетсяс ограниченияминет поддержкинет данных≤31 — не позднее версии 31

CSS синтаксис:

CSS
list-style-image: <image> | none;

/* Глобальные значения */
list-style-image: initial | inherit | unset | revert | revert-layer;

| — выбор варианта.

JavaScript синтаксис:

JavaScript
element.style.listStyleImage = "url('loshad.jpg')";

Начальное значение свойства

none.

Значения свойства

Значения list-style-image
Значение Описание
none Изображение не будет отображаться, тип маркера элемента списка определяется значением свойства list-style-type. Начальное значение.
url Задает путь к изображению для использования в качестве маркера элемента списка.
initial Устанавливает начальное значение свойства.
inherit Наследует вычисленное значение свойства у родительского элемента.
unset Для наследуемого свойства list-style-image наследует вычисленное значение у родительского элемента.
revert Отменяет заданное в коде значение свойства для этого элемента: применяются пользовательские или стандартные стили браузера. Если они не задают значение, свойство наследуется или получает начальное значение по обычным правилам. Не возвращает значение из предыдущей строки CSS.
revert-layer Сбрасывает значение свойства для текущего слоя каскада @layer. Применяется значение из другого слоя по правилам каскада; если подходящего значения нет, возможен откат к стилям пользователя или браузера.

Спецификация

CSS Lists and Counters — спецификация list-style-image.

Наследуется

Да.

Анимируемое

Тип анимации — дискретный: значение переключается без плавных промежуточных положений.

Примеры, попробуйте сами

Изображение маркера

Замените url(...) на none: появится обычный маркер. Картинка хранится рядом с примером; HTML списка не меняется.

base.css
CSS
* {
    box-sizing: border-box;
}
body {
    margin: 16px;
    font:
        16px/1.5 system-ui,
        sans-serif;
    color: #172c3d;
}
section {
    margin-bottom: 24px;
    min-width: 0;
}
h3 {
    margin: 0 0 12px;
    font-size: 16px;
}
.item {
    padding: 8px;
    min-width: 0;
    background: #c5dbea;
    border: 1px solid #35658a;
    overflow-wrap: anywhere;
}
ul {
    padding-left: 32px;
}
index.html
HTML
<!doctype html>
<html lang="ru">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width,initial-scale=1" />
    <title>Изображение маркера</title>
  </head>
  <body>
    <ul class="sample">
      <li>Первый пункт</li>
      <li>Второй пункт</li>
    </ul>
  </body>
</html>
style.css
CSS
.sample {
    list-style-image: url('assets/mini5.png');
}