<embed>

Intègre une ressource externe dans la page, le plus souvent un document PDF.

Affichage
inline (élément remplacé)
Balise fermante
Aucune, élément vide
Contenu autorisé
Aucun, élément vide
Sur cette page

Exemple

#
HTML
<embed src="/pliki/plan-kursu-html.pdf" type="application/pdf" width="480" height="320">
<p><a href="/pliki/plan-kursu-html.pdf">Télécharger le programme de la formation (PDF)</a></p>

Sur ordinateur, le navigateur affiche ici une visionneuse PDF intégrée, avec défilement et zoom. Sur certains téléphones, un espace vide reste en place : c’est pourquoi le lien de téléchargement est indispensable.

Définition et utilisation

#

L’élément <embed> insère dans la page un contenu externe que le navigateur affiche avec ses propres outils, le plus souvent un document PDF dans la visionneuse intégrée. Vous indiquez l’adresse dans src, le type de fichier dans type, et la taille dans width et height. C’est un élément vide, sans balise fermante.

Autrefois, <embed> servait surtout aux plugins, comme Flash. Les plugins ont disparu des navigateurs, si bien qu’aujourd’hui cet élément n’a plus beaucoup d’usages. Insérez les images avec <img>, les vidéos avec <video> et les autres pages avec <iframe>.

Le plus gros défaut de <embed> est l’absence de contenu de remplacement. Si le navigateur ne sait pas afficher le fichier (par exemple un PDF sur certains téléphones), l’utilisateur voit un espace vide. C’est pourquoi il est toujours utile d’ajouter à côté un simple lien de téléchargement, ou de recourir à <object>, qui gère le contenu de remplacement.

Syntaxe

#
Syntaxe
<embed src="fichier.pdf" type="application/pdf" width="…" height="…">

Attributs

#
  • src

    URL

    L’adresse du fichier intégré.
  • type

    type MIME, p. ex. `application/pdf`

    Le type de la ressource. Il aide le navigateur à choisir comment l’afficher avant même de télécharger le fichier.
  • width / height

    nombre de pixels

    Les dimensions de la zone dans laquelle la ressource s’affiche.

L’élément accepte aussi tous les attributs globaux, comme class, id, style ou hidden.

Plus d’exemples

#
Une image intégrée avec embed
HTML
<embed src="/collections/covers/programowanie-dla-dzieci.webp" type="image/webp" width="240" height="160">
Aperçu

Cela fonctionne, mais pour les images, <img> est préférable, car il offre le texte alternatif alt et le chargement différé.

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Ajoutez toujours à côté un lien pour télécharger le fichier. <embed> n’a pas de contenu de remplacement : c’est donc la seule aide pour les personnes dont l’aperçu ne fonctionnera pas.
  • Pour intégrer d’autres pages, utilisez <iframe>, et pour les vidéos de services vidéo, le code <iframe> fourni par le service.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.