<embed> : l'élément de contenu externe embarqué
===============================================

L'élément HTML **`<embed>`** permet d'intégrer du contenu externe à cet endroit dans le document. Le contenu peut être fourni par une application externe ou une autre source telle qu'un *plugin* du navigateur.

Exemple interactif
------------------

**Note :** Cet article ne traite que de l'élément faisant partie du HTML5. Il ne concerne pas la version précédente et non normalisée de cet élément.

Il faut garder à l'esprit que la plupart des navigateurs ont déprécié voire retiré la prise en charge des plugins. Aussi, mieux vaut ne pas utiliser sur `<embed>` si on souhaite qu'un site ou une application soit fonctionnelle sur un navigateur moyen.

|  |  |
| --- | --- |
| Catégories de contenu | Contenu de flux,
 contenu phrasé,
 contenu intégré,
 contenu interactif,
 contenu tangible.
  |
| Contenu autorisé | Aucun, cet élément est un élément vide. |
| Omission de balises | 
 Cet élément doit avoir une balise ouvrante mais ne doit pas avoir de
 balise fermante.
  |
| Parents autorisés | Tout élément qui accepte du contenu intégré. |
| Rôle ARIA implicite | Pas de rôle correspondant |
| Rôles ARIA autorisés | `application`,
 `document`, `img`, `none`,
 `presentation` |
| Interface DOM | `HTMLEmbedElement` (en-US) |

Attributs
---------

Cet élément possède les attributs universels.

`height`

La hauteur utilisée pour l'affichage de la ressource, exprimée en pixels CSS. La valeur est absolue, les pourcentages ne sont pas autorisés.

`src`

L'URL de la ressource à intégrer.

`type`

Le type MIME à utiliser pour sélectionner le plugin à instancier.

`width`

La largeur utilisée pour l'affichage de la ressource, exprimée en pixels CSS. La valeur est absolue, les pourcentages ne sont pas autorisés.

Notes d'utilisation
-------------------

Il est possible d'utiliser la propriété CSS `object-position` afin d'ajuster la position de l'objet embarqué au sein de la *frame* et la propriété CSS `object-fit` afin de contrôler la façon dont la taille de l'objet est ajustée par rapport à celle de la *frame*.

Exemples
--------


```html
<embed
 type="video/quicktime"
 src="film.mov"
 width="640"
 height="480"
 title="Titre de ma vidéo" />
```

Accessibilité
-------------

Utilisez l'attribut `title` sur un élément `embed` pour étiqueter son contenu afin que les personnes naviguant avec une technologie d'assistance telle qu'un lecteur d'écran puissent comprendre ce qu'il contient. La valeur du titre doit décrire de manière concise le contenu intégré. Sans titre, il se peut qu'elles ne soient pas en mesure de déterminer quel est son contenu intégré. Ce changement de contexte peut être source de confusion et de perte de temps, en particulier si l'élément `embed` contient du contenu interactif comme de la vidéo ou de l'audio.

Spécifications
--------------

| Specification |
| --- |
| HTML Standard # the-embed-element |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* D'autres éléments sont utilisés pour intégrer du contenu de différents types, notamment `<audio>`, `<canvas>`, `<iframe>`, `<img>`, `<math>`, `<object>`, `<svg>`, and `<video>`.
* Positionnement et dimensionnement du contenu intégré dans son cadre : `object-position` and `object-fit`