← 全部文档

editor.getSelectedControl()

返回当前选中的控件元素——通常是用户点击过、带有缩放手柄的图片。当选区是普通文本或光标时,返回 null。可以用它为选中的对象构建上下文操作,例如“编辑图片”或“设置替代文本”按钮。

语法

editor.getSelectedControl()

参数

无。

返回值

选中的控件元素;如果没有选中控件,则返回 null。

行为说明

  • 控件选区与文本选区不同。点击图片会把它作为控件选中;拖动经过文字则是文本范围。只有前者会让 getSelectedControl() 返回元素。
  • 光标或文本范围返回 null。使用结果之前,请先检查是否为 null。
  • 它驱动针对对象的行为。编辑器自身在 delete() 等操作中也会检查选中的控件,此时删除的是选中的图片而不是文本。

用法示例

只在选中图片时启用“编辑图片”操作:

var editor1 = new RichTextEditor("#div_editor1");
var control = editor1.getSelectedControl();
if (control && control.tagName === "IMG") {
    openImageOptions(control);   // e.g. resize, alt text, replace
}

读取当前选中图片的源 URL:

var control = editor1.getSelectedControl();
var src = control && control.tagName === "IMG" ? control.src : null;

相关内容