文档手册

class Range

2024-07-06 23:32:38

class Range

Range表示可以包含节点和文本节点的部分的文档片段。

properties:

isCollapsed

只读,布尔值,如果范围被折叠到一个位置(开始==结束),则为true

commonAncestorContainer

只读,元素,封闭开始和结束位置的最近容器元素。

endContainer

只读,范围结束的节点。

endOffset

只读,endContainer中的结束位置

startContainer

只读,范围开始的节点。

startOffset

只读,startContainer中的起始位置

start

只读,对[startContainer,startOffset]。

end

只读,对[endContainer,endOffset]。

methods:

setStart()

range.setStart(node,offset)

setEnd()

range.setEnd(node,offset)

setStartBefore()

range.setStartBefore(node)

设置开始位置,使其包括节点的开始。

setEndBefore()

range.setEndBefore(node)

设置结束位置,使其不包括节点的开始。

setStartAfter()

range.setStartAfter(node)

设置开始位置,使其不包括节点的开始。

setEndAfter()

range.setEndAfter(node)

设置开始位置,使其包含节点的结束位置。

selectNode()

range.selectNode(node)

设置范围以包括节点的开始和结束位置。

selectNodeContents()

range.selectNodeContents(node)

设置范围不包括节点的开始和结束位置,但包括其内容。

collapse()

range.collapse([toStart:bool])` - sets either end or start positions.

 设置:

  • end = start,toStart为true,或者

  • start = end,否则。

cloneRange()

range.cloneRange():Range

返回此范围对象的副本。

方法(Sciter特异性):

nodes()

range.nodes():array<Node>

返回范围所覆盖的节点列表-所有在范围内开始或结束的节点。

applyMark()

highlight()

range.applyMark(name | [name1, name2,...]) // or
range.highlight(name | [name1, name2,...])

应用标记或标记的范围,使它可以样式的CSS ::mark(name) {...}

clearMark()

clearHighlight()

range.clearMark(name | [name1, name2,...]) // or
range.clearHighlight(name | [name1, name2,...])

从范围中删除给定的标记。

marks()

range.marks():[]

返回此范围内标记名称的列表(数组)。

setToMark()

range.setToMark(name)

将范围设置为具有名称标记设置的字符范围的开始/结束。