Figura 1. La barra di stato e la barra di navigazione,
chiamate collettivamente barre di sistema.
Disponi tutte le app in modo che i contenuti si estendano dal bordo superiore a quello inferiore dello schermo. Questo è il comportamento predefinito a partire da Android 15
(livello API 35). Ciò significa che le aree superiore e inferiore dell'app sono disposte
dietro la barra di stato e la barra di navigazione. La barra di stato e la barra di navigazione
sono chiamate barre di sistema. Le barre di sistema sono aree
generalmente dedicate alla visualizzazione di notifiche, alla comunicazione dello stato
del dispositivo e alla navigazione del dispositivo.
Le sovrapposizioni tra la tua app e le aree in cui viene visualizzata l'interfaccia utente di sistema sono
un esempio di margini della finestra, che rappresentano le parti dello schermo in cui
la tua app può intersecarsi con l'interfaccia utente di sistema. L'intersezione con queste parti dell'interfaccia utente può significare la visualizzazione sopra i contenuti, ma può anche informare l'app in merito ai gesti di sistema.
Sono disponibili i seguenti tipi di rientri della finestra.
Per impostazione predefinita, scegli di espandere la finestra dell'app in modo che si estenda su tutto lo schermo e disegna i contenuti dell'app da bordo a bordo dietro le barre di sistema. Utilizza gli offset per evitare di visualizzare contenuti importanti
e target di tocco dietro le barre di sistema.
Le app che mostrano contenuti come film o immagini possono nascondere temporaneamente le
barre di sistema per un'esperienza più coinvolgente.
Valuta attentamente le esigenze e le aspettative degli utenti prima di modificare le
barre di sistema, poiché offrono agli utenti un modo standard per navigare in un dispositivo e
visualizzarne lo stato.
Un ritaglio display è un'area su alcuni dispositivi che si estende nella superficie del display
per fornire spazio ai sensori sulla parte anteriore del dispositivo. Le app possono
supportare le tacche del display eseguendo query sulle loro
posizioni in modo che nessun contenuto importante si sovrapponga all'area della tacca.
Una transizione della tastiera è un esempio comune in cui gli inset della finestra vengono
aggiornati in modo dinamico. Le app possono osservare lo stato attuale della tastiera,
attivare/disattivare gli stati in modo programmatico, supportare le animazioni per gli inset della finestra
e animare i contenuti delle app in modo fluido durante le transizioni della tastiera.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-08-27 UTC.
[null,null,["Ultimo aggiornamento 2025-08-27 UTC."],[],[],null,["Try the Compose way \nJetpack Compose is the recommended UI toolkit for Android. Learn how to work with WindowInsets in Compose. \n[WindowInsets in Compose →](/develop/ui/compose/system/insets) \n\n\u003cbr /\u003e\n\n**Figure 1.** The status bar and navigation bar, collectively called the *system bars*.\n\nLayout all apps so that your content stretches from the top edge to the bottom\nedge of the screen. This is the default behavior beginning in Android 15\n(API level 35). This means that the top and bottom areas of your app are laid\nout behind the status bar and the navigation bar. Together, the status bar and\nthe navigation bar are called the *system bars*. The system bars are areas that\nare generally dedicated to the display of notifications, communication of device\nstatus, and device navigation.\n\nThe overlaps between your app and the areas where the system UI is displayed is\none example of *window insets*, which represent the parts of your screen where\nyour app can intersect with the system UI. Intersecting with these parts of the\nUI can mean displaying above the content, but it can also inform your app about\nsystem gestures.\n\nThe following types of window insets are available.\n\n- By default, opt-in to expand your app window to extend across the entire\n screen and draw app content [edge-to-edge](/training/gestures/edge-to-edge)\n behind the system bars. Use offsets to avoid displaying important content\n and touch targets behind system bars.\n\n- Apps that display content such as movies or images can temporarily [hide the\n system bars](/training/system-ui/immersive) for a more immersive experience.\n Carefully consider your users' needs and expectations before modifying the\n system bars, since they give users a standard way of navigating a device and\n viewing its status.\n\n- A *display cutout* is an area on some devices that extends into the display\n surface to provide space for sensors on the front of the device. Apps can\n support [display cutouts](/guide/topics/display-cutout) by querying their\n positions so that no important content overlaps the cutout area.\n\n- A keyboard transition is a common example where window insets are\n dynamically updated. Apps can observe the current keyboard state,\n programmatically toggle the states, support animations for window insets,\n and make app content animate seamlessly between keyboard transitions."]]