Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

iframe — documento incorporado

O elemento iframe incorpora um documento separado. Descubra a diferença entre src e srcdoc e como sandbox restringe o conteúdo.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<iframe src="URL" title="Description"></iframe>
<iframe srcdoc="HTML" title="Description" sandbox></iframe>

iframe incorpora um documento HTML separado. src indica um URL, enquanto srcdoc contém HTML e tem prioridade sobre src. Ambas as etiquetas são necessárias; o conteúdo entre elas não é o documento incorporado.

Um sandbox vazio ativa restrições, incluindo o bloqueio da execução de scripts e da submissão de formulários. Os formulários podem continuar a ser apresentados e os utilizadores podem interagir com os respetivos controlos. Os tokens aliviam algumas restrições. Não combine allow-scripts e allow-same-origin para conteúdo não fiável da mesma origem: este pode remover a proteção. No exemplo, srcdoc fornece conteúdo local sem o obter da rede.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>iframe demo</title>
<iframe title="Greeting" sandbox
        srcdoc="<p>Hello from iframe.</p>"></iframe>
</html>

Resultado

Hello from iframe.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes