Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

round(): ajustar um valor a um intervalo escolhido

Escolhe explicitamente a estratégia, sobretudo para valores negativos e casos exatamente a meio.

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

Sintaxe

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

A função round() arredonda um valor para um múltiplo inteiro de um intervalo. Os argumentos têm de ter tipos compatíveis: comprimentos podem ser arredondados para comprimentos, mas não para segundos. A estratégia predefinida nearest escolhe o múltiplo mais próximo; num empate exato, escolhe no sentido do infinito positivo. As outras estratégias são up para o infinito positivo, down para o infinito negativo e to-zero para zero. Para entradas negativas, up e down não equivalem simplesmente a aumentar ou diminuir o valor absoluto.

Com um intervalo de 10px, -15px torna-se -10px com nearest, up e to-zero, mas -20px com down. Um valor já múltiplo mantém-se inalterado. Um intervalo nulo produz NaN: usa um intervalo não nulo adequado. Um número sem unidade pode omitir o intervalo, que passa a ser 1; grandezas dimensionais normalmente exigem um intervalo explícito. O projeto atual também define line-width para comprimentos com um ajuste especial aos píxeis, mas esta estratégia mais recente precisa de uma verificação de compatibilidade própria.

O exemplo mede margens calculadas para as quatro estratégias estabelecidas e ambos os sinais do caso intermédio: 15px positivo torna-se 20px. Também preserva -20px exatos e rejeita misturar px com s. O Chromium 157 devolve false para a sintaxe testada round(line-width, 1.3px). Esta limitação da implementação não torna inválida a funcionalidade do projeto nem impede o funcionamento das estratégias estabelecidas.

Exemplos

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

Os resultados mostram que up significa no sentido do infinito positivo, não afastar-se de zero. A verificação separada de line-width é um resultado de compatibilidade, não uma demonstração executada de ajuste aos píxeis.

Fontes