← 全部文档

editor.getSelectedText()

返回当前选区的纯文本内容——即用户高亮选中、去除了格式的文本。可用于字数统计、查词、“在网上搜索这个短语”之类的操作,或者任何需要选中文本而不是其标记的场合。

语法

editor.getSelectedText()

参数

无。

返回值

以字符串表示的选中文本;当选区处于折叠状态(只有光标、没有高亮内容)时返回 null。

行为说明

  • 折叠的选区返回 null。只有光标而没有高亮文本时,getSelectedText() 返回 null——使用结果之前请先检查这一点。
  • 返回纯文本,而不是 HTML。结果只包含文本;如果需要带标记的内容,请使用 getHTMLCode() 或选区范围。
  • 反映的是实时选区,因此请在需要的那一刻读取它(例如在工具栏按钮的点击处理函数中)。

用法示例

对高亮的文本执行操作,并防止选区为空:

var editor1 = new RichTextEditor("#div_editor1");
var text = editor1.getSelectedText();
if (text) {
    window.open("https://www.google.com/search?q=" + encodeURIComponent(text));
}

实时显示当前选区的字符数:

var text = editor1.getSelectedText() || "";
console.log(text.length + " characters selected");

相关内容