list-style-image

Устанавливает адрес изображения, которое служит в качестве маркера списка. Это свойство наследуется, поэтому для отдельных элементов списка для восстановления маркера используется значение none.

Краткая информация

Значение по умолчанию none
Наследуется Да
Применяется К элементам <dd>, <dt>, <li>, <ol> и <ul>, а также ко всем элементам, у которых указано displaylist-item
Анимируется Нет

Синтаксис

list-style-image: none | url(<адрес>)
Описание Пример
<тип> Указывает тип значения. <размер>
A && B Значения должны выводиться в указанном порядке. <размер> && <цвет>
A | B Указывает, что надо выбрать только одно значение из предложенных (A или B). normal | small-caps
A || B Каждое значение может использоваться самостоятельно или совместно с другими в произвольном порядке. width || count
[ ] Группирует значения. [ crop || cross ]
* Повторять ноль или больше раз. [,<время>]*
+ Повторять один или больше раз. <число>+
? Указанный тип, слово или группа не является обязательным. inset?
{A, B} Повторять не менее A, но не более B раз. <радиус>{1,4}
# Повторять один или больше раз через запятую. <время>#

Значения

none
Отменяет изображение в качестве маркера для родительского элемента.
url
Относительный или абсолютный путь к графическому файлу. Значение можно указывать в одинарных, двойных кавычках или без них.

Пример

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>list-style-image</title> <style> ul { list-style-image: url(/example/image/mathematics.png); } </style> </head> <body> <ul> <li>Легко проверить, что аффинное преобразование монотонно.</li> <li>Доказательство решительно стабилизирует отрицательный криволинейный интеграл, явно демонстрируя всю чушь вышесказанного.</li> <li>Степенной ряд, в первом приближении, расточительно искажает многомерный лист Мёбиуса, откуда следует доказываемое равенство.</li> </ul> </body> </html>

Результат данного примера показан на рис. 1.

Применение свойства list-style-image

Рис. 1. Применение свойства list-style-image

Объектная модель

Объект.style.listStyleImage

Примечание

В разных браузерах расстояние между изображением и текстом может различаться.

В Internet Explorer до версии 7 включительно не отображаются маркеры, если для списка добавлено свойство float.

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

Спецификация Статус
CSS Lists and Counters Module Level 3 Рабочий проект
CSS Level 2 (Revision 1) Рекомендация

Браузеры

4 8 12 1 7 1 1
1 1 6 1

В таблице браузеров применяются следующие обозначения.

  • — элемент полностью поддерживается браузером;
  • — элемент браузером не воспринимается и игнорируется;
  • — при работе возможно появление различных ошибок, либо элемент поддерживается с оговорками.

Число указывает версию браузреа, начиная с которой элемент поддерживается.