Ce document décrit le nouveau système de préférences présent dans les versions récentes du toolkit. L'utilisation de ce système permet de créer des fenêtres de préferences s'affichant et fonctionnant de façon appropriée sur les différentes plateformes (Windows, Mac OS X et GNOME).
Note : Le nouveau système de préferences n'est disponible qu'à partir de Firefox/Thunderbird 1.5 (et leurs versions alpha et beta). Vous ne pourrez pas l'utiliser dans des applications ou extensions basées sur Firefox 1.0.
Ce nouveau système est implémenté grâce à quelques éléments et attributs XUL. Les informations de référence sont disponibles en suivant les liens ci-dessous :
Documentation sur le système de préférences :
- Introduction : Premiers pas | Exemples | Troubleshooting
- Référence :
prefwindow|prefpane|preferences|preference| Nouveaux attributs
Utilisation
this will eventually be moved from here
Voici un code pour une fenêtre de préférences classique :
<prefwindow id="appPreferences"
xmlns="https://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul">
<prefpane id="pane1" label="&pane1.title;">
<preferences>
<preference id="pref1" name="pref.name" type="bool"/>
</preferences>
.. Élements de l'interface faisant référence aux préférences ci-dessus, par ex. :
<checkbox id="check1" preference="pref1"
label="&check1.label;" accesskey="&check1.accesskey;"/>
</prefpane>
<prefpane id="pane2" label="&pane2.title;" src="chrome://uri/to/pane.xul"/>
</prefwindow>
Le contenu d'un panneau peut être défini en ligne ou par l'intermédiaire d'un lien chrome externe via un overlay dynamique. Vous devrez lire attentivement le guide d'interfaces homme-machine (HIG) des plateformes visées et utiliser le pré-processeur XUL lorsque c'est nécessaire pour définir des titres de fenêtres différents. Vous devrez également faire attention à définir la largeur de la fenêtre (en em) de manière adaptée en utilisant le pré-processeur pour chaque plateforme cible, ainsi que la hauteur (en em) pour les plateformes où la fenêtre ne change pas de taille selon le panneau sélectionné (comme sous Windows).
Bugzilla
Les bugs pour les liaisons des préférences (lorsqu'ils ne sont pas des bugs d'interface de Firefox/Thunderbird) sont répertoriés sous le composantToolkit:Preferences(créer un bug liste des bugs ouverts).