CSS ::marker
ti consente di cambiare i contenuti e alcuni stili di elenchi puntati e numeri negli elenchi HTML.
Introduzione agli pseudo-elementi
Uno pseudo-elemento rappresenta una parte del documento non rappresentata nella struttura ad albero del documento. Ad esempio, puoi selezionare la prima riga di un paragrafo utilizzando
lo pseudo-elemento p::first-line
, anche se non esiste un elemento HTML che avvolga
la riga di testo.
Considera il seguente elenco non ordinato 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>
Il risultato è il seguente con lo stile predefinito:
Il punto all'inizio di ogni elemento <ul>
viene generato durante il rendering
dell'elenco e non ha un proprio elemento HTML. ::marker
è un
pseudo-elemento che rappresenta il punto o il numero all'inizio di un elemento
elenco ordinato.
Creare un indicatore
La casella di indicatore dell'elemento pseudo ::marker
viene generata automaticamente all'interno di ogni elemento dell'elenco, prima dei contenuti effettivi e dell'elemento pseudo ::marker
.::before
li::before {
content: "::before";
background: lightgray;
border-radius: 1ch;
padding-inline: 1ch;
margin-inline-end: 1ch;
}
Gli elementi dell'elenco sono in genere elementi HTML <li>
, ma puoi utilizzare display: list-item
per trasformare altri elementi in elementi dell'elenco.
<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;
}
Modificare lo stile di un indicatore
Prima che ::marker
fosse disponibile, potevi applicare uno stile agli elenchi utilizzando list-style-type
e list-style-image
per modificare il simbolo dell'elemento dell'elenco:
li {
list-style-image: url(/right-arrow.svg);
/* OR */
list-style-type: '👉';
padding-inline-start: 1ch;
}
::marker
aggiunge la possibilità di modificare il colore, le dimensioni e la spaziatura degli indicatori, consentendoti di scegliere come target gli pseudo-elementi degli indicatori singolarmente o a livello globale nel CSS:
li::marker {
color: hotpink;
}
li:first-child::marker {
font-size: 5rem;
}
::marker
offre un controllo molto maggiore sugli stili degli indicatori rispetto a list-style-type
, ma non funziona con tutte le proprietà CSS. Sono consentite le seguenti proprietà:
animation-*
transition-*
color
direction
font-*
content
unicode-bidi
white-space
Modifica i contenuti di un ::marker
utilizzando content
, non list-style-type
. L'esempio seguente mostra come le proprietà di list-style-type
si applicano all'intero elemento dell'elenco e come ::marker
ti consente di scegliere come target solo la casella dell'indicatore. La proprietà background
funziona con list-style-type
, ma non con ::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;
}
Modificare i contenuti di un indicatore
Ecco alcuni esempi di stili per gli indicatori.
Modificare tutti gli elementi dell'elenco
li {
list-style-type: "😍";
}
/* OR */
li::marker {
content: "😍";
}
Modificare una sola voce dell'elenco
li:last-child::marker {
content: "😍";
}
Definire gli indicatori con 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>");
}
Modificare gli elenchi ordinati
E un <ol>
? Per impostazione predefinita, l'indicatore di un elemento dell'elenco ordinato è un numero, non un punto o un "bullet". In CSS, si chiamano
Contatori,
e hanno proprietà per impostare o reimpostare l'inizio e la fine del numero oppure
passare, ad esempio, ai numeri romani. Puoi utilizzare ::marker
anche per applicare uno stile ai contatori e persino utilizzare il valore del contenuto dell'indicatore per creare la tua presentazione con numerazione.
li::marker {
content: counter(list-item) "› ";
color: hotpink;
}
Debug
Chrome DevTools può aiutarti a ispezionare, eseguire il debug e modificare gli stili applicati agli pseudo-elementi::marker
.
Risorse
Puoi scoprire di più su ::marker
da: