Kanonische Layouts

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

描绘了显示规范化布局的各种大屏设备。

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

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

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

列表详情

列表-详情布局的线框图。

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

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

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

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

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

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

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

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

实现

Das deklarative Paradigma von Compose unterstützt die Logik für Fenstergrößenklassen, mit der festgelegt wird, ob die Listen- und Detailbereiche gleichzeitig (wenn die Fenstergrößenklasse „Erweitert“ ist) oder nur der Listen- oder Detailbereich (wenn die Fenstergrößenklasse „Mittel“ oder „Kompakt“ ist) angezeigt werden sollen.

Um einen unidirektionalen Datenfluss zu gewährleisten, verschieben Sie den gesamten Status nach oben, einschließlich der aktuellen Fenstergrößenklasse und der Details des ausgewählten Listenelements (falls vorhanden), damit alle Composables Zugriff auf die Daten haben und korrekt gerendert werden können.

Wenn bei kleinen Fenstergrößen nur der Detailbereich angezeigt wird, fügen Sie ein BackHandler hinzu, um den Detailbereich zu entfernen und nur den Listenbereich anzuzeigen. Der BackHandler ist nicht Teil der allgemeinen App-Navigation, da der Handler von der Fenstergrößenklasse und dem ausgewählten Detailstatus abhängt.

ListDetailPaneScaffold ist eine übergeordnete zusammensetzbare Funktion, die die Implementierung von Listen-Detailansicht-Layouts vereinfacht. Die Logik für die Bereiche wird automatisch anhand der Fenstergrößenklassen verarbeitet und die Navigation zwischen den Bereichen wird unterstützt.

Hier ist eine minimale Implementierung mit ListDetailPaneScaffold:

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

Im Folgenden sind die wichtigsten Komponenten in diesem Beispiel aufgeführt:

  • rememberListDetailPaneScaffoldNavigator: Erstellt einen Navigator, um die Navigation zwischen der Liste und dem Detailbereich zu verwalten.
  • listPane: Zeigt die Liste der Elemente an.
  • detailPane: Zeigt den Inhalt eines ausgewählten Elements an.

Detaillierte Implementierungsbeispiele finden Sie hier:

信息流

Feed 布局的线框图。

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

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

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

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

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

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

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

实现

Ein Feed besteht aus einer großen Anzahl von Inhaltselementen in einem vertikal scrollbaren Container, die in einem Raster angeordnet sind. Lazy Lists rendern eine große Anzahl von Elementen in Spalten oder Zeilen effizient. Lazy Grids rendern Elemente in Rastern und unterstützen die Konfiguration der Elementgrößen und -spannen.

Konfigurieren Sie die Spalten des Rasterlayouts basierend auf dem verfügbaren Anzeigebereich, um die zulässige Mindestbreite für Rasterelemente festzulegen. Passen Sie beim Definieren von Rasterelementen die Spaltenspannen an, um bestimmte Elemente hervorzuheben.

Verwenden Sie für Abschnittsüberschriften, Trennlinien oder andere Elemente, die die gesamte Breite des Feeds einnehmen sollen, maxLineSpan, um die gesamte Breite des Layouts zu nutzen.

Auf Displays mit kompakter Breite, die nicht genügend Platz für mehr als eine Spalte bieten, verhält sich LazyVerticalGrid genau wie ein LazyColumn.

Hier ist eine minimale Implementierung mit 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)
        }
    }
}

Der Schlüssel zu einem adaptiven Feed ist die columns-Konfiguration. GridCells.Adaptive(minSize = 180.dp) erstellt ein Raster, in dem jede Spalte mindestens 180.dp breit ist. Im Raster werden dann so viele Spalten angezeigt, wie in den verfügbaren Platz passen.

Ein Beispiel für die Implementierung finden Sie im Feed with Compose-Beispiel.

辅助窗格

辅助窗格布局的线框图。

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

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

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

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

辅助窗格的用例包括：

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

实现

Compose unterstützt die Logik für Fenstergrößenklassen, mit der Sie festlegen können, ob sowohl der Hauptinhalt als auch der unterstützende Inhalt gleichzeitig angezeigt werden sollen oder ob der unterstützende Inhalt an einer anderen Stelle platziert werden soll.

Heben Sie den gesamten Status auf, einschließlich der aktuellen Fenstergrößenklasse und der Informationen zu den Daten im Hauptinhalt und im unterstützenden Inhalt.

Bei Displays mit kompakter Breite sollten Sie die unterstützenden Inhalte unter den Hauptinhalten oder in einer Ansicht am unteren Rand platzieren. Bei mittleren und erweiterten Breiten platzieren Sie die unterstützenden Inhalte neben den Hauptinhalten und passen Sie die Größe entsprechend den Inhalten und dem verfügbaren Platz an. Bei mittlerer Breite wird der Anzeigebereich gleichmäßig zwischen dem Haupt- und dem unterstützenden Inhalt aufgeteilt. Bei der Breite nach Expansion sollten 70% des Platzes für den Hauptinhalt und 30% für den unterstützenden Inhalt vorgesehen werden.

SupportingPaneScaffold ist eine übergeordnete zusammensetzbare Funktion, die die Implementierung von unterstützenden Bereichslayouts vereinfacht. Das Composable verarbeitet die Bereichslogik automatisch basierend auf den Fenstergrößenklassen. Auf großen Bildschirmen werden die Bereiche nebeneinander angezeigt, auf kleinen Bildschirmen wird der unterstützende Bereich ausgeblendet. SupportingPaneScaffold unterstützt auch die Navigation zwischen Bereichen.

Hier ein Beispiel für eine minimale Implementierung:

@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
        }
    )
}
 Wichtige Komponenten im Beispiel:

  • rememberSupportingPaneScaffoldNavigator: Composable, das einen Navigator erstellt, um die Sichtbarkeit von Bereichen zu verwalten (z. B. um den unterstützenden Bereich auf kompakten Bildschirmen auszublenden oder einzublenden)
  • mainPane: Composable, das den primären Inhalt anzeigt
  • supportingPane: Composable, das den ergänzenden Inhalt anzeigt

Detaillierte Implementierungsbeispiele finden Sie hier:

其他资源