Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
<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émentHTML<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 lesattributs universels.
archiveObsolèteUne liste d'URIs séparés par des espaces, pointant vers des archives de resources pour l'objet.
borderObsolèteLa largeur de la bordure autour de l'objet, exprimée en pixels.
classidObsolèteL'URI de l'implémentation de l'objet. Cet attribut peut être utilisé avec (ou en remplacement de) l'attribut
data.codebaseObsolèteLe chemin absolu de base servant à résoudre les URI relatifs définies par
classid,data, ouarchive. S'il n'est pas renseigné, l'URI de base considéré sera celui du document.codetypeObsolèteLe type de contenu des données définies par
classid.dataL'adresse de la ressource, une URL valide. Au moins un attribut
dataet un attributtypedoivent être définis.declareObsolèteSi 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.formL'é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.heightLa hauteur de la ressource affichée, comme pour
<integer>enpixels CSS.nameLe 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
WindowetDocument, contenant une référence à la fenêtre intégrée ou à l'élément lui-même.standbyObsolèteUn message que le navigateur peut afficher pendant le chargement de l'implémentation et des données liées à l'objet.
typeLetype MIME de la ressource définie par
data. Au moins un attributdataet un attributtypedoivent être définis.usemapObsolèteUne référence de type dièze-nom vers un élément
<map>; c'est-à-dire un '#' suivi de la valeur d'un attributnamed'un élément map.widthLa largeur de la ressource affichée, comme pour
<integer>enpixels CSS.
Exemples
Intégrer une vidéo
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'attributsrc défini sur le chemin de l'image à intégrer. Nous incluons aussi l'attributalt, qui fournit à l'image un nom accessible. Si l'image ne se charge pas non plus, le contenu de l'attributalt 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 attributusemap,contenu interactif ;contenu listé,contenu pouvant être envoyécontenu associé à un formulaire. |
|---|---|
| Contenu autorisé | Zéro ou plusieurs éléments<param> suivis par ducontenu transparent. |
| Omission de balise | Aucune, la balise ouvrante et la balise fermante sont obligatoires. |
| Parents autorisés | Tout élément acceptant ducontenu 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 |