mozilla

Révision 283380 sur Système de préférences

  • Raccourci de la révision : Système_de_préférences
  • Titre de la révision : Système de préférences
  • ID de la révision : 283380
  • Créé :
  • Créateur : Chbok
  • Version actuelle ? Non
  • Commentaire GNome -> GNOME

Contenu de la révision

Ce document décrit le nouveau système de préférences présent dans les outils de la dernière version. L'usage 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, MacOS X et GNOME).

Note : Le système de préference n'est disponible qu'à partir de Firefox/Thunderbird 1.5 (et leurs versions alpha et beta). Vous ne pourrez pas les 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 sur les liens ci-dessous :

{{wiki.template('TOC_système_de_préférences')}}

Usage

this will eventually be moved from here

Voici un code pour une fenêtre classique de préférences :

<prefwindow id="appPreferences"
            xmlns="http://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 des plateformes visées et utiliser le pré-processeur XUL si nécessaire pour définir des titres de fenêtres différentes appropriés. 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 se modifie pas selon le panneau sélectionné (comme sous Windows).

Bugzilla

Les bugs pour les liaisons des préférences sont répertoriés sous 'Toolkit:Preferences' (et non sous Firefox/Thunderbird Options UI) (créer un bug liste des bugs ouverts).

{{ wiki.languages( { "en": "en/Preferences_System" } ) }}

Source de la révision

<p>
</p><p>Ce document décrit le nouveau système de préférences présent dans les outils de la dernière version. L'usage 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, MacOS X et GNOME).
</p><p><b>Note :</b> Le système de préference n'est disponible qu'à partir de Firefox/Thunderbird 1.5 (et leurs versions alpha et beta). Vous ne pourrez pas les utiliser dans des applications ou extensions basées sur Firefox 1.0.
</p><p>Ce nouveau système est implémenté grâce à quelques éléments et attributs <a href="fr/XUL">XUL</a>. Les informations de référence sont disponibles sur les liens ci-dessous :
</p><p>{{wiki.template('TOC_système_de_préférences')}}
</p>
<h3 name="Usage"> Usage </h3>
<p><span class="comment">this will eventually be moved from here</span>
</p><p>Voici un code pour une fenêtre classique de préférences :
</p>
<pre>&lt;prefwindow id="appPreferences"
            xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"&gt;
  &lt;prefpane id="pane1" label="&amp;pane1.title;"&gt;
    &lt;preferences&gt;
      &lt;preference id="pref1" name="pref.name" type="bool"/&gt;
    &lt;/preferences&gt;
     
   .. Élements de l'interface faisant référence aux préférences ci-dessus, par ex. :
    &lt;checkbox id="check1" preference="pref1"
              label="&amp;check1.label;" accesskey="&amp;check1.accesskey;"/&gt;
  &lt;/prefpane&gt;

  &lt;prefpane id="pane2" label="&amp;pane2.title;" src="chrome://uri/to/pane.xul"/&gt;
&lt;/prefwindow&gt;
</pre>
<p>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 des plateformes visées et utiliser le pré-processeur XUL si nécessaire pour définir des titres de fenêtres différentes appropriés. 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 se modifie pas selon le panneau sélectionné (comme sous Windows).
</p>
<h3 name="Bugzilla"> Bugzilla </h3>
<p>Les bugs pour les liaisons des préférences sont répertoriés sous 'Toolkit:Preferences' (et non sous Firefox/Thunderbird Options UI) (<a class="external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Toolkit">créer un bug</a> <a class="external" href="https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&amp;product=Toolkit&amp;component=Preferences&amp;resolution=---&amp;chfieldto=Now">liste des bugs ouverts</a>).
</p>{{ wiki.languages( { "en": "en/Preferences_System" } ) }}
Revenir à cette révision