Lista imersiva
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A lista imersiva é uma combinação de uma linha de conteúdo e prévia do
item selecionado. Ele apresenta o conteúdo em uma janela de visualização maior.

Recursos
Destaques
- Visualização de conteúdo dinâmico. Quando um usuário navega pela linha de
a área de visualização será atualizada automaticamente para exibir o
para o item em foco no momento.
- O componente de lista imersiva apresenta uma janela de visualização maior para
exibir conteúdo, tornando mais fácil para os usuários visualizar e apreciar
os detalhes visuais do item em foco.
- Listas imersivas fornecem informações relevantes e contextuais
sobre o item em foco, ajudando os usuários a tomar decisões informadas sem
de sair da experiência de navegação.
- O componente da lista imersiva usa a divulgação progressiva para revelar
mais detalhes sobre o conteúdo à medida que os usuários navegam, reduzindo
carregar e manter o engajamento do usuário.
- O componente de lista imersiva garante interações consistentes em todo o app.
fornecendo aos usuários
uma experiência conhecida e previsível.
Anatomia

- Imagem de plano de fundo
- Bloqueio de conteúdo
- Card em foco
- Grade de conteúdo

- Filme scrim
- Cartaz
- Cor do segundo plano
Especificações

Comportamento
Ao navegar entre os cards na lista "Imersive", os detalhes do
os cards selecionados são revelados progressivamente em segundo plano.
Quando a lista imersiva está em foco, a altura aumenta para revelar
informações adicionais, como título e
na descrição, conforme mostrado no vídeo a seguir.
Uso
Use carrosséis imersivos quando quiser chamar a atenção para elementos em destaque ou
conteúdo promovido, como lançamentos, programas populares ou
títulos. A janela de visualização maior e a visualização dinâmica oferecem uma experiência
de mostrar esses itens de alta prioridade.
Exibição de imagens

- Foco do card: à medida que o usuário navega pelo carrossel, o
o cartão em foco é destacado visualmente, dimensionando o cartão em 1,1, usando uma borda,
e outras indicações visuais como elevação para indicar a seleção. Garantir o conteúdo
os títulos dentro da miniatura do cartão em foco estejam claramente
visíveis e fáceis de ler.
- Imagem de plano de fundo: quando um card estiver em foco, um plano de fundo correspondente
imagem é exibida na janela de visualização maior. Recomendamos este plano de fundo
é de alta qualidade e visualmente atraente, pois proporciona uma experiência
pano de fundo envolvente para o conteúdo.
Composição
check_circle
O que fazer
Dimensione e alinhe o objeto ao canto superior direito para criar uma experiência cinematográfica.
cancel
O que não fazer
Evite usar o recurso de cortar em tela cheia, porque isso fará com que o assunto seja cortado sob o conteúdo.
Garantir que as imagens usadas como planos de fundo no componente da lista imersiva
estejam boas, dimensione-as adequadamente para que não fiquem embaçadas
ou distorcidos.
Proporção
Use uma proporção de 16:9 nas imagens de plano de fundo sempre que possível para garantir
um layout visualmente atraente e consistente.

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.
[null,null,["Última atualização 2025-07-27 UTC."],[],[],null,["# Immersive list is a combination of a row of content \\& preview of the\nselected item. It features content in a larger viewport.\n\nResources\n---------\n\n| Type | Link | Status |\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------|\n| Design | [Design source (Figma)](https://goo.gle/tv-desing-kit) | Available |\n| Implementation | [Sample](https://cs.android.com/androidx/platform/frameworks/support/+/androidx-main:tv/samples/src/main/java/androidx/tv/samples/ImmersiveListSamples.kt;drc=5920fece16ad6723107098f24a492a25937cd51a) | N/A |\n\nHighlights\n----------\n\n- Dynamic content preview. When a user navigates through the row of content, the preview area automatically update to display the current focused item.\n- The Immersive list component features a larger viewport for displaying content, making it easier for users to view and appreciate the visual details of the focused item.\n- Immersive lists provide relevant and contextual information about the focused item, helping users make informed decisions without leaving the browsing experience.\n- The Immersive list component uses progressive disclosure to reveal more details about the content as users navigate, reducing cognitive load and maintaining user engagement.\n- The Immersive list component ensures consistent interactions across the app, providing users with a familiar and predictable experience.\n\nAnatomy\n-------\n\n1. Image background\n2. Content block\n3. Card on focus\n4. Content grid\n\n1. Cinematic scrim\n2. Poster\n3. Background color\n\nSpecs\n-----\n\nBehavior\n--------\n\nWhen navigating between cards in the Immersive list, the details of the\nselected card are progressively revealed in the background. \n\nWhen the immersive list is in focus, its height increases to reveal\nadditional information, such as the background title and\ndescription, as shown in the following video.\n\nUsage\n-----\n\nUse immersive carousels when you want to draw attention to featured or\npromoted content, such as new releases, popular shows, or exclusive\ntitles. The larger viewport and dynamic preview provide a compelling\nway to showcase these high-priority items.\n\n### Image display\n\n1. **Card focus**: As the user navigates through the carousel, the focused card is visually emphasized, scaling the card by 1.1, using a border, and other visual cues as elevation to indicate its selection. Ensure content titles inside the thumbnail of the focused card are clearly visible and easier to read.\n2. **Background image**: When a card is in focus, a corresponding background image is displayed in the larger viewport. We recommend this background image is high-quality and visually appealing, as it provides an immersive and engaging backdrop for the content.\n\n### Composition\n\ncheck_circle\n\n### Do\n\nScale and align the subject to the top right corner creating a cinematic experience. \ncancel\n\n### Don't\n\nAvoid using full screen crop that will make crop the subject under the content.\n\nTo ensure the images used as backgrounds in the Immersive list component\nlook good, make sure to scale them appropriately so they are not blurry\nor distorted.\n\n### Aspect ratio\n\nUse a 16:9 ratio for background images whenever possible to ensure\na visually appealing and consistent layout."]]