Gestire più display con l'API Window Management

Ottenere informazioni sui display collegati e posizionare le finestre rispetto a questi display.

Thomas Steiner

Data di pubblicazione: 14 settembre 2020

API Window Management

L'API Window Management ti consente di enumerare i display collegati al tuo computer e di posizionare le finestre su schermi specifici.

Casi d'uso suggeriti

Ecco alcuni esempi di siti che potrebbero utilizzare questa API:

Gli editor grafici multi-finestra come Gimp possono posizionare vari strumenti di modifica in finestre posizionate con precisione.
Le piattaforme di trading virtuale possono mostrare le tendenze di mercato in più finestre, ognuna delle quali può essere visualizzata in modalità a schermo intero.
Le app di presentazione possono mostrare le note del relatore nella schermata principale interna e la presentazione su un proiettore esterno.

Come utilizzare l'API Window Management

L'approccio collaudato per controllare le finestre, Window.open(), purtroppo non rileva schermi aggiuntivi. Sebbene alcuni aspetti di questa API sembrino un po' arcaici, come il parametro windowFeatures DOMString, ci ha comunque servito bene nel corso degli anni. Per specificare la posizione di una finestra, puoi passare le coordinate come left e top (o screenX e screenY rispettivamente) e passare le dimensioni desiderate come width e height (o innerWidth e innerHeight rispettivamente). Ad esempio, per aprire una finestra 400×300 a 50 pixel da sinistra e 50 pixel dall'alto, puoi utilizzare questo codice:

const popup = window.open(
  'https://example.com/',
  'My Popup',
  'left=50,top=50,width=400,height=300',
);

Puoi ottenere informazioni sulla schermata corrente esaminando la proprietà window.screen, che restituisce un oggetto Screen. Questo è l'output sul mio MacBook Pro 13":

window.screen;
/* Output from my MacBook Pro 13″:
  availHeight: 969
  availLeft: 0
  availTop: 25
  availWidth: 1680
  colorDepth: 30
  height: 1050
  isExtended: true
  onchange: null
  orientation: ScreenOrientation {angle: 0, type: "landscape-primary", onchange: null}
  pixelDepth: 30
  width: 1680
*/

Come la maggior parte delle persone che lavorano nel settore tecnologico, ho dovuto adattarmi alla realtà del lavoro nel 2020 e allestire il mio ufficio personale in casa. Il mio è come quello della foto (se ti interessa, puoi leggere i dettagli completi della mia configurazione). L'iPad accanto al mio MacBook è connesso al laptop tramite Sidecar, quindi quando ne ho bisogno posso trasformare rapidamente l'iPad in un secondo schermo.

Panca scolastica su due sedie. Sopra il banco di scuola ci sono scatole di scarpe che sostengono un laptop e due iPad. — Una configurazione multischermo.

Se voglio sfruttare lo schermo più grande, posso spostare il popup dell'esempio di codice sul secondo schermo. Io lo faccio così:

popup.moveTo(2500, 50);

Si tratta di una stima approssimativa, poiché non è possibile conoscere le dimensioni del secondo schermo. Le informazioni di window.screen riguardano solo lo schermo integrato, non quello dell'iPad. Il width segnalato dello schermo integrato era di 1680 pixel, quindi passare a 2500 pixel potrebbe funzionare per spostare la finestra sull'iPad, dato che so che si trova a destra del mio MacBook. Come posso farlo nel caso generale? A quanto pare, esiste un modo migliore per farlo rispetto al tirare a indovinare. Questo modo è l'API Window Management.

Rilevamento delle funzionalità

Per verificare se l'API Window Management è supportata, utilizza:

if ('getScreenDetails' in window) {
  // The Window Management API is supported.
}

Autorizzazione `window-management`

Nota:il nome dell'autorizzazione window-placement precedente non è più supportato.

Prima di poter utilizzare l'API Window Management, devo chiedere all'utente l'autorizzazione per farlo. L'autorizzazione window-management può essere richiesta con l'API Permissions nel seguente modo:

let granted = false;
try {
  const { state } = await navigator.permissions.query({ name: 'window-management' });
  granted = state === 'granted';
} catch {
  // Nothing.
}

Mentre sono in uso browser con il nome dell'autorizzazione precedente e quello nuovo, assicurati di utilizzare un codice difensivo quando richiedi l'autorizzazione, come nell'esempio.

async function getWindowManagementPermissionState() {
  let state;
  // The new permission name.
  try {
    ({ state } = await navigator.permissions.query({
      name: "window-management",
    }));
  } catch (err) {
    return `${err.name}: ${err.message}`;
  }
  return state;
}

document.querySelector("button").addEventListener>("click", async () = {
  const state = await getWindowManagementPermissionState();
  document.querySelector(&quot;pre").textContent = state;
});

Il browser può scegliere di mostrare la richiesta di autorizzazione in modo dinamico al primo tentativo di utilizzare uno dei metodi della nuova API. Per saperne di più, continua a leggere quanto segue.

Proprietà `window.screen.isExtended`

Per scoprire se al mio dispositivo è collegato più di uno schermo, accedo alla proprietà window.screen.isExtended. Restituisce true o false. Per la mia configurazione, restituisce true.

window.screen.isExtended;
// Returns `true` or `false`.

Il metodo `getScreenDetails()`

Ora che so che la configurazione attuale è multi-schermo, posso ottenere maggiori informazioni sul secondo schermo utilizzando Window.getScreenDetails(). Se chiamo questa funzione, viene visualizzata una richiesta di autorizzazione che mi chiede se il sito può aprire e posizionare finestre sullo schermo. La funzione restituisce una promessa che viene risolta con un oggetto ScreenDetailed. Sul mio MacBook Pro 13 con un iPad collegato, è incluso un campo screens con due oggetti ScreenDetailed:

await window.getScreenDetails();
/* Output from my MacBook Pro 13″ with the iPad attached:
{
  currentScreen: ScreenDetailed {left: 0, top: 0, isPrimary: true, isInternal: true, devicePixelRatio: 2, …}
  oncurrentscreenchange: null
  onscreenschange: null
  screens: [{
    // The MacBook Pro
    availHeight: 969
    availLeft: 0
    availTop: 25
    availWidth: 1680
    colorDepth: 30
    devicePixelRatio: 2
    height: 1050
    isExtended: true
    isInternal: true
    isPrimary: true
    label: "Built-in Retina Display"
    left: 0
    onchange: null
    orientation: ScreenOrientation {angle: 0, type: "landscape-primary", onchange: null}
    pixelDepth: 30
    top: 0
    width: 1680
  },
  {
    // The iPad
    availHeight: 999
    availLeft: 1680
    availTop: 25
    availWidth: 1366
    colorDepth: 24
    devicePixelRatio: 2
    height: 1024
    isExtended: true
    isInternal: false
    isPrimary: false
    label: "Sidecar Display (AirPlay)"
    left: 1680
    onchange: null
    orientation: ScreenOrientation {angle: 0, type: "landscape-primary", onchange: null}
    pixelDepth: 24
    top: 0
    width: 1366
  }]
}
*/

Le informazioni sugli schermi collegati sono disponibili nell'array screens. Nota come il valore di left per l'iPad inizia da 1680, che corrisponde esattamente alla width del display integrato. In questo modo posso determinare esattamente come sono disposte le schermate a livello logico (una accanto all'altra, una sopra l'altra e così via). Ora sono disponibili anche i dati per ogni schermata per mostrare se si tratta di una schermata isInternal e se si tratta di una schermata isPrimary. Tieni presente che lo schermo integrato non è necessariamente lo schermo principale.

Il campo currentScreen è un oggetto attivo corrispondente all'window.screen corrente. L'oggetto viene aggiornato nei posizionamenti delle finestre cross-screen o nelle modifiche del dispositivo.

Nota:l'ultima implementazione dell'API di Chromium restituisce le etichette dello schermo fornite dalla piattaforma sottostante, ad esempio "Built-in Retina Display", anziché segnaposto meno descrittivi, come "Internal Display 1".

L'evento `screenschange`

L'unica cosa che manca ora è un modo per rilevare quando la configurazione dello schermo cambia. Un nuovo evento, screenschange, fa esattamente questo: si attiva ogni volta che la costellazione dello schermo viene modificata. (Tieni presente che "screens" è al plurale nel nome dell'evento.) Ciò significa che l'evento viene attivato ogni volta che una nuova schermata o una schermata esistente viene (fisicamente o virtualmente nel caso di Sidecar) collegata o scollegata.

