← Toda a documentação

editor.getSelectedControl()

Retorna o elemento de controle selecionado no momento — normalmente uma imagem em que o usuário clicou, exibida com alças de redimensionamento. Retorna null quando a seleção é um texto comum ou apenas o cursor. Use-o para criar ações de contexto para um objeto selecionado, como um botão “editar imagem” ou “definir texto alternativo”.

Sintaxe

editor.getSelectedControl()

Parâmetros

Nenhum.

Retorno

O elemento de controle selecionado, ou null se nenhum controle estiver selecionado.

Observações de comportamento

  • A seleção de controle é diferente da seleção de texto. Clicar em uma imagem a seleciona como controle; arrastar sobre palavras cria um intervalo de texto. Só o primeiro caso faz getSelectedControl() retornar um elemento.
  • Retorna null para o cursor ou um intervalo de texto. Verifique null antes de usar o resultado.
  • Ele orienta o comportamento específico de cada objeto. O próprio editor verifica o controle selecionado em operações como delete(), que remove a imagem selecionada em vez de texto.

Exemplo de uso

Habilite uma ação “editar imagem” só quando uma imagem estiver selecionada:

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

Leia a URL de origem da imagem selecionada:

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

Relacionados