Skip to main content

Visit Mozilla.org

System preferencji

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

UWAGA: Tłumaczenie tej strony nie zostało zakończone.
Może być ona niekompletna lub wymagać korekty.
Chcesz pomóc? | Dokończ tłumaczenie | Sprawdź ortografię | Więcej takich stron...

This document describes the Aviary Toolkit's new preferences system. Using this system it is possible to create preferences windows that display and operate appropriately on various platforms (Windows, MacOS X and GNOME).

Uwaga: the Preferences System is only available starting with Firefox/Thunderbird 1.5 (including their alpha and beta releases). You can't use it in Firefox 1.0-based applications and extensions.

The new system is implemented through a few XUL elements and attributes. Reference information about them is available, just click on one of links below:

Dokumentacja Systemu preferencji:

[edytuj] Use

Code for a typical preferences window may look like this: 

<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>
     
   .. UI elements that refer to the preferences above, e.g.:
    <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>

Pane content can be specified inline or an external chrome URI supplied for pane content to be loaded in via a dynamic overlay. You should be careful to read the HIGs for the platforms you are targeting and use the XUL preprocessor if necessary to set different window titles as appropriate. You should also be careful to specify the width of the window (in em) as appropriate using the preprocessor for each targeted platform, as well as the height (in em) for platforms where the window size does not change as the selected panel is changed (e.g. Windows).

[edytuj] Usage in XULRunner applications

When opening a preferences dialog from a XULRunner application, be sure to check the following:

  • The boolean preferences browser.preferences.animateFadeIn and browser.preferences.instantApply should be defined in the default preferences (see błąd 302509). Example: 
pref("browser.preferences.animateFadeIn", false);
pref("browser.preferences.instantApply", true);
  • When calling openDialog() to open a preferences dialog, "toolbar" should be included in the features string. Example: 
var features = "chrome,titlebar,toolbar,centerscreen,modal";
window.openDialog(url, "Preferences", features);

[edytuj] Bugzilla

The component for bugs in the Preferences bindings (but not in Firefox/Thunderbird Options UI) is Toolkit:Preferences (file a bug list open bugs)

Źródło: "http://developer.mozilla.org/pl/docs/System_preferencji"