← 全部文档

editor.getEditable(bFocus)

返回可编辑的根元素——编辑器 iframe 中实际承载用户输入内容的 body。需要容器元素本身时使用它：读取其子元素、测量尺寸，或者把查询范围限定在编辑内容中。

语法

editor.getEditable(bFocus)

参数

bFocus——可选的布尔值。为 true 时，会先让编辑器获得焦点，再返回元素。省略它（或传入假值）则只获取元素，不改变焦点。

返回值

可编辑的 body 元素。

行为说明

  • 返回元素，而不是 document。此方法返回 body 元素；getDocument() 返回包含它的 Document。两者都位于编辑 iframe 中。
  • 可选的焦点参数只是为了方便。当您即将设置选区或开始编辑时，传入 true 可以省去单独调用一次 focus()。
  • 针对它执行查询，可以限定范围。对返回的元素执行 querySelector，只会看到编辑内容，永远不会涉及周围的页面外框。

用法示例

读取编辑内容中的第一个段落：

var editor1 = new RichTextEditor("#div_editor1");
var body = editor1.getEditable();
var firstPara = body.querySelector("p");

在设置选区之前，一次调用即可让编辑器获得焦点并获取可编辑元素：

var body = editor1.getEditable(true);   // focuses, then returns the element

相关内容