Gecko DOM Reference:Preface
出典: MDC
目次 |
[編集] この資料について
この節では、このガイドそのものについて説明します。誰のための資料で、どんな情報があって、あなた独自の DOM 開発を行うにあたってこの資料のなかの例をどのように使えるのか、について説明します。
この文書は書きかけなので、Gecko に実装されている DOM 関数と属性がきれいにまとめられてはいません。ただし、資料に含まれる各オブジェクトに関する文書 （ DOM Document Reference など） は完結しています。多数の API に含まれるさまざまな資料が準備でき次第、この資料に追加します。
[編集] この資料の対象となる読者
Gecko DOM Reference の読者は web 開発者や web ページの仕組みを知っている web の利用者です。この資料では、読者の専門知識を前提とはしていません。DOM、XML、web サーバ、web 標準、JavaScript に関する知識があるとは限らないものとしています。ですが、web ページの基本である HTML とブラウザとスタイルシートなどは押さえているものとして書かれています。
「導入の記述がある」 「例が多様」 「説明が詳しい」 という点では、「初心者向け」 のハッキングガイドと言うこともできます。ただし、一般的に言って、技術資料というものは web 開発の経験があっても無くても、その人たちにとって有用な資料である必要があります。
[編集] Gecko とは？
Netscape 6.1 と Mozilla、Mozilla をもとにしたブラウザの DOM 実装は同一のものです。というのも、これらのブラウザは同じ技術を使用しているからです。
Gecko はこれらのブラウザの中にあるソフトウェアコンポーネントのことで、HTML の解析、ページのレイアウト、ドキュメント・オブジェクト・モデル、そしてアプリケーションの操作まわりも処理しています。Gecko は、速く、標準に準拠した描画エンジンで、ウェブページの中でのブラウザのアプリケーション・インターフェース（chrome）のなかにある W3C の DOM 標準や DOM に類似した（しかし標準化されていない）ブラウザ・オブジェクト・モデル（例：window ）を実装します。
ブラウザによって表示されるアプリケーション・インターフェースやコンテントは実際には異なりますが、DOM はこれらを一律にノードの階層として提示します。
[編集] API シンタックス
各資料には、文法、入出力の引数 （return 型が与えられている return 型の場所） 、例、補足、該当仕様へのリンクがあります。
読みとり専用属性の文法は基本的に一行だけです。名前のとおり、設定できないからです。例えば、screen オブジェクトの availHeight は読みとり専用属性なので、次のように書かれています。
つまり、式の右辺の属性だけが利用できるということです。それに対して、読み書き可能な属性の場合は、次の例でも分かるように、値を設定することもできます。
一般に、メンバの記述があるオブジェクトの場合、その文法は簡潔な型になります。例えば、要素ならなんでも element ですし、document オブジェクトなら document ですし、TABLE オブジェクトなら TABLE といった具合です (データ型について詳しくはImportant Data Types を参照してください)。
[編集] 例の使い方
資料にある例のうち、その多くは単独のファイルとして完結しているものです。新しいファイルにコピーしてブラウザで開くと、きちんと動作します。コード断片もあります。断片の場合は、その断片を JavaScript コールバック関数内で使うことができます。例えば、 window.document 属性の資料にある例を次のように関数内に入れて、ボタンが押されたら呼ばれるような確認コードを書くことができます。
<html>
<script>
function testWinDoc() {
doc= window.document;
alert(doc.title);
}
</script>
<button onclick="testWinDoc();">test document property</button>
</html>
すぐに利用できるように梱包されていないオブジェクトのメンバーについても、上記のような関数やページを作り出すことができます。「動作確認」 の導入部分にある Testing the DOM API の節を参照してください。それを使うと、一度に、たくさんの API の動作を確認できます。