Articles
Introdução ao CSS
Propriedades CSS relacionadas a listas

Propriedades CSS relacionadas a listas

Este artigo explica as propriedades CSS relacionadas a listas.

Você pode aprender como usar e escrever a propriedade list-style e a função counter().

YouTube Video

HTML para Visualização

css-list.html 
  1<!DOCTYPE html>
  2<html lang="en">
  3<head>
  4    <meta charset="UTF-8">
  5    <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6    <title>CSS Properties Example</title>
  7    <link rel="stylesheet" href="css-base.css">
  8    <link rel="stylesheet" href="css-list.css">
  9</head>
 10<body>
 11    <!-- Header -->
 12    <header>
 13        <h1>List Related CSS Properties</h1>
 14    </header>
 15
 16    <!-- Main content -->
 17    <main>
 18        <header>
 19            <h2>List Related Properties</h2>
 20        </header>
 21        <article>
 22            <h3>list-style</h3>
 23            <section>
 24                <header><h4>list-style-type: circle; list-style-position: inside;</h4></header>
 25                <section class="sample-view">
 26                    <h5>Unordered List (ul)</h5>
 27                    <ul>
 28                        <li>Item 1</li>
 29                        <li>Item 2</li>
 30                        <li>Item 3</li>
 31                    </ul>
 32                </section>
 33                <header><h4>list-style: upper-roman outside</h4></header>
 34                <section class="sample-view">
 35                    <h5>Ordered List (ol)</h5>
 36                    <ol>
 37                        <li>First</li>
 38                        <li>Second</li>
 39                        <li>Third</li>
 40                    </ol>
 41                </section>
 42                <header><h4>list-style-image: url('custom-bullet.png')</h4></header>
 43                <section class="sample-view">
 44                    <h5>Custom Bullet List</h5>
 45                    <ul class="custom-list">
 46                        <li>Custom Item 1</li>
 47                        <li>Custom Item 2</li>
 48                        <li>Custom Item 3</li>
 49                    </ul>
 50                </section>
 51            </section>
 52        </article>
 53        <article>
 54            <h3>counter()</h3>
 55            <section>
 56                <header><h4>CSS</h4></header>
 57<pre class="sample">
 58dl {
 59    counter-reset: item;
 60}
 61
 62dl dt::before {
 63    counter-increment: item; /* Increment the counter */
 64    content: counter(item) ". "; /* Display the counter */
 65}
 66</pre>
 67                <header><h4>HTML</h4></header>
 68<pre>
 69&lt;dl&gt;
 70    &lt;dt&gt;Term A&lt;/dt&gt;
 71    &lt;dd&gt;Explication for term A&lt;/dd&gt;
 72    &lt;dt&gt;Term B&lt;/dt&gt;
 73    &lt;dd&gt;Explication for term B&lt;/dd&gt;
 74    &lt;dt&gt;Term C&lt;/dt&gt;
 75    &lt;dd&gt;Explication for term C&lt;/dd&gt;
 76&lt;/dl&gt;
 77</pre>
 78                <header><h4>HTML+CSS</h4></header>
 79                <section class="sample-view">
 80                    <dl>
 81                        <dt>Term A</dt>
 82                        <dd>Explication for term A</dd>
 83                        <dt>Term B</dt>
 84                        <dd>Explication for term B</dd>
 85                        <dt>Term C</dt>
 86                        <dd>Explication for term C</dd>
 87                    </dl>
 88                </section>
 89            </section>
 90        </article>
 91        <article>
 92            <h3>counters()</h3>
 93            <section>
 94                <header><h4>CSS</h4></header>
 95<pre class="sample">
 96ol {
 97    list-style: none;
 98    counter-reset: list-counter;
 99}
