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

CKTIS / CSS

log() — logarithmes et domaine de définition

Calculez un logarithme naturel ou choisissez sa base, puis transformez le résultat numérique en une valeur CSS utile.

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

Syntaxe

log(A)
log(A, B)
transform: translateX(calc(log(8, 2) * 1px));

log() indique à quelle puissance élever une base pour obtenir un nombre. Dans log(A, B), les deux arguments doivent se résoudre en <number> ; sans base explicite, la fonction utilise e. Ainsi, log(8, 2) vaut 3, log(e) vaut 1 et log(8, 0.5) vaut −3. Pour obtenir une longueur, multipliez le résultat par une unité, comme dans calc(log(8, 2) * 1px).

Pour les logarithmes finis ordinaires, utilisez une entrée positive et une base positive différente de 1. Une base comprise entre 0 et 1 est valide. Une entrée négative ou une base égale à 1 produit un résultat non numérique ; zéro et les infinis suivent des règles particulières de la spécification. Une longueur ne peut pas servir directement d’entrée, et un résultat fractionnaire ne constitue pas un décompte entier.

CSS.supports() vérifie la prise en charge d’une déclaration, pas l’utilité mathématique de ses entrées. La déclaration de l’exemple avec une entrée négative est donc acceptée, bien que le calcul produise NaN. Validez les données dynamiques, prévoyez une solution de repli pour les anciens navigateurs et ne généralisez pas un test unique à tous les appareils.

Exemples

const box = document.createElement('div');
document.body.append(box);
function offset(expression) {
  box.style.transform = 'translateX(calc(' + expression + ' * 1px))';
  return Number(new DOMMatrix(getComputedStyle(box).transform).m41.toFixed(6));
}
console.log('base2:', offset('log(8, 2)'));
console.log('natural:', offset('log(e)'));
console.log('fractional base:', offset('log(8, 0.5)'));
console.log('one:', offset('log(1)'));
console.log('length argument:', CSS.supports('width', 'calc(log(8px) * 1px)'));
console.log('negative argument parses:', CSS.supports('width', 'calc(log(-1) * 1px)'));
box.remove();

Résultat

base2: 3
natural: 1
fractional base: -3
one: 0
length argument: false
negative argument parses: true

Le JavaScript affiché lit de véritables déplacements CSS pour quatre cas finis, arrondis à six décimales. Il vérifie séparément la syntaxe et les types ; aucun résultat NaN n’est rendu ni mesuré.

Sources