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

SELFHTML/Quickbar JavaScript Référence objet

plugins

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

Propriétés:

description (description d'un plugin)
filename (nom de fichier d'un plugin)
length (nombre de plugins)
name (nom de produit d'un plugin)

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 plugins, au sens de la technique Netscape des plugins, ont été installés par l'utilisateur.

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

Schéma 1:

navigator.plugins[#].propriete

Schéma 2:

navigator.plugins["nom"].propriete

Explication:

Vous pouvez adresser des plugins 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 plugins. Pour cette raison, l'utilisation de numéros d'index n'est judicieuse que si par exemple vous recherchez dans une boucle tous les plugins disponibles.
avec le nom d'un plugin 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 plugin. 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:

<html><head><title>Test</title>
</head><body>
<script language="JavaScript">
document.writeln("<table border>");
for(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 plugins disponibles sont listés. Dans la colonne de gauche figure le nom du plugin 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 plugin.

description

Sauvegarde un court descriptif du plugin.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
 if(navigator.plugins["VDOLive small plugin"])
  alert(navigator.plugins['VDOLive small plugin'].description);
</script>
</head><body>
</body></html>

Explication:

L'exemple recherche si un plugin du nom de "VDOLive small plugin" est installé chez l'utilisateur (l'exemple suppose que l'auteur est en possession de ce plugin et désire tester s'il peut envoyer des données relatives à ce plugin à un utilisateur). L'exemple se limite à sortir dans une boite de dialogue le court descriptif du plugin dans le cas où ce plugin est installé.

filename

Sauvegarde le nom du fichier programme d'un plugin.

Exemple:

<html><head><title>Test</title>
<script language="JavaScript">
if(navigator.plugins["VDOLive small plugin"].filename.indexOf("npsmlvdo.dll"))
 alert("Le plugin est insuffisant ");
</script>
</head><body>
</body></html>

Explication:

L'exemple suppose que l'installation d'un plugin 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 plugin, apparaît la valeur "npsmlvdo.dll". Si c'est le cas, une annonce sera sortie dans l'exemple stipulant que le plugin 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 plugins que l'utilisateur a installé avec son navigateur.

Exemple:

<html><head><title>Test</title>
</head><body>
<b>Les fichiers plugin suivants sont installés sur l'ordinateur:</b>
<script language="JavaScript">
for(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 plugins installés et écrit pour chacun d'entre eux une ligne avec le nom de fichier du plugin. Ainsi sont listés à la fin tous les fichiers de tous les plugins installés.

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

name

Sauvegarde le nom de produit d'un plugin.

Exemple:

<html><head><title>Test</title>
</head><body>
<b>Les plugins suivants sont installés:</b>
<script language="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 plugins installés et écrit pour chaque plugin une ligne avec le nom du plugin. Ainsi, à la fin, tous les plugins installés seront listés.


après:	Number
avant:	mimeTypes

SELFHTML/Quickbar JavaScript Référence objet