100
101li {
102    counter-increment: list-counter;
103}
104
105li::before {
106    content: counters(list-counter, ".") " ";
107}
108</pre>
109                <header><h4>HTML</h4></header>
110<pre>
111&lt;ol&gt;
112    &lt;li&gt;Item A
113        &lt;ol&gt;
114            &lt;li&gt;Subitem A-1&lt;/li&gt;
115            &lt;li&gt;Subitem A-2&lt;/li&gt;
116        &lt;/ol&gt;
117    &lt;/li&gt;
118    &lt;li&gt;Item B
119        &lt;ol&gt;
120            &lt;li&gt;Subitem B-1&lt;/li&gt;
121        &lt;/ol&gt;
122    &lt;/li&gt;
123&lt;/ol&gt;
124</pre>
125                <header><h4>HTML+CSS</h4></header>
126                <section class="sample-view">
127                    <ol>
128                        <li>Item A
129                            <ol>
130                                <li>Subitem A-1</li>
131                                <li>Subitem A-2</li>
132                            </ol>
133                        </li>
134                        <li>Item B
135                            <ol>
136                                <li>Subitem B-1</li>
137                            </ol>
138                        </li>
139                    </ol>
140                </section>
141            </section>
142            <section>
143                <header><h4>CSS</h4></header>
144<pre class="sample">
145article {
146    counter-reset: chapter;
147}
148h1.chapter {
149    counter-increment: chapter;
150    counter-reset: section;
151}
152h1.chapter::before {
153    content: counter(chapter) " ";
154}
155h2.section {
156    counter-increment: section;
157    counter-reset: sub-section;
158}
159h2.section::before {
160    content: counters(chapter, ".") "." counter(section) " ";
161}
162h3.sub-section {
163    counter-increment: sub-section;
164}
165h3.sub-section::before {
166    content: counters(chapter, ".") "." counter(section) "." counter(sub-section) " ";
167}
168</pre>
169                <header><h4>HTML</h4></header>
170<pre>
171&lt;h1 class=&quot;chapter&quot;&gt;Chapter A&lt;/h1&gt;
172&lt;h2 class=&quot;section&quot;&gt;Section A-1&lt;/h2&gt;
173&lt;h3 class=&quot;sub-section&quot;&gt;Subsection A-1-1&lt;/h3&gt;
174&lt;h3 class=&quot;sub-section&quot;&gt;Subsection A-1-2&lt;/h3&gt;
175
176&lt;h2 class=&quot;section&quot;&gt;Section A-2&lt;/h2&gt;
177&lt;h3 class=&quot;sub-section&quot;&gt;Subsection A-2-1&lt;/h3&gt;
178
179&lt;h1 class=&quot;chapter&quot;&gt;Chapter B&lt;/h1&gt;
180&lt;h2 class=&quot;section&quot;&gt;Section B-1&lt;/h2&gt;
181&lt;h3 class=&quot;sub-section&quot;&gt;Subsection B-1-1&lt;/h3&gt;
182</pre>
183                <header><h4>HTML+CSS</h4></header>
184                <section class="sample-view">
185                    <h1 class="chapter">Chapter A</h1>
186                    <h2 class="section">Section A-1</h2>
187                    <h3 class="sub-section">Subsection A-1-1</h3>
188                    <h3 class="sub-section">Subsection A-1-2</h3>
189
190                    <h2 class="section">Section A-2</h2>
191                    <h3 class="sub-section">Subsection A-2-1</h3>
192
193                    <h1 class="chapter">Chapter B</h1>
194                    <h2 class="section">Section B-1</h2>
195                    <h3 class="sub-section">Subsection B-1-1</h3>
196                </section>
197            </section>
198        </article>
199    </main>
200</body>
201</html>

Relacionado a listas

Propriedade list-style 

 1ul {
 2    list-style-type: circle; /* Empty circle bullets */
 3    list-style-position: inside; /* Position bullets inside the content area */
 4}
 5
 6ol {
 7    /* Uppercase Roman numerals with bullets positioned outside */
 8    list-style: upper-roman outside;
 9}
10
11.custom-list {
12    list-style-image: url('custom-bullet.png'); /* Custom image bullets */
13}

