<EMBED>NN 2 IE 3 HTML s.o.  

<EMBED>...</EMBED>

Balise de fin HTML : Facultatif  /  Obligatoire  

Un élément embed permet de charger des types d'objet multimédia et de fichier autres que ceux affichés de façon native par le navigateur. En général, un plug-in ou une application auxiliaire est nécessaire pour charger ces données externes et afficher le fichier correspondant correctement. Cet élément est pris en charge par Navigator et Internet Explorer depuis les versions  2 et 3 respectivement, mais il n'a jamais fait partie du vocabulaire HTML standard. Les spécifications HTML  4 recommandent d'utiliser l'élément object pour charger le type de données externes prises en charge par l'élément embed dans les navigateurs. Navigator  4 et versions ultérieures et Internet Explorer  4 et versions ultérieures prennent également en charge l'élément object, si bien qu'il est conseillé de l'utiliser pour les éléments incorporés si la technologie du navigateur de votre visiteur le prend en charge.

N'oubliez pas que, pour les types de données qui exécutent des plug-ins, le panneau de contrôle affiché varie largement en fonction du navigateur, du système d'exploitation et des plug-ins que l'utilisateur a installés pour ce type de données particulier. Il est hasardeux de tenter de concevoir une présentation combinant le panneau de contrôle d'un plug-in avec du texte environnant ou d'autres éléments.

La liste des attributs de l'élément embed est longue, et il convient d'être particulièrement attentif au niveau de la compatibilité de chaque attribut avec les divers navigateurs. Les ensembles d'attributs des navigateurs IE pour Windows, IE pour Mac et Navigator diffèrent, au même titre que leurs technologies de plug-in. Il est cependant possible d'incorporer, dans un document, un élément embed compatible avec les deux navigateurs, pour autant qu'il ne repose pas sur un paramétrage d'attribut non pris en charge par l'un des navigateurs. Toutefois, certains plug-ins peuvent nécessiter ou accepter des paires nom  /  valeur non répertoriées pour cet élément. Dans le cas de Navigator, tous les attributs (y compris ceux qui sont normalement ignorés par le navigateur) et leurs valeurs sont transmis au plug-in. C'est pourquoi il convient de consulter la documentation relative au plug-in afin de déterminer si des attributs supplémentaires sont pris en charge. L'élément object contourne ce problème d'attribut spécifique à l'objet en vous permettant d'ajouter un nombre quelconque d'éléments param adaptés à l'objet.

La balise de fin est obligatoire pour Internet  Explorer 4, mais pas pour Navigator  4.

 
Exemple
 
<EMBED name="jukebox" src="jazz.aif" height="100" width="200"></EMBED>
 
Référence de modèle d'objet
 
[window.]document.embeds[elementName]
[window.]document.getElementById(elementID)
 
Attributs spécifiques à l'élément
 
alignaltheighthiddenname
pluginspagepluginurlsrctypeunits
width
 
Attributs du gestionnaire d´événements spécifiques à l´élément

Aucune.

alignNN tous IE 4 HTML s.o.  

align="alignement"

Facultatif  

Si l'objet incorporé (ou le panneau de contrôle du composant multimédia) occupe un espace sur la page, l'attribut align détermine l'affichage de l'objet par rapport au conteneur parent immédiat de l'élément. Si un texte supplémentaire doit s'insérer entre les balises de début et de fin de l'élément embed, l'attribut align affecte également l'affichage du texte par rapport à l'espace rectangulaire de l'objet.

La plupart des règles concernant les constantes d'alignement indiquées au début de ce chapitre s'appliquent à l'élément embed. Il est difficile pour l'auteur de la page HTML d'en déterminer précisément la présentation, du fait qu'il ne maîtrise pas le panneau de contrôle du plug-in qui s'affiche. Des dimensions d'élément adéquates pour un panneau de contrôle donné peuvent être inadéquates pour un autre

L'attribut align est délaissé dans HTML 4, qui conseille d'utiliser l'attribut de feuille de style align. Mais vous pouvez utiliser l'attribut align si vous utilisez l'élément embed afin d'assurer la compatibilité ascendante.

 
Exemple
 
<EMBED src="jazz.aif" align="left" height="100" width="200"></EMBED>
 
Valeur

Chaque navigateur définit un ensemble de valeurs différent pour cet attribut. Sélectionnez dans le tableau suivant celle(s) qui conviennent:

ValeurNNIE
absbottom-
absmiddle-
baseline-
bottom
left
middle
right
texttop-
top
 
