Client directives: client:load, idle, visible y media

Domina las directivas de hidratación para decidir cuándo se activa cada componente interactivo.

Las client directives son una de las decisiones más importantes en Astro para equilibrar UX y rendimiento.

No todas las interacciones necesitan cargarse al inicio; escoger mal esta estrategia penaliza el sitio.

Con client:visible y client:idle puedes diferir trabajo sin sacrificar experiencia.

Esta lección te da criterio para elegir directiva según contexto real.

  • Elegir bien evita JS innecesario en el primer render.
  • La directiva es una decisión de producto, no solo de código.
  • Mide impacto con Lighthouse.
  • Revisa interacción real del usuario.
  • Prioriza carga de elementos que aportan valor inmediato.

Cuándo usar cada directiva

Elegir bien evita JS innecesario en el primer render.

Buenas prácticas rápidas

La directiva es una decisión de producto, no solo de código.

  • Mide impacto con Lighthouse.
  • Revisa interacción real del usuario.
  • Prioriza carga de elementos que aportan valor inmediato.
Astro
07

Client directives: client:load, idle, visible y media

Domina las directivas de hidratación para decidir cuándo se activa cada componente interactivo.

Código del tema: <ComponenteReact client:visible />

📘 Teoría

Cuándo usar cada directiva

Elegir bien evita JS innecesario en el primer render.

1

client:load

Hidrata inmediatamente al cargar la página.

  • Úsalo para componentes críticos above the fold.
  • Evita abusarlo en páginas largas.
2

client:idle

Hidrata cuando el navegador está libre.

  • Ideal para widgets secundarios.
  • Mejora respuesta inicial de la página.
3

client:visible

Hidrata al entrar en viewport.

  • Perfecto para bloques al final de página.
  • Muy útil en listados largos.

Buenas prácticas rápidas

La directiva es una decisión de producto, no solo de código.

  • Mide impacto con Lighthouse.
  • Revisa interacción real del usuario.
  • Prioriza carga de elementos que aportan valor inmediato.

🧪 Aprende probando

Ejemplo Comparativa visual de directivas Esquema rápido para memorizar uso recomendado.

🏁 Retos

Reto Reto: elegir directiva correcta Para un carrusel al final de página, elige estrategia.

🧰 Recursos

Test

Comprueba tus conocimientos con un test sobre Astro.

Test de Astro

¿Qué es esto?

Soy Cristian Eslava y a veces hago webs para procrastinar yo y vosotros. culTest

La hice en febrero de 2026 para facilitar el aprendizaje de mis alumnos. La idea es aprender desarrollo web practicando y que el proyecto siga creciendo con nuevos temas, tests y retos.

Está inspirada en MDN, W3Schools, CodePen, Manz y muchos otros sitios de documentación sobre desarrollo web. Quería combinar teoría útil, ejemplos ejecutables, retos y el sistema de tests que ya tenía en culTest. culTest

Si te gustó, si no te gustó o si quieres escribirme, puedes hacerlo en cristianeslava@gmail.com