A propriedade list-style é uma propriedade CSS usada para especificar o estilo dos marcadores de lista (pontos ou números) para elementos de lista HTML, como <ul> e <ol>. Esta propriedade permite controlar o estilo geral da lista, sendo útil para personalizar a aparência das listas.

Neste exemplo, os seguintes estilos são aplicados.

  • ul: Pontos em forma de círculos ocos são exibidos internamente.
  • ol: Numerado com algarismos romanos maiúsculos e os números são exibidos externamente.
  • Classe custom-list: A imagem especificada é exibida como marcador.

Estrutura list-style

list-style é uma abreviação para as três propriedades a seguir:

  • list-style-type: Especifica o tipo de marcador (ponto ou número) para itens de lista.
  • list-style-position: Especifica se o marcador é colocado dentro (inside) ou fora (outside) do item da lista.
  • list-style-image: Especifica uma imagem a ser usada como marcador da lista.

Uso Básico 

1ul {
2    list-style: square inside url('path/to/image.png');
3}

Este código funciona da seguinte forma:

  • list-style-type: square: Define o tipo de marcador como um quadrado.
  • list-style-position: inside: O marcador é exibido dentro do item da lista.
  • list-style-image: url('path/to/image.png'): Usa uma imagem como marcador.

Explicação das Propriedades Individuais

list-style-type

list-style-type especifica o tipo de marcador para a lista. Os estilos disponíveis dependem do tipo de lista.

Exemplo de valor 
 1ul {
 2    /* Change list bullets to empty circles */
 3    list-style-type: circle;
 4}
 5
 6ol {
 7    /* Number list items with lowercase letters (a, b, c, ...) */
 8    list-style-type: lower-alpha;
 9}
10
11ol.roman-list {
12    /* Number list items with uppercase roman numerals (I, II, III, ...) */
13    list-style-type: upper-roman;
14}
  • none: Nenhum marcador é exibido.
  • disc (padrão): Um pequeno círculo preto.
  • circle: Um pequeno círculo vazio (anel).
  • square: Um pequeno quadrado.
  • decimal: Uma lista numerada como 1, 2, 3, ....
  • lower-alpha: Alfabeto em minúsculas como a, b, c, ....
  • upper-alpha: Alfabeto em maiúsculas como A, B, C, ....
  • lower-roman: Números romanos em minúsculas como i, ii, iii, ....
  • upper-roman: Números romanos em maiúsculas como I, II, III, ....
list-style-position 
1ul {
2    list-style-position: inside;
3}

A propriedade list-style-position especifica se o marcador (bullet) é colocado fora ou dentro do item da lista. O list-style-position pode ter os seguintes valores:.

  • outside: Os marcadores são colocados fora do item da lista, e o item começa após o marcador. Este é o valor padrão.
  • inside: Os marcadores são colocados dentro do item da lista e exibidos como parte do texto.
list-style-image 
1ul {
2    list-style-image: url('bullet.png'); /* Use an image as the list marker */
3}

A propriedade list-style-image é definida ao usar uma imagem como marcador da lista. A imagem é especificada usando url(), e se a imagem não puder ser carregada, o marcador especificado por list-style-type será exibido.

Propriedade abreviada list-style 

1ul {
2    list-style: square inside url('bullet.png');
3}

A propriedade list-style é uma propriedade abreviada que pode definir list-style-type, list-style-position e list-style-image de uma só vez. A ordem é flexível, mas geralmente é escrita como neste exemplo. Neste caso, um marcador quadrado é exibido dentro do item da lista, e uma imagem é exibida como marcador.

Resumo

  • list-style é uma propriedade abreviada que permite especificar a aparência da lista (tipo de marcador, posição, imagem personalizada) de uma só vez.
  • Também é possível definir list-style-type, list-style-position e list-style-image individualmente.
  • Você pode personalizar de forma flexível os marcadores da lista de acordo com o layout e o design.

Contador CSS (counter()) 

 1/* Reset the counter */
 2dl {
 3    counter-reset: item;
 4}
 5
 6/* Apply the counter to list items */
 7dl dt::before {
 8    counter-increment: item; /* Increment the counter */
 9    content: counter(item) ". "; /* Display the counter */
10}