Par défaut

bottom

 
Référence de modèle d'objet
 
[window.]document.embeds[elementName].align
[window.]document.getElementById(elementID).align
altNN s.o. IE 4 HTML s.o.  

alt="textMessage"

Facultatif  

Si Internet Explorer n'est pas capable de charger et exécuter l'objet multimédia externe, le texte affecté à l'attribut alt est supposé s'afficher dans le document à l'emplacement de l'élément embed. Ce texte indique généralement à l'utilisateur ce qui s'afficherait si les données avaient pu être chargées (Internet Explorer affiche également une boîte de dialogue indiquant comment accéder à des informations en ligne sur le plug-in).

Utilisez l'attribut alt avec prudence. Si les données externes ne constituent pas un élément essentiel du contenu de votre page, il est sans doute préférable de ne pas attirer l'attention sur le contrôleur d'objet multimédia manquant dans les navigateurs les moins complets. Un message d'explication peut être plus gênant pour l'utilisateur que l'absence de lecteur d'objet multimédia.

Navigator offre des possibilités équivalentes avec l'élément noembed.

 
Exemple
 
<EMBED src="jazz.aif" alt="Sound media player" height="10" width="20"></EMBED>
 
Valeur

Chaîne de caractères quelconque entre guillemets.

 
Par défaut

Aucune.

height, widthNN 2 IE 3 HTML s.o.  

height="length" width="length"

obligatoire  

L'espace occupé dans un document par un objet incorporé (ou par le panneau de contrôle de son plug-in) est défini par les valeurs des attributs height et width. Dans certaines versions des navigateurs, ces attributs n'ont pas besoin d'être définis; c'est alors l'interface utilisateur même du plug-in qui détermine la hauteur et la largeur de son rectangle visible. Dans la mesure du possible, il est préférable de spécifier les dimensions exactes du panneau de contrôle d'un plug-in (les panneaux de contrôle diffèrent d'un navigateur à l'autre, voire entre les différents plug-ins destinés au même navigateur). Dans certains cas, par exemple avec Navigator  4 pour Macintosh, le panneau de contrôle peut ne pas s'afficher du tout si vous n'indiquez pas une hauteur suffisante sur la page. Si vous indiquez des valeurs supérieures aux dimensions réelles du panneau de contrôle, le navigateur réserve cet espace vide sur la page, ce qui peut altérer la mise en page désirée.

 
Exemple
 
<EMBED src="jazz.aif" height="150" width="250"></EMBED>
 
Valeur

Entier positif (éventuellement entre guillemets) ou pourcentage (entre guillemets). Vous ne pouvez pas masquer entièrement le panneau de contrôle d'un objet incorporé en lui affectant la valeur zéro (un pixel occupe toujours de l'espace) mais vous pouvez le réduire jusqu'à une dimension de 1  pixel de côté. Pour masquer un plug-in, vous devez utiliser DHTML et affecter la valeur none à son attribut display.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.embeds[i].height
[window.]document.getElementById(elementID).height
[window.]document.embeds[i].width
[window.]document.getElementById(elementID).width
hiddenNN< 6 IE 4 HTML s.o.  

hidden="true" | "false"

Facultatif  

Concurrent de la définition des bordures par feuille de style, l'attribut hidden est un commutateur permettant de définir si le panneau de contrôle du plug-in des données incorporées s'affiche à l'écran. Ce peut être souhaitable pour une musique en arrière-plan sous un contrôle de script (via LiveConnect de Netscape). La définition de l'attribut hidden annule l'effet des attributs height et width.

 
Exemple
 
<EMBED src="soothing.aif" hidden="true"></EMBED>
 
Valeur

true | false

 
Par défaut

false

 
Référence de modèle d'objet
 
[window.]document.embeds[i].hidden
[window.]document.getElementById(elementID).hidden
titleNN 6 IE 3 HTML 3.2

title="advisoryText"

Facultatif

Description de l'élément. Pour les éléments HTML qui produisent du contenu visible sur la page, IE 4 et versions ultérieures ainsi que Netscape 6 affichent le contenu de l'attribut title sous forme d'info-bulle lorsque le curseur reste un moment sur l'élément concerné. Par exemple, l'élément de colonne col n'affiche pas le contenu, donc son attribut title fournit simplement des informations. Pour générer des info-bulles dans les tableaux, affectez des attributs title aux éléments tels que table, tr, th ou td.

