Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

round(): ajustar un valor a un intervalo elegido

Elige explícitamente la estrategia, especialmente con valores negativos y casos exactamente intermedios.

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

Sintaxis

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

La función round() redondea un valor a un múltiplo entero de un intervalo. Los argumentos deben tener tipos compatibles: se pueden redondear longitudes a longitudes, pero no a segundos. La estrategia predeterminada nearest elige el múltiplo más cercano; en un empate exacto elige hacia el infinito positivo. Las otras estrategias son up hacia el infinito positivo, down hacia el infinito negativo y to-zero hacia cero. Para entradas negativas, up y down no equivalen simplemente a aumentar o reducir la magnitud.

Con un intervalo de 10px, -15px se convierte en -10px para nearest, up y to-zero, pero en -20px para down. Un valor que ya es múltiplo queda intacto. Un intervalo cero produce NaN: usa un intervalo no nulo adecuado. Un número sin unidad puede omitir el intervalo, que entonces vale 1; las dimensiones normalmente necesitan un intervalo explícito. El borrador actual también define line-width para longitudes con un ajuste especial a píxeles, pero esta estrategia más reciente necesita su propia comprobación de compatibilidad.

El ejemplo mide márgenes calculados para las cuatro estrategias establecidas y ambos signos del caso intermedio: 15px positivo se convierte en 20px. También conserva -20px exactos y rechaza mezclar px con s. Chromium 157 devuelve false para la sintaxis probada round(line-width, 1.3px). Esta limitación de implementación no invalida la función del borrador ni impide que funcionen las estrategias establecidas.

Ejemplos

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)'));

Resultado

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

Los resultados muestran que up significa hacia el infinito positivo, no alejarse de cero. La prueba separada de line-width es un resultado de compatibilidad, no una demostración ejecutada del ajuste a píxeles.

Fuentes