选择跨度元素时，Javascript 选择 API :: containsNode() 不返回 true

Question

我的问题是关于这个功能：https://developer.mozilla.org/en-US/docs/Web/API/Selection/containsNode 我已经创建了这个沙箱：https://codesandbox.io/s/amazing-bartik-smjt2?file=/src/index.js

代码：

document.getElementById("app").innerHTML = `
<h1>Hello Vanilla!</h1>
<div>
  We use the same configuration.<s> <span id="_span"><img src="http://www.mandysam.com/img/random.jpg" id="_img" alt="????" aria-label="????" width="40"></span> as Parcel to bundle this </s> sandbox, you can find more
  info about Parcel.
  <h2 id="y" hidden=true>span selected</h2>
  <h2 id="z" hidden=true>img selected</h2>
</div>
`;

document.addEventListener("selectionchange", () => {
  const selection = window.getSelection();

  let span = document.querySelector("#_span");
  const foundSpan = selection.containsNode(span);

  let img = document.querySelector("#_img");
  const foundImg = selection.containsNode(img);

  let y = document.querySelector("#y");
  y.toggleAttribute("hidden", !foundSpan);
  let z = document.querySelector("#z");
  z.toggleAttribute("hidden", !foundImg);
});

我不明白为什么我应该在图像前后至少选择一个字符，所以containsNode 在span 元素上返回true。这是预期的行为吗？ the span element supposed to be selected whenever the img is selected, right?

Answer 1

这是预期的行为。

来自specification for the Selection API：

containsNode() 方法

如果上下文，该方法必须返回false 对象为空或者如果节点的根不是与关联的文档 上下文对象。

否则，如果allowPartialContainment是false，则该方法必须返回 true 当且仅当其范围的开始在之前或视觉上 相当于节点和的第一个边界点 范围在最后一个边界点之后或视觉上等同于 节点。

如果allowPartialContainment 是true，则该方法必须返回true，如果并且 仅当其范围的开始在之前或视觉上等同于 节点中的第一个边界点或其范围的末尾在或之后 视觉上等同于节点中的最后一个边界点。

containsNode() 的接口是defined as：

boolean containsNode(Node node, optional boolean allowPartialContainment = false);

如果您还希望仅部分包含的节点被视为选择的一部分，则必须为 allowPartialContainment 参数提供 true：

const foundSpan = selection.containsNode(span, true); 

document.addEventListener("selectionchange", () => {
  const selection = window.getSelection();

  let span = document.querySelector("#_span");
  const isFullyContained = selection.containsNode(span);
  const isPartiallyContained = selection.containsNode(span, true);

  let y = document.querySelector("#y");
  y.toggleAttribute("hidden", !isPartiallyContained || isFullyContained);
  let z = document.querySelector("#z");
  z.toggleAttribute("hidden", !isFullyContained);
});

<h1>Select the text with the image</h1>
<div>
  We use the same configuration.
  <span id="_span"><img src="http://www.mandysam.com/img/random.jpg" width="40"></span>
  as Parcel to bundle this sandbox, you can find more info about Parcel.
  <h2 id="y" hidden=true>span partially contained</h2>
  <h2 id="z" hidden=true>span fully contained</h2>
</div>

它适用于图像，因为 img 是一个 void 元素（没有内容），因此不能仅部分包含在选择中。