Zähler (Counter)

Der Print-Styleguide implementiert eine statische Variante der CSS-Counter. Mit diesen ist derzeit bspw. möglich die aktuelle sowie die gesamte Seitenanzahl auszugeben und auch eigene Zähler zu definieren. Alle Optionen der Zähler werden über das HTML-Attribut data-print-counter definiert. Darin befindet sich eine über Leerzeichen getrennte Liste von den einzelnen auszuführenden Aktionen. Ein Zähler wird immer über seinen Identifikator angesprochen, welcher nur aus Kleinbuchstaben von A bis Z und Zahlen bestehen darf.

Erstellen/Zurücksetzen eines Zählers

Bevor ein Zähler ausgegeben oder verändert werden kann, muss dieser definiert werden. Folgende Defnition wird hierfür innerhalb des HTML-Attributs data-print-counter genutzt:

reset:[Identifikator des Zählers]=[Initialwert] // Beispiel: reset:page=0

Verändern eines Zählers

Der Wert eines defniertern Zählers kann vergrößert oder verkleinert werden. Hierzu muss folgenden Definition innerhalb des HTML-Attributs eingehalten werden:

increment:[Identifikator des Zählers][+|-][Wert] // Beispiel: increment:page+1 oder increment:page-4

Ausgeben eines Zählerwertes

Der aktuelle Wert eines Zählers kann über die nachfolgende Definition innerhalb des Elements ausgegeben werden, welches das HTML-Attribut besitzt. Hierzu wird der Inhalt des Elements mit dem Wert des Zählers ersetzt.

output:[Identifikator des Zählers]



Platzhalter für Zählerausgabe

Spezieller Zähler page und pages

Diese beiden Zähler sind standardmäßig vorhanden. Der Zähler page enthält die aktuelle Nummer der Seite auch welcher sich das ansprechende Element befindet. Der Zähler pages enthält wiederrum immer die gesamte Anzahl an Seiten des aktuellen Dokuments.