設定システム

このドキュメントはAviary Toolkitの新しい設定システムについて説明します。このシステムを使用して、様々なプラットフォーム (Windows、 MacOS X および GNOME) で表示して動くのに適した設定ウインドウを作ることができます。

注意: 設定システムは Firefox/Thunderbird 1.5 (alpha版、beta版を含む) をスタートするときのみ利用できます。Firefox 1.0ベースのアプリケーションおよび拡張機能でこれを使うことはできません。

新しい設定システムは、いくつかのXUL要素と属性によって実装されます。以下のリンクをクリックすることで、それらについての参考となる情報にアクセスできます。:

使用方法

this will eventually be moved from here

典型的な設定ウィンドウのコードは、以下のようなものです。:

<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>
     
   .. 上のpreference要素を参照するユーザインターフェイス要素、例えば:
    <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>

ペインの内容は、内容となる要素をインラインで記述するか、または、動的なオーバーレイによって読み込まれるべき外部のリソースのchrome URIを指定することで、定義されます。必要に応じた異なるウィンドウタイトルを指定することが必要な場合、あなたがターゲットとし、そしてXULプリプロセッサを利用しようとしているプラットフォームごとのヒューマン・インターフェース・ガイドラインを注意深く読むべきです。また、プリプロセッサを使用して、それぞれのターゲットとするプラットフォームごとに適切なウィンドウの幅を（em単位で）指定する場合にも、注意してください。選択されたパネルが替わるのに合わせてウィンドウサイズを変更しないプラットフォーム（例：Windows）用に高さを（em単位で）指定する場合にも同様です。

※日本語版注記：prefpaneの内容をすべてインラインで記述して、ウィンドウの幅も高さも指定しなければ、適切なウィンドウサイズに自動調整してくれるはず。

XULRunnerアプリケーションでの使用方法

XULRunnerアプリケーションから設定ダイアログを開くために openDialog() メソッドを呼ぶ時は、ウィンドウの特性を示す文字列に"toolbar"が含まれているべきです。例:

var features = "chrome,titlebar,toolbar,centerscreen,modal";
window.openDialog(url, "Preferences", features);

Bugzilla

（FirefoxおよびThunderbirdの設定ユーザインターフェイスではなく）設定のバインディングに関するバグのコンポーネントは、Toolkit:Preferences (file a bug list open bugs)です。