Você pode usar contadores CSS para numerar automaticamente itens de lista ou elementos específicos.

Criando e Inicializando Contadores 

1/* Create and initialize the counter */
2ol {
3  counter-reset: section; /* Set the counter name to 'section' */
4}

Você pode criar um contador e redefini-lo com a propriedade counter-reset.

Incrementando Contadores 

1/* Increment the counter and display it */
2li::before {
3  counter-increment: section; /* Increment the counter by 1 */
4  content: counter(section) ". "; /* Display the counter value */
5}

Você incrementa um contador com a propriedade counter-increment e exibe o valor do contador com a função counter.

counters()

A função counters no CSS é muito útil para gerenciar contadores personalizados, como numeração de itens de lista ou ordenação de parágrafos. Esta função pode concatenar vários valores de contador com uma string e exibí-los no conteúdo CSS. Aqui, explicaremos em detalhes desde o uso básico da função counters até exemplos de aplicação prática.

Diferenças entre counter e counters

Ambas as funções counter e counters são usadas para exibir valores de contador, mas possuem as seguintes diferenças.

  • counter: Recupera o valor de um único contador.
  • counters: Concatena vários valores de contadores com um separador especificado e os exibe.

Por exemplo, se você quiser usar contadores com itens de lista aninhados, pode usar a função counters para exibi-los concatenando os contadores pai e filho.

Sintaxe da Função counters 

counters(<counter-name>, <string>);

A função counters é usada com a seguinte sintaxe.

  • <counter-name>: Especifica o nome do contador a ser usado.
  • <string>: Especifica a string a ser inserida entre cada contador (geralmente um separador como . ou -).

Exemplo de uso da função counters

Agora, vamos ver um exemplo de uso da função counters.

 1ol {
 2    list-style: none;
 3    counter-reset: list-counter;
 4}
 5
 6li {
 7    counter-increment: list-counter;
 8}
 9
10li::before {
11    content: counters(list-counter, ".") " ";
12}
  • Neste exemplo, os contadores pai e filho são concatenados para uma lista aninhada de dois níveis.
    • O contador list-counter está sendo definido.
    • A função counters é usada para concatenar e exibir o contador da lista pai e o contador da lista filha.

Exemplo avançado usando contadores de múltiplos níveis

Usando a função counters, você pode gerenciar de forma flexível contadores de múltiplos níveis, como numeração personalizada ou numeração de parágrafos. Por exemplo, é útil ao criar documentos que incluem capítulos e seções.

 1article {
 2    counter-reset: chapter;
 3}
 4
 5h1.chapter {
 6    font-size: 1.2rem;
 7    counter-increment: chapter;
 8    counter-reset: section;
 9}
10
11h1.chapter::before {
12    content: counter(chapter) " ";
13}
14
15h2.section {
16    font-size: 1.1rem;
17    counter-increment: section;
18    counter-reset: sub-section;
19}
20
21h2.section::before {
22    content: counters(chapter, ".") "." counter(section) " ";
23}
24
25h3.sub-section {
26    font-size: 1rem;
27    counter-increment: sub-section;
28}
29
30h3.sub-section::before {
31    content: counters(chapter, ".") "." counter(section) "." counter(sub-section) " ";
32}

Neste código, os contadores para capítulos (h1), seções (h2) e subseções (h3) são reiniciados, e a função counters é usada para concatenar cada nível.

Resumo

A função counters é muito útil quando você deseja personalizar e exibir múltiplos contadores hierarquicamente. Usando contadores CSS, você pode personalizar livremente a numeração de listas e títulos, proporcionando às páginas da web uma estrutura informacional avançada.

Você pode acompanhar o artigo acima usando o Visual Studio Code em nosso canal do YouTube. Por favor, confira também o canal do YouTube.

YouTube Video

Propriedades de CSS relacionadas à decoração do modelo de caixaPropriedades de CSS relacionadas a tabelas