Ein Listen-Detail-Layout erstellen

„List-Detail“ ist ein UI-Muster, das aus einem Dual-Pane-Layout besteht, bei dem ein Bereich zeigt eine Liste mit Elementen an, während ein weiterer Bereich die Details der ausgewählten Elemente enthält aus der Liste aus.

Das Muster ist besonders nützlich für Anwendungen, die detaillierte Informationen zu Elementen großer Sammlungen, z. B. zu E-Mail-Clients die eine Liste der E-Mails und den detaillierten Inhalt jeder E-Mail-Nachricht enthält. Die Funktion „Listendetails“ kann auch für weniger wichtige Pfade wie das Unterteilen von Apps verwendet werden. in eine Liste von Kategorien mit den Einstellungen für jede Kategorie in Detailbereich.

UI-Muster mit ListDetailPaneScaffold implementieren

ListDetailPaneScaffold ist eine zusammensetzbare Funktion, die die Implementierung von das Listen-Detail-Muster in deiner App. Ein Gerüst mit Listendetails kann bis zu einen Listenbereich, einen Detailbereich und einen optionalen zusätzlichen Bereich. Die die Bildschirmflächenberechnungen. Bei ausreichender Bildschirmgröße verfügbar ist, wird der Detailbereich neben dem Listenbereich angezeigt. Auf einem kleinen Display wechselt das Gerüst automatisch zur Anzeige der Liste oder Detailbereich im Vollbildmodus.

<ph type="x-smartling-placeholder">
</ph> Detailbereich neben der Listenseite
Abbildung 1: Bei ausreichender Bildschirmgröße neben dem Listenbereich angezeigt.
<ph type="x-smartling-placeholder">
</ph> Nachdem ein Element ausgewählt wurde, nimmt der Detailbereich den gesamten Bildschirm ein.
Abbildung 2. Bei eingeschränkter Bildschirmgröße: Detailbereich (da ein Element ausgewählt wurde) die den gesamten Raum einnimmt.

Abhängigkeiten deklarieren

ListDetailPaneScaffold ist Teil des Adaptiven Material 3-Layouts .

Fügen Sie die folgenden drei zusammengehörigen Abhängigkeiten in die Datei build.gradle Ihres App oder Modul:

Kotlin


implementation("androidx.compose.material3.adaptive:adaptive")
implementation("androidx.compose.material3.adaptive:adaptive-layout")
implementation("androidx.compose.material3.adaptive:adaptive-navigation")

Cool


implementation 'androidx.compose.material3.adaptive:adaptive'
implementation 'androidx.compose.material3.adaptive:adaptive-layout'
implementation 'androidx.compose.material3.adaptive:adaptive-navigation'

  • adaptive – Low-Level-Bausteine wie HingeInfo und Posture
  • adaptive-layout – adaptive Layouts wie ListDetailPaneScaffold und SupportingPaneScaffold
  • adaptive-navigation – Composables zur Navigation innerhalb und zwischen den Bereichen

Grundlegende Nutzung

Implementieren Sie ListDetailPaneScaffold so:

  1. Verwenden Sie eine Klasse, die den auszuwählenden Inhalt darstellt. Dieser Kurs sollte Parcelable sein, um das Speichern und das ausgewählte Listenelement wiederherstellen. Das Objekt kötlin-parcelize verwenden Plug-in ein, um den Code für Sie zu generieren.

    @Parcelize
    class MyItem(val id: Int) : Parcelable

  2. Erstellen Sie ein ThreePaneScaffoldNavigator mit rememberListDetailPaneScaffoldNavigator und füge BackHandler hinzu. Dieses navigator wird verwendet, um zwischen der Liste, den Details und zusätzlichen Bereichen zu wechseln. Von gibt der Navigator einen generischen Typ an, Scaffold (das heißt, MyItem wird angezeigt). Da dieser Typ kann der Status vom Navigator gespeichert und wiederhergestellt werden. Konfigurationsänderungen automatisch verarbeiten. Die BackHandler können Sie über die Zurück-Touch-Geste des Systems oder Schaltfläche. Das erwartete Verhalten der Zurück-Schaltfläche für eine ListDetailPaneScaffold hängt von der Fenstergröße und dem aktuellen Gerüst ab Wert. Wenn ListDetailPaneScaffold eine Rückkehr mit der ist canNavigateBack() auf "true" gesetzt. BackHandler.

    val navigator = rememberListDetailPaneScaffoldNavigator<MyItem>()
    
    BackHandler(navigator.canNavigateBack()) {
        navigator.navigateBack()
    }

  3. Übergeben Sie die scaffoldState von der navigator an die ListDetailPaneScaffold zusammensetzbar.

    ListDetailPaneScaffold(
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        // ...
    )

  4. Stellen Sie Ihre Listenbereich-Implementierung für den ListDetailPaneScaffold bereit. Verwenden Sie AnimatedPane um die standardmäßigen Fensteranimationen während der Navigation anzuwenden. Verwenden Sie dann ThreePaneScaffoldNavigator, um zum Detailbereich zu wechseln, ListDetailPaneScaffoldRole.Detail und rufen Sie das übergebene Element auf.

    ListDetailPaneScaffold(
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        listPane = {
            AnimatedPane {
                MyList(
                    onItemClick = { item ->
                        // Navigate to the detail pane with the passed item
                        navigator.navigateTo(ListDetailPaneScaffoldRole.Detail, item)
                    }
                )
            }
        },
        // ...
    )

  5. Fügen Sie die Implementierung des Detailbereichs in ListDetailPaneScaffold ein. Wenn die Navigation abgeschlossen ist, enthält currentDestination den Bereich, aufgerufen wurde, einschließlich des angezeigten Inhalts. Die Die Eigenschaft content ist der gleiche Typ, der im ursprünglichen Aufruf zum Merken angegeben wurde (in diesem Beispiel MyItem), sodass Sie auch für alle Daten auf die Property zugreifen können. die Sie präsentieren möchten.

    ListDetailPaneScaffold(
        directive = navigator.scaffoldDirective,
        value = navigator.scaffoldValue,
        listPane =
        // ...
        detailPane = {
            AnimatedPane {
                navigator.currentDestination?.content?.let {
                    MyDetails(it)
                }
            }
        },
    )

Nachdem Sie die obigen Schritte implementiert haben, sollte Ihr Code in etwa so aussehen:

val navigator = rememberListDetailPaneScaffoldNavigator<MyItem>()

BackHandler(navigator.canNavigateBack()) {
    navigator.navigateBack()
}

ListDetailPaneScaffold(
    directive = navigator.scaffoldDirective,
    value = navigator.scaffoldValue,
    listPane = {
        AnimatedPane {
            MyList(
                onItemClick = { item ->
                    // Navigate to the detail pane with the passed item
                    navigator.navigateTo(ListDetailPaneScaffoldRole.Detail, item)
                },
            )
        }
    },
    detailPane = {
        AnimatedPane {
            // Show the detail pane content if selected item is available
            navigator.currentDestination?.content?.let {
                MyDetails(it)
            }
        }
    },
)