Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

round(): adattare un valore a un intervallo scelto

Scegli esplicitamente la strategia, soprattutto per i valori negativi e i casi esattamente a metà.

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

Sintassi

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

La funzione round() arrotonda un valore a un multiplo intero di un intervallo. Gli argomenti devono avere tipi compatibili: le lunghezze si arrotondano a lunghezze, non a secondi. La strategia predefinita nearest sceglie il multiplo più vicino; in caso di parità esatta sceglie verso l’infinito positivo. Le altre strategie sono up verso l’infinito positivo, down verso l’infinito negativo e to-zero verso zero. Per valori negativi, up e down non equivalgono semplicemente ad aumentare o ridurre il valore assoluto.

Con un intervallo di 10px, -15px diventa -10px per nearest, up e to-zero, ma -20px per down. Un valore già multiplo rimane invariato. Un intervallo nullo produce NaN: usa quindi un intervallo sensato diverso da zero. Per un numero senza unità l’intervallo può essere omesso e vale allora 1; le grandezze dimensionali normalmente richiedono un intervallo esplicito. La bozza attuale definisce anche line-width per lunghezze con uno speciale allineamento ai pixel, ma questa strategia più recente richiede una verifica di compatibilità separata.

L’esempio misura i margini calcolati per tutte le quattro strategie consolidate e i due segni del caso intermedio: 15px positivo diventa 20px. Conserva inoltre -20px esatti e rifiuta la combinazione di px e s. Chromium 157 restituisce false per la sintassi provata round(line-width, 1.3px). Questo limite dell’implementazione non invalida la funzionalità della bozza e non impedisce il funzionamento delle strategie consolidate.

Esempi

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

Risultato

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

I risultati mostrano che up significa verso l’infinito positivo, non allontanarsi da zero. La prova separata di line-width verifica la compatibilità e non dimostra un allineamento ai pixel effettivamente eseguito.

Fonti