<APPLET>NN 2 IE 3 HTML 3.2  

<APPLET>...</APPLET>

Balise de fin HTML : obligatoire  

Vous pouvez incorporer un segment de code Java exécutable dans un document HTML sous forme d'applet. Une applet occupe une zone rectangulaire de la page, même si celle-ci n'est pas plus grande qu'un pixel carré. Une applet peut exiger que certaines valeurs initiales soient définies dans le document HTML. Vous pouvez utiliser un ou plusieurs éléments param pour passer des paramètres à l'applet avant son exécution (du moment qu'elle a été écrite pour accepter des paramètres). Les éléments param se placent entre les balises de début et de fin d'un élément applet.

Les applets sont compilées par leurs auteurs en fichiers de classe (portant l'extension de fichier .class). Un fichier de classe d'applet doit se trouver dans le même répertoire que le document HTML qui charge l'applet, ou dans l'un de ses sous-répertoires. Les attributs clés de l'élément applet indiquent au navigateur qu'il doit charger un fichier de classe spécifique à partir du répertoire ou du sous-répertoire approprié.

Tous les éléments de l'interface utilisateur de l'applet sont programmés dans cette dernière en JavaScript. Les attributs de l'élément applet ont pour rôle, entre autres, de définir la taille et les autres propriétés d'affichage de l'applet sur la page. Les versions récentes des navigateurs permettent aux scripts JavaScript de communiquer avec une applet; elles permettent également à une applet d'accéder aux différents éléments du document (non pris en charge dans Netscape  6).

Notez que HTML 4 délaisse l'élément applet au profit de l'élément object, plus générique. L'implémentation de l'insertion des applets par le biais de l'élément object n'est pas systématique. Les navigateurs continueront cependant à prendre en charge l'élément applet jusqu'à nouvel ordre.

 
Exemple
 
<APPLET code="simpleClock.class" name="myClock" width="400" height="50">
<PARAM name="bgColor" value="black">
<PARAM name="fgColor" value="yellow">
</APPLET>
 
Référence de modèle d'objet
 
[window.]document.applets[i]
[window.]document.appletName
[window.]document.getElementById(elementID)
 
Attributs spécifiques à l'élément
 
alignaltarchivecodecodebase
dataflddatasrcheighthspacemayscript
nameobjectsrcvspacewidth
 
Attributs du gestionnaire d´événements spécifiques à l´élément
 
GestionnaireNNIEHTML
onafterupdates.o4s.o
onbeforeupdates.o4s.o
ondataavailables.o4s.o
ondatasetchangeds.o4s.o
ondatasetcompletes.o4s.o
onerrorupdates.o4s.o
onrowenters.o4s.o
onrowexits.o4s.o
alignNN 2 IE 3 HTML 3.2  

align="alignmentConstant"

Facultatif  

L'attribut align définit le positionnement du rectangle de l'applet par rapport au contenu environnant. Voir la section  8.1.5, au début de ce chapitre, pour en savoir plus sur les valeurs possibles de cet attribut dans Navigator et Internet Explorer.

 
Exemple
 
<APPLET code="simpleClock.class" name="myClock" align="absmiddle"
width="400" height="50"></APPLET>
 
Valeur

Constante non sensible à la casse.

 
Par défaut

bottom

 
Référence de modèle d'objet
 
[window.]document.applets[i].align
[window.]document.appletName.align
[window.]document.getElementById(elementID).align
altNN 6 IE 3 HTML 3.2  

alt="Texte"

Facultatif  

Si un navigateur n'est pas capable de charger et d'exécuter des applets Java ou si cette fonction est désactivée dans les préférences utilisateur, le texte associé à l'attribut alt doit normalement s'afficher dans le document à l'endroit où la balise applet de l'élément apparaît. Ce texte indique généralement à l'utilisateur ce qu'aurait affiché l'applet Java si elle avait pu être chargée. Contrairement aux éléments noscript et noframes, une fonction d'applet Java absente ne possède pas d'élément correspondant. Dans la pratique, les navigateurs n'affichent pas toujours de message d'information lorsque le chargement d'une applet échoue.

 
Exemple
 
<APPLET code="simpleClock.class" name="myClock" align="absmiddle"
alt="A Java clock applet." width="400" height="50"></APPLET>
 
Valeur

Chaîne de caractères quelconque entre guillemets.

 
Par défaut

Aucune.

archiveNN 6 IE 3 HTML 4  

archive="URL_de_fichier_d'archive"

Facultatif  

Le sens exact de l'attribut archive varie entre la recommandation HTML 4 générique et son implémentation spécifique dans Netscape Navigator. L'attribut archive de Netscape permet à un auteur de regrouper plusieurs fichiers de classe dans un fichier d'archive .zip unique non compressé; le navigateur charge alors tous ces fichiers en même temps. Ceci se traduit par une amélioration des performances par rapport à la méthode consistant à charger le fichier de classe principal (spécifié par l'attribut code) puis à appeler chaque fichier de classe supplémentaire au fur et à mesure.

Lorsque vous spécifiez l'attribut archive, n'oubliez pas d'inclure un attribut code précisant le nom du fichier de classe principal à charger. Navigator vérifie d'abord si ce fichier est présent dans l'archive. Si ce fichier est absent, Navigator charge le fichier de classe code séparément (celui-ci peut ensuite charger des fichiers de classe supplémentaires, l'un après l'autre). Navigator exige que les fichiers d'archive portent l'extension de fichier .zip. L'adresse URL doit également être relative par rapport à l'emplacement codebase.

La spécification HTML autorise plusieurs adresses URL (séparées par un espace) désignant des fichiers supplémentaires de classe ou autre ressource. Ceci a pour but de permettre l'utilisation future du même attribut avec l'élément object, pressenti par le W3C comme le successeur de l'élément applet. IE 6 prend en charge la présence de l'attribut à des fins de compatibilité uniquement, mais il ne peut pas l'exploiter.

 
Exemple
 
<APPLET code="ScriptableClock.class" archive="myClock.zip" width="400" height="50">
</APPLET>
 
Valeur

Adresse URI sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.applets[i].archive
[window.]document.appletName.archive
[window.]document.getElementById(elementID).archive
codeNN 2 IE 3 HTML 3.2  

code="fileName.class"

obligatoire  

Nom du fichier de classe principal qui charge et exécute l'applet. Si l'attribut codebase n'est pas spécifié, l'attribut code doit inclure le chemin du répertoire dans lequel se trouve le document HTML qui charge l'applet. Il est possible que vous ne rencontriez aucun problème si vous omettez l'extension de fichier .class, mais il vaut mieux ne pas s'y risquer: pour les fichiers de classe, il vaut mieux indiquer le nom complet, extension comprise. D'autre part, la plupart des serveurs étant sensibles à la casse, vous devez respecter la casse du nom de fichier.

 
Exemple
 
<APPLET code="applets/ScriptableClock.class" width="400" height="50">
</APPLET>
 
Valeur

Nom de fichier de classe (doté de l'extension .class) respectant la casse ou chemin complet relatif au document HTML.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.applets[i].code
[window.]document.appletName.code
[window.]document.getElementById(elementID).code
codebaseNN 2 IE 3 HTML 3.2  

codebase="path"

Facultatif  

Chemin du répertoire où se trouve le fichier de classe spécifié dans l'attribut code ou archive. L'attribut codebase nomme uniquement le chemin, et non le fichier de classe. Vous pouvez spécifier l'adresse URL complète du répertoire, mais ne tentez pas d'accéder à un codebase extérieur au domaine du document courant. En effet, pour des raisons de sécurité, le chargement de la classe peut être interdit. Vous pouvez spécifier un chemin complet et un nom de fichier dans l'attribut code ou object, auquel cas vous n'avez pas besoin de définir l'attribut codebase.

 
Exemple
 
<APPLET code="ScriptableClock.class" codebase="applets/" width="400" height="50">
</APPLET>
 
Valeur

Nom de chemin sensible à la casse, qui est en général l'adresse relative par rapport au répertoire du document HTML courant.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.applets[i].codeBase
[window.]document.appletName.codeBase
[window.]document.getElementById(elementID).codeBase
datafld, datasrc  

  

Voir l'élément param pour une liaison de données IE vers des applets Java.

height, widthNN 2 IE 3 HTML 3.2  

width="pixels" height="pixels"

obligatoire  

La taille de l'emplacement occupé par une applet Java dans un document est déterminée par la valeur 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 de l'applet qui détermine la hauteur et la largeur de son rectangle visible. Comme c'est le cas pour les images, il vaut toutefois mieux spécifier les dimensions de l'applet. Cela facilitera la tâche du navigateur. Prenez l'habitude de fournir ces valeurs pour toutes les applets, comme vous le feriez pour les images ou autres objets visibles externes.

 
Exemple
 
<APPLET code="ScriptableClock.class" width="400" height="50"></APPLET>
 
Valeur

Nombre entier positif de pixels. Vous ne pouvez pas masquer entièrement une applet en lui affectant la valeur zéro, mais vous pouvez descendre jusqu'à 1 pixel pour chaque dimension. Pour masquer une applet, 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.applets[i].height
[window.]document.appletName.height
[window.]document.getElementById(elementID).height
[window.]document.applets[i].width
[window.]document.appletName.width
[window.]document.getElementById(elementID).width
hspace, vspaceNN 2 IE 3 HTML 3.2  

hspace="pixels" vspace="pixels"

Facultatif  

Vous pouvez aérer l'espace entre une applet et le contenu environnant à l'aide des attributs hspace et vspace. L'attribut vspace définit la quantité d'espace à insérer au-dessus et au-dessous de l'applet, l'attribut hspace la quantité d'espace à insérer à gauche et à droite de l'applet. Si votre navigateur gère bien les feuilles de style, il vaut mieux utiliser les attributs de remplissage et/ou de définition des marges, grâce auxquels vous pourrez mieux contrôler les côtés individuels de l'applet.

 
Exemple
 
<APPLET code="ScriptableClock.class" width="400" height="50" hspace="3" vspace="4">
</APPLET>
 
Valeur

Nombre entier positif (entre guillemets ou pas) représentant un nombre de pixels.

 
Par défaut

0

 
Référence de modèle d'objet
 
[window.]document.applets[i].hspace
[window.]document.appletName.hspace
[window.]document.getElementById(elementID).hspace
[window.]document.applets[i].vspace
[window.]document.appletName.vspace
[window.]document.getElementById(elementID).vspace
idNN s.o. 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 élément à une règle de style nommant cet attribut comme sélecteur d'ID. Un élément peut recevoir une ID qui en assurera l'unicité, ainsi qu'une classe qui le rattachera à un groupe. Reportez-vous au chapitre  3.

Si vous définissez un attribut id mais pas d'attribut name, la valeur de l'attribut id peut être utilisée comme nom de l'applet dans les types de référencement par des scripts qui utilisent le nom de l'élément (document.appletName).

 
Exemple
 
<APPLET id="clocker" code="ScriptableClock.class" width="400" height="50">
</APPLET>
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.applets[i].id
[window.]document.appletName.id
[window.]document.getElementById(elementID).id
mayscriptNN 4 IE 3 HTML s.o.  

mayscript

Facultatif  

Avec Navigator 3 est apparue la technologie LiveConnect, qui permettait aux scripts de communiquer avec les applets Java et vice versa (cette fonction n'est pas implémentée dans les navigateurs articulés sur Mozilla). Pour des raisons de sécurité, les fonctions de communication d'une applet avec les scripts doivent être activées explicitement par l'auteur de la page. En ajoutant l'attribut mayscript à la balise de l'applet, l'auteur permet à cette dernière de communiquer avec les objets et les scripts du document, du moment qu'elle est conçue pour. En d'autres mots, le HTML accorde à l'applet l'accès aux scripts du document. L'activation de cet attribut est très simple: lorsque le nom de l'attribut est présent, l'attribut est activé.

Une autre action est nécessaire pour qu'une applet puisse communiquer avec JavaScript. Le code de l'applet doit importer un fichier de classe Netscape spécial nommé JSObject.class. Dans la version Windows de Microsoft Internet Explorer 4 et versions ultérieures, ce fichier (et la classe d'exception qui l'accompagne) sont intégrés dans le support Java. Bien qu'imparfaite, une communication de base entre les applets et les scripts est possible dans IE.

 
Exemple
 
<APPLET code="ScriptableClock.class" width="400" height="50" mayscript>
</APPLET>
 
Valeur

Aucune valeur n'est affectée à cet attribut. La présence du nom de l'attribut suffit à activer la communication entre l'applet et les scripts.

 
Par défaut

Off.

nameNN 2 IE 3 HTML 3.2  

name="elementIdentifier"

Facultatif  

Lorsque vous créez un script pour une applet, il est généralement plus pratique de créer une référence à l'applet à l'aide d'un nom unique que vous lui aurez attribué. Ainsi, si vous modifiez la page par la suite et que vous déplacez ou supprimez plusieurs applets qui y figurent, vous n'aurez pas besoin de modifier les valeurs d'index dans des références en tableau. Dans IE 4 et versions ultérieures, vous pouvez omettre l'attribut name et utiliser la valeur de l'attribut id dans les références du script à l'objet applet (applet).

 
Exemple
 
<APPLET name="clock2" code="ScriptableClock.class" width="400" height="50">
</APPLET>
 
Valeur

Identifiant sensible à la casse.

 
Par défaut

Aucune.

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

object="filename"

Facultatif  

Référence au nom du fichier (par rapport à l'URI codebase) qui conserve l'état de l'applet entre les sessions. Si sa prise en charge est correcte, cet attribut remplace l'attribut code et le fichier de données pointe vers le fichier de classe de démarrage de l'applet.

 
Exemple
 
<APPLET name="clock2" object="clockData.dat" width="400" height="50">
</APPLET>
 
Valeur

Nom de fichier sensible à la casse.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.applets[i].object
[window.]document.appletName.object
[window.]document.getElementById(elementID).object
srcNN s.o. IE 4 HTML s.o.  

src="URL"

Facultatif  

Internet Explorer définit cet attribut comme étant l'adresse URL d'un  «  fichier associé   ». Il peut être identique à l'attribut archive défini dans les spécifications HTML et Navigator. L'attribut src ne remplace pas les attributs code et/ou codebase.

 
Valeur

Une adresse URL complète ou relative.

 
Par défaut

Aucune.

 
Référence de modèle d'objet
 
[window.]document.applets[i].src
[window.]document.appletName.src
[window.]document.getElementById(elementID).aex
vspace  

  

Voir hspace.

width  

  

Voir height.