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

CKTIS / HTML

object — incorporar um recurso com conteúdo alternativo

O elemento `object` incorpora um recurso externo como imagem ou documento aninhado. Os seus elementos descendentes fornecem conteúdo alternativo, apresentado quando não é possível mostrar o recurso.

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

Sintaxe

<object data="resource-url" type="mime/type" width="320" height="180">Fallback content</object>

O elemento object representa um recurso externo, tratado como imagem ou documento aninhado consoante o seu tipo. São necessárias as etiquetas de abertura e de fecho. O seu modelo de conteúdo transparente significa que os elementos descendentes permitidos dependem do contexto envolvente.

A norma HTML exige a presença de pelo menos um dos atributos data e type. Este requisito aplica-se ao código HTML e não garante que o recurso seja incorporado com êxito. Se data estiver presente, o seu valor tem de ser um URL válido e não vazio do recurso — não utilize src aqui. O atributo type declara um tipo MIME; não converte os dados. width e height especificam as dimensões, name dá um nome ao contexto de navegação aninhado, caso seja criado, e form associa explicitamente o elemento a um formulário.

Os elementos descendentes são conteúdo alternativo, não uma legenda apresentada permanentemente. São mostrados, entre outras situações, quando a obtenção falha ou quando a imagem não é suportada ou está malformada. Após uma incorporação bem-sucedida, não fazem parte do conteúdo apresentado. Ao contrário de object, embed não suporta este conteúdo alternativo.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Object fallback</title>
</head>
<body>
  <object data="data:image/png,not-a-png" type="image/png" width="320" height="80">
    <p>Image unavailable.</p>
  </object>
</body>
</html>

Resultado

Image unavailable.

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