文档手册

Element.Selection 支持选择的元素

2024-07-07 00:38:06

class Element.Selection

表示支持选择的元素上的当前选择:

  • <htmlarea> —WYSIWYG HTML编辑器;

  • <plaintext> -纯文本多行编辑器;

  • 设置了 selectable 属性的任何其他元素;

properties:

  • element.selection.isCollapsed:bool -如果选择被折叠到一个位置,则为true(锚=焦点)

  • element.selection.commonAncestorContainer:Element -将锚作为焦点位置封闭的最近容器元素

  • element.selection.anchorNode: Node

  • element.selection.anchorOffset: int

  • element.selection.focusNode:Node - focusNode/Offset是插入符号位置。

  • element.selection.focusOffset:int

  • element.selection.rangeCount:uint -选择中的范围数

  •   element.selection.type: string -其中之一:

    • “插入符号”-折叠的选择-只有插入符号是可见的,

    • “选择”-连续文本选择,

    • “元素”-选择整个元素(Sciter特定),

    • “TableCells”-选择表格单元格的范围(Sciter特定);

methods:

  • element.selection.collapse() -将所选内容折叠到当前焦点(插入符号)位置。

  • element.selection.collapseToEnd() -折叠选择到锚或焦点-无论位置是最后在DOM中。

  • element.selection.collapseToStart() -将选定内容折叠到锚或焦点-DOM中的第一个位置。

  • element.selection.containsNode(node):bool -如果选择包含节点,则为true。

  • element.selection.empty() -删除选定内容(但不删除其内容)。

  • element.selection.extend(node,offset) -设置焦点(插入符号)位置而不更改锚位置。

  • element.selection.getRangeAt(index:uint):Range -返回给定索引处的Range对象。

  • element.selection.selectNodeContent(node) -选择节点。

  • element.selection.setBaseAndExtent(anchorNode, anchorOffset, focusNode, focusOffset) -将选定内容设置为给定的锚和插入符号位置。

  • element.selection.toString():string -返回选定的文本。