Référence de l'API XPInstall:Objet Install:Méthodes:loadResources
Un article de MDC.
Sommaire |
[modifier] loadResources
Charge un fichier de propriétés.
[modifier] Méthode de
Objet Install
[modifier] Syntaxe
Object loadResources( Chaîne xpiPath );
[modifier] Paramètres
L'unique paramètre d'entrée de la méthode loadResources est une chaîne représentant le chemin vers le fichier de propriétés dans une archive xpi dans laquelle les paires clefs/valeurs sont définies.
[modifier] Retours
Un objet JavaScript dont les noms des propriétés sont des clefs de ce fichier et dont les valeurs sont les chaînes.
[modifier] Description
Le format du fichier de propriétés attendu par la méthode loadResources est le même que celui des fichiers de propriétés du chrome local. Cette méthode est utilisée pour internationaliser les scripts d'installation en permettant à l'installeur de récupérer les valeurs des chaînes localisées depuis un fichier annexe. Faites attention à ce que le paramètre spécifie correctement le fichier de l'archive xpi et non celui du système de fichiers, comme indiqué dans l'exemple ci-dessous.
[modifier] Exemple
Soit un xpi avec la structure interne suivante :
install.js bin/res_eg_2.properties bin/somefile.exe bin/...
Les lignes suivantes récupèrent les propriétés comme objet JavaScript et rendent les valeurs accessibles avec la syntaxe habituelle des fichiers .property :
resEg2Obj = loadResources("bin/res_eg_2.properties");
dump( resEg2Obj.title )