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

CKTIS / CSS

round() : ajuster une valeur à un intervalle choisi

Choisis explicitement une stratégie, surtout pour les valeurs négatives et les cas exactement à mi-chemin.

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

Syntaxe

margin-left: round(nearest, -15px, 10px);

La fonction round() arrondit une valeur à un multiple entier d’un intervalle. Les arguments doivent avoir des types compatibles : une longueur peut être arrondie à une longueur, pas à des secondes. La stratégie par défaut nearest choisit le multiple le plus proche ; à égalité exacte, elle choisit vers l’infini positif. Les autres stratégies sont up vers l’infini positif, down vers l’infini négatif et to-zero vers zéro. Pour les valeurs négatives, up et down ne signifient pas simplement augmenter ou réduire la valeur absolue.

Avec un intervalle de 10px, -15px devient -10px pour nearest, up et to-zero, mais -20px pour down. Une valeur déjà multiple reste inchangée. Un intervalle nul produit NaN : utilise donc un intervalle non nul pertinent. Pour un nombre sans unité, l’intervalle peut être omis et vaut alors 1 ; les dimensions exigent normalement un intervalle explicite. Le projet actuel définit aussi line-width pour les longueurs avec un ajustement particulier aux pixels ; cette stratégie plus récente nécessite un contrôle de compatibilité distinct.

L’exemple mesure les marges calculées pour les quatre stratégies établies et les deux signes du cas médian : 15px positif devient 20px. Il conserve aussi -20px exact et rejette le mélange de px et s. Chromium 157 renvoie false pour la syntaxe testée round(line-width, 1.3px). Cette limite d’implémentation ne rend pas invalide la fonction du projet et n’empêche pas les stratégies établies de fonctionner.

Exemples

const box=document.createElement('div');document.body.append(box);
const read=value=>{box.style.marginLeft='0px';box.style.marginLeft=value;return getComputedStyle(box).marginLeft};
for(const mode of ['nearest','up','down','to-zero'])console.log(mode+'='+read('round('+mode+', -15px, 10px)'));
console.log('positive-tie='+read('round(15px, 10px)')+'; exact='+read('round(-20px, 10px)'));
console.log('mixed-types='+CSS.supports('margin-left','round(15px, 2s)')+'; line-width='+CSS.supports('border-width','round(line-width, 1.3px)'));

Résultat

nearest=-10px
up=-10px
down=-20px
to-zero=-10px
positive-tie=20px; exact=-20px
mixed-types=false; line-width=false

Les résultats montrent que up signifie vers l’infini positif, pas en s’éloignant de zéro. Le test distinct de line-width est un résultat de compatibilité, pas une démonstration exécutée d’ajustement aux pixels.

Sources