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

CKTIS / HTML

data: o recurso incorporado por object

Distinga o URL de um recurso incorporado dos dados próprios da aplicação.

Versão: HTML Living Standard

Sintaxe

<object data="/embedded.html" type="text/html">Fallback text</object>

Em object, data fornece o URL obrigatório, válido e não vazio do recurso incorporado. O atributo de tipo pode descrever o MIME. Conforme a resposta e o suporte, o objeto representa uma imagem, um documento aninhado ou o conteúdo alternativo dos seus filhos. Não é um dicionário de valores personalizados.

Não o confunda com atributos prefixados por data nem com o elemento data separado. Carregar um objeto não torna conteúdo alheio fiável: continuam válidas as regras de origem, restrições do servidor e política de segurança. Forneça uma alternativa útil sem depender de extensões obsoletas.

O exemplo incorpora um documento HTML local e lê o conteúdo depois do carregamento. A leitura é permitida porque os documentos partilham a origem. O teste comprova o carregamento aninhado real, não autorização para inspecionar documentos de outros sítios.

Exemplos

<!doctype html><meta charset="utf-8">
<object id="object" data="/embedded.html" type="text/html" width="300" height="100">Fallback text</object>
<output id="result"></output><script>
window.addEventListener('load', () => {
  const object = document.querySelector('#object');
  document.querySelector('#result').textContent = 'embedded=' + object.contentDocument.querySelector('#inside').textContent;
});
</script>

Resultado

embedded=Local embedded document

Só é carregado o documento filho local descrito; a política da mesma origem não é contornada.

Fontes