Les propriétés de police et de couleur sont régies par le navigateur et ne peuvent pas être modifiées par script. Dans IE pour Windows, l'info-bulle est le petit rectangle jaune clair standard; dans IE pour Macintosh, l'info-bulle s'affiche comme une bulle de BD, à la manière du système d'aide de MacOS. Dans Netscape 6, les info-bulles s'affichent toujours sous la forme du même petit rectangle quelle que soit la version du système d'exploitation. Si aucun attribut n'est spécifié, l'info-bulle ne s'affiche pas.

Vous pouvez affecter à cet attribut le texte descriptif de votre choix. Etant donné que tout le monde ne le verra pas, n'y placez pas d'informations essentielles. Peut-être les navigateurs conçus pour satisfaire les critères d'accessibilité Web utiliseront-ils les informations de cet attribut pour lire les informations au sujet d'un lien ou d'éléments autres que du texte à des utilisateurs malvoyants. Donc, ne négligez pas cette aide potentiellement utile pour décrire l'objectif d'un élément sur une page.

Bien que les indications de compatibilité pour cet attribut le fassent remonter à l'époque de Microsoft Internet Explorer 3 et HTML 3.2, il est nouvellement affecté à de nombreux éléments à partir de Microsoft Internet Explorer 4 et de HTML 4.0.

 
Exemple
 
<span title="United States of America">U.S.A.</span>
 
Valeur

Toute chaîne de caractères. Cette chaîne doit figurer entre guillemets (simples ou doubles, mais identiques).

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).title
idNN 4 IE 4 HTML 4

id="elementIdentifier"

Facultatif

Identifiant unique qui distingue cet élément de tous les autres au sein du document. Peut être utilisé pour associer un simple élément à une règle de style nommant cette valeur d'attribut — en tant que sélecteur d'ID. Un élément peut recevoir un ID qui en assurera l'unicité, ainsi qu'une classe qui le rattachera à un groupe. Reportez-vous au chapitre 3.

IE 4 et les versions ultérieures ainsi que Netscape 6 autorisent les attributs id pour les éléments non affichables, mais si votre code requiert une validation, sachez que les DTD HTML 4 W3C et XHTML ne l'autorisent pas. Comme tous les éléments du DOM W3C ont une propriété id, il est naturel d'affecter un attribut id aux éléments non affichables si les scripts doivent référencer ces éléments. Ou vos scripts peuvent utiliser d'autres moyens (par exemple le tableau renvoyé par document.getElementsByTagName( )) pour référencer de tels éléments.

Affectez des identifiants aux attributs id afin de dupliquer des valeurs précédemment affectées seulement aux attributs name dans des éléments comprenant l'attribut name. Les contrôles de formulaire des navigateurs actuels nécessitent encore des attributs name pour que les paires nom/valeur soient envoyées avec le formulaire et les éléments a jouant le rôle d'ancres nécessitent toujours ces attributs de nom. N'oubliez pas d'affecter un identifiant à l'attribut id de tout élément que vous avez l'intention de référencer par script.

 
Exemple
 
<h2 id="sect3Head">Section Three</h2>
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.getElementById(elementID).id
nameNN 2 IE 3 HTML s.o.  

name="elementIdentifier"

Facultatif  

Pour contrôler un plug-in à l'aide d'un script (en particulier dans Navigator, via LiveConnect), il est en général plus pratique de créer une référence à l'élément incorporé en lui affectant un nom unique. Par la suite, si vous modifiez la page et déplacez ou effacez plusieurs éléments embed de cette page, vous n'aurez pas à vous soucier de modifier les valeurs d'index comme c'est le cas pour un référencement en tableau (document.embeds[embedName]).

 
Exemple
 
<EMBED name="jukebox" id="jukebox" src="jazz.aif" height="15" width="25"></EMBED>
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.embeds[i].name
[window.]document.getElementById(elementID).name
pluginspageNN< 6 IE 4 HTML s.o.  

pluginspage="URL"

Facultatif  

Si le type MIME du fichier de données affecté à l'attribut src de l'élément embed n'est pas pris en charge par un plug-in ou une application auxiliaire existant, l'attribut pluginspage a pour rôle de fournir une adresse URL pour le téléchargement et l'installation du plug-in nécessaire. Si vous omettez cet attribut, Navigator 4 affiche un lien générique pointant sur la liste des fournisseurs de plug-in pour Netscape.

 
Exemple
 
