← Toda a documentação

editor.delete()

Remove o que estiver selecionado no editor no momento. Com um intervalo de texto selecionado, exclui esse texto; com um controle selecionado, como uma imagem, remove a imagem. É o equivalente, por código, de o usuário selecionar o conteúdo e pressionar Delete.

Sintaxe

editor.delete()

Parâmetros

Nenhum.

Retorno

Nada (undefined).

Observações de comportamento

  • Um controle selecionado tem prioridade. Se um controle (uma imagem, por exemplo) estiver selecionado, delete() remove esse nó e coloca o cursor onde ele estava, independentemente do estado da seleção de texto.
  • Um cursor recolhido não exclui nada. Quando a seleção é apenas um cursor sem texto destacado, delete() não faz nada — não exclui o próximo caractere. Selecione um intervalo antes se precisar remover conteúdo.
  • Um intervalo de texto é removido no lugar, e o conteúdo ao redor se junta como esperado.

Exemplo de uso

Selecione o documento inteiro e apague o conteúdo:

var editor1 = new RichTextEditor("#div_editor1");
editor1.setHTMLCode("<b>hello world</b>");
editor1.selectDoc();
editor1.delete();

Exclua um controle específico — selecione-o primeiro e depois exclua. Aqui a imagem selecionada é removida:

var img = editor1.getEditable().querySelector("img");
if (img) {
    editor1.selectControl(img);
    editor1.delete();
}

Relacionados