KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

FocusEvent.relatedTarget — het andere doel van de focusovergang

FocusEvent.relatedTarget geeft het andere object bij een focusovergang aan: het vorige doel wanneer het focus krijgt, of het volgende doel wanneer het de focus verliest. De eigenschap is alleen-lezen en kan null zijn.

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

Syntax

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

FocusEvent staat voor de gebeurtenissen focus, blur, focusin en focusout. Het erft van UIEvent en indirect van Event. De eigenschap FocusEvent.relatedTarget beschrijft het andere doel bij een focusovergang, niet het doel dat door event.target wordt aangeduid.

Bij focus en focusin duidt event.target het object aan dat focus krijgt, terwijl event.relatedTarget het object aanduidt dat focus verliest. Bij blur en focusout zijn de rollen omgekeerd: event.target verliest focus en event.relatedTarget krijgt focus.

relatedTarget is alleen-lezen en retourneert een EventTarget of null. Het andere doel is mogelijk niet beschikbaar of om veiligheidsredenen verborgen, bijvoorbeeld wanneer je met Tab een pagina binnenkomt of verlaat. Controleer op null voordat je de waarde gebruikt; ga er ook niet van uit dat elke EventTarget een DOM-element is.

Met de constructor new FocusEvent(type, options) kun je relatedTarget instellen; standaard is de waarde null. Het voorbeeld controleert deze optie zonder afhankelijk te zijn van gebruikersinteractie. FocusEvent is een browser-Web-API, geen functie van een bepaalde ECMAScript-editie. MDN vermeldt dat de interface en eigenschap sinds juli 2015 breed beschikbaar zijn; het gebruik van Node 24 in een repository bewijst niet dat deze API wordt ondersteund.

Voorbeelden

(() => {
  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);
})();

Resultaat

focus
true
true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen