Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

onfocus — gerir a obtenção do foco

O atributo onfocus contém JavaScript executado quando é recebido um evento focus. Permite reagir quando um campo de entrada obtém o foco, mas, por si só, não torna um elemento focável.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

onfocus="JavaScript statements"

onfocus é um atributo de tratamento do evento focus. O seu valor é o corpo de uma função JavaScript, não o nome de um evento nem um valor booleano. Em body e frameset, trata o foco do objeto Window, e não o do próprio elemento.

O foco indica o destino da entrada do teclado. Um campo pode obtê-lo através da navegação com Tab ou de focus(). Adicionar apenas onfocus não torna um elemento focável. O evento focus não propaga para cima e não pode ser cancelado; return false não impede a obtenção do foco.

O atributo HTML e a propriedade JavaScript element.onfocus configuram o mesmo processador. A Content Security Policy pode bloquear código escrito diretamente no atributo. Não insira nele texto não fiável como código.

No exemplo, mova o foco para o campo com Tab. O texto Waiting muda para Focused. Mantenha visível um indicador de foco para que as pessoas que usam o teclado possam identificar o elemento ativo.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onfocus example</title>
<label for="name">Name</label>
<input id="name" onfocus="document.getElementById('status').textContent = 'Focused';">
<p id="status">Waiting</p>
</html>

Resultado

Focused

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes