База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / CSS

round(): закръгляване до избрана стъпка

Изберете стратегията за закръгляване изрично, особено за отрицателни стойности и случаи точно по средата.

Версия: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Синтаксис

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

Функцията round() закръгля стойност до цяло кратно на стъпката. Аргументите трябва да имат съвместими типове: дължини могат да се закръгляват до дължини, но не до секунди. Стратегията по подразбиране nearest избира по-близкото кратно; при равни разстояния избира в посока към положителната безкрайност. Другите стратегии са up към положителната безкрайност, down към отрицателната безкрайност и to-zero към нулата. При отрицателни входове up и down не означават просто увеличаване или намаляване на абсолютната стойност.

При стъпка 10px стойността -15px става -10px за nearest, up и to-zero, но -20px за down. Стойност, която вече е кратна на стъпката, остава непроменена. Нулева стъпка дава NaN, затова използвайте смислена ненулева стъпка. За число без единица стъпката може да се пропусне и тогава е 1; величините с единици обикновено изискват изрична стъпка. Текущият проект определя и line-width за дължини със специално подравняване към пиксели, но тази по-нова стратегия изисква отделна проверка на съвместимостта.

Примерът измерва изчислените външни отстъпи за четирите утвърдени стратегии и за двата знака на случая по средата: положителни 15px стават 20px. Запазва и точно -20px и отхвърля смесване на px със s. Chromium 157 връща false за проверения синтаксис round(line-width, 1.3px). Това ограничение на реализацията не прави проектната възможност невалидна и не пречи на утвърдените стратегии.

Примери

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

Резултат

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

Резултатите показват, че up означава към положителната безкрайност, а не отдалечаване от нулата. Отделната проба line-width проверява съвместимостта, а не демонстрира изпълнено подравняване към пиксели.

Източници