Range:selectNodeContents() 方法
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
Range.selectNodeContents() 方法用于设置 Range,使其包含一个 Node 的内容。
Range 的开始和结束节点的父节点(Node)即为引用节点。startOffset 为 0,endOffset 则是引用节点包含的字符数或子节点个数。
语法
js
selectNodeContents(referenceNode)
参数
返回值
无(undefined)。
示例
js
const range = document.createRange();
const referenceNode = document.querySelector("div");
range.selectNodeContents(referenceNode);
实时示例
这个例子让用户使用按钮选择或取消选择一个段落。Document.createRange()、Range.selectNodeContents() 和 Selection.addRange() 用于选择内容。Window.getSelection() 和 Selection.removeAllRanges() 用于取消选择。
HTML
html
<p id="p"><strong>使用下面的按钮</strong>选择或取消选择本段的内容。</p>
<button id="select-button">选择段落</button>
<button id="deselect-button">取消选择段落</button>
JavaScript
js
const p = document.getElementById("p");
const selectButton = document.getElementById("select-button");
const deselectButton = document.getElementById("deselect-button");
selectButton.addEventListener("click", (e) => {
// 清除当前的任何选择
const selection = window.getSelection();
selection.removeAllRanges();
// 选择段落
const range = document.createRange();
range.selectNodeContents(p);
selection.addRange(range);
});
deselectButton.addEventListener("click", (e) => {
const selection = window.getSelection();
selection.removeAllRanges();
});
结果
规范
| Specification |
|---|
| DOM> # dom-range-selectnodecontents> |
浏览器兼容性
Loading…