13.6.2.3 NodeList オブジェクト

NodeList は、ノードからなるシーケンスを表現します。これらのオブジェクトは DOM コア勧告 (DOM Core recommendation) において、二通りに使われています: Element オブジェクトでは、子ノードのリストを提供するのに NodeList を利用します。また、このインタフェースにおける Node の getElementsByTagName() および getElementsByTagNameNS() メソッドは、クエリに対する結果を表現するのにNodeList を利用します。

DOM レベル 2 勧告では、これらのオブジェクトに対し、メソッドと属性を一つづつ定義しています:

item( i): シーケンスに i 番目の要素がある場合にはその要素を、そうでない場合には None を返します。i はゼロよりも小さくてはならず、シーケンスの長さ以上であってはなりません。

length: シーケンス中のノードの数です。

この他に、Python の DOM インタフェースでは、NodeList オブジェクトを Python のシーケンスとして使えるようにするサポートが追加されていることが必要です。NodeList の実装では、全て __len__() と __getitem__() をサポートしなければなりません; このサポートにより、for 文内で NodeList にわたる繰り返しと、組み込み関数 len() の適切なサポートができるようになります。

DOM 実装が文書の変更をサポートしている場合、NodeList の実装でも __setitem__() および __delitem__() メソッドをサポートしなければなりません。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。