Animación de texto CSS: efecto máquina de escribir con steps()

Contenido
- Por qué necesitas una animación de texto mecanografiado en CSS
- Crear el efecto de mecanografía solo con CSS
- Qué revisar antes de aplicarlo
- Conclusión
- El mecanismo técnico clave: cómo funciona por dentro la escritura con CSS
- Matriz comparativa de técnicas para implementar texto que se escribe
- 5 errores fatales al implementar una animación de escritura
- Flujo de trabajo en 5 pasos para hacer texto que se escribe con CSS a nivel de producción
- 7 consejos para tu efecto de texto escrito
- Árbol de decisión: ¿qué método de implementación elegir?
- Glosario de términos clave (chuleta de terminología)
- Preguntas frecuentes
El texto que aparece letra a letra, como si alguien lo escribiera en tiempo real con el teclado —la presentación del perfil en el portafolio de un desarrollador, la ventana de respuestas de un chatbot de IA o el titular de una landing page— es lo que se conoce como animación de texto mecanografiado (typing text) en CSS. Antes se implementaba con temporizadores de JavaScript como setInterval() o requestAnimationFrame() para ir añadiendo caracteres al DOM uno por uno, pero si combinas la función de easing steps() con la unidad de carácter ch y una animación de cursor parpadeante dibujado con border-right, puedes lograr el mismo efecto solo con CSS. En este artículo te explicamos cómo funciona la función escalonada steps(), cómo escribir el código a mano y cómo usar una herramienta que hace los cálculos por ti.
Resumen ① Combinando steps(N, end) con la unidad ch puedes crear una animación de mecanografía solo con CSS. ② En lugar de contar los caracteres a mano para calcular el valor de steps y el ancho, puedes hacerlo automáticamente con una herramienta. ③ Conviene revisar de antemano si usas una fuente monoespaciada y cómo tratar caracteres de varios idiomas, como el coreano.
Por qué necesitas una animación de texto mecanografiado en CSS
Para implementar una animación de mecanografía con JavaScript tienes que crear un temporizador y escribir el código que recorta la cadena carácter a carácter en cada fotograma para reflejarla en el DOM, lo que alarga el código y te obliga a preocuparte además por el rendimiento. Si lo haces solo con CSS puedes conseguir el mismo efecto sin esa lógica de temporizadores, únicamente con la función de easing steps() y una animación de width, pero sigue estando la molestia de calcular con precisión el valor steps(N) y el ancho (Nch) según el número de caracteres de la frase.
Crear el efecto de mecanografía solo con CSS
La función escalonada steps(N) y la unidad ch
El principio de la animación de texto mecanografiado en CSS consiste en aumentar el ancho (width) de la caja que contiene la frase desde 0 hasta el número total de caracteres N, a saltos. Expresado como función de tiempo de CSS, es lo siguiente.
steps(N, end) es una función de easing que divide la duración de la animación en N intervalos iguales y, al final de cada k-ésimo intervalo (progreso total k/N), hace que el ancho salte de forma escalonada a k × 1ch.
Las propiedades clave que la componen son las siguientes.
- Unidad de carácter (1ch): la unidad ch de CSS representa el ancho horizontal del carácter 0 (cero) de la fuente actual. Si aplicas una fuente monoespaciada, el ancho de todos los caracteres será exactamente 1ch.
- Easing por pasos steps(N, end): divide el easing de la animación en N escalones equidistantes en lugar de una curva continua, y así consigues el movimiento mecánico propio de una máquina de escribir, en el que las letras aparecen cortadas una a una.
- white-space: nowrap y overflow: hidden: impiden que la frase se parta automáticamente a la línea siguiente y ocultan la parte derecha del texto que todavía no se ha escrito.
Código CSS para implementar también el parpadeo del cursor
Este es el código en CSS puro con el que un cursor de máquina de escribir parpadea mientras escribe una frase.
<div class="typing-container">
<h1 class="typing-text">Hello, World! I am a Full-Stack Engineer.</h1>
</div>
.typing-container {
display: inline-block;
background-color: #0f172a;
padding: 24px;
border-radius: 12px;
}
.typing-text {
font-family: 'Fira Code', 'Courier New', monospace;
font-size: 28px;
font-weight: 600;
color: #38bdf8;
white-space: nowrap;
overflow: hidden;
border-right: 3px solid #38bdf8; /* cursor de máquina de escribir parpadeante */
/* Basado en 41 caracteres ("Hello, World! I am a Full-Stack Engineer."): animación escalonada de 41 pasos */
width: 41ch;
animation:
typing 3.5s steps(41, end) forwards,
blink-cursor 0.75s step-end infinite;
}
/* Línea de tiempo del aumento del ancho del texto */
@keyframes typing {
from { width: 0; }
to { width: 41ch; }
}
/* Línea de tiempo del parpadeo del cursor */
@keyframes blink-cursor {
from, to { border-color: transparent; }
50% { border-color: #38bdf8; }
}
Nota No hace falta contar a mano el total de caracteres de la frase ni calcular uno por uno el valor de steps(N) y el ancho Nch: también existen herramientas en las que escribes el texto, ajustas el tamaño de fuente y la velocidad de escritura, y obtienes al instante el código CSS con los valores ya calculados, listo para copiar y aplicar.
Si prefieres generar el resultado directamente con el texto que quieras, sin calcular nada a mano, pruébalo con nuestro Generador de efecto máquina de escribir en CSS.
Configura en tiempo real el texto que quieres escribir, la velocidad y la forma del cursor, y copia la hoja de estilos CSS con la fórmula del número de caracteres ya calculada.

Qué revisar antes de aplicarlo
| Punto a comprobar | Descripción |
|---|---|
| Uso de una fuente monoespaciada | Si usas una fuente de ancho variable (Inter, Roboto, Arial, etc.), el ancho de cada carácter es distinto y, al desplazarse con steps(), aparecen letras cortadas por la mitad. Debes indicar una fuente monoespaciada como Fira Code, Monaco o Courier New. |
| Tratamiento de varios idiomas (CJK) | Los caracteres de coreano, japonés y chino ocupan aproximadamente 2ch de ancho, a diferencia de una letra del alfabeto latino. Al implementar mecanografía en coreano puedes ajustar la proporción del ancho o apoyarte además en una librería de mecanografía dinámica con JavaScript. |
| overflow y white-space | Debes indicar overflow: hidden junto con white-space: nowrap para evitar que se vean las letras antes de escribirse o que la frase se parta a la línea siguiente. |
Conclusión
La animación de texto mecanografiado en CSS se puede implementar sin temporizadores de JavaScript combinando la función de easing steps(N, end), la unidad ch y la animación de parpadeo del cursor hecha con border-right. Cada vez que cambia el texto o el número de caracteres hay que recalcular el valor de steps y el ancho, así que usar una herramienta que calcule los valores automáticamente al introducir la frase te ayuda a reducir errores. Antes de aplicarlo, conviene comprobar si usas una fuente monoespaciada y cómo vas a tratar caracteres de varios idiomas, como el coreano.
Configura en tiempo real el texto que quieres escribir, la velocidad y la forma del cursor, y copia la hoja de estilos CSS con la fórmula del número de caracteres ya calculada.
El mecanismo técnico clave: cómo funciona por dentro la escritura con CSS
El modelo de interpolación escalonada de steps(N, end) (Staircase Interpolation)
A diferencia de las animaciones CSS habituales, que interpolan los valores de forma suave con linear o ease, steps(N) divide un cambio continuo en N escalones discretos.
- Divide la duración total de la animación en tramos iguales.
- En cada frontera de tramo, es decir, en el punto rac{k}{N} cdot T$, la propiedad animada (el ancho) salta de inmediato al siguiente valor escalonado: $(t_k) = rac{k}{N} imes W_{ ext{final}} = k cdot 1 ext{ch}$$
- La palabra clave end significa que el salto se produce en el momento en que termina cada tramo. Así se consigue el movimiento de una máquina de escribir mecánica, en el que la letra sale de golpe después de que haya pasado un tiempo determinado.
Análisis a fondo de la unidad ch de CSS (Character Unit)
1ch es el ancho de avance (advance width) del glifo del número «0» (U+0030) en la fuente que se está aplicando.
- Fuente monoespaciada obligatoria: en una fuente monoespaciada, el ancho de todas las letras coincide exactamente con el del número 0. Por eso, una frase de N caracteres siempre mide Nch de ancho.
- Cuidado con las fuentes proporcionales: en una fuente proporcional, la «W» ocupa 1,3ch y la «i» 0,3ch, así que cada letra tiene un ancho distinto. En ese caso se rompe la correspondencia de 1 paso = 1 letra y aparece una distorsión en la que las letras se ven cortadas por la mitad.
Fórmula para calcular el ancho de caracteres CJK
Incluso con fuentes monoespaciadas, los caracteres CJK (coreano, chino y japonés: hangul, hanzi, kana) ocupan aproximadamente el doble de ancho que las letras latinas y los números (halfwidth), porque son de ancho completo (fullwidth).
- Fórmula para el ancho de una frase mixta: { ext{steps}} = N_{ ext{Latin}} + 2 imes N_{ ext{CJK}}$
- Ancho final del elemento: $ ext{width} = N_{ ext{steps}} cdot 1 ext{ch}$
Arquitectura de doble animación (Dual-Animation)
Un efecto de escritura bien afinado se consigue combinando dos animaciones independientes.
- typing: la animación principal, que expande el ancho del contenedor de texto de 0 a Nch.
- blink-cursor: la animación de parpadeo del cursor, que alterna el color de border-right entre transparente y el color elegido. Usa step-end para que se encienda y se apague al instante, sin degradado. Las dos se declaran a la vez en la propiedad animation, separadas por una coma (,).
Matriz comparativa de técnicas para implementar texto que se escribe
Tabla comparativa de ventajas y desventajas de cada forma de implementación, para elegir el stack técnico más adecuado a cada situación.
| Criterio | CSS puro (steps + ch) | JS setInterval (inyección en el DOM) | React useEffect (gestión de estado) | Librerías tipo GSAP / Typed.js |
|---|---|---|---|---|
| Sobrecarga del bundle JS | 0 (cero) | Baja | Media (provoca re-renderizados) | Alta (hay que cargar la librería) |
| SEO y rastreo | Excelente (el texto original se mantiene en el DOM) | Débil (etiqueta vacía antes de renderizar) | Débil (retraso en la hidratación) | Excelente / débil (según la configuración) |
| Rendimiento de renderizado | El mejor (lo calcula el compositor de la GPU) | Media (reflows continuos) | Baja (cálculo del DOM virtual) | Media (JS Animation Frame) |
| Soporte multilingüe CJK | Requiere cálculo manual (ancho doble) | Automático | Automático | Automático |
| Flexibilidad de reproducción y control | Baja (necesita el truco del reflow) | Normal | Alta | La mejor (muchas opciones disponibles) |
5 errores fatales al implementar una animación de escritura
- Usar una fuente proporcional: si aplicas una fuente de ancho variable como Inter, Pretendard o Noto Sans, el cálculo escalonado basado en la unidad ch se desajusta y el texto aparece cortado.
- Calcular mal el número de caracteres coreanos (CJK): en un entorno monoespaciado, un carácter coreano ocupa 2ch; si lo cuentas como 1ch y dejas el ancho y el número de steps a la mitad, la frase no llega a mostrarse completa.
- Olvidar animation-fill-mode: forwards: si te falta forwards, que es lo que conserva el estado al terminar la animación, el texto vuelve a su estado original (ancho 0) y desaparece en cuanto se completa la escritura.
- Olvidar white-space: nowrap: mientras el ancho se va expandiendo falta espacio y la frase se parte, saltando a la línea de abajo.
- Aplicar un easing lineal (linear): si usas ease o linear en lugar de steps(N, end), las letras no aparecen de golpe como si saltaran, sino que se deslizan como cuando se abre una persiana, y eso rompe la inmersión.
Flujo de trabajo en 5 pasos para hacer texto que se escribe con CSS a nivel de producción
- Analizar el texto y hacer los cálculos: cuenta cuántas letras latinas y números y cuántos caracteres coreanos (CJK) tiene la cadena, y obtén el número exacto de steps ({ ext{Latin}} + 2 imes N_{ ext{CJK}}$) y el ancho total (ch).
- Configuración CSS imprescindible: aplica al elemento una fuente monoespaciada, oculta con overflow: hidden la zona que aún no se ha escrito y evita los saltos de línea con white-space: nowrap.
- Definir los keyframes: escribe @keyframes typing, que lleva el ancho de 0 a Nch, y @keyframes blink-cursor, que hace parpadear el color del borde derecho.
- Vincular la animación: aplícalas al elemento con la forma animation: typing 2s steps(N, end) forwards, blink-cursor 0.5s step-end infinite;
- Adaptación responsive y de accesibilidad: ajusta el tamaño de fuente para que el texto no se salga de la pantalla en el móvil y añade media queries que desactiven la animación según la configuración del sistema.
7 consejos para tu efecto de texto escrito
- Usa una fuente de programación adecuada: elige una fuente monoespaciada especializada como D2Coding, en la que el ancho coreano es exactamente el doble del latino, o fuentes como Fira Code y JetBrains Mono.
- Añade un retraso dramático: con animation-delay: 0.5s creas una pausa muy breve justo después de cargar la página y atraes mucho más la mirada del usuario.
- Una sola reproducción y estado final fijo: si la escritura no va en bucle, combina siempre animation-iteration-count: 1 (el valor por defecto) con forwards para fijar el estado final del texto.
- Encadenar varias líneas: para escribir varias líneas en secuencia, escalona el animation-delay de cada línea según lo que tarda en escribirse la anterior, así se enlazan de forma natural.
- Reiniciar a la fuerza con JavaScript (truco del reflow): cuando no hay cambios en el renderizado del DOM y quieres volver a disparar la animación CSS, quita la clase, llama a void element.offsetWidth para forzar un reflow y vuelve a añadir la clase.
- Media query pensada para la accesibilidad (a11y): añade @media (prefers-reduced-motion: reduce) para que las personas que sufren mareos vean todo el texto al instante, sin animación.
- Usa la herramienta de cálculo automático: no cuentes a mano los steps y el ancho de un texto que mezcla latín y coreano; usa el Generador de efecto máquina de escribir en CSS que tienes arriba y evita errores copiando y pegando.
Árbol de decisión: ¿qué método de implementación elegir?
- Un único texto estático (un titular de landing page, por ejemplo) ➔ CSS puro (steps + ch): resuélvelo de forma limpia y sin sobrecarga de JS.
- Texto dinámico que depende de lo que escribe el usuario (una interfaz de chat, por ejemplo) ➔ Basado en el estado de JavaScript (React, etc.): es lo adecuado para entornos con número de caracteres variable y reinicios frecuentes.
- Cambios complejos entre varias cadenas (escribir A, borrarlo y escribir B) ➔ Librerías (Typed.js, GSAP): imprescindibles para controlar timelines complejos, como el efecto de borrado hacia atrás o la velocidad variable.
Glosario de términos clave (chuleta de terminología)
- Efecto de texto mecanografiado (Typing Text Effect): animación de interfaz en la que las letras aparecen una tras otra, como en una máquina de escribir mecánica o una consola de terminal.
- Función escalonada (steps(N, end)): función de temporización de CSS que hace que el valor cambie a saltos, en lugar de forma fluida, ajustándose a un número concreto de N pasos.
- Unidad ch (Character Unit): unidad de longitud relativa de CSS que toma como referencia de 1ch la anchura del carácter «0» en la fuente renderizada.
- Fuente monoespaciada (Monospace Font): fuente pensada para programación en la que todas las letras ocupan la misma anchura horizontal, ya sea una «W» o una «i».
- Desbordamiento oculto (overflow: hidden): propiedad de CSS que recorta lo que sobresale de la anchura definida para que no se vea en pantalla.
- Parpadeo del cursor (Cursor Blink): símbolo que parpadea al final del texto y que normalmente se implementa ajustando la transparencia del borde derecho del elemento (border-right).
- Caracteres CJK de ancho completo (Fullwidth Characters): caracteres de Asia Oriental como el hangul, los hanja o el japonés que, en un entorno monoespaciado, ocupan el doble de espacio que el alfabeto latino (2ch).
- Modo de relleno de la animación (animation-fill-mode: forwards): propiedad que hace que, al terminar la animación, el elemento conserve el estado final al que llegó en el fotograma clave del 100%.
Preguntas frecuentes
Q1. En una frase con hangul, texto en inglés y espacios, ¿cómo calculo con exactitud los steps y la anchura en ch?
R1. Tomando como base una fuente monoespaciada, las letras del alfabeto inglés, los números, los espacios y los signos especiales habituales cuentan como 1ch. En cambio, el hangul (consonantes y vocales incluidas), los hanja y los signos especiales de ancho completo cuentan como 2ch. Por ejemplo, en «Hello 안녕» lo más exacto es calcular 5 del inglés + 1 del espacio + 2 caracteres de hangul (2×2=4) = un total de 10 steps y 10ch.
Q2. ¿Cómo puedo volver a reproducir (replay) una animación de mecanografiado en CSS con JavaScript?
R2. Quitar y volver a poner la clase del elemento no basta: el navegador agrupa los cambios (batching) y la animación no se reinicia. Justo después de llamar a el.classList.remove('typing') tienes que añadir una línea con void el.offsetWidth; para forzar el recálculo del diseño del navegador (reflow) y, a continuación, ejecutar el.classList.add('typing'). Así el navegador lo interpreta como una animación nueva y la reproduce desde el principio.
Q3. ¿Por qué el texto desaparece una y otra vez al terminar la animación (blinking out)?
R3. El comportamiento predeterminado de las animaciones CSS es volver al estado CSS original (el estilo inicial, no el de los fotogramas clave) cuando acaba la duración de la animación. Al terminar una animación que amplía la anchura de 0 a Nch, el elemento vuelve a la anchura predeterminada declarada en su origen (0). Para evitarlo, tienes que añadir explícitamente la propiedad animation-fill-mode: forwards, de modo que se mantenga el estado del momento del 100% (Nch).
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano