Window Management API
The currentscreenchange event of the ScreenDetails interface is fired when the ScreenDetails.currentScreen changes in one of the following ways:
- The current screen changes to a different screen, i.e., the current browser window is moved to a different screen.
- One or more of the following properties change on the current screen:
- Screen.width
- Screen.height
- Screen.availWidth
- Screen.availHeight
- Screen.colorDepth
- Screen.orientation
- One or more of the following values change:
- The screen's position ((x,y) coordinates of the top-left corner) inside the OS virtual screen arrangement, relative to the multi-screen origin
- The screen's available position ((x,y) coordinates of the top-left corner) inside the OS virtual screen arrangement, relative to the multi-screen origin. This is equal to the screen position, plus the width/height of any OS UI elements drawn on the top-left of the screen — windows cannot be placed in those areas
- ScreenDetailed.devicePixelRatio
- ScreenDetailed.label
- The screen's designation as primary or secondary (see ScreenDetailed.isPrimary)
- The screen's designation as internal or external (see ScreenDetailed.isInternal)
Syntax
Use the event name in EventTarget/addEventListener:
addEventListener("currentscreenchange", (event) => { })
Alternatively, assign to the event handler property of the interface:
oncurrentscreenchange = (event) => { }
Event type
A generic Event.
Examples
const screenDetails = await window.getScreenDetails();
screenDetails.addEventListener("currentscreenchange", (event) => {
const details = screenDetails.currentScreen;
console.log("The current screen has changed.", event, details);
});
Specifications
Browser compatibility
See also
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
