Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

<object> : l'élément d'objet externe

Baseline Widely available

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis ⁨juillet 2015⁩.

L'élément HTML <object> représente une ressource externe, qui peut être traitée comme une image, un contexte de navigation imbriqué ou une ressource à gérer par un module externe.

Exemple interactif

<object
  type="video/mp4"
  data="/shared-assets/videos/flower.mp4"
  width="250"
  height="200"></object>

Attributs

Cet élément inclut les attributs universels.

archive Obsolète

Une liste d'URIs séparés par des espaces, pointant vers des archives de resources pour l'objet.

border Obsolète

La largeur de la bordure autour de l'objet, exprimée en pixels.

classid Obsolète

L'URI de l'implémentation de l'objet. Cet attribut peut être utilisé avec (ou en remplacement de) l'attribut data.

codebase Obsolète

Le chemin absolu de base servant à résoudre les URI relatifs définies par classid, data, ou archive. S'il n'est pas renseigné, l'URI de base considéré sera celui du document.

codetype Obsolète

Le type de contenu des données définies par classid.

data

L'adresse de la ressource, une URL valide. Au moins un attribut data et un attribut type doivent être définis.

declare Obsolète

Si cet attribut booléen est présent, l'élément sera seulement une déclaration. L'objet devra donc être instancié par un élément <object> dans la suite du document. En HTML5, il faut répéter l'élément <object> complètement chaque fois que la ressource est réutilisée.

form

L'élément de formulaire éventuel auquel l'élément est associé. La valeur de cet attribut doit être l'identifiant d'un élément <form> du même document.

height

La hauteur de la ressource affichée, comme pour <integer> en pixels CSS.

name

Le nom du contexte de navigation valide (HTML5) ou du contrôle associé à l'élément (HTML 4). Le nom devient une propriété des objets Window et Document, contenant une référence à la fenêtre intégrée ou à l'élément lui-même.

standby Obsolète

Un message que le navigateur peut afficher pendant le chargement de l'implémentation et des données liées à l'objet.

type

Le type MIME de la ressource définie par data. Au moins un attribut data et un attribut type doivent être définis.

usemap Obsolète

Une référence de type dièze-nom vers un élément <map> ; c'est-à-dire un '#' suivi de la valeur d'un attribut name d'un élément map.

width

La largeur de la ressource affichée, comme pour <integer> en pixels CSS.

Exemples

Intégrer une vidéo

HTML

html
<object
  type="video/webm"
  data="/shared-assets/videos/flower.webm"
  width="600"
  height="140">
  <img
    src="/shared-assets/images/examples/flowers.jpg"
    alt="Quelques belles fleurs" />
</object>

Résultat

Si la vidéo de l'exemple ne se charge pas, une image sera proposée à l'utilisateur·ice comme contenu de repli. La balise <img> est utilisée pour afficher une image. Nous incluons l'attribut src défini sur le chemin de l'image à intégrer. Nous incluons aussi l'attribut alt, qui fournit à l'image un nom accessible. Si l'image ne se charge pas non plus, le contenu de l'attribut alt sera affiché.

Résumé technique

Catégories de contenu contenu de flux ; contenu phrasé ; contenu intégré, contenu tangible ; si l'élément a un attribut usemap, contenu interactif ; contenu listé, contenu pouvant être envoyé contenu associé à un formulaire.
Contenu autorisé Zéro ou plusieurs éléments <param> suivis par du contenu transparent.
Omission de balise Aucune, la balise ouvrante et la balise fermante sont obligatoires.
Parents autorisés Tout élément acceptant du contenu intégré.
Rôle ARIA implicite Pas de rôle correspondant (angl.)
Rôles ARIA autorisés application, document, img
Interface DOM HTMLObjectElement

Spécifications

Specification
HTML
# the-object-element

Compatibilité des navigateurs

Voir aussi