ContextQMD
Back to Content

ScreenDetailed: top property

files/en-us/web/api/screendetailed/top/index.md

latest1.6 KB
Original Source

{{APIRef("Window Management API")}}{{seecompattable}}{{SecureContext_Header}}

The top read-only property of the {{domxref("ScreenDetailed")}} interface is a number representing the y-coordinate (top edge) of the total screen area inside the OS virtual screen arrangement, relative to the multi-screen origin.

This is equal to the true top edge, ignoring any OS UI element drawn at the top of the screen. Windows cannot be placed in those areas; to get the top coordinate of the screen area that windows can be placed in, use {{domxref("ScreenDetailed.availTop")}}.

[!NOTE] In Firefox, a non-standard implementation of the top property is available on the Screen interface. See the Non-standard example below for usage details, and see the Screen reference page for browser support information relating to the non-standard implementation.

Value

A number.

Examples

Window Management API example

js
// Available in browsers that support the Window Management API
const screenDetails = await window.getScreenDetails();

// Return the absolute top value of the first screen
const screen1Top = screenDetails.screens[0].top;

Non-standard example

js
// Available in Firefox
// Return the absolute top value of the current screen
const screenTop = window.screen.top;

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also