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

CKTIS / CSS

cubic-bezier() — curva de temporização personalizada

`cubic-bezier()` relaciona o progresso de entrada com o de saída através de dois pontos de controlo de uma curva de Bézier cúbica.

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

Sintaxe

cubic-bezier( [ <number [0,1]>, <number> ]#{2} )

cubic-bezier() relaciona o progresso de entrada com o de saída através de dois pontos de controlo de uma curva de Bézier cúbica.

O exemplo pausa animações reais a meio do tempo: cubic-bezier(0.25, 0.1, 0.25, 1) desloca o elemento até 80.24px, enquanto cubic-bezier(0.3, 1.5, 0.7, 1.5) atinge 125px, revelando a ultrapassagem permitida. cubic-bezier(-0.1, 0, 1, 1) é inválida porque a primeira coordenada x está fora do intervalo.

Gramática: cubic-bezier( [ <number [0,1]>, <number> ]#{2} ).

As duas coordenadas x têm de pertencer a [0,1] para cada instante ter uma saída inequívoca. y1 e y2 não têm esse limite e podem levar o valor além dos extremos. Os pontos finais são fixos em (0,0) e (1,1); o progresso de entrada é a coordenada x da curva, não o parâmetro t.

Exemplos

const makeBox = () => { const box = document.createElement('div'); box.style.cssText = 'width:10px;height:10px'; document.body.append(box); return box; };
const sample = easing => {
  const box = makeBox();
  const animation = box.animate([{transform:'translateX(0px)'},{transform:'translateX(100px)'}],{duration:1000,fill:'both',easing});
  animation.pause(); animation.currentTime = 500;
  const matrix = new DOMMatrix(getComputedStyle(box).transform);
  animation.cancel(); box.remove();
  return matrix.m41;
};
const easeMid = sample('cubic-bezier(0.25,0.1,0.25,1)');
const overshootMid = sample('cubic-bezier(0.3,1.5,0.7,1.5)');
const invalidX = CSS.supports('animation-timing-function','cubic-bezier(-0.1,0,1,1)');
console.log('ease-mid=' + easeMid.toFixed(2) + '; overshoot-mid=' + overshootMid.toFixed(2) + '; invalid-x=' + invalidX);

Resultado

ease-mid=80.24; overshoot-mid=125.00; invalid-x=false

`cubic-bezier()` relaciona o progresso de entrada com o de saída através de dois pontos de controlo de uma curva de Bézier cúbica.

Fontes