التنسيقات الأساسية

规范化布局是经过验证的通用型布局，可在各种规格的设备上提供最佳用户体验。

规范化布局既支持小屏幕的手机，也支持平板电脑、可折叠设备和 ChromeOS 设备。此类布局遵循 Material Design 指南，不仅十分美观 ，而且功能强大。

Android 框架包含专门的组件，让您可以使用 View 和 Jetpack Compose 方便而可靠地实现此类布局。

借助规范化布局，您可以构建出引人注目且能提高效率的界面，为打造优秀的应用奠定基础。

列表详情

借助列表详情布局，用户可以浏览包含描述性、解释性或其他补充信息（即“项详情”）的项列表。

该布局可将应用窗口分为两个并排显示的窗格：一个用于显示列表，另一个用于显示详情。用户从列表中选择要查看的项，即可显示对应的项详情。详情中的深层链接可以在详情窗格中显示更多内容。

较大宽度的显示屏（请参阅使用窗口大小类别）可同时容纳 列表和详情。选择列表项后，详情窗格会更新，以显示所选项的相关内容。

中等宽度和紧凑宽度的显示屏可以显示列表或详情，具体取决于用户与应用的互动。如果只显示列表，当用户选择某个列表项时，对应的详情便会取代列表进行显示。如果只显示详情，当用户按返回按钮时，系统会重新显示列表。

配置更改（例如设备屏幕方向更改或应用窗口大小更改）可能会更改显示屏的窗口大小类别。列表详情布局会相应地做出响应，同时保留应用状态：

• 如果展开宽度的显示屏同时显示列表窗格和详情窗格，然后收窄为中等宽度或紧凑宽度，则详情窗格仍会显示，而列表窗格会变为隐藏状态
• 如果中等宽度或紧凑宽度的显示屏先只显示“详细信息”窗格，然后窗口大小类别展开为较大宽度，则列表和详情会一起显示，并且列表会指明与“详细信息”窗格中的内容对应的项已被选中
• 如果中等宽度或较小宽度的屏幕先只显示列表窗格，然后展开为较大宽度，则列表和占位符详情窗格会一起显示

列表详情布局非常适合即时通讯应用、通讯录管理器、互动 媒体浏览器或内容可整理为 项列表（用于显示额外信息）的任何应用。

图 1. 显示对话列表和所选对话的详情的即时通讯应用。

实现

يتيح النموذج التصريحي في Compose منطق فئة حجم النافذة الذي يحدّد ما إذا كان سيتم عرض لوحتَي القائمة والتفاصيل في الوقت نفسه (عندما تكون فئة حجم النافذة الموسّعة) أو لوحة القائمة أو التفاصيل فقط (عندما تكون فئة حجم النافذة متوسطة أو صغيرة).

لضمان تدفّق البيانات في اتجاه واحد، ارفع مستوى جميع الحالات، بما في ذلك فئة حجم النافذة الحالية وتفاصيل عنصر القائمة المحدّد (إن وُجد)، حتى تتمكّن جميع العناصر القابلة للإنشاء من الوصول إلى البيانات وعرضها بشكل صحيح.

عند عرض لوحة التفاصيل فقط على أحجام النوافذ الصغيرة، أضِف BackHandler لإزالة لوحة التفاصيل وعرض لوحة القائمة فقط. لا يشكّل BackHandler جزءًا من التنقّل العام في التطبيق لأنّ المعالج يعتمد على فئة حجم النافذة وحالة التفاصيل المحدّدة.

‫ListDetailPaneScaffold هي دالة قابلة للإنشاء ذات مستوى عالٍ تبسّط عملية تنفيذ عرض على شكل قائمة مع تفاصيل. ويتعامل تلقائيًا مع منطق اللوحة استنادًا إلى فئات حجم النافذة ويتيح التنقّل بين اللوحات.

في ما يلي عملية تنفيذ بسيطة باستخدام ListDetailPaneScaffold:

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MyListDetailPaneScaffold() {
    val navigator = rememberListDetailPaneScaffoldNavigator()
    ListDetailPaneScaffold(
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        listPane = {
            // Listing Pane
        },
        detailPane = {
            // Details Pane
        }
    )
}
CanonicalLayoutSamples.kt

