Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é arquitetura de ilhas?

    A arquitetura de ilhas combina HTML com componentes interativos independentes. No Astro, diretivas definem quando carregar o JavaScript de cada componente.

    Também chamado de: islands architecture

    StayCloudVPS Agêntica

    30% off na sua VPS Agêntica nos 2 primeiros meses

    A StayCloud aplica o desconto sozinha no plano mensal, sem fidelidade. Suba uma VPS em São Paulo, instale o SetupVibe Desktop e desenvolva com agentes num ambiente que fica ligado o tempo todo.

    Aproveitar a Black Friday

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    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

    Aplicaçã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
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano