CSS list-style-type: como definir marcadores e numeração de listas

list-style-type define o marcador ou o formato do número exibido antes de cada item de uma lista. Use <ol> quando a ordem for importante e <ul> quando os itens puderem aparecer em qualquer ordem. Para começar no número três, adicione start="3" ao <ol>.

Como escolher o tipo de marcador

disc, circle e square exibem círculo preenchido, círculo vazio e quadrado. decimal e lower-roman exibem numeração decimal e romana minúscula. none oculta o marcador textual padrão.

O valor inicial da propriedade é disc. A folha de estilos do navegador costuma definir decimal para <ol>. Veja o valor calculado no item para confirmar a regra que está em vigor.

ol.steps { list-style-type: lower-roman; }
ul.topics { list-style-type: square; }

Exemplo completo para abrir no navegador

Salve o código completo em list-style-type.html com codificação UTF-8 e abra o arquivo no navegador. As classes permitem alterar cada lista de forma independente.

<!doctype html>
<html lang="pt-BR">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Etapas / Tópicos</title>
  <style>
    .steps, .topics { padding-inline-start: 2em; }
    ol.steps { list-style-type: lower-roman; }
    ul.topics { list-style-type: square; }
  </style>
</head>
<body>
  <h1>Etapas</h1>
  <ol class="steps">
    <li>Salve o arquivo</li>
    <li>Abra o arquivo</li>
  </ol>
  <h2>Tópicos</h2>
  <ul class="topics">
    <li>HTML</li>
    <li>CSS</li>
  </ul>
</body>
</html>

A lista de etapas mostra i. e ii.. A lista de tópicos usa marcadores quadrados.

  1. Na regra de .steps, troque lower-roman por decimal e depois por none. Confira que a ordem dos itens permanece a mesma e restaure lower-roman.
  2. Adicione start="3" ao <ol>. A lista passa a mostrar iii. e iv.. Remova o atributo para começar em um novamente.

Padrão HTML para listas ordenadas

Herança, imagens e a propriedade abreviada

Os itens geralmente herdam o valor da lista. Uma lista aninhada pode receber seu próprio valor da folha de estilos do navegador. Para herdar o estilo da lista externa, aplique uma regra específica como .features ul { list-style-type: inherit; }.

Uma imagem válida em list-style-image ou content explícito em ::marker pode fornecer o marcador exibido. A declaração list-style: inside restaura ao valor inicial o tipo e a imagem omitidos. Para alterar apenas a posição, use list-style-position: inside.

Especificação do W3C sobre marcadores de lista

O que conferir quando o marcador desaparece

  1. Selecione o <li> afetado nas ferramentas de desenvolvedor. Confira display e list-style-type. Se display: flex eliminar a caixa que gera o marcador, aplique Flexbox a um contêiner dentro do item.
  2. Desative as regras de imagem e de ::marker uma por vez. Se os valores estiverem corretos, confira o espaçamento do lado inicial e o overflow dos elementos ancestrais. O marcador externo pode ficar cortado quando falta espaço.

Mantenha a numeração quando o leitor precisar usar os números para seguir os passos. Em alguns contextos, o Safari pode deixar de representar uma lista sem marcadores como lista na árvore de acessibilidade. Confira o ambiente de uso e adicione role="list" quando necessário. Notas de acessibilidade da MDN