A
NodeFilter
接口表示的对象用于过滤节点在
NodeIterator
or
TreeWalker
。
NodeFilter
knows nothing about the document or traversing nodes; it only knows how to evaluate a single node against the provided filter.
注意:
The browser doesn't provide any object implementing this interface. It is the user who is expected to write one, tailoring the
acceptNode()
method to its needs, and using it with some
TreeWalker
or
NodeIterator
对象。
此接口既未实现,也未继承任何特性。
此接口未继承任何方法。
NodeFilter.acceptNode()
返回
unsigned short
that will be used to tell if a given
节点
must be accepted or not by the
NodeIterator
or
TreeWalker
iteration algorithm.
This method is expected to be written by the user of a
NodeFilter
. Possible return values are:
| 常量 | 描述 |
|---|---|
FILTER_ACCEPT
|
Value returned by the
NodeFilter.acceptNode()
method when a node should be accepted.
|
FILTER_REJECT
|
Value to be returned by the
NodeFilter.acceptNode()
method when a node should be rejected. For
TreeWalker
, child nodes are also rejected.
For
|
FILTER_SKIP
|
Value to be returned by
NodeFilter.acceptNode()
for nodes to be skipped by the
NodeIterator
or
TreeWalker
对象。
The children of skipped nodes are still considered. This is treated as "skip this node but not its children". |
const nodeIterator = document.createNodeIterator(
// Node to use as root
document.getElementById('someId'),
// Only consider nodes that are text nodes (nodeType 3)
NodeFilter.SHOW_TEXT,
// Object containing the function to use for the acceptNode method
// of the NodeFilter
{
acceptNode: function(node) {
// Logic to determine whether to accept, reject or skip node
// In this case, only accept nodes that have content
// other than whitespace
if (/\S/.test(node.data)) {
return NodeFilter.FILTER_ACCEPT
}
}
},
false
);
// Show the content of every non-empty text node that is a child of root
let node;
while ((node = nodeIterator.nextNode())) {
alert(node.data)
}
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
NodeFilter
|
Chrome 1 | Edge 12 | Firefox 2 | IE 9 | Opera 9 | Safari 3 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android 10.1 | Safari iOS 3 | Samsung Internet Android Yes |
acceptNode
|
Chrome 1 | Edge 12 | Firefox 2 | IE 9 | Opera 9 | Safari 3 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android 10.1 | Safari iOS 3 | Samsung Internet Android Yes |
完整支持
NodeFilter
AbortController
AbortSignal
AbstractRange
Attr
ByteString
CDATASection
CSSPrimitiveValue
CSSValue
CSSValueList
CharacterData
ChildNode
注释
CustomEvent
DOMConfiguration
DOMError
DOMErrorHandler
DOMException
DOMImplementation
DOMImplementationList
DOMImplementationRegistry
DOMImplementationSource
DOMLocator
DOMObject
DOMParser
DOMPoint
DOMPointInit
DOMPointReadOnly
DOMRect
DOMString
DOMTimeStamp
DOMTokenList
DOMUserData
Document
DocumentFragment
DocumentType
元素
ElementTraversal
Entity
EntityReference
事件
EventTarget
HTMLCollection
MutationObserver
节点
NodeIterator
NodeList
NonDocumentTypeChildNode
ProcessingInstruction
PromiseResolver
范围
StaticRange
文本
TextDecoder
TextEncoder
TimeRanges
TreeWalker
TypeInfo
USVString
UserDataHandler
XMLDocument