Élément HTML <embed> : l'élément de contenu externe embarqué
Baseline
Large disponibilité
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 <embed> intègre du contenu externe au point défini dans le document. Ce contenu est géré par le navigateur ou une application externe.
Exemple interactif
<embed
type="video/mp4"
src="/shared-assets/videos/flower.mp4"
width="250"
height="200" />
Attributs
Cet élément inclut les attributs universels.
height-
La hauteur utilisée pour l'affichage de la ressource, exprimée en pixels CSS (angl.). La valeur est absolue ; les pourcentages ne sont pas autorisés.
src-
L'URL de la ressource à intégrer.
type-
Le type MIME de la ressource imbriquée.
width-
La largeur utilisée pour l'affichage de la ressource, exprimée en pixels CSS (angl.). La valeur est absolue ; les pourcentages ne sont pas autorisés.
Notes d'utilisation
Les navigateurs modernes ne prennent plus en charge les plugins de navigateur tels que Flash, mais <embed> peut toujours afficher du contenu géré par le navigateur lui-même, comme les fichiers PDF dans un visualiseur PDF intégré.
Pour les aperçus de PDF, envisagez d'utiliser <object> ou <iframe>. Contrairement à <object>, <embed> ne peut pas contenir de contenu de repli. Contrairement à <iframe>, il n'a aucun attribut qui contrôle le chargement.
Il est possible d'utiliser la propriété CSS object-position afin d'ajuster la position de l'objet embarqué au sein de le cadre 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 le cadre.
Note :
La propriété object-fit n'a aucun effet sur les éléments <embed>.
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.
Exemples
<embed
type="video/quicktime"
src="film.mov"
width="640"
height="480"
title="Titre de ma vidéo" />
Résumé technique
| 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 (angl.) |
| Rôles ARIA autorisés |
application, document,
img, none,
presentation
|
| Interface DOM | HTMLEmbedElement |
Spécifications
| Spécification |
|---|
| HTML # the-embed-element |
Compatibilité des navigateurs
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>et<video>. - Positionnement et dimensionnement du contenu intégré dans son cadre :
object-positionetobject-fit