NodeFilter

NodeFilter 接口表示一个对象，此对象用于过滤 NodeIterator 或 TreeWalker 中的节点。它既不能处理 DOM，也不能遍历节点；它只能根据提供的过滤器对单个节点进行判定。

属性

此接口没有实现或继承任何属性。

方法

此接口不继承任何方法。

NodeFilter.acceptNode()

返回一个 unsigned short，用于表示提供的Node 是否需要被NodeIterator 或 TreeWalker 迭代算法所接受。这个方法应由使用 NodeFilter 的用户编写。可能的值如下：

常量	描述
FILTER_ACCEPT	当需要接受一个节点时，NodeFilter.acceptNode()返回该值。
FILTER_REJECT	当需要拒绝一个节点时，NodeFilter.acceptNode()返回该值。对于 TreeWalker，这个节点的子节点也会被拒绝。对于 NodeIterator，这个常量的表现与FILTER_SKIP一样。
FILTER_SKIP	当NodeIterator 或 TreeWalker 对象需要跳过一个节点时，NodeFilter.acceptNode()返回该值。但被跳过节点的子节点仍会被考虑，意即“跳过该节点但不包括其子节点”。

示例

var nodeIterator = document.createNodeIterator(
  // 用作根节点的节点
  document.getElementById('someId'),

  // 只筛选文本节点（即节点类型3）
  NodeFilter.SHOW_TEXT,

  // 用作 NodeFilter 的对象，其中包含 acceptNode 方法
    { acceptNode: function(node) {
      // 接受、拒绝或跳过的逻辑
      // 下述例子只接受除了空格以外的内容
      if ( ! /^\s*$/.test(node.data) ) {
        return NodeFilter.FILTER_ACCEPT;
      }
    }
  },
  false
);

// 显示根节点下每个非空的文本节点
var node;

while ((node = nodeIterator.nextNode())) {
  alert(node.data);
}

规范

浏览器兼容性

参见

• 相关接口：TreeWalker、NodeIterator。