في ما يلي المكوّنات الرئيسية في هذا المثال:

• rememberListDetailPaneScaffoldNavigator: تنشئ أداة تنقّل لإدارة التنقّل بين لوحتي القائمة والتفاصيل.
• ‫listPane: تعرض هذه السمة قائمة بالسلع.
• ‫detailPane: تعرض هذه السمة محتوى عنصر محدّد.

للاطّلاع على أمثلة تفصيلية حول التنفيذ، يُرجى مراجعة:

• دليل المطوّر إنشاء عرض على شكل قائمة مع تفاصيل
• نموذج list-detail-compose

信息流

Feed 布局能够以可配置网格的形式排列等效的内容元素，以便用户快速、方便地查看大量内容。

内容元素之间的关系由大小和位置确定。

如要创建内容组，可以将相关元素设置为相同的大小，并将这些元素放置到一起。如要吸引用户注意某个元素，可以将其设置为比附近的元素大。

卡片和列表是 Feed 布局的常见组件。

Feed 布局支持几乎任何尺寸的显示屏，因为网格可从滚动的单列调整为滚动的多列内容 Feed。

Feed 尤其适用于 新闻和社交媒体应用。

图 2. 以各种大小的卡片显示帖子的社交媒体应用。

实现

تتألف الخلاصة من عدد كبير من عناصر المحتوى في حاوية قابلة للتمرير عموديًا مرتّبة في شبكة. تعرض القوائم الكسولة عددًا كبيرًا من العناصر في أعمدة أو صفوف بكفاءة. تعرض الشبكات الكسولة العناصر في شبكات، وتتيح إمكانية ضبط أحجام العناصر ومدى اتساعها.

اضبط أعمدة التخطيط الشبكي استنادًا إلى مساحة العرض المتاحة لضبط الحد الأدنى المسموح به لعرض عناصر الشبكة. عند تحديد عناصر الشبكة، اضبط عدد الأعمدة التي تشغلها بعض العناصر لتسليط الضوء عليها أكثر من غيرها.

بالنسبة إلى عناوين الأقسام أو الفواصل أو العناصر الأخرى المصمّمة لتشغل العرض الكامل للخلاصة، استخدِم maxLineSpan لتشغل العرض الكامل للتصميم.

على الشاشات ذات العرض المضغوط التي لا تتوفّر فيها مساحة كافية لعرض أكثر من عمود واحد، يتصرف LazyVerticalGrid تمامًا مثل LazyColumn.

في ما يلي عملية تنفيذ بسيطة باستخدام LazyVerticalGrid:

@Composable
fun MyFeed(names: List<String>) {
    LazyVerticalGrid(
        // GridCells.Adaptive automatically adapts column count based on available width
        columns = GridCells.Adaptive(minSize = 180.dp),
    ) {
        items(names) { name ->
            Text(name)
        }
    }
}
CanonicalLayoutSamples.kt

يكمن مفتاح الخلاصة التكيّفية في إعداد columns. تنشئ GridCells.Adaptive(minSize = 180.dp) شبكة يكون فيها كل عمود بعرض 180.dp على الأقل. تعرض الشبكة بعد ذلك أكبر عدد ممكن من الأعمدة التي يمكن أن تتسع في المساحة المتاحة.

للحصول على مثال على التنفيذ، اطّلِع على نموذج الخلاصة باستخدام Compose.

辅助窗格

辅助窗格布局会按主要显示区域和辅助显示区域来整理应用内容。

主要显示区域占据应用窗口的大部分区域（通常占据三分之二左右），并且包含主要内容。辅助显示区域是一个窗格，它占据应用窗口的其余区域，并会展示主要内容的辅助性内容。

