A arquitetura de ilhas combina o HTML de uma página com regiões interativas que carregam seu próprio JavaScript. Cada região pode ser ativada separadamente, o que permite manter o texto de um artigo disponível sem hidratar toda a página como uma única aplicação.
No Astro, os componentes de frameworks como React são renderizados em HTML por padrão. Uma diretiva client:* informa quando carregar o JavaScript e hidratar o componente. A hidratação conecta o comportamento do framework ao conteúdo renderizado para que eventos, como um clique, produzam a resposta programada.
Uma calculadora dentro do artigo
Neste exemplo didático, uma página Astro importa uma calculadora React já implementada. A chamada abaixo adia a ativação até o componente aparecer na área visível do navegador.
<Calculadora client:visible />O artigo pode ser lido enquanto a calculadora ainda aguarda a hidratação. Quando ela entra na área visível, o navegador inicia o carregamento necessário para ativá-la. Você precisa considerar esse intervalo ao testar os campos, porque o HTML visível pode aparecer antes de a calculadora responder às entradas.
A diretiva client:load inicia o carregamento durante a abertura da página e pode atender componentes que precisam de interação logo no início. A escolha altera o momento da ativação, sem modificar o cálculo programado no componente. O tamanho do JavaScript e as condições da conexão ainda afetam a espera.
Ilhas de cliente e de servidor
O Astro também oferece ilhas de servidor para renderizar separadamente conteúdo dinâmico, como uma região personalizada. Elas tratam a geração do conteúdo no servidor. A interatividade no navegador continua exigindo o JavaScript correspondente, mesmo quando a página usa essa modalidade.
Dúvidas frequentes
Perguntas frequentes sobre arquitetura de ilhas
- Várias ilhas podem compartilhar estado?
- Sim. Cada ilha pode ser hidratada separadamente e acessar um estado compartilhado por uma implementação apropriada. Essa troca não acontece apenas por estarem na mesma página.
- Todo componente Astro precisa de uma diretiva client?
- Os componentes .astro geram HTML e não recebem hidratação por diretivas client. Essas diretivas são usadas nos componentes de frameworks compatíveis, como React ou Vue, para ativar seu comportamento no navegador.
- Qual é a função de uma ilha de servidor?
- Ela renderiza uma parte dinâmica separadamente no servidor, por exemplo uma região personalizada. Esse recurso não ativa por si só os eventos interativos de um componente no navegador.
Para continuar
Recursos relacionados
Documentação
Astro: componentes e arquitetura de ilhas
Documentação do Astro sobre ilhas de cliente, hidratação independente e ilhas de servidor.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Na sessão de Desenvolvimento Colaborativo da Dev Side Studio, você opera o projeto com orientação ao vivo para investigar falhas como uma ilha que não responde.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
No desenvolvimento com agentes, compreender as ilhas permite conferir qual componente precisa de JavaScript e quando sua interação estará disponível.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.