Devi cercare i nuovi dettagli dello schermo in modo asincrono, l'evento screenschange stesso non fornisce questi dati. Per cercare i dettagli dello schermo, utilizza l'oggetto live da un'interfaccia Screens memorizzata nella cache.

const screenDetails = await window.getScreenDetails();
let cachedScreensLength = screenDetails.screens.length;
screenDetails.addEventListener('screenschange', (>event) = {
  if (screenDetails.screens.length !== cachedScreensLength) {
    console.log(
      `The screen count changed from ${cachedScreensLength} to ${screenDetails.screens.length}`,
    );
    cachedScreensLength = screenDetails.screens.length;
  }
});

L'evento `currentscreenchange`

Se mi interessano solo le modifiche alla schermata corrente (ovvero il valore dell'oggetto live currentScreen), posso ascoltare l'evento currentscreenchange.

const screenDetails = await window.getScreenDetails();
screenDetails.addEventListener('currentscreenchange', async (>event) = {
  const details = screenDetails.currentScreen;
  console.log('The current screen has changed.', event, details);
});

L'evento `change`

Infine, se mi interessano solo le modifiche a una schermata specifica, posso ascoltare l'evento change di quella schermata.

const firstScreen = (await window.getScreenDetails())[0];
firstScreen.addEventListener('change', async (>event) = {
  console.log('The first screen has changed.', event, firstScreen);
});

Nuove opzioni a schermo intero

Fino ad ora, potevi richiedere la visualizzazione degli elementi in modalità a schermo intero tramite il metodo requestFullScreen(). Il metodo accetta un parametro options in cui puoi passare FullscreenOptions. Finora, la sua unica proprietà è stata navigationUI. L'API Window Management aggiunge una nuova proprietà screen che consente di determinare su quale schermo avviare la visualizzazione a schermo intero. Ad esempio, se vuoi visualizzare la schermata principale a schermo intero:

try {
  const primaryScreen = (await getScreenDetails()).screens.filter((screen) => screen.isPrimary)[0];
  await document.body.requestFullscreen({ screen: primaryScreen });
} catch (err) {
  console.error(err.name, err.message);
}

Polyfill

Non è possibile eseguire il polyfill dell'API Window Management, ma puoi eseguire lo shim della sua forma in modo da poter programmare esclusivamente in base alla nuova API:

if (!('getScreenDetails' in window)) {
  // Returning a one-element array with the current screen,
  // noting that there might be more.
  window.getScreenDetails = as>ync () = [window.screen];
  // Set to `false`, noting that this might be a lie.
  window.screen.isExtended = false;
}

Gli altri aspetti dell'API, ovvero i vari eventi di cambio schermo e la proprietà screen di FullscreenOptions, non vengono mai attivati o vengono ignorati rispettivamente dai browser non supportati.

Demo

Se tieni d'occhio lo sviluppo delle varie criptovalute, puoi monitorare i mercati comodamente dal letto con una configurazione a schermo singolo nella mia applicazione. (Non è così, perché amo questo pianeta, ma, per il bene di questo articolo, fingi che sia così.)

Schermo TV enorme alla fine di un letto con le gambe dell'autore parzialmente visibili. Sullo schermo, un trading desk di criptovalute falso. — Rilassarsi e guardare i mercati.

Trattandosi di criptovalute, i mercati possono diventare frenetici in qualsiasi momento. In questo caso, posso spostarmi rapidamente alla mia scrivania, dove ho una configurazione multi-schermo. Posso fare clic sulla finestra di qualsiasi valuta e visualizzare rapidamente tutti i dettagli in una visualizzazione a schermo intero sullo schermo opposto. Ecco una mia foto recente scattata durante l'ultima strage di YCY. Mi ha colto completamente alla sprovvista e mi ha lasciato con le mani sul viso.

Io, in preda al panico, assisto al massacro su base annua.

Prova la demo o visualizza il relativo codice sorgente su GitHub.

Sicurezza e autorizzazioni

Il team di Chrome ha progettato e implementato l'API Window Management utilizzando i principi fondamentali definiti in Controlling Access to Powerful Web Platform Features, tra cui controllo utente, trasparenza ed ergonomia. L'API Window Management espone nuove informazioni sugli schermi collegati a un dispositivo, aumentando la superficie di fingerprinting degli utenti, in particolare di quelli con più schermi collegati in modo coerente ai loro dispositivi. Per mitigare questo problema di privacy, le proprietà dello schermo esposte sono limitate al minimo necessario per i casi d'uso comuni di posizionamento.

Per ottenere informazioni sul multischermo e posizionare le finestre su altri schermi, i siti devono disporre dell'autorizzazione dell'utente. Mentre Chromium restituisce etichette dettagliate dello schermo, i browser sono liberi di restituire etichette meno descrittive (o anche vuote).

Controllo utenti

L'utente ha il pieno controllo dell'esposizione della propria configurazione. Possono accettare o rifiutare la richiesta di autorizzazione e revocare un'autorizzazione concessa in precedenza tramite la funzionalità delle informazioni del sito nel browser.

Controllo aziendale

Gli utenti di Chrome Enterprise possono controllare diversi aspetti dell'API Window Management come descritto nella sezione pertinente delle impostazioni dei gruppi di criteri atomici.

Trasparenza

Il fatto che l'autorizzazione per l'utilizzo dell'API Window Management sia stata concessa è esposto nelle informazioni sul sito del browser ed è anche interrogabile con l'API Permissions.

Persistenza delle autorizzazioni

Il browser mantiene le concessioni delle autorizzazioni. L'autorizzazione può essere revocata tramite le informazioni del sito del browser.

Feedback

C'è qualcosa nell'API che non funziona come previsto? Oppure mancano metodi o proprietà che ti servono per implementare la tua idea? Hai una domanda o un commento sul modello di sicurezza?

Invia una segnalazione relativa alle specifiche nel repository GitHub corrispondente o aggiungi i tuoi commenti a una segnalazione esistente.
Segnala un bug relativo all'implementazione di Chrome. Assicurati di includere il maggior numero di dettagli possibile, le istruzioni per la riproduzione e inserisci Blink>Screen>MultiScreen nella casella Componenti.

Mostrare il supporto per l'API

Intendi utilizzare l'API Window Management? Il tuo supporto pubblico aiuta il team di Chrome a dare la priorità alle funzionalità e mostra ad altri fornitori di browser quanto sia fondamentale supportarle.

Condividi il modo in cui prevedi di utilizzarlo nel thread di discussione WICG.
Invia un tweet a @ChromiumDev utilizzando l'hashtag #WindowManagement e facci sapere dove e come lo utilizzi.
Chiedi ad altri fornitori di browser di implementare l'API.

Risorse

Ringraziamenti

Le specifiche dell'API Window Management sono state modificate da Victor Costan, Joshua Bell e Mike Wasserman. L'API è stata implementata da Mike Wasserman e Adrienne Walker. Questo articolo è stato rivisto da Joe Medley, François Beaufort e Kayce Basques. Grazie a Laura Torrent Puig per le foto.