← Toda a documentação

editor.focus()

Move o foco do teclado para o editor, para que o usuário possa começar a digitar sem clicar antes. Use-o depois de criar o editor, depois de inserir conteúdo por código ou depois de fechar uma caixa de diálogo ou um painel lateral que tirou o foco da área de edição.

Sintaxe

editor.focus()

Parâmetros

Nenhum.

Retorno

Nada (undefined).

Observações de comportamento

focus() não é um simples invólucro da chamada de foco nativa do DOM — ele leva em conta os diferentes modos do editor e as peculiaridades de seleção dos navegadores:

  • Modo de código. Enquanto o editor mostra o código-fonte HTML, o foco vai para o editor de código, e não para a área de texto rico; assim, a chamada faz a coisa certa em qualquer um dos modos.
  • Um controle selecionado tem prioridade. Se um controle, como uma imagem, estiver selecionado, focus() retorna sem alterar nada. Isso é intencional: impede que uma chamada de foco feita por código descarte silenciosamente a imagem selecionada pelo usuário (e as alças de redimensionamento que vêm com ela).
  • O cursor é preservado. Alguns navegadores descartam a seleção atual quando o foco entra no frame de edição. O editor reaplica depois o intervalo armazenado, e o cursor fica onde o usuário o deixou, em vez de pular para o início do documento.

Exemplo de uso

Dê foco ao editor assim que ele estiver pronto, para que a página aceite digitação imediatamente:

var editor1 = new RichTextEditor("#div_editor1");
editor1.focus();

Insira um trecho e depois devolva o foco ao editor, para que a digitação continue naturalmente:

document.getElementById("btn_signature").onclick = function () {
    editor1.insertHTML("<p>-- <br/>Sent from RichTextEditor</p>");
    editor1.focus();   // the button took focus on click; give it back
};

Dê foco depois de exibir um editor oculto. Dar foco a um elemento que ainda está com display:none não tem efeito; por isso, exiba-o antes:

function openComposer() {
    document.getElementById("composer").style.display = "block";
    editor1.focus();
}

Relacionados