Um documento dentro de outro
Um iframe é um elemento HTML que exibe outro documento dentro de uma área da página. O navegador mantém esse documento com sua própria janela e estrutura de elementos, por isso um relatório incorporado pode carregar separadamente do painel que o apresenta.
O atributo src indica o endereço a carregar. Para incorporar uma página de relatório preparada para esse uso, o HTML poderia ser:
<iframe src="https://relatorios.example.com/resumo" title="Resumo dos atendimentos" width="800" height="450"></iframe>O endereço ilustrativo deve ser substituído pelo destino do relatório que você pretende incorporar. Quando esse destino permite a incorporação e disponibiliza o documento, o navegador o exibe na área de 800 por 450 pixels. O atributo title descreve o relatório para leitores de tela e deve identificar a função do documento incorporado.
Acesso entre documentos e permissões
A origem de um documento é definida pela combinação de protocolo, domínio e porta. A política de mesma origem limita o acesso por JavaScript entre documentos de origens diferentes. Exibir o relatório não autoriza o script do painel a ler seus campos. Para trocar informações entre as aplicações, você pode implementar mensagens com window.postMessage e conferir a origem recebida.
O atributo sandbox acrescenta restrições ao conteúdo incorporado, como a proibição de executar scripts. O servidor de destino também pode recusar a incorporação. Durante os testes, confira a resposta desse servidor e as mensagens do console do navegador para distinguir uma falha de carregamento de uma restrição de acesso.
Dúvidas frequentes
Perguntas frequentes sobre iframe
- O iframe copia o conteúdo para o HTML da página principal?
- O navegador mantém um documento próprio dentro do iframe. O HTML incorporado não se mistura à estrutura da página principal.
- O JavaScript da página principal pode ler um iframe externo?
- A política de mesma origem restringe esse acesso quando os documentos têm origens diferentes. Para trocar mensagens entre eles, as aplicações podem usar window.postMessage com validação da origem.
- Qualquer página pode aparecer num iframe?
- O servidor da página de destino pode recusar a incorporação por cabeçalhos como Content-Security-Policy com frame-ancestors ou X-Frame-Options. O endereço funcionar numa aba própria não confirma que possa ser incorporado.
Para continuar
Recursos relacionados
Documentação
MDN: incorporação de documentos HTML
Referência dos atributos src e sandbox, do acesso por scripts e do título acessível do iframe.
Abrir recursoSite de referência
Dev Side Studio: desenvolvimento colaborativo
Orientação técnica ao vivo para investigar falhas de incorporação e revisar a comunicação entre a página principal e o iframe.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
A incorporação de páginas exige conferir o carregamento do documento externo e as permissões de acesso usadas pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.