Punktory niestandardowe w kodzie CSS ::marker

Dostosowywanie koloru, rozmiaru lub typu liczby albo punktora podczas korzystania z <ul> czy <ol> jest teraz proste.

Adam Argyle
Oriol Brufau
Oriol Brufau
GitHub

Dzięki sponsorowanym przez Bloombergiem Igalii możemy w końcu odłożyć obecny styl na listy stylistyczne. Zobacz!

Wyświetl źródło

Dzięki CSS ::marker możemy zmieniać treść oraz niektóre style punktorów i numerów.

Zgodność z przeglądarką

Usługa ::marker jest obsługiwana w przeglądarce Firefox na komputerach, urządzeniach z Androidem, w Safari na komputery i w przeglądarce iOS (ale tylko w przypadku właściwości color i font-*, zobacz Błąd 204163) oraz w przeglądarkach opartych na Chromium i komputerach z Androidem.

Obsługa przeglądarek

  • 86
  • 86
  • 68
  • 11.1

Źródło

Pseudoelementy

Zwróć uwagę na tę nieuporządkowaną listę zasadniczą 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>

W rezultacie powoduje to niezaskakujące renderowanie:

Kropka na początku każdego produktu <li> jest bezpłatna. Przeglądarka rysuje i tworzy wygenerowane pole znacznika.

Dzisiaj zajmiemy się pseudoelementem ::marker, który umożliwia zmianę stylu elementu listy punktowanego tworzonego przez przeglądarkę.

Tworzenie znacznika

Pole znacznika pseudoelementu ::marker jest generowane automatycznie w każdym elemencie listy, poprzedzając rzeczywistą treść i pseudoelement ::before.

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

Zazwyczaj elementy listy są elementami HTML <li>, ale inne elementy mogą też stać się elementami listy z atrybutem display: list-item.

<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

Do ::marker można zmieniać styl list za pomocą elementów list-style-type i list-style-image, aby zmienić symbol elementu listy za pomocą 1 wiersza kodu CSS:

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

To przydatne, ale potrzebujemy więcej. A co z kolorem, rozmiarem, odstępami itp.? ::marker przychodzi z pomocą. Umożliwia indywidualne i globalne kierowanie tych pseudoelementów z CSS:

li::marker {
  color: hotpink;
}

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

Właściwość list-style-type daje bardzo ograniczone możliwości określania stylu. Pseudoelement ::marker oznacza, że możesz kierować reklamy bezpośrednio na znacznik i stosować do niego style. Dzięki temu masz znacznie większą kontrolę.

Pamiętaj jednak, że w elemencie ::marker nie możesz używać wszystkich właściwości CSS. Lista właściwości dozwolonych i niedozwolonych jest wyraźnie określona w specyfikacji. Jeśli spróbujesz z tym pseudoelementem coś interesującego, a coś się nie uda, z listy poniżej dowiesz się, co można, a czego nie można zrobić w CSS:

Dozwolone właściwości ::marker CSS

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

Zmiana zawartości elementu ::marker odbywa się za pomocą content, a nie list-style-type. W tym przykładzie styl pierwszego elementu ma postać list-style-type, a drugi – ::marker. Właściwości z pierwszego przypadku dotyczą całego elementu listy, a nie tylko znacznika, co oznacza, że tekst jest animowany tak samo jak znacznik. Gdy używasz funkcji ::marker, możemy kierować reklamy tylko na pole znacznika, a nie na tekst.

Pamiętaj też, że niedozwolona właściwość background nie powoduje żadnych skutków.

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;
}
Różne wyniki między znacznikiem a elementem 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;
}
Szczegółowe wyniki między znacznikiem a elementem listy


Zmienianie zawartości znacznika

Oto kilka sposobów na zmianę stylu znaczników.

Zmienianie wszystkich pozycji listy

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

/* OR */

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

Zmiana tylko jednego elementu listy

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

Zmiana elementu listy na 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>");
}

Zmienianie list numerowanych Co jednak z <ol>? Znacznik elementu listy uporządkowanej jest domyślnie liczbą, a nie punktorem. W CSS są one nazywane licznikami i są bardzo skuteczne. Mają nawet właściwości, które można ustawić i resetować, w których zaczyna się i koniec numer, lub przełączać je na cyfry rzymskie. Czy możemy dodać styl? Tak. Możemy nawet użyć wartości znacznika do utworzenia własnej prezentacji numeracji.

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

Debugowanie

Narzędzia deweloperskie w Chrome pomogą Ci sprawdzać, debugować i modyfikować style stosowane do pseudoelementów ::marker.

Otwierają się narzędzia deweloperskie i wyświetlają style powiązane z klientem użytkownika i stylami użytkownika

Przyszłe style pseudoelementowe

Więcej informacji na temat ::marker znajdziesz w tych miejscach:

Dobrze jest mieć dostęp do czegoś, co było trudne do wypracowania. Możesz dodać styl do innych elementów generowanych automatycznie. Może frustrować Cię funkcja <details> lub wskaźnik autouzupełniania danych wyszukiwania, które nie działają w ten sam sposób w różnych przeglądarkach. Jednym ze sposobów udostępniania potrzebnych danych jest utworzenie żądania na stronie https://webwewant.fyi.