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

CKTIS / JavaScript

FocusEvent.relatedTarget — o outro alvo da transição de foco

FocusEvent.relatedTarget identifica o outro objeto envolvido numa transição de foco: o alvo anterior ao receber o foco ou o alvo seguinte ao perdê-lo. A propriedade é só de leitura e pode ser null.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })

FocusEvent representa os eventos focus, blur, focusin e focusout. Herda de UIEvent e, indiretamente, de Event. A propriedade FocusEvent.relatedTarget descreve o outro alvo de uma transição de foco, não o alvo identificado por event.target.

Em focus e focusin, event.target identifica o objeto que recebe o foco, enquanto event.relatedTarget identifica o objeto que o perde. Em blur e focusout, os papéis invertem-se: event.target perde o foco e event.relatedTarget recebe-o.

relatedTarget é só de leitura e devolve um EventTarget ou null. O outro alvo pode estar indisponível ou oculto por motivos de segurança, por exemplo, ao usar a tecla Tab para entrar ou sair de uma página. Verifique se o valor é null antes de o utilizar; também não assuma que todo o EventTarget é um elemento DOM.

O construtor new FocusEvent(type, options) permite definir relatedTarget; o valor predefinido é null. O exemplo verifica esta opção sem depender da interação do utilizador. FocusEvent é uma Web API do browser, não uma funcionalidade de uma edição específica de ECMAScript. A MDN indica que a interface e a propriedade estão amplamente disponíveis desde julho de 2015; utilizar Node 24 num repositório não comprova o suporte desta API.

Exemplos

(() => {
  const previous = document.createElement("button");
  previous.id = "previous";

  const event = new FocusEvent("focus", {
    relatedTarget: previous
  });

  console.log(event.type);
  console.log(event.relatedTarget === previous);
  console.log(new FocusEvent("blur").relatedTarget === null);
})();

Resultado

focus
true
true

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