Marcadores personalizados com CSS ::marker

Adam Argyle
Oriol Brufau
Oriol Brufau
GitHub

Compatibilidade com navegadores

  • 86
  • 86
  • 68
  • 11.1

Origem

O ::marker CSS permite mudar o conteúdo e alguns dos estilos de marcadores e números em listas HTML.

Exemplos de estilos de marcador. Ver código-fonte

Introdução aos pseudoelementos

Um pseudoelemento representa uma parte do documento que não está representada na árvore do documento. Por exemplo, é possível selecionar a primeira linha de um parágrafo usando o pseudoelemento p::first-line, mesmo que não haja um elemento HTML encapsulando essa linha de texto.

Considere a seguinte lista HTML não ordenada:

<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>

Ela é renderizada da seguinte forma com o estilo padrão:

O ponto no início de cada elemento <ul> é gerado como parte da renderização da lista e não tem o próprio elemento HTML. ::marker é um pseudoelemento que representa esse ponto ou o número no início de um elemento de lista ordenada.

Criar um marcador

A caixa de marcador de pseudoelemento ::marker é gerada automaticamente dentro de cada elemento de item da lista, antes do conteúdo real e do pseudoelemento ::before.

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

Os itens de lista geralmente são elementos HTML <li>, mas você pode usar display: list-item para transformar outros elementos em itens de lista.

<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;
}

Definir o estilo de um marcador

Antes de ::marker ser disponibilizado, era possível definir o estilo das listas usando list-style-type e list-style-image para mudar o símbolo do item da lista:

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

::marker permite mudar a cor, o tamanho e o espaçamento dos marcadores, permitindo segmentar pseudoelementos do marcador individualmente ou globalmente no CSS:

li::marker {
  color: hotpink;
}

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

::marker oferece muito mais controle sobre os estilos de marcador do que list-style-type, mas não funciona com todas as propriedades CSS. As seguintes propriedades são permitidas:

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

Mude o conteúdo de uma ::marker usando content, e não list-style-type. O próximo exemplo mostra como as propriedades de list-style-type se aplicam a todo o item da lista, e ::marker permite segmentar apenas a caixa do marcador. A propriedade background funciona com list-style-type, mas não com ::marker.

Listar estilos
li:nth-child(1) {
  list-style-type: '?';
  font-size: 2rem;
  background: hsl(200 20% 88%);
  animation: color-change 3s ease-in-out infinite;
}
A estilização afeta todo o item da lista.
Estilos de marcadores
li:nth-child(2)::marker {
  content: '!';
  font-size: 2rem;
  background: hsl(200 20% 88%);
  animation: color-change 3s ease-in-out infinite;
}
Com a estilização do marcador, você se concentra no elemento.


Alterar o conteúdo de um marcador

Confira alguns exemplos de formas de definir o estilo dos seus marcadores.

Alterar todos os itens da lista

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

/* OR */

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

Alterar apenas um item da lista

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

Definir marcadores com 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>");
}

Alterar listas ordenadas

Mas e um <ol>? O marcador em um item da lista ordenada é um número por padrão, não um ponto ou "marcador". No CSS, eles são chamados de contadores e têm propriedades para definir ou redefinir onde o número começa e termina, ou para alternar para, por exemplo, numerais romanos. Você também pode usar ::marker para estilizar contadores e até mesmo usar o valor do conteúdo do marcador para criar sua própria apresentação de numeração.

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

Depuração

O Chrome DevTools cab ajuda a inspecionar, depurar e modificar os estilos aplicados aos pseudoelementos ::marker.

DevTools abre e mostra estilos do user agent e dos estilos do usuário
Descrições dos estilos de marcador do DevTools.

Recursos

Saiba mais sobre ::marker em: