JavaScript：mx-Lab：SSブログ

	ブログをはじめるログイン

Document（HTMLDocument）　[JavaScript]

◆Document（HTMLDocument）クラス

JavaScript の Document（HTMLDocument）クラスは、ウィンドウ内外のドキュメント（文書）インスタンスを制御します。

ウィンドウであれば、それがきちんとした画面だろうと、ダイアログだろうと、そして準備されているだけで表示されていないウィンドウであろうと、その Window（DOMWindow）クラスインスタンス window のプロパティ document として、必ずそのウィンドウ用の HTMLDocument クラスインスタンスが存在します。

以下には、そのメンバを機械的に抽出した結果を、インデックスとしてまとめてあります。

調査対象のブラウザは、Internet Explorer 8、Firefox 3.6.13、Opera 11.00、Safari 5.0.3、Google Chrome 8.0.552.224 です。

５つほど、お断りです。

１）長いです
機械的にメンバを抽出してみたら、２１３ありました。
これを全部羅列してるので、長いです；；；。

２）これで全部のメンバを網羅できているとは限りません
機械的にメンバを抽出したんですが、当然あるべき toString などが見当たりません。
従って、これで全部のメンバを網羅できているとは限りません。

３）全部調べるつもりはありません
２１３もあるとは思いませんでした。
全部調べていたら、ひとりで調べてる間に死んでしまいそうです；；；。

４）プロパティ、メソッド、イベントが混在しています
このインデックスでは、プロパティ、メソッド、イベントが混在しています。
この点については、掘り下げていくうちに、整理したいです。

５）調査対象は HTMLDocument です

このインデックスでは、HTMLDocument クラスインスタンスを機械的に調査しました。
俺の中では、Document クラスと HTMLDocument クラスは異なるものと認識しています。
この点については、掘り下げていくうちに、インデックスを分けるかもしれません。

なお、よく使うメンバや、定型処理などについては、長くなるので別エントリーにまとめます。

それでは、参ります。

タグ：JavaScript プログラム document HTMLDocument

2011-01-10 21:37 nice!(1) コメント(1) トラックバック(0)
共通テーマ：パソコン・インターネット

Window（DOMWindow）　[JavaScript]

◆Window（DOMWindow）クラス

JavaScript の Window（DOMWindow）クラスは、ウィンドウインスタンスを制御します。

ウィンドウであれば、それがきちんとした画面だろうと、ダイアログだろうと、そして準備されているだけで表示されていないウィンドウであろうと、必ずこの Window（DOMWindow）クラスインスタンスが、ひとつ以上存在します。

以下には、そのメンバを機械的に抽出した結果を、インデックスとしてまとめてあります。

調査対象のブラウザは、Internet Explorer 8、Firefox 3.6.13、Opera 11.00、Safari 5.0.3、Google Chrome 8.0.552.224 です。

５つほど、お断りです。

１）長いです
機械的にメンバを抽出してみたら、５１５ありました。
これを全部羅列してるので、長いです；；；。

３）全部調べるつもりはありません
５１５もあるとは思いませんでした。
全部調べていたら、ひとりで調べてる間に死んでしまいそうです；；；。

５）Window と DOMWindow が混在しています

このインデックスでは、Window クラスと DOMWindow クラスが混在しています。
正直、Window クラスと DOMWindow クラスでは、ちょっと差が大きいです。
この点については、掘り下げていくうちに、インデックスを分けるかもしれません。

なお、よく使うメンバや、ライフサイクルなどについては、長くなるので別エントリーにまとめます。

それでは、参ります。

タグ：プログラム JavaScript window DOMWindow

2011-01-08 22:58 nice!(1) コメント(0) トラックバック(0)
共通テーマ：パソコン・インターネット

confirm　[JavaScript]

◆window.confirm メソッド

boolean = window.confirm(string);

こいつもすっかり忘れてた；；；。

【告知】
マシントラブルがあり、しばらく更新できませんでした。
申し訳ありません。
とりあえずの対処はしたので、今後は様子を見てみます。

ポップアップダイアログに、引数 string で示される文字列を表示します。

ポップアップされるのはモーダルダイアログなので、この confirm の表示期間は、スクリプト実行が停止します。

表示されるダイアログには、文字列の他に、[OK] ボタンと [キャンセル] ボタンがあります。

ユーザーがどちらかのボタンを押すと confirm を抜け、スクリプト実行が再開されます。

confirm は、ユーザーによってどちらのボタンが押されたかを、boolean 値で返します。

[OK] ボタンが押された場合は true、[キャンセル] ボタンが押された場合は false が返ってきます。

window インスタンススコープで、実行したい window が同じインスタンスの場合は、window を省略し、単に confirm(string); と記述するのが通例です。

