CKTIS / JavaScript
FocusEvent.relatedTarget — l’autre cible de la transition de focus
FocusEvent.relatedTarget désigne l’autre objet impliqué dans une transition de focus : la cible précédente lors de la prise de focus, ou la cible suivante lors de sa perte. Cette propriété est en lecture seule et peut valoir null.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })FocusEvent représente les événements focus, blur, focusin et focusout. Il hérite de UIEvent et, indirectement, de Event. Sa propriété FocusEvent.relatedTarget décrit l’autre cible d’une transition de focus, et non celle désignée par event.target.
Pour focus et focusin, event.target désigne l’objet qui reçoit le focus, tandis que event.relatedTarget désigne celui qui le perd. Pour blur et focusout, les rôles sont inversés : event.target perd le focus et event.relatedTarget le reçoit.
relatedTarget est en lecture seule et renvoie un EventTarget ou null. L’autre cible peut être indisponible ou masquée pour des raisons de sécurité, par exemple lors d’une navigation avec la touche Tab vers une page ou hors de celle-ci. Vérifiez si la valeur est null avant de l’utiliser ; ne supposez pas non plus que chaque EventTarget est un élément DOM.
Le constructeur new FocusEvent(type, options) permet de définir relatedTarget ; sa valeur par défaut est null. L’exemple vérifie cette option sans dépendre d’une interaction de l’utilisateur. FocusEvent est une API Web du navigateur, et non une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique que l’interface et la propriété sont largement disponibles depuis juillet 2015 ; l’utilisation de Node 24 dans un dépôt ne prouve pas la prise en charge de cette API.
Exemples
(() => {
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);
})();Résultat
focus true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.