Die "getwindowsegments"-JavaScript-API für Dual-Screen-GeräteThe getWindowSegments JavaScript API for dual-screen devices

Wichtig

In diesem Artikel werden Funktionen und Anleitungen beschrieben, die sich in der öffentlichen Vorschau befinden und vor der allgemeinen Verfügbarkeit noch wesentlich geändert werden können.This article describes functionality and guidance that is in public preview and may be substantially modified before it's generally available. Microsoft übernimmt keine Garantie, weder ausdrücklich noch stillschweigend, für die hier bereitgestellten Informationen.Microsoft makes no warranties, express or implied, with respect to the information provided here.

Die window.getWindowSegments() -Methode gibt ein Array mit den DOMRect s aller Anzeige Bereiche zurück, auf die sich das Browserfenster erstreckt.The window.getWindowSegments() method returns an array containing the DOMRects of all the display-regions the browser window is spanning across.

SyntaxSyntax

let screens = window.getWindowSegments();

console.log(screens.length);

/**
 * Output:
 * Surface Duo with browser spanning: 2
 * Surface Duo with browser and another app side-by-side: 1
 * Desktops, Macs, Etc: 1
 **/

API-LebensdauerAPI Lifetime

Der von zurückgegebene Wert Window.getWindowSegments() ist eine unveränderliche Momentaufnahme des Geräte Zustands zum Zeitpunkt des Aufrufs der-Methode. wenn der Benutzer den umteilungs Status geändert hat oder das Gerät gedreht hat, sind die zuvor abgerufenen Fenster Segmente ungültig.The value returned from Window.getWindowSegments() is an immutable snapshot of the device state at the time the method was called, if the user changed the spanning state, or rotated the device, the window segments previously retrieved will be invalid.

Entwickler können auf das Windows- resize Ereignis lauschen oder orientationchange erkennen, ob die Größe des Browsers geändert wurde oder ob das Gerät gedreht wurde.Developers may listen to the window resize event or orientationchange to detect whether the browser was resized or the device was rotated.

BeispielExample

/**
 * Browser state: spanning on duo device
 **/
let screens = window.getWindowSegments();

console.log(screens.length); // prints 2

/**
 * Some time later.. user resizes the browser
 *
 * Browser state: residing on 1 display
 **/

window.addEventListener('resize', () =>{
   screens = window.getWindowSegments();
   console.log(screens.length); // prints 1
});