NodeFilter

NN 7 IE s.o DOM 2

L´objet NodeFilter fournit un mécanisme aux objets NodeIterator et TreeWalker permettant de déterminer quels noeuds ou quelles classes de noeuds doivent être acceptés ou rejetés pour l´inclusion dans l´une des listes de noeuds spéciales. La seule méthode accept() est invoquée silencieusement par les objets NodeInterator et TreeWalker chaque fois qu´ils doivent désigner le noeud suivant dans la séquence. L´objet NodeFilter est aussi le conteneur de deux ensembles de constantes utilisés dans une gamme d´appels de méthodes de création et de fonctions de filtre définies par l´utilisateur. Reportez-vous à l´objet TreeWalker pour un exemple et à la méthode document.createTreeWalker() pour l´application de ces constantes.

Référence de modèle d'objet

NodeFilter

Propriétés spécifiques à l´objet

FILTER_ACCEPT	FILTER_REJECT	FILTER_SKIP
SHOW_ALL	SHOW_ATTRIBUTE	SHOW_CDATA_SECTION
SHOW_COMMENT	SHOW_DOCUMENT	SHOW_DOCUMENT_FRAGMENT
SHOW_DOCUMENT_TYPE	SHOW_ELEMENT	SHOW_ENTITY
SHOW_NOTATION	SHOW_PROCESSING_INSTRUCTION	SHOW_TEXT

Méthodes spécifiques à l´objet

accept()

Propriétés de gestionnaire d´événements spécifiques à l´objet

Aucune.

accept()	NN 7 IE s.o DOM 2
accept(nodeReference)
Renvoie un nombre entier indiquant si un noeud doit être inclus dans la liste de l´objet NodeIterator ou TreeWalker. Cette méthode est invoquée automatiquement par les objets chaque fois que l´une de leurs méthodes de déplacement de pointeur est invoquée.

Paramètres

Référence à un noeud de l´arborescence de documents en cours de test. Transmise automatiquement à la méthode lorsqu´elle est invoquée par les objets NodeInterator et TreeWalker.

Valeur renvoyée
Valeur sous forme de nombre entier; à chacune d´entre elles correspond une valeur constante associée à l´objet NodeFilter: 1 (NodeFilter.FILTER_ACCEPT); 2 (NodeFilter.FILTER_REJECT); 3 (NodeFilter.FILTER_SKIP).