沉浸式酒店列表
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
沉浸式列表由一系列内容和预览
所选内容。它会在更大的视口中显示内容。

资源
亮点
- 动态内容预览。当用户浏览
预览区域会自动更新
当前聚焦的项。
- 沉浸式列表组件的视口比
便于用户查看和欣赏
聚焦项的视觉细节。
- 沉浸式列表可提供相关的背景信息
有助于用户做出明智的决定,
用户也就离开了网站
- 沉浸式列表组件使用渐进式披露方式来
会更详细地了解用户所浏览的内容,从而降低
并维持用户互动度
- 沉浸式列表组件可确保整个应用中互动的一致性,
为用户提供熟悉且可预测的体验。
解剖学

- 图片背景
- 内容块
- 卡片对准焦点
- 内容网格

- 影片效果纱罩
- 海报
- 背景颜色
规格

行为
当您在“沉浸式”列表中的卡片之间切换时,
所选卡片会逐渐在后台显示
当沉浸式列表获得焦点时,其高度会增加以显示
其他信息,如背景标题和
如以下视频所示。
用法
如果您想吸引用户关注精选内容或
推广内容,例如新上线的内容、热门节目或独家内容
标题。更大的视口和动态预览
展示这些高优先级商品的方式。
图片显示

- 卡片焦点:当用户在轮播界面中导航时,
聚焦卡片在视觉上进行了强调,使用边框将卡片放大 1.1,
以及其他视觉提示作为高度来指示其选择。确保内容
焦点所在的卡片缩略图内的标题清晰
更清晰可见且更便于阅读
- 背景图片:当卡片获得焦点时,对应的背景
让图片显示在较大的视口中我们推荐使用此背景
图片质量很好,而且具有视觉吸引力,
为内容营造一个引人入胜的背景
合成
check_circle
正确做法
请对拍摄对象进行缩放并使其与右上角对齐,营造出影院级的体验。
cancel
错误做法
避免使用会剪裁掉内容下方的正文的全屏剪裁。
确保将图片用作全景列表组件中的背景
确保图片尺寸合适,不模糊
失真或失真
宽高比
请尽可能对背景图片使用 16:9 的宽高比,
具有视觉吸引力且一致的布局。

本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-27。
[null,null,["最后更新时间 (UTC):2025-07-27。"],[],[],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."]]