制御文字（'\n' での改行や '\t' での字下げ、'\' でのシングルクォートやダブルクォートのエスケープ）も使用可能です。

（ソネブロでは '￥' の半角が '\' と表示されるので、上記の '\' は '￥' の半角です）

タグ：プログラム JavaScript confirm

2011-01-05 00:19 nice!(4) コメント(3) トラックバック(0)
共通テーマ：パソコン・インターネット

alert　[JavaScript]

◆window.alert メソッド

window.alert(string);

オラ、すっごく大事な「こいつ」を忘れてた気がするだ。

ポップアップダイアログに、引数 string で示される文字列を表示します。

ポップアップされるのはモーダルダイアログなので、この alert の表示期間は、スクリプト実行が停止します。

表示されるダイアログには、文字列の他に、[OK] ボタンがあり、ユーザーが [OK] ボタンを押すと alert を抜け、スクリプト実行が再開されます。

window インスタンススコープで、実行したい window が同じインスタンスの場合は、window を省略し、単に alert(string); と記述するのが通例です。

制御文字（'\n' での改行や '\t' での字下げ、'\' でのシングルクォートやダブルクォートのエスケープ等）も使用可能です。

（ソネブロでは '￥' の半角が '\' と表示されるので、上記の '\' は '￥' の半角です）

タグ：JavaScript プログラム alert

2010-12-30 20:58 nice!(3) コメント(4) トラックバック(0)
共通テーマ：パソコン・インターネット

all　[JavaScript]

◆document.all プロパティ／メソッド

collection = document.all;
allcollection = document.all;
element = document.all.id;
element = document.all[index];
element = document.all[id];
collection = document.all[name];
nodelist = document.all[name];
element = document.all(index);
element = document.all(id);
element = document.all(name);
collection = document.all(name);
nodelist = document.all(name);

なんじゃこら。

形をピックアップするだけでも大変だわ。

指定された DOM(Document Object Model) 形式のドキュメント document に対して、以下の動作をします。

Internet Explorer、Opera がこの形。document 内のすべてのエレメントに対する Element クラス（またはそのサブクラス）のコレクション collection （HTMLCollection）を返す。ただし、Internet Explorer と Opera では、格納されている情報が異なる場合があるので、要注意。
Safari、Google Chrome がこの形。document 内のすべてのエレメントに対する Element クラス（またはそのサブクラス）のコレクション allcollection （HTMLAllCollection）を返す。
id プロパティが id であるエレメントへの参照 element を返す。
document 内のインデックス値が index であるエレメントへの参照 element を返す。ただし、Internet Explorer と他のブラウザでは、格納されている情報が異なる場合があるので、要注意。
id プロパティが指標値（文字列） id であるエレメントへの参照 element を返す。
Internet Explorer、Opera がこの形。name プロパティが指標値（文字列） name の複数のエレメントのコレクション collection （HTMLCollection）を返す。
Safari、Google Chrome がこの形。name プロパティが指標値（文字列） name の複数のエレメントのノードリスト nodelist （NodeList）を返す。
document 内のインデックス値が index であるエレメントへの参照 element を返す。ただし、Internet Explorer と他のブラウザでは、格納されている情報が異なる場合があるので、要注意。
id プロパティが引数（文字列） id であるエレメントへの参照 element を返す。
Internet Explorer のみ、この形。name プロパティが引数（文字列） name のうち、最初のエレメントの参照 element を返す（模様）。
Opera のみ、この形。name プロパティが引数（文字列） name の複数のエレメントのコレクション collection （HTMLCollection）を返す。
Safari、Google Chrome がこの形。name プロパティが引数（文字列） name の複数のエレメントのノードリスト nodelist （NodeList）を返す。

Firefox 系は動きません。

Firefox くらい、態度がはっきりしててくれると、まだ助かるんだけどね。

なんなの？　このブラウザごとのバラバラ加減。

はっきり言って、こういう存在は、JavaScript の「癌」です。

【追記】 2010/12/29 22:03 検証したブラウザのバージョンを追記します。
Internet Explorer 8、Firefox 3.6.13、Opera 11.00、Safari 5.0.3、Google Chrome 8.0.552.224。

タグ：プログラム JavaScript All

2010-12-29 22:05 nice!(2) コメント(4) トラックバック(0)
共通テーマ：パソコン・インターネット

getElementsByName　[JavaScript]

◆document.getElementsByName メソッド

collection = document.getElementsByName(name);
nodelist = document.getElementsByName(name);

指定された DOM(Document Object Model) 形式のドキュメント document から、name プロパティが引数（文字列）name であるエレメントに対する Element クラス（またはそのサブクラス）のコレクション collection、またはノードリスト nodelist を返します。

