counter()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die counter() CSS Funktion gibt einen String zurück, der den aktuellen Wert des benannten Zählers (Counter) darstellt, falls ein solcher vorhanden ist.
Die counter() Funktion wird üblicherweise innerhalb von Pseudo-Elementen durch die content Eigenschaft verwendet. Theoretisch kann sie jedoch überall dort eingesetzt werden, wo ein <string> Wert unterstützt wird.
Probieren Sie es aus
.double-list {
counter-reset: count -1;
}
.double-list li {
counter-increment: count 2;
}
.double-list li::marker {
content: counter(count, decimal) ") ";
}
<p>Best Dynamic Duos in Sports:</p>
<ol class="double-list">
<li>Simone Biles + Jonathan Owens</li>
<li>Serena Williams + Venus Williams</li>
<li>Aaron Judge + Giancarlo Stanton</li>
<li>LeBron James + Dwyane Wade</li>
<li>Xavi Hernandez + Andres Iniesta</li>
</ol>
Syntax
/* Basic usage */
counter(counter-name);
/* changing the counter display */
counter(counter-name, upper-roman)
Zähler haben von sich aus keine sichtbare Wirkung. Die counter() und counters() Funktionen machen die Zähler nützlich, indem sie vom Entwickler definierte Strings (oder Bilder) zurückgeben.
Werte
Die counter() Funktion akzeptiert bis zu zwei Parameter. Der erste Parameter ist der <counter-name>. Der optionale zweite Parameter ist der <counter-style>.
<counter-name>-
Ein
<custom-ident>, das den Zähler identifiziert. Dies ist der gleiche, fallunterscheidende Name, der mit den Eigenschaftswertencounter-resetundcounter-incrementverwendet wird. Der Zählername darf nicht mit zwei Strichen beginnen und darf nichtnone,unset,initialoderinheritsein. <counter-style>-
Ein
<list-style-type>Name,<@counter-style>Name odersymbols()Funktion, bei der ein Zählerstilname ein vordefinierternumeric,alphabeticodersymbolicZählerstil ist, ein komplexer langschriftlicher ostasiatischer oder äthiopischer vordefinierter Zählerstil oder ein anderer vordefinierter Zählerstil. Wenn ausgelassen, wird der Zählerstil standardmäßig aufdecimalgesetzt.
Hinweis:
Um die Zählerwerte beim Verschachteln von Zählern zu verbinden, verwenden Sie die counters() Funktion, die einen zusätzlichen <string> Parameter bereitstellt.
Formale Syntax
<counter()> =
counter( <counter-name> , <counter-style>? )
<counter-style> =
<counter-style-name> |
<symbols()>
<symbols()> =
symbols( <symbols-type>? [ <string> | <image> ]+ )
<symbols-type> =
cyclic |
numeric |
alphabetic |
symbolic |
fixed
<image> =
<url> |
<image()> |
<image-set()> |
<cross-fade()> |
<element()> |
<gradient>
<image()> =
image( <image-tags>? [ <image-src>? , <color>? ]! )
<image-set()> =
image-set( <image-set-option># )
<cross-fade()> =
cross-fade( <cf-image># )
<element()> =
element( <id-selector> )
<image-tags> =
ltr |
rtl
<image-src> =
<url> |
<string>
<image-set-option> =
[ <image> | <string> ] [ <resolution> || type( <string> ) ]?
<cf-image> =
[ <image> | <color> ] &&
<percentage [0,100]>?
<id-selector> =
<hash-token>
Beispiele
>lower-roman im Vergleich zu lower-alpha
In diesem Beispiel zeigen wir einen Zähler mit lower-roman und lower-alpha Listenstilen an.
HTML
<ol>
<li></li>
<li></li>
<li></li>
</ol>
CSS
ol {
counter-reset: count;
}
li {
counter-increment: count;
}
li::after {
content:
"[" counter(count, lower-roman) "] == ["
counter(count, lower-alpha) "]";
}
Ergebnis
Anzeige eines Zählers mit drei Stilen
In diesem Beispiel verwenden wir die counter() Funktion dreimal.
HTML
<ol>
<li></li>
<li></li>
<li></li>
</ol>
CSS
Wir integrieren die counter() Funktion mit drei verschiedenen Zählerstilen, einschließlich des Standardwerts decimal. Wir haben Padding zur Liste hinzugefügt, um Platz für den langen ::marker String zu schaffen.
ol {
counter-reset: listCounter;
padding-left: 5em;
}
li {
counter-increment: listCounter;
}
li::marker {
content:
"Item #" counter(listCounter) " is: ";
}
li::after {
content:
"[" counter(listCounter, decimal-leading-zero) "] == ["
counter(listCounter, upper-roman) "]";
}
Ergebnis
Spezifikationen
| Specification |
|---|
| CSS Lists and Counters Module Level 3> # counter-functions> |
| CSS Counter Styles Level 3> # extending-css2> |
Browser-Kompatibilität
Siehe auch
- CSS-Zähler verwenden
counter-resetcounter-setcounter-increment@counter-style- CSS
counters()Funktion - CSS Listen und Zähler Modul
- CSS Zählerstile Modul
- CSS generierter Inhalt Modul