← Toda a documentação

editor.getSelectionElement()

Retorna o elemento que contém a seleção atual. Dependendo do que está selecionado, é o controle selecionado, a célula de tabela onde está o cursor ou o elemento que envolve um intervalo destacado. Use-o para responder “onde o usuário está agora?” — por exemplo, para ativar os controles de tabela apenas dentro de uma célula.

Sintaxe

editor.getSelectionElement()

Parâmetros

Nenhum.

Retorno

O elemento que envolve a seleção, ou null quando a seleção não tem um único contêiner significativo (por exemplo, uma seleção vazia sem âncora).

Observações de comportamento

  • Um controle selecionado tem prioridade. Se um controle (como uma imagem) estiver selecionado, ele é retornado diretamente — o mesmo elemento que você obteria de getSelectedControl().
  • Um cursor em uma célula de tabela retorna essa célula. Quando a seleção está recolhida dentro de um TD ou TH, essa célula é retornada — prático para ativar ações que dependem da célula.
  • Um intervalo retorna o elemento que o envolve. Para um intervalo destacado, getSelectionElement() sobe na árvore até o elemento que contém as duas extremidades da seleção.

Exemplo de uso

Descubra se o cursor está dentro de uma célula de tabela:

var editor1 = new RichTextEditor("#div_editor1");
var el = editor1.getSelectionElement();
var inCell = el && (el.closest("td") || el.closest("th"));

Leia o link mais próximo na seleção atual:

var el = editor1.getSelectionElement();
var link = el ? el.closest("a[href]") : null;
if (link) console.log("Editing link:", link.href);

Relacionados