Punktory niestandardowe w kodzie CSS ::marker

Adam Argyle

Oriol Brufau

CSS ::marker umożliwia zmienić treść oraz niektóre style punktorów i numerów na listach HTML.

Wprowadzenie do pseudoelementów

Pseudoelement reprezentuje część dokumentu, która nie jest uwzględniona w drzewo 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.

Rozważ następującą listę nieuporządkowaną w kodzie 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>

Co renderuje się w ten sposób ze stylem domyślnym:

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

Utwórz znacznik

Pole pseudoelementu ::marker jest automatycznie generowane w każdym element listy przed rzeczywistą treścią i elementem ::before pseudoelementu.

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

Określanie stylu znacznika

Zanim ::marker staną się dostępne, można było zmieniać styl list 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 dodaje możliwość zmiany koloru, rozmiaru i odstępów znaczników przez które umożliwiają kierowanie na pseudoelementy znaczników pojedynczo lub globalnie w CSS:

li::marker {
  color: hotpink;
}

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

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

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

Zmień zawartość pola ::marker za pomocą właściwości content, a nie list-style-type. następny przykład pokazuje, jak właściwości list-style-type mają zastosowanie do całego obiektu na liście, a ::marker umożliwia kierowanie reklam tylko na pole znacznika. Właściwość background działa z list-style-type, ale nie z ::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;
}

Zmiana zawartości znacznika

Oto kilka przykładowych sposobów określania stylu znaczników.

Zmień wszystkie elementy listy

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

/* OR */

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

Zmiana tylko jednego elementu 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>");
}

Zmień listy uporządkowane

A co z <ol>? Marker na elemencie uporządkowanej listy jest domyślnie liczbą, a nie kropką ani „strzałką”. W CSS są to Liczniki zdarzeń, i mają właściwości pozwalające ustawić lub zresetować miejsce, w którym liczba zaczyna się i kończy; i możesz je zamienić np. 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

Sekcja Narzędzia deweloperskie w Chrome ułatwia sprawdzanie, debugowanie i modyfikowanie stylów, do których stosujesz zasady ::marker pseudoelementów.

Zasoby

Więcej informacji o aplikacji ::marker znajdziesz w tych miejscach:

• Listy, znaczniki i liczniki w CSS z Smashing Magazine
• Liczenie za pomocą liczników CSS i siatki CSS z CSS-Tricks
• Korzystanie z liczników CSS z MDN