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 😉.

Esta la hice en febrero de 2026 para facilitar el aprendizaje de mis alumnxs. Aprender desarrollo web practicando. La idea es que crezca semanalmente con nuevos temas, tests y retos.

Inspirado en MDN, en W3Schools, en Codepen, en el crack de Manz y en mil sitios de documentación sobre desarrollo web. Quería aportar además de bloques teóricos con ejemplos, la gamificación de los retos y el sistema de test que ya tenía en culTest .

Si te gustó, si no te gustó, si quieres saludarme, o invitarme a 🍻 no dudes en escribirme en cristianeslava@gmail.com .