Marcadores personalizados com CSS ::marker

Agora é fácil personalizar a cor, o tamanho ou o tipo de número ou marcador ao usar <ul> ou <ol>.

Graças à Igalia, patrocinada pela Bloomberg, podemos finalmente guardar dicas para criar listas de estilo. Viu!

Exibir código-fonte

Graças ao CSS ::marker, podemos mudar o conteúdo e alguns dos estilos de marcadores e números.

Compatibilidade com navegadores

O ::marker é compatível com o Firefox para computador e Android, com o Safari e o iOS do iOS (mas apenas as propriedades color e font-*, consulte Bug 204163) e navegadores de computadores e Android baseados no Chromium.

Compatibilidade com navegadores

  • 86
  • 86
  • 68
  • 11.1

Origem

Pseudoelementos

Considere a seguinte lista HTML essencial 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>

O que resulta na seguinte renderização não surpreendente:

O ponto no início de cada item de <li> é sem custo financeiro. O navegador está desenhando e criando uma caixa de marcador gerada para você.

Hoje, vamos falar sobre o pseudoelemento ::marker, que permite definir o estilo do elemento de marcador que os navegadores criam para você.

Criar um marcador

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

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

Normalmente, os itens de lista são elementos HTML <li>, mas outros elementos também podem se tornar itens de lista com 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;
}

Definir o estilo de um marcador

Até ::marker, as listas podem ser estilizadas usando list-style-type e list-style-image para alterar o símbolo do item da lista com uma linha de CSS:

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

Isso é útil, mas precisamos de mais. Que tal mudar a cor, o tamanho, o espaçamento etc.? É aí que ::marker vem para ajudar. Ela permite o direcionamento individual e global desses pseudoelementos do CSS:

li::marker {
  color: hotpink;
}

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

A propriedade list-style-type oferece possibilidades de estilo muito limitadas. O pseudoelemento ::marker significa que é possível segmentar o próprio marcador e aplicar estilos diretamente a ele. Isso oferece muito mais controle.

Não é possível usar todas as propriedades de CSS em um ::marker. A lista de propriedades que são permitidas ou não está indicada claramente na especificação. Se você tentar algo interessante com este pseudoelemento e não funcionar, a lista abaixo contém o guia sobre o que pode ou não ser feito com o CSS:

Propriedades CSS ::marker permitidas

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

A mudança do conteúdo de uma ::marker é feita com content, e não com list-style-type. No exemplo a seguir, o primeiro item é estilizado usando list-style-type e o segundo com ::marker. As propriedades no primeiro caso se aplicam a todo o item da lista, não apenas ao marcador, o que significa que o texto e o marcador são animados. Ao usar ::marker, podemos segmentar apenas a caixa do marcador, e não o texto.

Além disso, observe como a propriedade background não permitida não tem efeito.

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;
}
Resultados mistos entre o marcador e 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;
}
Resultados focados entre o marcador e o item da lista


Alterar o conteúdo de um marcador

Veja algumas maneiras de definir o estilo dos seus marcadores.

Como mudar todos os itens da lista

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

/* OR */

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

Como mudar apenas um item da lista

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

Como mudar um item da lista para 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>");
}

Como mudar listas numeradas Mas e a <ol>? Por padrão, o marcador em um item da lista ordenada é um número, não um marcador. Em CSS, eles são chamados de contadores e são bastante eficientes. Além disso, eles têm propriedades para definir e redefinir o ponto de início e término do número ou mudar para numerais romanos. Podemos estilizar isso? Sim, e podemos até usar o valor do conteúdo do marcador para criar nossa própria apresentação de numeração.

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

Depuração

O Chrome DevTools está pronto para ajudar você 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

Estilo futuro dos pseudoelementos

Saiba mais sobre ::marker em:

É ótimo ter acesso a algo que nunca foi tão difícil de estilizar. Você pode estilizar outros elementos gerados automaticamente. <details> ou o indicador de preenchimento automático da entrada de pesquisa podem incomodar os usuários, que não são implementados da mesma forma em todos os navegadores. Uma maneira de compartilhar o que você precisa é criando um desejo em https://webwewant.fyi.