← Toda a documentação

editor.getSelection()

Retorna o objeto de seleção ativo do editor — a seleção dentro da área de edição, e não o window.getSelection() da página externa. Use-o para inspecionar o que está selecionado, ler intervalos ou conduzir lógica de seleção de baixo nível em comandos personalizados.

Sintaxe

editor.getSelection()

Parâmetros

Nenhum.

Retorno

O objeto de seleção do editor.

Observações de comportamento

  • Restrito ao iframe de edição. Esta é a seleção dentro do conteúdo do editor; portanto, os intervalos dela apontam para nós dentro de editor.getDocument() — e não da página em volta.
  • É a seleção ativa. Leia-a no momento em que precisar; ela reflete onde quer que o cursor ou o destaque esteja no momento.
  • Para as necessidades comuns, há helpers de nível mais alto. Use getSelectedText() para o texto e getSelectionElement() para o elemento que a envolve, em vez de percorrer a seleção manualmente.

Exemplo de uso

Verifique se há algo selecionado:

var editor1 = new RichTextEditor("#div_editor1");
var sel = editor1.getSelection();
if (sel && !sel.isCollapsed) {
    // there is a highlighted range to act on
}

Leia o intervalo atual a partir da seleção:

var sel = editor1.getSelection();
if (sel && sel.rangeCount) {
    var range = sel.getRangeAt(0);
    console.log(range.toString());
}

Relacionados