list-style-image

Время чтения: меньше 5 мин

Кратко

Секция статьи "Кратко"

Свойство устанавливает картинку в качестве маркера у списка.

Пример

Секция статьи "Пример"
        
          
          ul {  list-style-image: url("rocket.svg");}
          ul {
  list-style-image: url("rocket.svg");
}

        
        
          
        
      

Как пишется

Секция статьи "Как пишется"

Ключевые слова:

        
          
          .selector {  list-style-image: none;}
          .selector {
  list-style-image: none;
}

        
        
          
        
      

URL в качестве значения:

        
          
          .selector {  list-style-image: url("starsolid.gif");}
          .selector {
  list-style-image: url("starsolid.gif");
}

        
        
          
        
      

Подсказки

Секция статьи "Подсказки"

💡 Размером и положением маркера нельзя управлять, поэтому он будет равен размеру картинки и выровнен по базовой линии текста. Из этой особенности следует, что картинку-маркер следует заранее подготовить, подогнав под нужный размер.

Открыть демо в новой вкладке

💡 Это наследуемое свойство, поэтому чаще всего его задают тегу списка, чтобы все внутренние элементы унаследовали его. Но при желании каждому элементу списка <li> можно задать его индивидуально.

💡 Если по какой-то причине изображение не загрузится, будет показан маркер по умолчанию. Для <ol> это нумерация, для <ul> — маркер, соответствующий уровню вложенности.

💡 Согласно справочникам свойство не анимируется, но в некоторых браузерах (Chrome, Safari) есть поддержка плавной смены картинки с использованием transition.

        
          
          li {  list-style-image: url("marker.png");  transition: list-style-image 0.3s;}li:hover {  list-style-image: url("marker_hover.png");}
          li {
  list-style-image: url("marker.png");
  transition: list-style-image 0.3s;
}

li:hover {
  list-style-image: url("marker_hover.png");
}

        
        
          
        
      
Открыть демо в новой вкладке