該当するインスタンスが存在しない場合、null ではなく、空のコレクション collection、または空のノードリスト nodelist を返します。

HTML では、ボタンやテキストボックスといったコントロールは、そのエレメントごとに name プロパティで「名前」を付けることができますが、name プロパティはひとつのドキュメント内でユニークである必要はありません。ひとつのドキュメント内で、複数のエレメントで name プロパティが重複しても、大丈夫なわけです。

従って、document.getElementsByName(name) メソッドは、指定された name プロパティを持つコントロール群を、一度に返せるような戻り値を返します。

だから、ユニークな id プロパティでエレメントを探すメソッドが geｔElementById（単数形）なのに対して、name プロパティでエレメントを探すこのメソッドの名前は geｔElementsByName（複数形）なんですね。

問題の戻り値のインスタンスなんですが、ブラウザ依存です（またかよ･･････）。

Internet Explorer 8、Firefox 3.6.13 では、戻り値が HTMLCollection というオブジェクトインスタンスで返ってきます。

一方、Opera 11.00、Safari 5.0.3、Google Chrome 8.0.552.224 では、戻り値が NodeList というオブジェクトインスタンスで返ってきます。

いずれ HTMLCollection も NodeList もエントリーにしますが、あんまり便利な代物じゃありません。

タグ：プログラム JavaScript getElementsByName

2010-12-28 20:26 nice!(1) コメント(0) トラックバック(0)
共通テーマ：パソコン・インターネット

getElementsByTagName　[JavaScript]

◆document.getElementsByTagName メソッド

collection = document.getElementsByTagName(tagname);
nodelist = document.getElementsByTagName(tagname);

指定された DOM(Document Object Model) 形式のドキュメント document から、tagName プロパティが引数（文字列）tagname であるエレメントに対する、Element クラス（またはそのサブクラス）のコレクション collection、またはノードリスト nodelist を返します。

タグ名ですから、getElementsByTagName('a'); とか、getElementsByTagName('body'); なんてこともできちゃいます。

該当するインスタンスが存在しない場合、null ではなく、空のコレクション collection、または空のノードリスト nodelist を返します。

HTML では、ボタンやテキストボックスといったコントロールは、その種類のエレメントごとに「HTML タグ」が決められており、同一のタグを持つコントロールは、ひとつの document 内に複数存在する可能性があります。

従って、document.getElementsByTagName(tagname) メソッドは、指定されたタグ名のコントロール群を、一度に返せるような戻り値を返します。

だから、ユニークな id プロパティでエレメントを探すメソッドが geｔElementById（単数形）なのに対して、tagName プロパティで探すこのメソッドの名前は geｔElementsByTagName（複数形）なんですね。

こいつは Ajax などで、かなりいい加減にサーバーから送信した XML でも、XMLHttpObject オブジェクトインスタンスの responseXML プロパティで受け取った DOM オブジェエクトを、きちんとフィールドごとの Element としてピックアップしてくれるので、かなり重宝します。

問題の戻り値のインスタンスなんですが、ブラウザ依存です（また出たよ･･････）。

Internet Explorer 8、Firefox 3.6.13 では、戻り値が HTMLCollection というオブジェクトインスタンスで返ってきます。

一方、Opera 11.00、Safari 5.0.3、Google Chrome 8.0.552.224 では、戻り値が NodeList というオブジェクトインスタンスで返ってきます。

HTMLCollection も NodeList もいずれエントリーにしますが、あんまり便利な代物じゃありません。

タグ：プログラム JavaScript getElementsByTagName

2010-12-27 20:33 nice!(2) コメント(3) トラックバック(0)
共通テーマ：パソコン・インターネット

getElementById　[JavaScript]

◆document.getElementById メソッド

element = document.getElementById(id)

指定された DOM(Document Object Model) 形式のドキュメント document から、id プロパティが引数（文字列）id であるエレメントに対する Element クラス（またはそのサブクラス）のインスタンス参照 element を返します。

該当するエレメントが存在しない場合、null を返します。

HTML では、その document 内にある複数のエレメントが、それぞれ個別に持つ id プロパティは、必ずユニーク（＝一意、つまり同じ値を持つ複数の要素の共存は許されない、という意味）でなければならないので、id が決まると、特定できるエレメントは、必ずひとつか、もしくは存在しません（該当する id プロパティを持つエレメントがない場合）。

なので、document.getElementById が返してくるエレメントのインスタンス参照は、必ずひとつか、存在しない場合は null か、このいずれかになります。

最近の JavaScript では、なんつったって、こいつがいないと、困っちゃいますね。

タグ：プログラム JavaScript getElementById

2010-12-26 20:03 nice!(2) コメント(0) トラックバック(0)
共通テーマ：パソコン・インターネット