← 全部文档

editor.getSelection()

返回编辑器的实时选区对象——即编辑区域内的选区，而不是外部页面的 window.getSelection()。可以用它查看选中了什么、读取范围，或者在自定义命令中实现更底层的选区逻辑。

语法

editor.getSelection()

参数

无。

返回值

编辑器的选区对象。

行为说明

  • 作用范围限于编辑 iframe。这是编辑器内容中的选区，因此它的范围指向 editor.getDocument() 中的节点——而不是周围的页面。
  • 它是实时选区。请在需要的那一刻读取它；它反映的是光标或高亮当前所在的位置。
  • 常见需求有更高层的辅助方法。获取文本请使用 getSelectedText()，获取外层元素请使用 getSelectionElement()，而不必手动遍历选区。

用法示例

检查是否选中了内容：

var editor1 = new RichTextEditor("#div_editor1");
var sel = editor1.getSelection();
if (sel && !sel.isCollapsed) {
    // there is a highlighted range to act on
}

从选区读取当前范围：

var sel = editor1.getSelection();
if (sel && sel.rangeCount) {
    var range = sel.getRangeAt(0);
    console.log(range.toString());
}

相关内容