Clase 03 · Módulo 05
Secciones y componentes reutilizables
Secciones y componentes reutilizables
Qué logras en esta clase
Construyes las secciones de tu web como piezas que se usan muchas veces sin copiarse.
- Distingues qué merece ser un componente y qué no.
- Sabes leer props y slots en lo que entrega Claude.
- Pides cada sección de forma que reutilice lo que ya existe.
02
Copiar y pegar es una deuda
Cada bloque copiado es un lugar más donde un cambio futuro puede quedar a medias.
03
Qué es un componente
Un componente es un archivo .astro que define una pieza de la página: un botón, una tarjeta, una sección completa. Se escribe una vez y se usa como si fuera una etiqueta propia.
En Astro, los componentes se convierten en HTML al construir el sitio. Por defecto no envían JavaScript al navegador, así que reutilizar no vuelve más lenta la página.
04
Dos tamaños de pieza
| Tipo | Ejemplos | Se usa |
|---|---|---|
| Pieza base | Botón, tarjeta, etiqueta, título de sección | Decenas de veces |
| Sección | Portada, lista de servicios, testimonios, preguntas frecuentes | Una o pocas veces |
Las secciones se arman con piezas base. Si el botón está bien hecho, todas las secciones heredan el mismo botón.
05
Lo que cambia entra por props
Una tarjeta de servicio siempre tiene la misma forma. Cambian el título, el texto y el enlace. Esos datos variables son las props.
---
interface Props {
titulo: string;
texto: string;
enlace: string;
}
const { titulo, texto, enlace } = Astro.props;
---
<article>
<h3>{titulo}</h3>
<p>{texto}</p>
<a href={enlace}>Ver más</a>
</article>interface Props declara qué datos espera la pieza. Si falta uno, el editor lo avisa.
06
Una pieza, muchos usos
---
import Tarjeta from "../components/Tarjeta.astro";
const servicios = [
{ titulo: "Frenos", texto: "Revisión y cambio.", enlace: "/frenos" },
{ titulo: "Aceite", texto: "Cambio en 30 minutos.", enlace: "/aceite" },
];
---
{servicios.map((s) => <Tarjeta {...s} />)}La lista de datos queda arriba, separada del diseño. Agregar un tercer servicio es sumar una línea. Cambiar el aspecto de todas las tarjetas es editar un solo archivo.
07
Slots: cuando el contenido es libre
Las props sirven para datos cortos. Cuando lo que varía es un bloque entero de contenido, se usa un slot: un hueco que cada uso rellena a su manera.
- Un contenedor de sección recibe por slot lo que lleva dentro.
- Los slots con nombre permiten varios huecos, por ejemplo uno para el texto y otro para la imagen.
- Un slot puede traer contenido por defecto, que aparece si no le pasan nada.
08
Cuándo vale la pena un componente
| Situación | Decisión |
|---|---|
| Aparece una sola vez y es simple | Déjalo en la página |
| Aparece por segunda vez | Conviértelo en componente |
| Es una sección larga, aunque se use una vez | Componente, para que la página se lea de un vistazo |
| Dos piezas se parecen pero no son iguales | Una pieza con variantes |
Crear componentes «por si acaso» también es un error: suma archivos que nadie usa.
09
Una página bien armada se lee como un índice
Si abres index.astro y ves una lista de secciones con nombre, el sitio está ordenado.
10
Pide una sección, no el sitio
El segundo dice el alcance, de dónde sale el contenido y qué debe reutilizar. Deja poco espacio para inventar.
11
El ciclo de cada sección
Una sección por ciclo. Si el resultado no sirve, vuelves al commit anterior y pierdes solo esa sección.
12
Cómo evitar que Claude duplique
Claude tiende a resolver lo que le pides con código nuevo. Tres hábitos lo corrigen:
- Escribe en
CLAUDE.mdla regla: antes de crear un componente, revisar los que existen. - Nombra en el pedido las piezas que debe usar.
- Al leer el plan, busca archivos nuevos que se parezcan a otros que ya tienes y pregunta por qué no reutiliza.
13
Variantes en vez de copias
Tu web necesita un botón principal y uno secundario. Hay dos caminos:
| Camino | Resultado |
|---|---|
Dos archivos: BotonPrincipal y BotonSecundario | El tamaño, el foco y el borde se mantienen por duplicado |
Un Boton con una prop variante | Lo común se define una vez; solo cambia el color |
Lo mismo vale para tarjetas con y sin imagen, o secciones con fondo claro y oscuro.
14
Los textos vienen del brief
El contenido de cada sección sale de lo que escribiste en el módulo 3. Si no se lo entregas, Claude rellena con texto inventado que suena bien y no dice nada de tu negocio.
15
Cuándo una pieza necesita JavaScript
La mayoría de las secciones son contenido fijo y no necesitan nada más. Algunas piezas sí reaccionan al visitante: un carrusel, un filtro, una calculadora.
Para esas, Astro permite usar componentes de React u otros frameworks. Por defecto también se convierten en HTML fijo. Solo se vuelven interactivos si les agregas una directiva client.
16
Las directivas client más usadas
| Directiva | Cuándo carga el JavaScript | Conviene para |
|---|---|---|
client:load | Al cargar la página | Lo que se usa de inmediato, arriba |
client:visible | Cuando la pieza entra en pantalla | Lo que está más abajo |
client:only | Solo en el navegador, sin HTML previo | Piezas que no pueden generarse antes |
Estas directivas no funcionan en archivos .astro. Un componente .astro que necesita algo de comportamiento usa una etiqueta de script dentro del propio archivo.
17
Demasiadas props
Señal de alerta: para usar la pieza tienes que abrir su archivo y leerlo. Divídela, o reemplaza varias props por un slot.
18
Auditar la duplicación
Cada cierto número de secciones, pídele a Claude una revisión de solo lectura: que busque en src bloques repetidos, colores escritos a mano en vez de tokens y componentes sin uso, y que entregue una lista sin modificar nada.
19
Orden dentro de components
- Nombres que dicen qué es la pieza, no dónde va:
Tarjeta, noCajaInicio2. - Las piezas base en una subcarpeta y las secciones en otra, cuando pasen de una decena.
- Un componente por archivo.
- Lo que deja de usarse se borra en el mismo commit.
Anota esta convención en CLAUDE.md para que Claude la siga en cada sesión.
20
Lo que te llevas
- Un componente se escribe una vez y se usa como etiqueta propia.
- Las props llevan los datos que cambian; los slots, bloques enteros.
- La segunda aparición de algo es la señal para crear el componente.
- Una sección por ciclo: plan, diff, navegador y commit.
- El JavaScript se agrega pieza por pieza, solo donde hay interacción.
21
Hazlo ahora
En 15 minutos:
- Pide a Claude, en modo plan, un componente de botón con dos variantes y una tarjeta.
- Pide la primera sección de tu inicio usando esas piezas y los textos de tu brief.
- Abre el diff y confirma que no creó un botón nuevo.
- Cambia un color del botón y comprueba que cambia en todos sus usos.
- Haz commit.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026