SELFHTML: JavaScript / Référence objet / plugins

SELFHTML/Aides à la navigation

JavaScript/DOM

Référence objet

plugins

plugins: généralités sur l'utilisation

Propriétés:

description (description d'un plugiciel)
filename (nom de fichier d'un plugiciel)
length (nombre de plugiciels)
name (nom de produit d'un plugiciel)

plugins: généralités sur l'utilisation

Par l'objet plugins, qui se situe sous l'objet navigator dans la hiérarchie objet JavaScript, vous pouvez rechercher quels plugiciels, au sens de la technique Netscape des plugiciels, ont été installés par l'utilisateur.

Pour adresser un plugiciel, vous disposez des possibilités suivantes:

Schéma 1:

navigator.plugins[#].propriété

Schéma 2:

navigator.plugins["Nom"].propriété

Explication:

Vous pouvez adresser des plugiciels de deux façons:

avec un numéro d'index (comme dans le schéma 1)
Pour utiliser des numéros d'index, mentionnez navigator.plugins suivi d'un nombre entre crochets. Vous ne pouvez à vrai dire pas savoir où sont sauvegardés quels plugiciels. Pour cette raison, l'utilisation de numéros d'index n'est judicieuse que si par exemple vous recherchez dans une boucle tous les plugiciels disponibles.
avec le nom d'un plugiciel comme nom d'index (comme dans le schéma 2)
Pour cela, notez, comme pour l'adressage avec des numéros d'index, derrière navigator.plugins des crochets. Dans les crochets, notez entre guillemets le nom du plugiciel. Comme noms d'index sont possibles par exemple des valeurs que vous pouvez rechercher avec la propriété d'objet name.

Exemple pour l'objet complet:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
</head><body>
<script type="text/javascript">
<!--
document.writeln("<table border=\"1\">");
for(var i=0; i<navigator.plugins.length; i++)
{
 document.writeln("<tr>");
 document.writeln("<td>" + navigator.plugins[i].name + "<\/td>");
 document.writeln("<td>" + navigator.plugins[i].description + "<\/td>");
 document.writeln("<td>" + navigator.plugins[i].filename + "<\/td>");
 document.writeln("<\/tr>");
}
document.writeln("<\/table>");
 //-->
</script>
</body></html>

Explication:

L'exemple écrit de façon dynamique un tableau dans le fichier HTML à l'aide de la méthode writeln(). Dans le tableau, tous les plugiciels disponibles sont listés. Dans la colonne de gauche figure le nom du plugiciel comme vous pouvez aussi l'utiliser pour l'adressage par nom d'index. Dans la colonne suivante figure un court descriptif et dans la dernière colonne, quel fichier sur l'ordinateur de l'utilisateur représente le plugiciel.

Attention:

L'édition Macintosh de l'Explorer Internet MS 5.0 interprète également cet exemple.

description

Sauvegarde un court descriptif du plugiciel.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
<script type="text/javascript">
<!--
 if(navigator.plugins["Java Plug-in"])
  alert(navigator.plugins['Java Plug-in'].description);
//-->
</script>
</head><body>
</body></html>

Explication:

L'exemple interroge si un plugiciel nommé "Java Plug-in" est installé chez l'utilisateur (l'exemple suppose que l'auteur possède ce plugiciel et désire tester s'il peut soumettre à un utilisateur des données pour ce pluciciel). L'exemple se limite à sortir dans une boite de dialogue une courte description du plugiciel, si celui-ci est installé.

filename

Sauvegarde le nom du fichier programme d'un plugiciel.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
<script type="text/javascript">
<!--
if(navigator.plugins["VDOLive small plugin"].filename.indexOf("npsmlvdo.dll"))
 alert("Le plugiciel est insuffisant ");
//-->
</script>
</head><body>
</body></html>

Explication:

L'exemple suppose que l'installation d'un plugiciel du nom de "VDOLive small plugin" a été recherchée auparavant chez l'utilisateur. L'exemple demande maintenant si dans l'enregistrement contenant le nom de fichier du plugiciel, apparaît la valeur "npsmlvdo.dll". Si c'est le cas, une annonce sera sortie dans l'exemple stipulant que le plugiciel est insuffisant.

Dans la propriété d'objet filename Netscape sauvegarde le chemin complet du fichier. Pour rechercher le nom de fichier proprement-dit, une méthode de l'objet string est appelée, à savoir indexOf().

length

Sauvegarde le nombre de plugiciels que l'utilisateur a installé avec son navigateur.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
</head><body>
<b>Les fichiers plugiciel suivants sont installés sur l'ordinateur:</b>
<script type="text/javascript">
<!--
for(var i=0; i<navigator.plugins.length; ++i)
 document.write("<br>" + navigator.plugins[i].filename);
//-->
</script>
</body></html>

Explication:

L'exemple parcourt dans une boucle for tous les plugiciels installés et écrit pour chacun d'entre eux une ligne avec le nom de fichier du plugiciel. Ainsi sont listés à la fin tous les fichiers de tous les plugiciels installés.

Pour la définition de la boucle for, c'est la propriété navigator.plugins.length.

Attention:

L'édition Macintosh de l'Explorer Internet MS 5.0 interprète également cet exemple.

name

Sauvegarde le nom de produit d'un plugiciel.

Exemple:

Exemple d'affichage: aperçu

<html><head><title>Test</title>
</head><body>
<b>Les plugiciels suivants sont installés:</b>
<script type="text/javascript">
<!--
for(i=0; i<navigator.plugins.length; ++i)
 document.write("<br>" + navigator.plugins[i].name);
//-->
</script>
</body></html>

Explication:

L'exemple parcourt dans une boucle for tous les plugiciels installés et écrit pour chaque plugiciel une ligne avec le nom du plugiciel. Ainsi, à la fin, tous les plugiciels installés seront listés.

Attention:

L'édition Macintosh de l'Explorer Internet MS 5.0 interprète également cet exemple.


	Number
	mimeTypes

SELFHTML/Aides à la navigation

JavaScript/DOM

Référence objet