~/discoveries/work 2026-11-21

La animación de 1 ms que nunca terminó

Una terminal tipeada en este sitio dejó 148 de 430 glifos invisibles aunque el navegador reportaba todas las animaciones como terminadas. El arreglo, la medición y un segundo problema con calc() y var().

  • css
  • animation
  • debugging
  • chromium

Síntoma

La página de inicio tiene una terminal que se escribe sola. Para lograr una revelación por carácter sin timers de JavaScript, cada glifo es un span con su propia animación CSS, retrasada según su índice. En mi máquina se veía bien y en otras mal: algunos caracteres nunca aparecían.

Conté en lugar de confiar en mis ojos. Tras la carga, 148 de 430 glifos tenían una opacidad calculada de 0. Lo raro es que element.getAnimations() reportaba esas mismas animaciones como terminadas.

El código que falló

antescss
.type-glyph {
  opacity: 0;
  animation: type-glyph 1ms steps(1) var(--d) forwards;
}

@keyframes type-glyph {
  to { opacity: 1; }
}

El estilo base oculta el glifo. La animación debía pasarlo a visible tras su retraso y mantener ese valor con forwards. Una duración de un milisegundo con un solo paso parecía la forma más barata de decir "enciéndete en el tiempo d".

Cómo lo medí

La verificación es un script corto ejecutado en la página después de la carga. Recorre cada glifo, lee la opacidad calculada y cuenta los que siguen en 0. También lo compara con el estado de la animación. Esta es la forma, no un archivo de test del repositorio.

js
const glyphs = [...document.querySelectorAll(".type-glyph")];
const hidden = glyphs.filter((g) => getComputedStyle(g).opacity === "0");
const finished = glyphs.filter((g) =>
  g.getAnimations().every((a) => a.playState === "finished"),
);
console.log({ total: glyphs.length, hidden: hidden.length, finished: finished.length });

Antes del arreglo esto imprimía 430 en total y 148 ocultos, con las animaciones reportadas como terminadas. Una animación terminada con un resultado oculto significa que el estado final de la animación no se aplicó al estilo calculado.

El arreglo

despuéscss
.type-glyph {
  animation: type-glyph 40ms linear var(--d) both;
}

@keyframes type-glyph {
  from { opacity: 0; }
}
  • Sin opacidad base. El elemento es visible por defecto, así que un glifo nunca puede quedar oculto por la falta de un efecto de animación.
  • El keyframe anima desde el valor oculto hasta el valor propio del elemento, así que el estado de reposo es el estilo normal, no un valor rellenado hacia adelante.
  • both también rellena hacia atrás, lo que mantiene el glifo oculto durante su retraso.
  • 40 ms linear en lugar de 1 ms steps(1). La revelación es un fundido corto y no un interruptor.

Mismo script, misma página: 0 de 430 ocultos.

Causa, como hipótesis. No verifiqué nada de esto en el código fuente de Chromium. Una: con una duración de 1 ms y muchas animaciones empezando en los mismos frames, una animación puede llegar a su final entre actualizaciones de estilo, y un fill forwards del keyframe final puede no aplicarse sobre la base opacity: 0. Dos: la base opacity: 0 y un fill forwards son dos declaraciones separadas que deben ganar en la cascada, y quité esa dependencia en lugar de probar cuál lado perdía. El arreglo funciona; la explicación es una conjetura.

Un segundo problema, el mismo día

El tipeo línea por línea usaba una animación por línea, con su duración calculada a partir de la cantidad de caracteres.

css
.type-line {
  animation: type calc(var(--chars) * var(--type-step, 20ms)) steps(var(--chars), end) var(--delay, 0ms) both;
}

Una línea de 10 caracteres tenía --type-step: 90ms fijado inline en el mismo elemento, así que esperaba 0.9 s. La animation-duration calculada fue 0.2 s, que es 10 veces el fallback de 20 ms. La custom property inline se ignoró dentro de ese calc().

alternativatsx
<span
  className="type-line"
  style={{ "--chars": text.length, animationDuration: `${text.length * 90}ms` }}
>

Fijar animationDuration inline dio 0.9 s. Igual que antes, no conozco la causa raíz. Mis hipótesis son un problema de orden entre la sustitución de var() del shorthand y la propiedad inline, o un valor con unidad que llega a calc() como el fallback. Ninguna está verificada.

Qué haría la próxima vez

  • Confiar en el estilo calculado, no en getAnimations(). El primero dijo que 148 glifos estaban ocultos; el segundo dijo que todo estaba bien.
  • Hacer que el estado por defecto sea el visible, y dejar que la animación quite cosas, no que las agregue.
  • Evitar duraciones menores que un frame. A 60 Hz un frame son unos 16.7 ms, así que 1 ms pide un efecto que la página no puede mostrar.
  • Cuando un valor se calcula a partir de una custom property y sale como el fallback, fijar el valor final inline y seguir adelante.