initial commit

7 files changed, 340 insertions, 0 deletions

diff --git a/files/ja/preferences_system/examples/index.html b/files/ja/preferences_system/examples/index.html
new file mode 100644
index 0000000000..3df3c27e10
--- /dev/null
+++ b/files/ja/preferences_system/examples/index.html
@@ -0,0 +1,38 @@
+---
+title: サンプル
+slug: Preferences_System/Examples
+tags:
+  - MDC Project
+  - Preferences system
+  - XUL
+translation_of: Mozilla/Preferences/Preferences_system/Examples
+---
+<div>{{Preferences_System_TOC}}</div>
+
+<h2 id="Example_preferences_dialog" name="Example_preferences_dialog">設定ダイアログの例</h2>
+
+<pre class="brush:xml">&lt;?xml version="1.0"?&gt;
+&lt;?xml-stylesheet href="<span class="nowiki">chrome://global/skin/</span>" type="text/css"?&gt;
+
+&lt;prefwindow
+  id="stockwatcher2-prefs"
+  title="StockWatcher 2 Options"
+  xmlns="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul"&gt;
+
+&lt;prefpane id="sw2-stock-pane" label="Stock Settings"&gt;
+  &lt;preferences&gt;
+    &lt;preference id="pref_symbol" name="stockwatcher2.symbol" type="string"/&gt;
+  &lt;/preferences&gt;
+
+  &lt;hbox align="center"&gt;
+    &lt;label control="symbol" value="Stock to watch: "/&gt;
+    &lt;textbox preference="pref_symbol" id="symbol" maxlength="4"/&gt;
+  &lt;/hbox&gt;
+&lt;/prefpane&gt;
+
+&lt;/prefwindow&gt;</pre>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+<ul>
+<li><a href="/ja/docs/Adding_preferences_to_an_extension">設定を拡張機能に加える</a></li>
+</ul>
diff --git a/files/ja/preferences_system/index.html b/files/ja/preferences_system/index.html
new file mode 100644
index 0000000000..b00294dfe8
--- /dev/null
+++ b/files/ja/preferences_system/index.html
@@ -0,0 +1,42 @@
+---
+title: 設定システム
+slug: Preferences_System
+tags:
+  - Preferences system
+  - XUL
+translation_of: Mozilla/Preferences/Preferences_system
+---
+<p> </p>
+<p>このドキュメントはAviary Toolkitの新しい設定システムについて説明します。このシステムを使用して、様々なプラットフォーム (Windows、 MacOS X および GNOME) で表示して動くのに適した設定ウインドウを作ることができます。</p>
+<p><strong>注意:</strong> 設定システムは Firefox/Thunderbird 1.5 (alpha版、beta版を含む) をスタートするときのみ利用できます。Firefox 1.0ベースのアプリケーションおよび拡張機能でこれを使うことはできません。</p>
+<p>新しい設定システムは、いくつかの<a href="/ja/XUL" title="ja/XUL">XUL</a>要素と属性によって実装されます。以下のリンクをクリックすることで、それらについての参考となる情報にアクセスできます。:</p>
+<div class="moreinfo">  <p><strong><a href="/ja/docs/Preferences_System">設定システム</a>の資料:</strong></p>  <ul>    <li>簡単な紹介: <a href="/ja/docs/Preferences_System/Getting_Started">Getting Started</a> | <a href="/ja/docs/Preferences_System/Examples">サンプル</a> | <a href="/ja/docs/Preferences_System/Troubleshooting">トラブルシューティング</a></li>    <li>リファレンス: <code><a href="/ja/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> | <a href="/ja/docs/Preferences_System/New_attributes">新しい属性</a></li>  </ul></div>
+<h3 id="使用方法">使用方法</h3>
+<p><span>this will eventually be moved from here</span></p>
+<p>典型的な設定ウィンドウのコードは、以下のようなものです。:</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;
+
+   .. 上のpreference要素を参照するユーザインターフェイス要素、例えば:
+    &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>ペインの内容は、内容となる要素をインラインで記述するか、または、動的なオーバーレイによって読み込まれるべき外部のリソースのchrome URIを指定することで、定義されます。必要に応じた異なるウィンドウタイトルを指定することが必要な場合、あなたがターゲットとし、そしてXULプリプロセッサを利用しようとしているプラットフォームごとのヒューマン・インターフェース・ガイドラインを注意深く読むべきです。また、プリプロセッサを使用して、それぞれのターゲットとするプラットフォームごとに適切なウィンドウの幅を（em単位で）指定する場合にも、注意してください。選択されたパネルが替わるのに合わせてウィンドウサイズを変更しないプラットフォーム（例：Windows）用に高さを（em単位で）指定する場合にも同様です。</p>
+<p>※日本語版注記：prefpaneの内容をすべてインラインで記述して、ウィンドウの幅も高さも指定しなければ、適切なウィンドウサイズに自動調整してくれるはず。</p>
+<h3 id="XULRunnerアプリケーションでの使用方法">XULRunnerアプリケーションでの使用方法</h3>
+<p>XULRunnerアプリケーションから設定ダイアログを開くために openDialog() メソッドを呼ぶ時は、ウィンドウの特性を示す文字列に"toolbar"が含まれているべきです。例:</p>
+<pre class="eval">var features = "chrome,titlebar,toolbar,centerscreen,modal";
+window.openDialog(url, "Preferences", features);
+</pre>
+<h3 id="Bugzilla">Bugzilla</h3>
+<p>（FirefoxおよびThunderbirdの設定ユーザインターフェイスではなく）設定のバインディングに関するバグのコンポーネントは、Toolkit:Preferences (<a class="link-https" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Toolkit">file a bug</a> <a class="link-https" href="https://bugzilla.mozilla.org/buglist.cgi?query_format=advanced&amp;product=Toolkit&amp;component=Preferences&amp;resolution=---&amp;chfieldto=Now">list open bugs</a>)です。</p>
+<p> </p>
+<p> </p>
diff --git a/files/ja/preferences_system/preference/index.html b/files/ja/preferences_system/preference/index.html
new file mode 100644
index 0000000000..6b279f7ed5
--- /dev/null
+++ b/files/ja/preferences_system/preference/index.html
@@ -0,0 +1,51 @@
+---
+title: '&lt;preference&gt; 要素リファレンス'
+slug: Preferences_System/preference
+tags:
+  - Preferences system
+  - XUL
+---
+<p> </p>
+<h3 id="概説"> 概説 </h3>
+<p><b><code>&lt;preference&gt;</code></b> は設定を表現する要素で、ユーザ設定の項目とユーザインターフェイス要素との間を仲介するために使われます。
+</p><p>この要素は <code><a href="ja/Preferences_System/preferences">&lt;preferences&gt;</a></code> 要素の直接の子要素として記述しなければいけません。
+</p>
+<h3 id="XUL構文"> XUL構文 </h3>
+<pre class="eval">&lt;preference id="<i>pref_id</i>" name="<i>preference.name</i>" type="<i>int</i>"/&gt;
+</pre>
+<h3 id="属性"> 属性 </h3>
+<dl><dt> <code>id</code> </dt><dd> 要素のid。これはユーザインターフェイス要素の <code>preference</code> 属性の値として使われます。
+</dd><dt> <code>instantApply</code> </dt><dd> もし全体の設定が、設定の変更を即座に反映しないようになっていても、この設定の変更を即座に反映させるために、この属性の値を <code>true</code> にセットすることができます。
+</dd><dt> <code>inverted</code> </dt><dd> （<code>type="bool"</code> である要素に対してのみ適用）この値が <code>true</code> にセットされている時、関連づけられたユーザインターフェイス要素の値は反転されてユーザ設定に保存されます。
+</dd><dt> <code>name</code> </dt><dd> この要素が制御する設定の名前（例えば、 &lt;tt&gt;browser.preferences.instantApply&lt;/tt&gt; ）。
+</dd><dt> <code>readonly</code> </dt><dd> <code>true</code>にセットした場合、関連づけられたユーザインターフェイス要素の値の変更は設定に影響しません。注意：この属性を<code>true</code>に設定しても、ユーザインターフェイス要素は無効化されません。<span>もしこれが意図された動作であるなら、いったいどんなケースで役に立つというのでしょうか？</span>
+</dd><dt> <code>type</code> </dt><dd> 設定の型。以下の値が利用可能です： <code>int</code> （整数値）, <code>bool</code> （真偽値）, <code>string</code> （Unicodeでない（ASCII）文字列）, <code>wstring</code> （<a class="external" href="http://kb.mozillazine.org/Dev_:_Using_preferences#nsIPrefLocalizedString"><code>nsIPrefLocalizedString</code></a>のような文字列）, <code>unichar</code> （Unicode文字列）, <code>file</code> (<code>nsIFile</code>)
+</dd><dd>※日本語版注記：つまり、日本語の文字列を保存させる場合は<code>string</code>ではなく<code>unichar</code>を指定する必要がある。
+</dd></dl>
+<h3 id="プロパティ"> プロパティ </h3>
+<dl><dt> <code>defaultValue</code> （読み取り専用） </dt><dd> その設定の既定の値を返します。このプロパティの型は、 <code>type</code> プロパティによって指定された値に依存します。
+</dd><dt> <code>disabled</code> （真偽値）</dt><dd> <code>disabled</code> 属性の値を設定/取得し、同時に、関連づけられたユーザインターフェイス要素の <code>disabled</code> プロパティも更新します。（しかし初期値は何も影響しないようですが？？）
+</dd><dt> <code>hasUserValue</code> （読み取り専用、真偽値） </dt><dd> その設定がユーザによって変更された値を持つ場合、 <code>true</code> を返します。
+</dd><dt> <code>instantApply</code> （読み取り専用、真偽値） </dt><dd> この設定が <i>即座に反映される</i> かどうかを調べるために使われます。この要素の <code>instantApply</code> 属性が <code>true</code> に設定されているか、もしくは <code>&lt;prefwindow&gt;</code> の <code>instantApply</code> が <code>true</code> である場合に、 <code>true</code> となります。（しかし<a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=293439">bug 293439</a>にも注意してください）
+</dd><dt> <code>inverted</code> （真偽値） </dt><dd> <code>inverted</code> 属性の値を取得または設定します。
+</dd><dt> <code>locked</code> （読み取り専用、真偽値） </dt><dd> この設定が <i>ロックされている</i> 場合、 <code>true</code> を返します。
+</dd><dt> <code>name</code> （文字列） </dt><dd> <code>name</code> 属性の値を取得または設定します。
+</dd><dt> <code>preferences</code> （読み取り専用、DOMElement） </dt><dd> <code>&lt;preferences&gt;</code> 要素の親要素。
+</dd><dt> <code>readonly</code> （真偽値） </dt><dd> <code>readonly</code> 属性の値を取得または設定します。
+</dd><dt> <code>tabIndex</code> （整数値） </dt><dd> <code>tabindex</code> 属性の値を取得または設定し、関連づけられたユーザインターフェイス要素のtabindex属性も更新します。（？？ <code>disabled</code>のものと同じコメント）
+</dd><dt> <code>type</code> （文字列） </dt><dd> <code>type</code> 属性の値を取得または設定します。
+</dd><dt> <code>value</code> </dt><dd> その設定の現在の値。もし instantApply がONである場合、この値は常に <code>valueFromPreferences</code> の値に等しいです。さもなくば、これは関連づけられたユーザインターフェイス要素の現在の値（言い替えれば、現在ユーザが見ている値）です。
+</dd><dt> <code>valueFromPreferences</code> </dt><dd> <code>name</code> 属性で指定されたユーザ設定に保存されている値を取得または設定します。
+</dd></dl>
+<h3 id="メソッド"> メソッド </h3>
+<dl><dt> <code>type getElementValue(in DOMElement element);</code> </dt><dd> 渡された値の現在の状態に基づいて、設定に書き込まれるべき値を取得します。このメソッドは <code>onsynctopreference</code> イベントハンドラを呼びます。
+</dd><dt> <code>boolean isElementEditable(in DOMElement element)</code> </dt><dd> 与えられた要素が "編集可能"（以下を参照）である場合に <code>true</code> を返します。
+</dd><dt> <code>void reset();</code> </dt><dd> 設定を既定の値にリセットします。
+</dd><dd> <b>注意:</b> このメソッドは、まだその設定がユーザによって変更されていない場合、例外を投げます。<span>（これは意図された動作なのでしょうか？？）</span>
+</dd><dt> <code>void setElementValue(in DOMElement element);</code> </dt><dd> 設定に保存された値に基づいて、渡された要素を初期化します。このメソッドは <code>onsyncfrompreference</code> イベントハンドラを呼びます。
+</dd><dt> <code>void updateElements();</code> </dt><dd> この設定を監視している全ての要素を更新します。
+</dd></dl>
+<h3 id="イベント"> イベント </h3>
+<dl><dt> <code>change</code> </dt><dd> 設定の値が変更された時、<code>onchange</code> または <code>change</code> イベントが &lt;preference&gt; 要素において発行されます。あなたは必要に応じてこれをハンドルできます。
+</dd></dl>
+<div class="moreinfo">  <p><strong><a href="/ja/docs/Preferences_System">設定システム</a>の資料:</strong></p>  <ul>    <li>簡単な紹介: <a href="/ja/docs/Preferences_System/Getting_Started">Getting Started</a> | <a href="/ja/docs/Preferences_System/Examples">サンプル</a> | <a href="/ja/docs/Preferences_System/Troubleshooting">トラブルシューティング</a></li>    <li>リファレンス: <code><a href="/ja/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> | <a href="/ja/docs/Preferences_System/New_attributes">新しい属性</a></li>  </ul></div>
diff --git a/files/ja/preferences_system/preferences/index.html b/files/ja/preferences_system/preferences/index.html
new file mode 100644
index 0000000000..57519e657c
--- /dev/null
+++ b/files/ja/preferences_system/preferences/index.html
@@ -0,0 +1,34 @@
+---
+title: '&lt;preferences&gt; 要素リファレンス'
+slug: Preferences_System/preferences
+tags:
+  - Preferences system
+  - XUL
+---
+<p> </p>
+<h3 id=".E6.A6.82.E8.AA.AC"> 概説 </h3>
+<p><b><code>&lt;preferences&gt;</code></b> は <code><a href="ja/Preferences_System/preference">&lt;preference&gt;</a></code> 要素のためのコンテナ要素です。この要素は <code><a href="ja/Preferences_System/prefpane">&lt;prefpane&gt;</a></code> 要素の子要素であることが想定されます。
+</p><p><code>&lt;preferences&gt;</code> 要素は一つ以上の <code>&lt;preference&gt;</code> 要素を含んでいるべきです。
+</p><p><i>注意: 以下のメソッドとプロパティのうちどれが公開のものであるかは、明らかになっていません。</i>
+</p>
+<h3 id="XUL.E6.A7.8B.E6.96.87"> XUL構文 </h3>
+<pre class="eval">&lt;preferences&gt;
+  &lt;preference id="pref_one" name="extensions.myextension.one" type="bool"/&gt;
+  &lt;preference id="pref_two" name="extensions.myextension.two" type="string"/&gt;
+    ... などなど ...
+&lt;/preferences&gt;
+</pre>
+<h3 id=".E3.83.A1.E3.82.BD.E3.83.83.E3.83.89"> メソッド </h3>
+<dl><dt> <code>void fireChangedEvent(in DOMElement preference);</code> </dt><dd> 渡された <code>preference</code> 要素のための（バブリングしない） <code>changed</code> イベントを生成して発行します。また、その要素の <code>onchanged</code> 属性で指定されたコードを実行します。<a href="ja/Preferences_System/preference#change">&lt;preference&gt; の change イベント</a>の説明も参照してください。
+</dd><dt> <code>void observe(in nsISupports aSubject, in string aTopic, in wstring aData);</code> </dt><dd> <a href="ja/NsIObserver">nsIObserver</a> のメソッドは、この要素の子要素としてリストされたpreference要素の変更を反映するために、内部的に使用されます。
+</dd></dl>
+<h3 id=".E3.83.95.E3.82.A3.E3.83.BC.E3.83.AB.E3.83.89"> フィールド </h3>
+<p><span>これらは読み取り専用であることが期待されます; これらのうち3つは一つのメンバに統合されることができました。</span>
+</p>
+<dl><dt> <code>attribute <a href="ja/NsIPrefService">nsIPrefService</a> service;</code> </dt><dd> 設定サービス。
+</dd><dt> <code>attribute <a href="ja/NsIPrefBranch">nsIPrefBranch</a> rootBranch;</code> </dt><dd> 設定の枝のルート（The root prefs branch）。
+</dd><dt> <code>attribute <a href="ja/NsIPrefBranch">nsIPrefBranch</a> defaultBranch;</code> </dt><dd> 既定の値を示す、設定のツリーの枝のルート（The root prefs branch of the tree with default values）。
+</dd><dt> <code>attribute <a href="ja/NsIPrefBranch2">nsIPrefBranch2</a> rootBranchInternal;</code> </dt><dd> <code><a href="ja/NsIPrefBranch2">nsIPrefBranch2</a></code>インターフェイスによる、設定の枝のルート。
+</dd></dl>
+<p>{{ Preferences_System_TOC() }}
+</p>{{ languages( { "en": "en/Preferences_System/preferences" } ) }}
diff --git a/files/ja/preferences_system/prefpane/index.html b/files/ja/preferences_system/prefpane/index.html
new file mode 100644
index 0000000000..367fa3d3d3
--- /dev/null
+++ b/files/ja/preferences_system/prefpane/index.html
@@ -0,0 +1,79 @@
+---
+title: '&lt;prefpane&gt; 要素リファレンス'
+slug: Preferences_System/prefpane
+tags:
+  - Preferences system
+  - XUL
+---
+<p> </p>
+<h3 id=".E6.A6.82.E8.AA.AC" name=".E6.A6.82.E8.AA.AC"> 概説 </h3>
+<p><b><code>&lt;prefpane&gt;</code></b> は、設定ウィンドウの <i>ペイン</i> （タブ）を意味する要素です。それは <code><a href="ja/Preferences_System/prefwindow">&lt;prefwindow&gt;</a></code> 要素の子要素でなければいけません。
+</p><p>一般的に、一つの <code>&lt;prefpane&gt;</code> 要素は子要素として一つの <code><a href="ja/Preferences_System/preferences">&lt;preferences&gt;</a></code> 要素と、ユーザインターフェイスのための追加の要素を含みます。
+</p><p><code>&lt;prefpane&gt;</code> 要素は、全ての内容をインラインの要素として含めるか、または、<code>src="<a class=" external" rel="freelink">chrome://uri/to/overlay.xul</a>"</code> 属性によって示された、外部のオーバーレイ用リソースのchrome URIを参照することができます。外部のリソースは、ペインが選択された時に読み込まれます。後者の方法は、あなたの設定ウィンドウの内容が非常に大きい場合に、ウィンドウがユーザに対して表示されるよりも前に一つのペインだけが読み込まれるのに必要な時間と同程度に、ウィンドウ全体が読み込まれるまでの時間を減らすために使うことができます。
+</p>
+<h3 id="XUL.E6.A7.8B.E6.96.87" name="XUL.E6.A7.8B.E6.96.87"> XUL構文 </h3>
+<pre class="eval">&lt;prefpane id="paneGeneral" label="General" src="<a class=" external" rel="freelink">chrome://path/to/paneOverlay.xul</a>"/&gt;
+</pre>
+<p>または
+</p>
+<pre class="eval">&lt;prefpane id="paneGeneral" label="General" onpaneload="onGeneralPaneLoad(event);"&gt;
+  &lt;preferences&gt;
+    &lt;preference id="pref_one" name="extensions.myextension.one" type="bool"/&gt;
+     ... さらにいくつかの設定 ...
+  &lt;/preferences&gt;
+
+  &lt;checkbox label="Number one?" preference="pref_one"/&gt;
+  ... さらにいくつかのユーザインターフェイス要素 ...
+&lt;/prefpane&gt;
+</pre>
+<h3 id=".E5.B1.9E.E6.80.A7" name=".E5.B1.9E.E6.80.A7"> 属性 </h3>
+<dl><dt> <code>id</code> </dt><dd> ペインのID。これは動的なオーバーレイで要素をマッチングするために使われることがありますが、もしペインの動的な読み込みを使わない場合でも、すべての <code>&lt;prefpane&gt;</code> 要素に対してidを提供する必要があります。
+</dd><dt> <code>image</code> </dt><dd> ペインのボタンに使用される画像のURL。（実行時にこの属性を動的に変更しても、ペインのボタンの画像は更新されません。）
+</dd><dt> <code>label</code> </dt><dd> ペインのボタンのラベル文字列。
+</dd><dt> <code>selected</code> </dt><dd> そのペインが現在選択されている（アクティブである）かどうかを示します。（XULの作成時にこの属性を指定しても、機能しません。代わりに <code>&lt;prefwindow&gt;</code> 要素の <code>lastSelected</code> 属性を使ってください。）<span class="comment">これはよくありません。</span>
+</dd><dt> <code>src</code> </dt><dd> 前述の通り、そのペインの内容を提供するオーバーレイ用リソースのURLを指定します。
+</dd></dl>
+<h3 id=".E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3" name=".E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3"> プロパティ </h3>
+<p>（todo: 実行時にこれらの属性やプロパティに値をセットした時に何が起こるのかを調べること。私はこれらの全てが実行時に機能するとは思わない。）
+</p>
+<dl><dt> <code>contentHeight</code> （読み取り専用） </dt><dd> 現在のペインの内容の高さ（ピクセル単位）。
+</dd><dt> <code>image</code> </dt><dd> <code>image</code> 属性の値を設定または取得します。（実行時にこのプロパティに値を設定しても機能しません。）
+</dd><dt> <code>label</code> </dt><dd> <code>label</code> 属性の値を設定または取得します。（実行時にこのプロパティに値を設定しても機能しません。）
+</dd><dt> <code>loaded</code> </dt><dd> そのペインが完全に読み込まれているかどうかを示します。<span class="comment">このプロパティはコード内で、本当に読み取り専用になっていなくてはなりません。</span>
+</dd><dt> <code>preferenceElements</code> （読み取り専用） </dt><dd> <code>preference</code> 属性を持つ子要素の <code>NodeList</code> 。
+</dd><dt> <code>preferences</code> （読み取り専用） </dt><dd> 全ての子要素である <code>&lt;preference&gt;</code> 要素の <code>NodeList</code> 。
+</dd><dt> <code>selected</code> </dt><dd> <code>selected</code> 属性の値を設定または取得します。
+</dd><dt> <code>src</code> </dt><dd> <code>src</code> 属性の値を設定または取得します。
+</dd></dl>
+<h3 id=".E3.83.A1.E3.82.BD.E3.83.83.E3.83.89" name=".E3.83.A1.E3.82.BD.E3.83.83.E3.83.89"> メソッド </h3>
+<dl><dt> <code>DOMElement getPreferenceElement(in DOMElement startElement)</code> </dt><dd> ??
+</dd><dt> <code>DOMElement preferenceForElement(in DOMElement element);</code> </dt><dd> 渡された要素を監視している <code>&lt;preference&gt;</code> 要素（言い替えると、 <code>element</code> の <code>preference</code> 属性で指定されている要素）を取得します。
+</dd><dt> <code>void userChangedValue(in DOMElement element);</code> </dt><dd> 設定システムのウィジェットの中でユーザが変更した値は、(1)の理由のため、自動的には状態の変化に追従しません。そのウィジェットに関連づけられた preference 要素は、そのウィジェット自身に保持されている状態に基づいて更新されるべきです。例えば、もしあなたがlistbox要素を使っていて、ユーザがlistboxの内容を（アイテムの追加や削除などで）変更し、あなたがその変更を preference 要素に同期的に反映させたい場合、あなたは <code>onsynctopreference</code> イベントハンドラを、 preference 要素に書き込まれるべき値を返すlistbox要素に記述し、あなたがリストの内容について preference 要素の値を変更するような編集を行う度に、 <code>userChangedValue</code> メソッドを呼ばなくてはいけません。
+</dd><dd> (1) それのために状態の変化が追従するウィジェットに関する例としては、 "command" イベントが発行される時に状態が自動的に追従する、 checkbox 要素が含まれます。
+</dd><dd>※日本語版注記：上の説明が分かりにくいので解説。この設定システムは、ユーザがUI要素を操作して状態が変化した場合に限って、UI要素の状態の変化を、その要素に関連づけられたpreference要素の値に反映させる。例えばcheckbox要素がクリックされてチェック状態がONになった場合、関連づけられたpreference要素のvalueは追従してtrueになる。しかし、（他の設定に連動するなどして）スクリプト操作でcheckboxの状態をONにした場合は、関連づけられたpreference要素のvalueは追従しないため変化しない。このような場合は、userChangedValueメソッドにcheckboxを渡して、その時のcheckbox要素の状態をpreference要素のvalueに強制的に反映させることができる。
+</dd><dt> <code>void writePreferences(in boolean flushToDisk);</code> </dt><dd> このペインの中での変更をすべて設定に書き込みます。オプション指定によって、ディスクに設定を書き込みます。
+</dd></dl>
+<h3 id=".E3.82.A4.E3.83.99.E3.83.B3.E3.83.88" name=".E3.82.A4.E3.83.99.E3.83.B3.E3.83.88"> イベント </h3>
+<dl><dt> <code>paneload</code> </dt><dd> このイベントは、そのペインが完全に読み込まれた時（例えば、オーバーレイが完全に統合された時）に、ペインの要素において発行されます。あなたはこの要素の <code>onpaneload</code> 属性によって、このイベントのためのイベントハンドラを置くことができます。
+</dd></dl>
+<h3 id=".E8.A4.87.E6.95.B0.E3.81.AE_prefpanes_.E8.A6.81.E7.B4.A0.E3.81.AE.E4.BD.BF.E7.94.A8.E6.96.B9.E6.B3.95" name=".E8.A4.87.E6.95.B0.E3.81.AE_prefpanes_.E8.A6.81.E7.B4.A0.E3.81.AE.E4.BD.BF.E7.94.A8.E6.96.B9.E6.B3.95"> 複数の <code>prefpane</code>s 要素の使用方法 </h3>
+<p>注意：複数の <code>prefpane</code> 要素を同じ<code>prefwindow</code> 要素の中で使う時は、 <code>&lt;script&gt;</code> 要素を <code>prefpane</code> 要素よりも後に置いてもいいですが、それらよりも前に置いてはいけません。さもなくば、そのダイアログは異常な挙動を示し、正常に表示されないでしょう。
+</p><p>正常に働かせるためには、 <code>&lt;script&gt;</code> タグは以下の設定ダイアログの例のように記述してください。:
+</p>
+<pre class="eval">&lt;prefwindow&gt;
+  &lt;prefpane id="paneGeneral" label="General"&gt;
+    ...
+  &lt;/prefpane&gt;
+
+  &lt;prefpane id="paneSecurity" label="Security"&gt;
+    ...
+  &lt;/prefpane&gt;
+
+  &lt;script type="application/javascript" src="<a class=" external" rel="freelink">chrome://myext/content/script0.js</a>"&gt;
+  &lt;script type="application/javascript" src="<a class=" external" rel="freelink">chrome://myext/content/script1.js</a>"&gt;
+&lt;/prefwindow&gt;
+</pre>
+<p>複数のペインを含むダイアログを開く場合、<code>openDialog</code>の機能指定に<code>toolbar</code>を入れておかないといけません。例：
+</p><p>window.openDialog("chrome//example/content/prefwin.xul", "", "chrome,toolbar");
+</p><p>{{ Preferences_System_TOC() }}
+</p>{{ languages( { "en": "en/Preferences_System/prefpane" } ) }}
diff --git a/files/ja/preferences_system/prefwindow/index.html b/files/ja/preferences_system/prefwindow/index.html
new file mode 100644
index 0000000000..1920527ed5
--- /dev/null
+++ b/files/ja/preferences_system/prefwindow/index.html
@@ -0,0 +1,84 @@
+---
+title: '&lt;prefwindow&gt; 要素リファレンス'
+slug: Preferences_System/prefwindow
+tags:
+  - Preferences system
+  - XUL
+---
+<p> </p>
+<h3 id=".E6.A6.82.E8.AA.AC" name=".E6.A6.82.E8.AA.AC"> 概説 </h3>
+<p><b><code>&lt;prefwindow&gt;</code></b> は設定ウィンドウの documentElement （言い替えると、 <code>&lt;window&gt;</code> や <code>&lt;dialog&gt;</code> のようなトップレベルの要素）です。
+</p><p>この要素は一つ以上の<code><a href="ja/Preferences_System/prefpane">&lt;prefpane&gt;</a></code> 要素を含んでいるべきです。
+</p>
+<h3 id="XUL.E6.A7.8B.E6.96.87" name="XUL.E6.A7.8B.E6.96.87"> XUL構文 </h3>
+<p>未定
+</p>
+<pre class="eval">&lt;prefwindow xmlns="<a class=" external" href="http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" rel="freelink">http://www.mozilla.org/keymaster/gat...re.is.only.xul</a>"
+       id="window-id" windowtype="window:type" title="Options"
+       style="未定"&gt;
+  一つ以上のprefpane要素
+&lt;/prefwindow&gt;
+</pre>
+<h3 id=".E5.B1.9E.E6.80.A7" name=".E5.B1.9E.E6.80.A7"> 属性 </h3>
+<dl><dt> <code>lastSelected</code> </dt><dd>最後に選択されたペインの <code>id</code> 。設定ウィンドウが次に開かれたときに、そのペインを再び開くために使用されます。
+</dd><dt> <code>type</code> </dt><dd> <code>"prefwindow"</code> または <code>"child"</code> のどちらかでなくてはいけません。
+</dd><dd> <code>type="child"</code> は、トップレベルの設定ウィンドウから開かれるサブダイアログ（それは通常モーダルダイアログです）であることを示します。（MacOS XやGNOMEのように）設定を即座に適用する環境では、このサブダイアログは、それらの設定を書き込んでもよいかどうか確認されます。（Windowsのように）設定を即座に適用しない環境でサブダイアログが確認された時（OKボタンが押された時）は、なされた変更は親ウィンドウの<code>&lt;preferences&gt;</code>のセットに保持され、親ウィンドウが確認された時に保存されます。子ウィンドウとなる設定ウィンドウは、複数のペインを持つことはできません。
+</dd><dt> <code>dlgbuttons</code> </dt><dd> dialog要素の場合と同じです。
+</dd></dl>
+<h3 id=".E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3" name=".E3.83.97.E3.83.AD.E3.83.91.E3.83.86.E3.82.A3"> プロパティ </h3>
+<dl><dt> <code>currentPane</code> （読み取り専用） </dt><dd> 現在選択されている <code>&lt;prefpane&gt;</code> 要素。他のペインを選択するには <code>showPane()</code> メソッドを使用してください。（<code>instantApply</code> に対するものと同じコメント）
+</dd><dt> <code>instantApply</code> （読み取り専用） </dt><dd> そのウィンドウが設定を即座に適用するモードかどうかを示します。値は真偽値のユーザ設定 <code>browser.preferences.instantApply</code> から読み込まれます。（？？　それは <code>&lt;field&gt;</code>として宣言されている、ということはあなたは値をセットすることが <i>できる</i> 、しかしながら私はそうすることが正当とは信じられない。）
+</dd><dt> <code>lastSelected</code> （読み取り専用） </dt><dd> <code>lastSelected</code> 属性の値を返します。
+</dd><dt> <code>preferencePanes</code> （読み取り専用） </dt><dd> <code>&lt;prefpane&gt;</code> 要素の <code>NodeList</code> 。
+</dd><dt> <code>type</code> （読み取り専用） </dt><dd> <code>type</code> 属性の値を返します。
+</dd></dl>
+<h3 id=".E3.83.A1.E3.82.BD.E3.83.83.E3.83.89" name=".E3.83.A1.E3.82.BD.E3.83.83.E3.83.89"> メソッド </h3>
+<dl><dt> <code>void addPane(in DOMElement pane);</code> </dt><dd> 渡された <code>&lt;prefpane&gt;</code> 要素を設定ウィンドウに加えます。あなたはこのメソッドを、動的に生成された設定ペインをダイアログに加えるために使用できます。
+</dd><dt> <code>animate(aOldPane, aNewPane)</code> </dt><dd> これは公開メソッドではありません（？）
+</dd><dt> <code>DOMWindow openSubDialog(in string url, in string features, in object params);</code> </dt><dd> モーダルなサブダイアログを、設定ウィンドウの子ウィンドウとして開きます。このメソッドが使用される時 <code>modal</code> と <code>centerscreen</code> が自動的に付与されるために、それらを特性として示す必要が無い点を除いて、 <code>window.openDialog</code> に似ています。Firefoxの接続設定のような、モーダルなサブダイアログを開くためにこのメソッドを使用してください。
+</dd><dt> <code>DOMWindow openWindow(in string windowType, in string url, in string features, in object params);</code> </dt><dd> モーダルでないサブウィンドウを設定ウィンドウの子ウィンドウとして開きます。あなたはウィンドウタイプを指定することができ、そのタイプのウィンドウがすでに存在して開かれている場合、新しいウィンドウを開く代わりに、そのウィンドウがフォーカスされます。このようなサブウィンドウの例は、Firefoxの設定の例外ウィンドウです。
+</dd><dt> <code>void showPane(in DOMElement paneElement)</code> </dt><dd> 与えられたペインを選択して、必要であれば動的に読み込みます。 <code>paneElement</code> は同じウィンドウに含まれる <code>&lt;prefpane&gt;</code> 要素でなければなりません。
+</dd></dl>
+<p>注意：あなたは、そのウィンドウがすでに開かれていた場合に、 <code>openWindow()</code> を使って渡されたパラメータを受け取るために、サブウィンドウ内で <code>initWithParams()</code> 関数を定義することができます。例えば、Firefoxのパーミッションマネージャのユーザインターフェイスは、画像、ソフトウェアのインストール、そしてポップアップのブロックという3つのダイアログのために、同じウィンドウを使っています。それは、ウィンドウを閉じて開き直すことなくダイアログのタイプを切り替えるために <code>initWithParams()</code> を使っています。
+</p><p>提案される利用例のパターンは以下のようなものです:
+</p>
+<pre>// subwindow.js
+function onLoad(ev) {
+  // 何らかの初期化処理...
+
+  initWithParams(window.arguments[0]); // 私たちは一つだけのパラメータがこのウィンドウに渡されることを期待しています
+}
+
+function initWithParams(aParams) {
+  // これはすでに開かれているウィンドウが openWindow() を使ってアクティブにされる時にも呼ばれます
+}
+</pre>
+<h3 id=".E6.B3.A8.E6.84.8F" name=".E6.B3.A8.E6.84.8F">注意</h3>
+<h4 id=".E3.83.A2.E3.83.BC.E3.83.80.E3.83.AB.E3.81.AA.E3.82.B5.E3.83.96.E3.83.80.E3.82.A4.E3.82.A2.E3.83.AD.E3.82.B0.E3.82.92.E9.96.8B.E3.81.8F.E5.A0.B4.E5.90.88" name=".E3.83.A2.E3.83.BC.E3.83.80.E3.83.AB.E3.81.AA.E3.82.B5.E3.83.96.E3.83.80.E3.82.A4.E3.82.A2.E3.83.AD.E3.82.B0.E3.82.92.E9.96.8B.E3.81.8F.E5.A0.B4.E5.90.88">モーダルなサブダイアログを開く場合</h4>
+<p>サブダイアログは、 <code>window</code> を通じてではなく、 <code>document.documentElement</code> を通じてのみ開くことができます。そのため、 <code>openSubDialog()</code> を呼ぶ例は以下のようになります。:
+</p>
+<pre class="eval">document.documentElement.openSubDialog("<a class=" external" rel="freelink">chrome://myextension/content/options-sub.xul</a>", "", null)
+</pre>
+<p><br>
+</p>
+<h4 id="prefpane.E4.BB.A5.E5.A4.96.E3.81.AE.E5.AD.90.E3.82.92.E6.8C.81.E3.81.9F.E3.81.9B.E3.82.8B.E9.9A.9B.E3.81.AE.E6.B3.A8.E6.84.8F" name="prefpane.E4.BB.A5.E5.A4.96.E3.81.AE.E5.AD.90.E3.82.92.E6.8C.81.E3.81.9F.E3.81.9B.E3.82.8B.E9.9A.9B.E3.81.AE.E6.B3.A8.E6.84.8F">prefpane以外の子を持たせる際の注意</h4>
+<p>script要素で外部のスクリプトを読み込ませるなどの目的で、prefwindow要素の子にprefpane要素以外の要素を置く場合、すべてのprefpane要素の後にこれらの要素を記述します。最初のprefpane要素よりも前にこれらの要素を記述した場合、パネルの切り替えに失敗するなどの問題が起こることがあります。
+</p><p>誤：
+</p>
+<pre class="eval">&lt;prefwindow&gt;
+  &lt;script src="config.js"/&gt;
+  &lt;prefpane label="pane1" src="pane1.xul"/&gt;
+  &lt;prefpane label="pane2" src="pane2.xul"/&gt;
+&lt;/prefwindow&gt;
+</pre>
+<p>正：
+</p>
+<pre class="eval">&lt;prefwindow&gt;
+  &lt;prefpane label="pane1" src="pane1.xul"/&gt;
+  &lt;prefpane label="pane2" src="pane2.xul"/&gt;
+  &lt;script src="config.js"/&gt;
+&lt;/prefwindow&gt;
+</pre>
+<p><br>
+{{ Preferences_System_TOC() }}
+</p>{{ languages( { "en": "en/Preferences_System/prefwindow" } ) }}
diff --git a/files/ja/preferences_system/troubleshooting/index.html b/files/ja/preferences_system/troubleshooting/index.html
new file mode 100644
index 0000000000..097e82d9e9
--- /dev/null
+++ b/files/ja/preferences_system/troubleshooting/index.html
@@ -0,0 +1,12 @@
+---
+title: トラブルシューティング
+slug: Preferences_System/Troubleshooting
+tags:
+  - NeedsContent
+  - Preferences system
+  - XUL
+translation_of: Mozilla/Preferences/Preferences_system/Troubleshooting
+---
+<p> </p><p><a href="ja/XUL_FAQ#prefwindow.E3.83.99.E3.83.BC.E3.82.B9.E3.81.AE.E8.A8.AD.E5.AE.9A.E3.82.A6.E3.82.A3.E3.83.B3.E3.83.89.E3.82.A6.E3.81.AB.E9.96.A2.E3.81.99.E3.82.8B.E3.83.88.E3.83.A9.E3.83.96.E3.83.AB.E3.82.B7.E3.83.A5.E3.83.BC.E3.83.86.E3.82.A3.E3.83.B3.E3.82.B0">XUL FAQのprefwindowベースの設定ウィンドウに関するトラブルシューティング</a>を参照してください。
+</p><p><br>
+</p><div class="moreinfo">  <p><strong><a href="/ja/docs/Preferences_System">設定システム</a>の資料:</strong></p>  <ul>    <li>簡単な紹介: <a href="/ja/docs/Preferences_System/Getting_Started">Getting Started</a> | <a href="/ja/docs/Preferences_System/Examples">サンプル</a> | <a href="/ja/docs/Preferences_System/Troubleshooting">トラブルシューティング</a></li>    <li>リファレンス: <code><a href="/ja/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/prefpane" title="prefpane">prefpane</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/preferences" title="preferences">preferences</a></code> | <code><a href="/ja/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code> | <a href="/ja/docs/Preferences_System/New_attributes">新しい属性</a></li>  </ul></div>