<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.
archiveObsolète-
Une liste d'URIs séparés par des espaces, pointant vers des archives de resources pour l'objet.
borderObsolète-
La largeur de la bordure autour de l'objet, exprimée en pixels.
classidObsolète-
L'URI de l'implémentation de l'objet. Cet attribut peut être utilisé avec (ou en remplacement de) l'attribut
data. codebaseObsolète-
Le 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è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
dataet un attributtypedoivent être définis. declareObsolè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
WindowetDocument, contenant une référence à la fenêtre intégrée ou à l'élément lui-même. standbyObsolè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 attributdataet un attributtypedoivent être définis. usemapObsolè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 attributnamed'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
<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> |