<EMBED name="jukebox" src="jazz.aif" height="150" width="250"
pluginspage="http://www.giantco.com/plugin/install/index.html">
</EMBED>
 
Valeur

Une adresse URL valide.

 
Par défaut

Aucune.

pluginurlNN |4| IE s.o. HTML s.o.  

pluginurl="URL"

Facultatif  

(Seul) Navigator 4 permet, grâce à une fonction appelée Smart Update, de procéder à une installation quasiment automatique de ses composants. Si un utilisateur ne dispose pas du plug-in nécessaire pour le type de données de votre élément embed, pluginurl peut pointer sur un fichier Java Archive (JAR) contenant le plug-in et des objets signés numériquement, afin de répondre aux problèmes de sécurité liés à l'installation automatique (via le gestionnaire d'installation Java de Netscape). Les fichiers JAR sont des fichiers signés numériquement et compressés (selon une technique comparable à celle des fichiers .zip), générés à l'aide de l'outil JAR Packager de Netscape.

Vous pouvez inclure les attributs pluginspage et pluginurl dans la balise d'un élément embed afin de gérer la version de navigateur appropriée. Les versions  2 et 3 de Navigator répondent à l'attribut pluginspage, tandis que Navigator  4 donne la priorité à l'attribut pluginurl lorsqu'il est présent.

 
Exemple
 
<EMBED name="jukebox" src="jazz.aif" height="150" width="250"
pluginurl="http://www.giantco.com/plugin/install.jar">
</EMBED>
 
Valeur

Toute adresse URL valide d'un fichier JAR.

 
Par défaut

Aucune.

srcNN 2 IE 3 HTML s.o.  

src="URL"

Facultatif  

L'attribut src est l'adresse URL d'un fichier contenant des données lues par le plug-in. Le plus souvent, l'élément embed est obligatoire, mais il arrive qu'il ne soit pas indispensable (voir la section consacrée à l'attribut type). Les navigateurs utilisent généralement l'extension du nom de fichier pour déterminer le plug-in à charger (en fonction des paramètres de préférence définis dans le navigateur pour les plug-ins et les applications auxiliaires).

 
Exemple
 
<EMBED name="babyClip" src="Ugachaka.avi" height="150" width="250"></EMBED>
 
Valeur

Une adresse URL complète ou relative.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.embeds[i].src
[window.]document.getElementById(elementID).src
typeNN 2 IE s.o. HTML s.o.  

type="MIMEtype"

Facultatif  

Navigator a prévu la possibilité d'un plug-in ne nécessitant pas de fichier de données externe. Un plug-in de ce type ressemble plutôt à une applet. Pour placer un plug-in de ce type dans votre document, utilisez l'élément embed en spécifiant le type MIME plutôt que l'adresse URL du fichier de données (dans l'attribut src). Cela suppose, naturellement, que la nature du type MIME soit si particulière qu'il ne puisse y avoir qu'un seul plug-in mappé sur ce type MIME dans les paramètres du navigateur. L'un des attributs src ou type doit figurer dans une balise d'élément embed de Navigator.

 
Exemple
 
<EMBED src="hooha.fbz" type="application/x-frobnitz" height="150" width="250"></EMBED>
 
Valeur

Tout nom de type MIME valide, sous forme d'une chaîne de caractères entre guillemets, comprenant les parties type et sous-type délimitées par une barre oblique. Un catalogue des types de MIME enregistrés est disponible à l'adresse suivante: ftp://ftp.isi.edu/in-notes/iana/assignments/media-types/.

 
Par défaut

Aucune.

unitsNN< 6 IE 3 HTML s.o.  

units="measurementUnitType"

Facultatif  

L'attribut units est censé indiquer le type d'unité de mesure utilisé pour les valeurs d'attribut height et width de l'élément. Navigator  4 et Internet Explorer  semblent traiter les mesures en pixels, quel que soit le paramétrage de cet attribut.

 
Exemple
 
<EMBED src="jazz.aif" height="150" width="250" units="en"></EMBED>
 
Valeur

Non seulement cet attribut ne semble pas influencer l'affichage d'un élément embed, mais Navigator  4 et Internet Explorer  4 divergent quant à la graphie précise et aux unités disponibles pour les valeurs. Navigator  4 propose le choix entre pixels ou en, tandis que Internet Explorer utilise px ou em.

 
Par défaut

pixels (ou px).

 
Référence de modèle d'objet
 
[window.]document.embeds[i].units
[window.]document.getElementById(elementID).units
width  

  

Voir height.