Пользовательские маркеры с помощью CSS::marker

Адам Аргил
Ориоль Бруфау
Oriol Brufau
GitHub

Опубликовано: 2 сентября 2020 г.

Browser Support

  • Chrome: 86.
  • Край: 86.
  • Firefox: 68.
  • Safari: 11.1.

Source

CSS ::marker позволяет изменять содержимое и некоторые стили маркеров и нумерации в HTML-списках.

Примеры стилей маркированных списков. (См. исходный код)

Введение в псевдоэлементы

Псевдоэлемент представляет собой часть документа, которая не представлена ​​в дереве документа. Например, вы можете выделить первую строку абзаца с помощью псевдоэлемента p::first-line , даже если нет HTML-элемента, оборачивающего эту строку текста.

Рассмотрим следующий неупорядоченный HTML-список:

<ul>
  <li>Lorem ipsum dolor sit amet consectetur adipisicing elit</li>
  <li>Dolores quaerat illo totam porro</li>
  <li>Quidem aliquid perferendis voluptates</li>
  <li>Ipsa adipisci fugit assumenda dicta voluptates nihil reprehenderit
      consequatur alias facilis rem</li>
  <li>Fuga</li>
</ul>

В результате при использовании стилей по умолчанию отображается следующее:

Точка в начале каждого элемента <ul> генерируется в процессе рендеринга списка и не имеет собственного HTML-элемента. ::marker — это псевдоэлемент, представляющий эту точку или число в начале элемента упорядоченного списка.

Создать маркер

Псевдоэлемент ::marker обозначающий маркер, автоматически генерируется внутри каждого элемента списка, перед фактическим содержимым и псевдоэлементом ::before .

li::before {
  content: "::before";
  background: lightgray;
  border-radius: 1ch;
  padding-inline: 1ch;
  margin-inline-end: 1ch;
}

Элементы списка обычно представляют собой HTML-элементы <li> , но вы можете использовать display: list-item , чтобы превратить другие элементы в элементы списка.

<dl>
  <dt>Lorem</dt>
  <dd>Lorem ipsum dolor sit amet consectetur adipisicing elit</dd>
  <dd>Dolores quaerat illo totam porro</dd>

  <dt>Ipsum</dt>
  <dd>Quidem aliquid perferendis voluptates</dd>
</dl>

dd {
  display: list-item;
  list-style-type: "🤯";
  padding-inline-start: 1ch;
}

Стиль маркера

До появления ::marker можно было стилизовать списки с помощью list-style-type и list-style-image , изменяя символ элемента списка:

li {
  list-style-image: url(/right-arrow.svg);
  /* OR */
  list-style-type: '👉';
  padding-inline-start: 1ch;
}

::marker добавляет возможность изменять цвет, размер и расстояние между маркерами, позволяя выбирать псевдоэлементы-маркеры как по отдельности, так и глобально в CSS:

li::marker {
  color: hotpink;
}

li:first-child::marker {
  font-size: 5rem;
}

::marker предоставляет гораздо больший контроль над стилями маркеров, чем list-style-type , но он работает не со всеми свойствами CSS. Допускаются следующие свойства:

  • animation-*
  • transition-*
  • color
  • direction
  • font-*
  • content
  • unicode-bidi
  • white-space

Изменяйте содержимое ::marker используя content , а не list-style-type . В следующем примере показано, как свойства list-style-type применяются ко всему элементу списка, а ::marker позволяет выбрать только сам маркер. Свойство background работает со list-style-type , но не с ::marker .

Стили списков 
li:nth-child(1) {
  list-style-type: '?';
  font-size: 2rem;
  background: hsl(200 20% 88%);
  animation: color-change 3s ease-in-out infinite;
}
 Стилизация списка затрагивает весь элемент списка.
Стили маркеров 
li:nth-child(2)::marker {
  content: '!';
  font-size: 2rem;
  background: hsl(200 20% 88%);
  animation: color-change 3s ease-in-out infinite;
}
 Стилизация маркера позволяет сосредоточиться на самом маркере.


Изменить содержимое маркера

Вот несколько примеров того, как можно оформить ваши маркеры.

Изменить все элементы списка 

li {
  list-style-type: "😍";
}

/* OR */

li::marker {
  content: "😍";
}

Измените всего один пункт списка. 

li:last-child::marker {
  content: "😍";
}

Создание маркеров с помощью SVG 

li::marker {
  content: url(/heart.svg);
  content: url(#heart);
  content: url("data:image/svg+xml;charset=UTF-8,<svg xmlns='http://www.w3.org/2000/svg' version='1.1' height='24' width='24'><path d='M12 21.35l-1.45-1.32C5.4 15.36 2 12.28 2 8.5 2 5.42 4.42 3 7.5 3c1.74 0 3.41.81 4.5 2.09C13.09 3.81 14.76 3 16.5 3 19.58 3 22 5.42 22 8.5c0 3.78-3.4 6.86-8.55 11.54L12 21.35z' fill='none' stroke='hotpink' stroke-width='3'/></svg>");
}

Изменить упорядоченные списки

А что насчет <ol> ? Маркер элемента упорядоченного списка по умолчанию представляет собой число, а не точку или маркер. В CSS они называются счетчиками (Counters ), и у них есть свойства для установки или сброса начального и конечного положения числа, или, например, для замены его на римские цифры. Вы также можете использовать ::marker для стилизации счетчиков и даже использовать значение содержимого маркера для создания собственного представления нумерации. 

li::marker {
  content: counter(list-item) "› ";
  color: hotpink;
}

Отлаживать

Инструменты разработчика Chrome могут помочь вам проверять, отлаживать и изменять стили, применяемые к псевдоэлементам ::marker .

В открытых инструментах разработчика отображаются стили пользовательского агента и пользовательские стили.
Описание стилей маркеров в инструментах разработчика.

Ресурсы

Более подробную информацию о ::marker можно найти здесь: