Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

counter() — valeur d’un compteur

`counter()` transforme la valeur la plus interne d’un compteur CSS nommé en texte ou image selon le style de compteur choisi.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

counter( <counter-name>, <counter-style>? )

counter() transforme la valeur la plus interne d’un compteur CSS nommé en texte ou image selon le style de compteur choisi.

L’exemple rend counter(step) sous la forme 7 et counter(step, decimal-leading-zero) sous la forme 07 ; la largeur double du second pseudo-élément prouve que le zéro initial appartient bien au contenu généré.

Grammaire: counter( <counter-name>, <counter-style>? ).

Le second argument est facultatif et vaut decimal par défaut. La fonction lit le compteur le plus proche de ce nom, pas tous les niveaux réunis, et le nom ne peut pas être none. Si le compteur manque, le navigateur l’instancie à 0. Employez-la dans le contenu généré ou les marqueurs avec des réinitialisations et incréments maîtrisés.

Exemples

const style = document.createElement('style');
style.textContent = '.plain,.padded{display:inline-block;font:20px monospace}.plain{counter-reset:step 7}.padded{counter-reset:step 7}.plain::before{content:counter(step)}.padded::before{content:counter(step, decimal-leading-zero)}';
const plain = document.createElement('span'); plain.className = 'plain';
const padded = document.createElement('span'); padded.className = 'padded';
document.head.append(style); document.body.append(plain, padded);
const one = plain.getBoundingClientRect().width;
const two = padded.getBoundingClientRect().width;
console.log('decimal-glyphs=' + Math.round(one / (one || 1)) + '; leading-zero-glyphs=' + Math.round(two / (one || 1)) + '; width-ratio=' + (two / one).toFixed(2));

Résultat

decimal-glyphs=1; leading-zero-glyphs=2; width-ratio=2.00

`counter()` transforme la valeur la plus interne d’un compteur CSS nommé en texte ou image selon le style de compteur choisi.

Sources