辅助窗格布局在采用横屏模式的较大宽度显示屏（请参阅使用窗口大小类别）上效果出众。在以下情况下，中等宽度或紧凑宽度的显示屏支持同时显示主要显示区域和辅助显示区域：内容可适应狭窄的显示空间，或者附加内容最初可隐藏在底部或侧边动作条（可通过菜单或按钮等控件访问）中。

主要内容和辅助内容之间的关系是辅助窗格布局与列表详情布局的区别所在。辅助窗格内容只在与主要内容相关时才有用；例如，如果单独使用，辅助窗格工具窗口则没有意义。但是，即使没有主要内容，列表详情布局的详情窗格中的补充内容仍然有意义；例如，商品详情中的商品说明。

辅助窗格的用例包括：

• 效率应用：在辅助窗格中附有评价者所发表 评论的文档或电子表格
• 媒体应用：在辅助窗格中显示流式视频和相关视频列表，或附有播放列表的音乐专辑说明
• 工具和设置：在辅助窗格中显示调色板、效果和其他设置的媒体编辑工具

图 3. 在辅助窗格中显示商品说明的购物应用。

实现

تتيح Compose منطق فئة حجم النافذة، ما يتيح لك تحديد ما إذا كنت تريد عرض المحتوى الرئيسي والمحتوى الداعم في الوقت نفسه أو وضع المحتوى الداعم في مكان بديل.

ارفع مستوى جميع الحالات، بما في ذلك فئة حجم النافذة الحالية والمعلومات ذات الصلة بالبيانات في المحتوى الرئيسي والمحتوى الداعم.

بالنسبة إلى الشاشات ذات العرض المضغوط، ضَع المحتوى الداعم أسفل المحتوى الرئيسي أو داخل ورقة في أسفل الشاشة. بالنسبة إلى العروض المتوسطة والموسّعة، ضَع المحتوى الثانوي بجانب المحتوى الرئيسي، مع ضبط حجمه بشكل مناسب استنادًا إلى المحتوى والمساحة المتاحة. بالنسبة إلى العرض المتوسط، قسِّم مساحة العرض بالتساوي بين المحتوى الرئيسي والمحتوى الداعم. بالنسبة إلى العرض الموسّع، خصِّص 70% من المساحة للمحتوى الرئيسي و30% للمحتوى الداعم.

‫SupportingPaneScaffold هي دالة برمجية قابلة للإنشاء عالية المستوى تبسّط عملية تنفيذ تنسيقات اللوحات المتجاورة. يتعامل العنصر القابل للإنشاء تلقائيًا مع منطق اللوحة استنادًا إلى فئات حجم النافذة، ويعرض اللوحات جنبًا إلى جنب على الشاشات الكبيرة أو يخفي اللوحة الثانوية على الشاشات الصغيرة. يتيح لك SupportingPaneScaffold أيضًا التنقّل بين اللوحات.

في ما يلي عملية تنفيذ بسيطة:

@OptIn(ExperimentalMaterial3AdaptiveApi::class)
@Composable
fun MySupportingPaneScaffold() {
    // Creates and remembers a navigator to control pane visibility and navigation
    val navigator = rememberSupportingPaneScaffoldNavigator()
    SupportingPaneScaffold(
        // Directive and value help control pane visibility based on screen size and state
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        mainPane = {
            // Main Pane for the primary content
        },
        supportingPane = {
            //Supporting Pane for supplementary content
        }
    )
}
CanonicalLayoutSamples.kt

المكوّنات الرئيسية في المثال:

• rememberSupportingPaneScaffoldNavigator: عنصر قابل للإنشاء ينشئ أداة تنقّل لإدارة إمكانية ظهور اللوحة (على سبيل المثال، إخفاء اللوحة الثانوية أو عرضها على الشاشات الصغيرة)
• ‫mainPane: دالة مركّبة تعرض المحتوى الأساسي
• ‫supportingPane: عنصر مركّب يعرض المحتوى التكميلي

للاطّلاع على أمثلة تفصيلية حول التنفيذ، يُرجى مراجعة:

• دليل المطوّرين حول إنشاء تخطيط لوحة داعمة
• نموذج supporting-pane-compose

其他资源

• Material Design：规范化布局