Insets no Compose
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As inserções fornecem informações sobre a interface do sistema para garantir que o app seja renderizado
na área correta e que a interface não seja obscurecida pela interface do sistema. Saiba como os insets
se comunicam com seu app onde as decorações do sistema são colocadas e como as APIs
do Compose ajudam seu conteúdo a se mover com as barras do sistema, o teclado
de software e a barra de tarefas.
Pontos principais
- Os Insets descrevem o quanto você precisa preencher o conteúdo do app para
evitar sobreposições com partes da interface do sistema ou recursos do dispositivo físico.
- Os diferentes tipos de insetos incluem barras de status, barras de navegação, teclado
de software e muito mais.
- As margens podem mudar enquanto o app está em execução, dependendo da configuração
do sistema e do ambiente de janelas, como a orientação do dispositivo,
a configuração do modo de várias janelas ou as configurações controláveis pelo usuário.
- Processe os insetos diretamente para aproveitar ao máximo o espaço da tela e melhorar a aparência
e o funcionamento do app em todos os formatos.
Coleções que contêm este guia
Este guia faz parte destas coleções selecionadas de guias rápidos que abrangem
metas mais amplas de desenvolvimento para Android:
Criar um scaffold da tela inicial
Descubra como usar uma plataforma padronizada para criar
interfaces do usuário complexas. O esqueleto reúne diferentes partes da
interface, dando aos apps uma aparência coerente.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Insets in Compose\n\n\u003cbr /\u003e\n\nInsets provide information about the system UI to ensure that your app draws in\nthe correct area and your UI isn't obscured by the system UI. Learn how insets\ncommunicate to your app where system decorations are placed, and how Compose\nAPIs help your content move with the system bars, software\nkeyboard, and the taskbar. \n\nKey points\n----------\n\n- *Insets* describe how much you need to pad the content of your app to avoid overlapping with parts of the system UI or physical device features.\n- Different types of insets include the status bars, navigation bars, software keyboard, and more.\n- Insets can change while your app is running, depending on the system configuration and windowing environment, such as device orientation, multi-window mode setup, or user controllable settings.\n- Handle insets directly to make full use of the screen space and improve how your app looks and functions across form factors.\n\nCollections that contain this guide\n-----------------------------------\n\nThis guide is part of these curated Quick Guide collections that cover\nbroader Android development goals: \n\n### Create a home screen scaffold\n\nFind out how to use a standardized platform to build complex user interfaces. The scaffold holds together different parts of the UI, giving apps a coherent look and feel. \n[Quick guide collection](/develop/ui/compose/quick-guides/collections/create-a-home-screen-scaffold) \n\nHave questions or feedback\n--------------------------\n\nGo to our frequently asked questions page and learn about quick guides or reach out and let us know your thoughts. \n[Go to FAQ](/quick-guides/faq) [Leave feedback](https://issuetracker.google.com/issues/new?component=1573691&template=1993320)"]]