← Toda a documentação

editor.getSelectedText()

Retorna o conteúdo em texto simples da seleção atual — o texto que o usuário destacou, sem formatação. Use-o para contagem de palavras, consultas, ações do tipo “pesquisar esta frase na web” ou qualquer coisa que precise do texto selecionado e não da sua marcação.

Sintaxe

editor.getSelectedText()

Parâmetros

Nenhum.

Retorno

O texto selecionado como string, ou null quando a seleção está recolhida (um cursor sem nada destacado).

Observações de comportamento

  • Seleção recolhida retorna null. Com apenas um cursor e nenhum texto destacado, getSelectedText() retorna null — verifique isso antes de usar o resultado.
  • Texto simples, não HTML. O resultado é só o texto; use getHTMLCode() ou o intervalo da seleção se precisar do conteúdo com marcação.
  • Reflete a seleção ativa, então leia o valor no momento em que precisar dele (por exemplo, dentro do handler de clique de um botão da barra de ferramentas).

Exemplo de uso

Aja sobre o texto destacado, protegendo-se contra uma seleção vazia:

var editor1 = new RichTextEditor("#div_editor1");
var text = editor1.getSelectedText();
if (text) {
    window.open("https://www.google.com/search?q=" + encodeURIComponent(text));
}

Mostre uma contagem de caracteres em tempo real da seleção atual:

var text = editor1.getSelectedText() || "";
console.log(text.length + " characters selected");

Relacionados