Punktory niestandardowe w kodzie CSS ::marker

Obsługa przeglądarek

  • Chrome: 86.
  • Edge: 86.
  • Firefox: 68.
  • Safari: 11.1.

Źródło

CSS ::marker umożliwia zmianę treści i niektórych stylów wypunktowania oraz numeracji na listach HTML.

przykłady stylów wypunktowania. Wyświetl źródło

Wprowadzenie do pseudoelementów

Pseudoelement reprezentuje część dokumentu, która nie jest reprezentowana w strukturze dokumentu. Możesz na przykład za pomocą pseudoelementu p::first-line wybrać pierwszy wiersz akapitu, mimo że nie ma elementu HTML otaczającego ten wiersz tekstu.

Weź pod uwagę tę nieuporządkowaną listę 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>

Wyświetla się on w ten sposób:

Kropka na początku każdego elementu <ul> jest generowana w ramach renderowania listy i nie ma własnego elementu HTML. ::marker to pseudoelement reprezentujący tę kropkę lub liczbę na początku elementu listy uporządkowanej.

Tworzenie znacznika

Pole znacznika pseudoelementu ::marker jest automatycznie generowane w ramach każdego elementu listy przed rzeczywistą zawartością i pseudoelementem ::before.

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

Elementy listy to zwykle elementy HTML <li>, ale za pomocą elementu display: list-item możesz przekształcać inne elementy w elementy listy.

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

Stylizowanie znacznika

Zanim funkcja ::marker została udostępniona, można było stylizować listy za pomocą list-style-type i list-style-image, aby zmienić symbol elementu listy:

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

::marker umożliwia zmianę koloru, rozmiaru i odstępów znaczników, pozwalając na kierowanie na pseudoelementy znaczników indywidualnie lub globalnie w pliku CSS:

li::marker {
 
color: hotpink;
}

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

::marker zapewnia znacznie większą kontrolę nad stylami znaczników niż list-style-type, ale nie działa z każdą właściwością CSS. Dozwolone są te właściwości:

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

Zmień zawartość pliku ::marker za pomocą polecenia content, a nie list-style-type. Następujący przykład pokazuje, jak właściwości list-style-type dotyczą całego elementu listy, a ::marker umożliwia kierowanie tylko na pole znacznika. Właściwość background działa z list-style-type, ale nie z ::marker.

Wyświetlanie listy stylów
li:nth-child(1) {
 
list-style-type: '?';
 
font-size: 2rem;
 
background: hsl(200 20% 88%);
 
animation: color-change 3s ease-in-out infinite;
}
Stylistyka listy ma wpływ na cały element listy.
Style znaczników
li:nth-child(2)::marker {
 
content: '!';
 
font-size: 2rem;
 
background: hsl(200 20% 88%);
 
animation: color-change 3s ease-in-out infinite;
}
Stylizacja znacznika pozwala skupić się na nim.


Zmiana zawartości znacznika

Oto kilka przykładowych sposobów stylizowania znaczników.

Zmień wszystkie elementy listy

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

/* OR */

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

Zmień tylko jeden element listy

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

Definiowanie znaczników za pomocą pliku 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>");
}

Zmiana list uporządkowanych

A co z <ol>? Marker na elemencie uporządkowanej listy jest domyślnie liczbą, a nie kropką ani „strzałką”. W CSS nazywa się je licznikami. Mają one właściwości, które umożliwiają ustawienie lub zresetowanie początkowego i końcowego zakresu liczby lub przełączenie się na cyfry rzymskie. Możesz też używać ::marker do stylizowania liczników, a nawet wartości zawartości znacznika do tworzenia własnych numeracji.

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

Debugowanie

Narzędzia deweloperskie w Chrome ułatwiają sprawdzanie, debugowanie i modyfikowanie stylów zastosowanych do ::markerpseudoelementów.

Narzędzia deweloperskie są otwarte i wyświetlają style z klienta użytkownika oraz stylów użytkownika
Opis stylów znaczników w Narzędziach deweloperskich.

Zasoby

Więcej informacji o ::marker znajdziesz tutaj: