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

CKTIS / CSS

rem(): um resto com o sinal do primeiro argumento

Calcule um resto com tipo e distinga-o de mod() e da unidade rem relativa ao tipo de letra raiz.

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

Sintaxe

transform: translateX(rem(-17.5px, 4px));

A função rem(A, B) subtrai ao primeiro argumento um múltiplo inteiro do segundo. Para argumentos finitos e um divisor diferente de zero, um resultado não nulo tem o sinal de A e valor absoluto inferior ao de B. Os dois cálculos devem ter um tipo numérico CSS compatível, que o resultado mantém. Esta função não está relacionada com a unidade do tipo de letra raiz em 2rem.

Ao contrário de rem(), mod() dá ao resultado não nulo o sinal do divisor. Um ciclo positivo costuma precisar da segunda função; um deslocamento que preserve o sinal pode precisar da primeira. Um divisor zero ou um primeiro argumento infinito produz NaN, não um resto normal. Um resultado positivo de CSS.supports() confirma apenas a aceitação da sintaxe da declaração, sem tornar estes casos excecionais numericamente válidos.

O exemplo mede deslocamentos horizontais reais. Com uma entrada negativa, o resto é -1.5px e o módulo 2.5px; com entrada positiva e divisor negativo, o resto é 1.5px. Um múltiplo exato dá zero. Misturar comprimentos com segundos é rejeitado, mas a declaração com divisor zero é aceite sintaticamente. Isto não mede o tratamento final de NaN específico de cada propriedade.

Exemplos

const box = document.createElement('div');
document.body.append(box);
function distance(expression) {
  box.style.transform = 'translateX(' + expression + ')';
  return new DOMMatrix(getComputedStyle(box).transform).m41;
}
console.log('negative input:', distance('rem(-17.5px,4px)'));
console.log('same input with mod:', distance('mod(-17.5px,4px)'));
console.log('negative divisor:', distance('rem(17.5px,-4px)'));
console.log('exact multiple:', distance('rem(12px,4px)'));
console.log('incompatible units:', CSS.supports('width', 'rem(12px,4s)'));
console.log('zero divisor parses:', CSS.supports('width', 'rem(12px,0px)'));
box.remove();

Resultado

negative input: -1.5
same input with mod: 2.5
negative divisor: 1.5
exact multiple: 0
incompatible units: false
zero divisor parses: true

Os valores vêm das matrizes de transformação calculadas no Chromium 157. A prova do divisor zero verifica apenas a sintaxe e não apresenta NaN como um deslocamento válido.

Fontes