|
共通 DOM API | |||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
public interface NodeFilter
フィルタは、ノードを「フィルタ処理する」方法を知っているオブジェクトです。NodeIterator または TreeWalker に NodeFilter を指定すると、NodeFilter は次のノードを返す前にフィルタを適用します。フィルタが次のノードを受け入れるように指定すると、トラーバーサルのロジックがそのノードを返します。 そうでない場合、トラバーサルは次のノードを検索し、拒否されたノードが存在していなかったように振る舞います。
DOM はフィルタを提供しません。NodeFilter は、ユーザーが独自のフィルタを利用するために実装できる単なるインタフェースです。
NodeFilters は、ノード間をトラバースする方法を認識している必要はなく、トラバースされているデータ構造についても認識している必要はありません。フィルタは、単一のノードを評価する方法だけを認識しておけばいいので、フィルタを記述するのはきわめて容易です。複数の種類の異なるトラバーサルで 1 つのフィルタを使用できるので、コードの再利用をお勧めします。
「Document Object Model (DOM) Level 2 Traversal and Range Specification」も参照してください。
| フィールドの概要 | |
|---|---|
static short |
FILTER_ACCEPT
ノードを受け入れます。 |
static short |
FILTER_REJECT
ノードを拒否します。 |
static short |
FILTER_SKIP
指定した単一のノードをスキップします。 |
static int |
SHOW_ALL
すべての Nodes を示します。 |
static int |
SHOW_ATTRIBUTE
Attr ノードを示します。 |
static int |
SHOW_CDATA_SECTION
CDATASection ノードを示します。 |
static int |
SHOW_COMMENT
Comment ノードを示します。 |
static int |
SHOW_DOCUMENT
Document ノードを示します。 |
static int |
SHOW_DOCUMENT_FRAGMENT
DocumentFragment ノードを示します。 |
static int |
SHOW_DOCUMENT_TYPE
DocumentType ノードを示します。 |
static int |
SHOW_ELEMENT
Element ノードを示します。 |
static int |
SHOW_ENTITY
Entity ノードを示します。 |
static int |
SHOW_ENTITY_REFERENCE
EntityReference ノードを示します。 |
static int |
SHOW_NOTATION
Notation ノードを示します。 |
static int |
SHOW_PROCESSING_INSTRUCTION
ProcessingInstruction ノードを示します。 |
static int |
SHOW_TEXT
Text ノードを示します。 |
| メソッドの概要 | |
|---|---|
short |
acceptNode(Node n)
指定されたノードが TreeWalker または NodeIterator の論理ビューで可視であるかどうかをテストします。 |
| フィールドの詳細 |
|---|
static final short FILTER_ACCEPT
NodeIterator または TreeWalker で定義されたナビゲーションメソッドはこのノードを返します。
static final short FILTER_REJECT
NodeIterator または TreeWalker に定義されたナビゲーションメソッドは、このノードを返しません。TreeWalker の場合、このノードの子も拒否されます。NodeIterators は、このノードを FILTER_SKIP と同義として扱います。
static final short FILTER_SKIP
NodeIterator または TreeWalker に定義されたナビゲーションメソッドは、このノードを返しません。NodeIterator と TreeWalker の両方で、このノードの子は引き続き考慮されます。
static final int SHOW_ALL
Nodes を示します。
static final int SHOW_ELEMENT
Element ノードを示します。
static final int SHOW_ATTRIBUTE
Attr ノードを示します。このフィールドは、属性ノードを root とする NodeIterator または TreeWalker を生成するときだけ有効です。この場合、属性ノードは繰り返し処理またはトラバーサルの最初の位置に現れることを示します。属性は、ほかのノードの子であることはないので、ドキュメントツリー上をトラバースするときに現れません。
static final int SHOW_TEXT
Text ノードを示します。
static final int SHOW_CDATA_SECTION
CDATASection ノードを示します。
static final int SHOW_ENTITY_REFERENCE
EntityReference ノードを示します。
static final int SHOW_ENTITY
Entity ノードを示します。このフィールドは、Entity ノードを root とする NodeIterator または TreeWalker を生成するときだけ有効です。この場合、Entity ノードはトラバーサルの最初の位置に現れることを示します。エンティティーは、ドキュメントツリーの一部ではないので、ドキュメントツリー上をトラバースするときに現れません。
static final int SHOW_PROCESSING_INSTRUCTION
ProcessingInstruction ノードを示します。
static final int SHOW_COMMENT
Comment ノードを示します。
static final int SHOW_DOCUMENT
Document ノードを示します。
static final int SHOW_DOCUMENT_TYPE
DocumentType ノードを示します。
static final int SHOW_DOCUMENT_FRAGMENT
DocumentFragment ノードを示します。
static final int SHOW_NOTATION
Notation ノードを示します。このフィールドは、Notation ノードを root とする NodeIterator または TreeWalker を生成するときだけ有効です。この場合、Notation ノードはトラバーサルの最初の位置に現れることを示します。表記法は、ドキュメントツリーの一部ではないので、ドキュメントツリー上をトラバースするときに現れません。
| メソッドの詳細 |
|---|
short acceptNode(Node n)
TreeWalker または NodeIterator の論理ビューで可視であるかどうかをテストします。この関数は、TreeWalker と NodeIterator の実装により呼び出されます。通常、ユーザーコードから直接呼び出されることはありません (ただし、同じフィルタを使ってユーザー独自のアプリケーション論理を導く場合は、ユーザーコードから直接呼び出すことも可能)。
n - フィルタを通過するかどうかをチェックするノード
|
共通 DOM API | |||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||