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

CKTIS / CSS

counters() — chemin de compteurs imbriqués

`counters()` formate tous les compteurs de même nom, du plus externe au plus interne, puis joint leurs représentations avec le séparateur fourni.

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

Syntaxe

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

counters() formate tous les compteurs de même nom, du plus externe au plus interne, puis joint leurs représentations avec le séparateur fourni.

L’exemple crée la valeur externe 2 et la valeur interne 4. counters(section, ".") peint trois glyphes correspondant à 2.4, alors que counter(section) ne montre que 4, la valeur interne ; les largeurs mesurées confirment la hiérarchie.

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

Le séparateur est une chaîne obligatoire et le style facultatif vaut decimal par défaut. L’ordre est toujours externe puis interne, ce qui convient aux numéros de section. Un compteur absent est instancié à 0 ; un counter-reset accidentel sur un descendant ajoute un niveau et peut allonger le chemin.

Exemples

const style = document.createElement('style');
style.textContent = '.outer{counter-reset:section 2}.inner{counter-reset:section 4}.path,.leaf{display:inline-block;font:20px monospace}.path::before{content:counters(section, ".")}.leaf::before{content:counter(section)}';
const outer = document.createElement('div'); outer.className = 'outer';
const inner = document.createElement('div'); inner.className = 'inner';
const path = document.createElement('span'); path.className = 'path';
const leaf = document.createElement('span'); leaf.className = 'leaf';
document.head.append(style); inner.append(path, leaf); outer.append(inner); document.body.append(outer);
const pathWidth = path.getBoundingClientRect().width;
const leafWidth = leaf.getBoundingClientRect().width;
console.log('path-glyphs=' + Math.round(pathWidth / leafWidth) + '; leaf-glyphs=1; width-ratio=' + (pathWidth / leafWidth).toFixed(2));

Résultat

path-glyphs=3; leaf-glyphs=1; width-ratio=3.00

`counters()` formate tous les compteurs de même nom, du plus externe au plus interne, puis joint leurs représentations avec le séparateur fourni.

Sources