<object>

Intègre une ressource externe (PDF, image, page) avec un contenu de remplacement au cas où elle ne se chargerait pas.

Affichage
inline (élément remplacé)
Balise fermante
Obligatoire
Contenu autorisé
Un contenu de remplacement, affiché quand la ressource ne se charge pas
Sur cette page

Exemple

#
HTML
<object data="/pliki/plan-kursu-html.pdf" type="application/pdf" width="320" height="160">
  <p>Nous ne pouvons pas afficher l’aperçu du PDF.</p>
  <p><a href="/pliki/plan-kursu-html.pdf">Télécharger le programme de la formation</a></p>
</object>
Aperçu

Dans l’aperçu, le fichier PDF n’est pas disponible : vous voyez donc le contenu de remplacement, exactement tel que l’utilisateur le verra quand le fichier ne se charge pas.

Définition et utilisation

#

L’élément <object> intègre une ressource externe : un document PDF, une image, un graphique SVG ou une autre page HTML. Vous indiquez l’adresse dans l’attribut data (et non src), le type dans type, et la taille dans width et height.

Son avantage sur <embed> est le contenu de remplacement. Tout ce que vous écrivez entre les balises apparaît quand la ressource ne peut pas être chargée ou affichée. C’est l’endroit idéal pour un lien de téléchargement du fichier.

Comme <embed>, cet élément date de l’époque des plugins, et ses anciens attributs servant à les gérer, comme classid et codebase, sont obsolètes. <iframe> convient mieux pour intégrer d’autres pages, et <img> pour les images.

Syntaxe

#
Syntaxe
<object data="fichier.pdf" type="application/pdf" width="…" height="…">
  contenu de remplacement
</object>

Attributs

#
  • data

    URL

    L’adresse de la ressource intégrée. C’est l’équivalent de l’attribut src des autres éléments.
  • type

    type MIME, p. ex. `application/pdf`, `image/svg+xml`

    Le type de la ressource. Il aide le navigateur à décider tout de suite s’il sait l’afficher ou s’il doit montrer le contenu de remplacement.
  • 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.

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

#
  • Prévoyez toujours un contenu de remplacement avec un lien vers le fichier. Sur téléphone, l’aperçu PDF intégré ne fonctionne pas toujours.
  • Pour les vidéos de services comme YouTube ou Vimeo, utilisez <iframe> et non <object>.

Entrées associées

#

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