TreeWalker: whatToShow 属性

Baseline 已广泛支持

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

TreeWalker.whatToShow 只读属性返回一个位掩码，该掩码指示要显示的节点类型。不匹配的节点将被跳过，但它们的子节点可能会被包含在内，如果相关的话。可能的值为：

常量	数值	描述
`NodeFilter.SHOW_ALL`	`4294967295`（即 `unsigned long` 的最大值）	显示所有节点。
`NodeFilter.SHOW_ATTRIBUTE` 已弃用	`2`	显示属性 `Attr` 节点。这仅在创建根节点为 `Attr` 节点的 `TreeWalker` 时才有意义；在这种情况下，它表示属性节点将出现在迭代或遍历的第一个位置。由于属性永远不是其他节点的子节点，因此在遍历文档树时它们不会出现。
`NodeFilter.SHOW_CDATA_SECTION` 已弃用	`8`	显示 `CDATASection` 节点。
`NodeFilter.SHOW_COMMENT`	`128`	显示 `Comment` 节点。
`NodeFilter.SHOW_DOCUMENT`	`256`	显示 `Document` 节点。
`NodeFilter.SHOW_DOCUMENT_FRAGMENT`	`1024`	显示 `DocumentFragment` 节点。
`NodeFilter.SHOW_DOCUMENT_TYPE`	`512`	显示 `DocumentType` 节点。
`NodeFilter.SHOW_ELEMENT`	`1`	显示 `Element` 节点。
`NodeFilter.SHOW_ENTITY` 已弃用	`32`	过时的，不再使用。
`NodeFilter.SHOW_ENTITY_REFERENCE` 已弃用	`16`	过时的，不再使用。
`NodeFilter.SHOW_NOTATION` 已弃用	`2048`	过时的，不再使用。
`NodeFilter.SHOW_PROCESSING_INSTRUCTION`	`64`	显示 `ProcessingInstruction` 节点。
`NodeFilter.SHOW_TEXT`	`4`	显示 `Text` 节点。

值

一个位掩码。

示例

const treeWalker = document.createTreeWalker(
  document.body,
  NodeFilter.SHOW_ELEMENT + NodeFilter.SHOW_COMMENT + NodeFilter.SHOW_TEXT,
  { acceptNode: (node) => NodeFilter.FILTER_ACCEPT },
  false,
);
if (
  treeWalker.whatToShow === NodeFilter.SHOW_ALL ||
  treeWalker.whatToShow % (NodeFilter.SHOW_COMMENT * 2) >=
    NodeFilter.SHOW_COMMENT
) {
  // treeWalker will show comments
}

规范

规范
DOM # dom-treewalker-whattoshow

浏览器兼容性

另见

TreeWalker 接口。

帮助改进 MDN

了解如何贡献

此页面最后修改于 2023年7月7日，由 MDN 贡献者修改。

在 GitHub 上查看此页面 • 报告此内容的问题