← Toda a documentação

editor.clearHistory()

Esvazia as pilhas de desfazer e refazer. O conteúdo do documento não é alterado — só o histórico registrado é apagado. Chame este método depois de carregar um novo documento por código, para que o usuário não consiga desfazer até antes do conteúdo que você acabou de definir.

Sintaxe

editor.clearHistory()

Parâmetros

Nenhum.

Retorno

Nada (undefined).

Observações de comportamento

  • O conteúdo não é afetado. Limpar o histórico remove apenas os registros de desfazer/refazer; o que estiver no editor permanece exatamente como está.
  • O estado da barra de ferramentas é atualizado. Depois que as pilhas são esvaziadas, o editor reavalia o estado da seleção, e os botões Undo e Redo da barra de ferramentas aparecem corretamente como desativados.
  • Use junto com um carregamento por código. Definir o conteúdo com setHTMLCode cria uma etapa de desfazer; chamar clearHistory() logo em seguida torna esse estado carregado o ponto de partida limpo.

Exemplo de uso

Carregue um documento e transforme-o na base que o usuário não consegue desfazer:

var editor1 = new RichTextEditor("#div_editor1");
editor1.setHTMLCode(loadedDocumentHtml);
editor1.clearHistory();   // fresh start; Undo is now disabled

Redefina o editor ao mudar para outro registro em uma aplicação de página única:

function openRecord(html) {
    editor1.setHTMLCode(html);
    editor1.clearHistory();
}

Relacionados