Window: focus event

{{APIRef}}

The focus event fires when an element has received focus.

The opposite of focus is {{domxref("Window/blur_event", "blur")}}.

This event is not cancelable and does not bubble.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}}, or set an event handler property.

addEventListener("focus", (event) => { })

onfocus = (event) => { }

Event type

A {{domxref("FocusEvent")}}. Inherits from {{domxref("UIEvent")}} and {{domxref("Event")}}.

{{InheritanceDiagram("FocusEvent")}}

Event properties

This interface also inherits properties from its parent {{domxref("UIEvent")}}, and indirectly from {{domxref("Event")}}.

• {{domxref("FocusEvent.relatedTarget")}}
  • : An {{domxref("EventTarget")}} representing a secondary target for this event. In some cases (such as when tabbing in or out a page), this property may be set to null for security reasons.

Examples

Live example

This example changes the appearance of a document when it loses focus. It uses {{domxref("EventTarget.addEventListener()", "addEventListener()")}} to monitor focus and {{domxref("Window/blur_event", "blur")}} events.

HTML

<p id="log">Click on this document to give it focus.</p>

CSS

.paused {
  background: #dddddd;
  color: #555555;
}

JavaScript

const log = document.getElementById("log");

function pause() {
  document.body.classList.add("paused");
  log.textContent = "FOCUS LOST!";
}

function play() {
  document.body.classList.remove("paused");
  log.textContent =
    "This document has focus. Click outside the document to lose focus.";
}

window.addEventListener("blur", pause);
window.addEventListener("focus", play);

Result

{{EmbedLiveSample("Live_example")}}

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• Related event: {{domxref("Window/blur_event", "blur")}}
• This event on Element targets: {{domxref("Element/focus_event", "focus")}} event