<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
Exemple
#<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
#<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
#<embed src="/collections/covers/programowanie-dla-dzieci.webp" type="image/webp" width="240" height="160">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
#- <object>Intègre une ressource externe (PDF, image, page) avec un contenu de remplacement au cas où elle ne se chargerait pas.
- <iframe>Un cadre qui intègre un autre document HTML dans la page, par exemple une vidéo YouTube ou une carte.
- <img>Une image intégrée à la page.
- <video>Un lecteur vidéo intégré directement à la page.
Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.