From 6ef1fa4618e08426b874529619a66adbd3d1fcf0 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 12:07:59 +0100 Subject: unslug ja: move --- .../index.html | 89 ++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 files/ja/orphaned/dynamically_modifying_xul-based_user_interface/index.html (limited to 'files/ja/orphaned/dynamically_modifying_xul-based_user_interface') diff --git a/files/ja/orphaned/dynamically_modifying_xul-based_user_interface/index.html b/files/ja/orphaned/dynamically_modifying_xul-based_user_interface/index.html new file mode 100644 index 0000000000..06e02a5102 --- /dev/null +++ b/files/ja/orphaned/dynamically_modifying_xul-based_user_interface/index.html @@ -0,0 +1,89 @@ +--- +title: Dynamically modifying XUL-based user interface +slug: Dynamically_modifying_XUL-based_user_interface +tags: + - Add-ons + - DOM + - Extensions + - XUL +--- +

この記事では、DOM やその他の API を使って XUL インターフェイスを操作する方法について検討します。まず DOM + + ドキュメント + の概念について説明し、DOM の呼び出しを使ってドキュメントを操作する基本的な方法の例を幾つか実演したのち、 Mozilla 固有のメソッドを使って + + 匿名 XBL コンテント + を操作する方法を実演します。

+

この記事は XUL 開発の初心者から中級者を対象にしており、読者が XUL と JavaScript の基本的な知識を持っていることを想定しています。Document Object Model について の記事や Gecko DOM リファレンス の 導入ページ といった DOM に関する入門記事も必要があればお読み下さい。

+


+ {{ 英語版章題("Introduction") }}

+

はじめに

+

ご存知の通り、XUL は Firefox や Thunderbird のような様々な Mozilla ベースのアプリケーションでユーザーインターフェイスを記述するのに使われている XML 言語です。XUL アプリケーションでは動作を定義するのに JavaScript が使われており、その中では XUL ドキュメントにアクセスするのに DOM API を使っています。

+

では Document Object Model API とは何なのでしょうか？

+

DOM API はスクリプトとドキュメント間で行われるやり取りのあらゆる所で使われるインターフェイスです。一度でも XUL (または HTML) ドキュメントとやり取りするスクリプトを書いた事があるなら、あなたは既に DOM 呼び出しを使っています。最も有名な DOM メソッドはおそらく document.getElementById() で、これは与えられた id に対応する要素を返します。あなたはそれ以外にも element.setAttribute() や、拡張機能を書いた事があるなら addEventListener() といった呼び出しを使った事があるかもしれません。これらは全て DOM で定義されているものです。

+

DOM メソッドには、ドキュメントに要素を作成したり、動かしたり、削除するものもあります。これらは後のセクションで実演します。まずは、 + + ドキュメント + とは何なのかについて学びましょう。

+

{{ 英語版章題("What is a document?") }}

+

ドキュメントとは何か？

+

ドキュメントは DOM API を使って操作できるデータ構造です。あらゆるドキュメントの論理的な構造はツリー状になっており、ノードとしての要素、属性、処理命令、コメントなどで出来ています。ドキュメントのツリー表現を見るには DOM Inspector を使ってください。Todo: XUL ドキュメントとツリーの簡単な例

+

ドキュメントは、妥当な HTML や整形式の (XHTML や XUL 等の) XML の、メモリ内部の表現とみなす事が出来ます。

+

異なるウェブページは (同じウェブページの異なるインスタンスであっても) 異なるドキュメントに対応しているということを覚えておく事が重要です。それぞれの XUL ウィンドウはそれ自身の独自のドキュメントを持っており、<iframe> や <browser> 、<tabbrowser> 要素を持っている場合には一つのウィンドウにさらに幾つかの異なるドキュメントがあるということになります。このため、扱っているのが適切なドキュメントなのかを常に確認する必要があります。 (詳しくは chrome コードでウィンドウを扱う を参照。) スクリプトが <script> タグを使って読み込まれているなら、document プロパティはそのスクリプトが含まれる DOM ドキュメントを参照します。

+

{{ 英語版章題("Examples: Using DOM methods") }}

+

DOM メソッドの使用例

+

このセクションでは DOM メソッドの appendChild() 、createElement() 、insertBefore() 、removeChild() の使い方を実演します。

+

{{ 英語版章題("= Removing all children of an element =") }}

+

ある要素の子要素を全て削除する

+

この例では、id=someElement である要素の全ての子要素を現在のドキュメントから削除するために、removeChild() メソッドを呼び出して子要素が全てなくなるまで最初の子要素を削除しています。

+

hasChildNodes() と firstChild も DOM API の一部です。

+
var element = document.getElementById("someElement");
+  while(element.hasChildNodes()){
+    element.removeChild(element.firstChild);
+  }
+
+

{{ 英語版章題("= Inserting menu items to a menu =") }}

+

メニューにメニューアイテムを挿入する

+

この例では <menupopup> の最初と最後に二つの新しいメニューアイテムを追加します。アイテムを作成するのには document.createElementNS() メソッドを使用しており、作成された xml 要素を insertBefore() と appendChild() を使ってドキュメントに挿入しています。

+

注:

+ +
function createMenuItem(aLabel) {
+  const XUL_NS = "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul";
+  var item = document.createElementNS(XUL_NS, "menuitem"); // 新しい XUL メニューアイテムを作成する
+  item.setAttribute("label", aLabel);
+  return item;
+}
+var popup = document.getElementById("myPopup"); // <menupopup> 要素
+var first = createMenuItem("First item");
+var last = createMenuItem("Last item");
+popup.insertBefore(first, popup.firstChild);
+popup.appendChild(last);
+
+

appendChild() や insertBefore() は存在している要素を動かすのにも使えます。例えば次の文を上の例の最後の行に追加すれば、 "First item" とラベルが付けられたアイテムをポップアップの最後に動かす事が出来ます。

+
popup.appendChild(first);
+
+

この文はノードをドキュメントの現在の位置から削除して、ポップアップの最後に再び挿入します。

+

{{ 英語版章題("Anonymous content (XBL)") }}

+

匿名コンテント (XBL)

+

XBL は Mozilla で新しいウィジェットを定義するのに使用される言語です。XBL で定義されたウィジェットは、バインディングが設定される時に、バインドされた要素に挿入するコンテントを定義する事ができます。このコンテントは、 + + 匿名コンテント + と呼ばれ、通常の DOM メソッドによってアクセスする事は出来ません。

+

代わりに、nsIDOMDocumentXBL インターフェイスのメソッドを使う必要があります。例えば

+
// 与えられたノードの最初の匿名子要素を取得する
+document.getAnonymousNodes(node)[0];
+
+// anonid 属性が el1 である匿名要素のノードリストを返す
+document.getAnonymousElementByAttribute(node, "anonid", "el1");
+
+

より多くの情報を得るには XBL リファレンスの getAnonymousNodes と getAnonymousElementByAttribute を参照して下さい。

+

匿名ノードを得さえすえば、通常の DOM メソッドを使ってバインディングの残りのノードを操作したり処理する事が出来ます。

+

{{ 英語版章題("See also") }}

+

参照

+ -- cgit v1.2.3-54-g00ecf