Compose Material 3

Mit Material Design 3-Komponenten, der nächsten Generation von Material Design, können Sie Jetpack Compose-UIs erstellen. Material 3 umfasst aktualisierte Designs und Komponenten sowie Material You-Personalisierungsfunktionen wie dynamische Farben. Es ist auf den neuen visuellen Stil und die System-UI von Android 12 abgestimmt.
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alpharelease
2. Juli 2025 1.3.2 - - 1.4.0-alpha17

Struktur

Compose ist eine Kombination aus sieben Maven-Gruppen-IDs in androidx. Jede Gruppe enthält eine bestimmte Teilmenge von Funktionen mit jeweils eigenen Versionshinweisen.

In dieser Tabelle werden die Gruppen erläutert und es sind Links zu den jeweiligen Versionshinweisen enthalten.

GruppeBeschreibung
compose.animationAnimationen in Jetpack Compose-Anwendungen erstellen, um die Nutzerfreundlichkeit zu verbessern.
compose.compiler@Composable-Funktionen transformieren und Optimierungen mit einem Kotlin-Compiler-Plug-in ermöglichen
compose.foundationMit den einsatzbereiten Bausteinen können Sie Jetpack Compose-Anwendungen schreiben und die Grundlage erweitern, um eigene Designsystemkomponenten zu erstellen.
compose.materialJetpack Compose-UIs mit einsatzbereiten Material Design-Komponenten erstellen Dies ist der Einstiegspunkt auf höherer Ebene für Compose. Er soll Komponenten bereitstellen, die den auf www.material.io beschriebenen Komponenten entsprechen.
compose.material3Mit Material Design 3-Komponenten, der nächsten Generation von Material Design, können Sie Jetpack Compose-UIs erstellen. Material 3 umfasst aktualisierte Designs und Komponenten sowie Material You-Personalisierungsfunktionen wie dynamische Farben. Es ist auf den neuen visuellen Stil und die System-UI von Android 12 abgestimmt.
compose.runtimeGrundlegende Bausteine des Programmiermodells und der Statusverwaltung von Compose sowie die Core-Laufzeit für das Compose Compiler-Plug-in.
compose.uiGrundlegende Komponenten der Compose-Benutzeroberfläche, die für die Interaktion mit dem Gerät erforderlich sind, einschließlich Layout, Zeichnen und Eingabe.

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von Compose hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:

Groovy

dependencies {
    implementation "androidx.compose.material3:material3:1.3.2"
    implementation "androidx.compose.material3:material3-window-size-class:1.3.2"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.3.2")
    implementation("androidx.compose.material3:material3-window-size-class:1.3.2")
    implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Lassen Sie es uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können für ein vorhandenes Problem abstimmen, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung.

Compose Material3 Common Version 1.0

Version 1.0.0-alpha01

17. April 2024

androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01 und androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 sind veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Themenlose Komponenten, mit denen Material Design-Komponenten erstellt werden können:

Compose Material3 Adaptive Navigation Suite Version 1.0

Version 1.0.0-alpha07

1. Mai 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 sind veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

API-Änderungen

  • Navigationssuite-APIs nicht mehr als experimentell kennzeichnen (If62af)

Fehlerkorrekturen

  • Standardmäßig Insets für Inhalte verwenden (50266df)

Version 1.0.0-alpha06

17. April 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

  • Fügen Sie containerColor und contentColor zu NavigationSuiteScaffoldDefaults hinzu. (I64e3a, b/331993720)
  • Die Funktion itemColors wird NavigationSuiteDefaults hinzugefügt. (Idf719, b/328480012)
  • NavigationSuiteScope versiegeln (Iefa57)

Version 1.0.0-alpha05

6. März 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

API-Änderungen

  • Machen Sie den NavigationSuiteItemColors-Konstruktor öffentlich. (Ica83a, b/324886877)

Version 1.0.0-alpha04

21. Februar 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Abhängigkeitsupdates

  • Aktualisieren Sie die adaptiven Material3-Abhängigkeiten auf die neuen Modulpfade. (Ibc421)
  • Auf die Window Manager-Version der Fenstergrößenklassen umstellen (I3794d)

Version 1.0.0-alpha03

7. Februar 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

  • Paketname von „navigation-suite“ in „navigationsuite“ ändern (I7eff7)
  • Material3-Komponenten, die in ihrer API ein MutableInteractionSource verfügbar machen, wurden aktualisiert, sodass sie jetzt ein nullable MutableInteractionSource verfügbar machen, das standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie das MutableInteractionSource nicht verschieben. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie ein MutableInteractionSource zugewiesen wird. Außerdem kann es sein, dass für andere Komponenten nur dann eine Instanz erstellt wird, wenn sie benötigt wird. Das verbessert die Leistung dieser Komponenten. Wenn Sie die MutableInteractionSource, die Sie an diese Komponenten übergeben, nicht verwenden, sollten Sie stattdessen „null“ übergeben. Es wird auch empfohlen, ähnliche Änderungen in Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146)

Version 1.0.0-alpha02

13. Dezember 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

Fehlerkorrekturen

  • Das Problem, dass die Navigationskomponente den gesamten Bildschirm ausfüllt, wenn die Stammoberfläche modifier.fillMaxSize hat, wurde behoben. (c9cf250, b/312664933)

Version 1.0.0-alpha01

15. November 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Compose Material3 Adaptive Version 1.0

Version 1.0.0-alpha06

7. Februar 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Es wurden zusätzliche Verhaltensoptionen für die ThreePaneScaffoldNavigator-Zurück-Navigation hinzugefügt. (I858aa)
  • Dem Navigationsverlauf wurden optionale Zielinhalte hinzugefügt. (Ibd7e6)

Version 1.0.0-alpha05

24. Januar 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Unterstützung von Verlaufsdaten in der Gerüstnavigation und Wertberechnung (I71d46)

Version 1.0.0-alpha04

10. Januar 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Unterstützung für Edge-to-Edge-Darstellung in Bereichsgerüsten hinzugefügt (I1b462)

API-Änderungen

  • Die Eigenschaften für die Scharniergrenzen in „Posture“ wurden in eine Liste mit Scharnierinformationen verschoben (I24f90).

Fehlerkorrekturen

  • Problem mit AnimatedPane, das nicht neu zusammengesetzt wird, behoben (c3f573d)

Version 1.0.0-alpha03

13. Dezember 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

  • Ändern Sie die Gerüstrollen in Aliase von ThreePaneScaffoldRole. (I65bd1)
  • Basisklasse für Gerüstrollen erstellen (I4784d)
  • Entferne unnötige Parameter aus den Inhalten von AnimatedPane (Ibc73b)
  • Benennt collectWindowSizeAsState um und gibt stattdessen Rohwerte zurück (I480f4)

Version 1.0.0-alpha02

29. November 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

API-Änderungen

  • Navigations-APIs von APIs für adaptive Gerüste trennen (Ic4045)
  • Entfernen Sie den Kurs GutterSize. (I785b3)

Fehlerkorrekturen

  • Fix: Bereiche werden nicht gewechselt, wenn AnimatedPane nicht verwendet wird (d88f181)

Version 1.0.0-alpha01

15. November 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Adaptive Condition APIs für Material 3:

Material3-APIs für adaptive Pane-Scaffold-Anweisungen:

Material3-APIs für adaptive Pane-Scaffolding:

Compose Material3 Version 1.4

Version 1.4.0-alpha17

2. Juli 2025

androidx.compose.material3:material3-*:1.4.0-alpha17 wird veröffentlicht. Version 1.4.0-alpha17 enthält diese Commits.

Neue Funktionen

  • Die Animation der Schaltflächengruppe wird jetzt bei einem Klick und nicht erst bei einem Druck zu 75% animiert. (593942a, b/423596967)

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem ein Karussellelement in einigen Fällen die Größe des großen Elements bei der Layoutberechnung überschreiten konnte, wodurch das gesamte Widget abgeschnitten wurde. (I1c3d7, b/397489534)
  • Das Überspringen von beforeContentPadding beim Scrollen von Karussells mit sich überschneidenden Start- und Endverschiebungen wurde behoben. (c3d5f3a, b/420618979)
  • Das aktivierte Verhalten von SwipeToDismiss wurde so aktualisiert, dass der abgerechnete Status anstelle des aktuellen Status berücksichtigt wird. Stellt das bisherige Verhalten wieder her, bei dem das Ankerverhalten nur deaktiviert wird, wenn sich die Komponente in einem geschlossenen Zustand befindet. (3844e07, b/425006844)
  • Das Pop-up-Menü von ExposedDropdownMenu kann jetzt über die Tastatur geöffnet werden. Außerdem ist das Menü für die bearbeitbare Variante jetzt über die Tastatur erreichbar. (46ead03)

Version 1.4.0-alpha16

18. Juni 2025

androidx.compose.material3:material3-*:1.4.0-alpha16 wird veröffentlicht. Version 1.4.0-alpha16 enthält diese Commits.

Neue Funktionen

  • Eine zentriert ausgerichtete Hero-Karussellkomponente wurde hinzugefügt (I6f6d3).

API-Änderungen

  • Implementierung von XR-Überschreibungen für die vertikale Symbolleiste (Ia1604)
  • CarouselState wurden programmatische Scrollfunktionen hinzugefügt (I12f8e)
  • ComponentOverride für ModalWideNavigationRail hinzufügen (I4f440)
  • ComponentOverride für WideNavigationRail hinzufügen (I6354f)
  • ComponentOverride für HorizontalFloatingToolbar erstellen (I51116)
  • ComponentOverride für ShortNavigationBar erstellen (I30e24)
  • SwipeToDismissBoxState-Verweise auf confirmValueChange wurden als veraltet markiert. Nutzer sollten stattdessen den SwipeToDismissBox API-Callback onDismissed verwenden. (Iee780)
  • Der Parameter „userScrollEnabled“ wurde den Carousel-Composables hinzugefügt. (I1d4d2)
  • Die currentItem des Karussells können jetzt über CarouselState beobachtet werden. (Ie87e9)

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem eine beliebige Form auf einem FAB, die an eine FloatingToolbar übergeben wurde, ihren Schatten nicht richtig angewendet hat. (Icdcc9, b/423336922)
  • Für alle Karussells wird jetzt standardmäßig die semantische Rolle „Karussell“ verwendet. (I7af12)
  • Falsche Daumenbewegung wurde korrigiert, wenn der Status des Schiebereglers über LaunchedEffect aktualisiert wurde (Id9f31, b/302774166)

Version 1.4.0-alpha15

20. Mai 2025

androidx.compose.material3:material3-*:1.4.0-alpha15 wird veröffentlicht. Version 1.4.0-alpha15 enthält diese Commits.

API-Änderungen

  • MotionTheme.LocalMotionScheme hinzugefügt, Komposition lokal. Dadurch kann über CompositionLocalConsumerModifierNodes mit currentValueOf(MotionTheme.LocalMotionScheme) auf das Bewegungsdesign des Themas zugegriffen werden. (I014b1)
  • Der ColorScheme-Konstruktor ohne feste Farbrollen ist jetzt veraltet. Bitte migrieren Sie zum Konstruktor, der feste Rollen enthält. (Iad0ee)
  • Die M3-Textkomponente unterstützt jetzt TextAutoSize. (I7f524)
  • API zum Erstellen von Split-Button-Größenvarianten und Beispiele hinzugefügt. (Ice30b)

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem Snackbar und FloatingActionButton bei aktivierter Edge-to-Edge-Funktion falsch positioniert waren. Scaffold wendet jetzt horizontale Insets korrekt auf diese Komponenten an. (Ib7c30, b/244400727)
  • Korrigiere die BottomSheet-Bewegung von vollständig maximiert zu teilweise maximiert. Für das BottomSheet wird jetzt der schnelle Effekt von MotionScheme beim Ausblenden oder Minimieren und der räumliche Standardeffekt beim Maximieren verwendet. (Ifa46f, b/416063171)
  • Der ColorScheme-Konstruktor ohne Rollen für Oberflächencontainer wurde als ausgeblendet markiert und wird nicht mehr empfohlen. (Ia7237)
  • Die Anforderung CircularWavyProgressIndicator Size.minDimension > 0 wurde entfernt, um mehr Flexibilität zu ermöglichen. Zuvor wurde dadurch eine Ausnahme ausgelöst. (Ic9418, b/377531195)
  • Hyperlinks in Text(AnnotatedString) haben jetzt standardmäßig das Material-Design. (I78288, b/339843816)
  • Es wurde ein Problem behoben, bei dem die Funktion toShape() in RoundedPolygon einen Pfad zwischenspeichert und ein Problem verursacht, wenn mehrere createOutline-Aufrufe mit unterschiedlichen Größen erfolgen. (I4026d)

Version 1.4.0-alpha14

7. Mai 2025

androidx.compose.material3:material3-*:1.4.0-alpha14 wird veröffentlicht. Version 1.4.0-alpha14 enthält diese Commits.

API-Änderungen

  • Es wurde eine neue zusammensetzbare Funktion AppBarColumn hinzugefügt, die genauso funktioniert wie AppBarRow, aber für Inhalte, die in einer Spalte angeordnet sind. (Iaf6bd)
  • Die maximale Anzahl von Elementen wurde AppBarRow hinzugefügt. Dies ist erforderlich, um die Material-Spezifikation für obere App-Leisten korrekt zu implementieren. (I92ce4)
  • In TooltipScope wurde eine Methode zum Abrufen der layoutCoordinates des Ankers hinzugefügt. Die Methode drawCaret wird eingestellt, da Entwickler mit dieser neuen Methode die Ankergrenzen layoutCoordinates abrufen und eine geeignete Form mit einem Caretzeichen erstellen können. (Ia2e12, b/329470609)
  • java.time-Unterstützung für Datumsauswahlen hinzugefügt: Es wurden rememberDatePickerState/rememberDateRangePickerState-Überladungen eingeführt, die java.time-Objekte (z.B. initial LocalDate, YearMonth) akzeptieren. Außerdem wurden Erweiterungsfunktionen für die Statusobjekte hinzugefügt, um Werte mit Typen wie LocalDate und YearMonth abzurufen/festzulegen. Erfordert API 26 oder höher oder Desugaring. (I70f29, b/266202516, b/281859606)
  • Fügen Sie die zusammensetzbare Funktion CenteredTrack hinzu, damit ein Schieberegler mit einem Track verwendet werden kann, der in der Mitte beginnt. (I5b1d6)

Fehlerkorrekturen

  • Die Leistung von wellenförmigen Fortschrittsanzeigen wurde verbessert: Lineare Typen werden jetzt etwa 8, 5% schneller geladen und es sind etwa 11% weniger Zuweisungen erforderlich.Bei kreisförmigen Typen ist die Geschwindigkeit um etwa 47% gestiegen und die Anzahl der Zuweisungen um etwa 39% gesunken. (I595d8)

Version 1.4.0-alpha13

23. April 2025

androidx.compose.material3:material3-*:1.4.0-alpha13 wird veröffentlicht. Version 1.4.0-alpha13 enthält diese Commits.

API-Änderungen

  • isAppearanceLightStatusBars und isAppearanceLightNavigationBars wurden in ModalBottomSheetProperties als reine Android-Parameter wieder eingeführt. (Id4bc0)
  • Fügen Sie eine AppBarRow-Composable hinzu, die den Überlauf von Elementen verarbeitet, die außerhalb ihrer Grenzen liegen. (I742bd)
  • Aktualisieren Sie die APIs DatePicker und DateRangePicker, um den Fokus beim Wechsel in den Datumseingabemodus anzufordern. Wir haben den booleschen Parameter requestFocus durch den optionalen Parameter focusRequester ersetzt, der einen FocusRequester akzeptiert. (I14b69)
  • Entfernen Sie die Modifikator- und Interaktionsquelle aus den standardmäßigen anklickbaren und umschaltbaren Elementen. Verwenden Sie es stattdessen als Implementierungsdetail. (I95ed6)
  • Die Schaltfläche ButtonGroup wird jetzt in ein Drop-down-Menü verschoben, wenn zu viele Schaltflächen auf dem Bildschirm angezeigt werden. (I7b88b)

Fehlerkorrekturen

  • Das Bottomsheet verwendet jetzt die oberen Insets, wenn es kleiner als der aktuelle Offset ist. So können Nutzer obere Insets für das erweiterte Verhalten angeben. BottomSheetDefaults.windowInsets enthält jetzt WindowInsets.safeDrawing.Top. (I0ab67, b/321877275, b/336962418, b/342093067)
  • Ein- und Ausblendeanimationen (Ein- und Ausblenden/Ein- und Ausschieben) für führende Symbole/Avatare und nachfolgende Symbole von Chips beim Hinzufügen oder Entfernen aktiviert. Das ist vor allem für auswählbare Chips (Filter, Eingabe) von Vorteil, gilt aber allgemein. (I9af21)
  • Das fehlerhafte Verhalten des RTL-Schiebereglers, das durch LookaheadScope verursacht wurde, wird behoben. (Ieb152, b/408118041)
  • Behebung des Absturzes im unteren AppBar-Bereich beim Scrollen mit ausgeblendeter System-UI. (Ic6140, b/405996228)

Version 1.4.0-alpha12

9. April 2025

androidx.compose.material3:material3-*:1.4.0-alpha12 wird veröffentlicht. Version 1.4.0-alpha12 enthält diese Commits.

API-Änderungen

  • Android-spezifische Parameter aus ModalBottomSheetProperties entfernt (Iab97f, b/362539765)
  • Überladen von Funktionen für Standardwerte für die Größe des Ziehpunkts (I0ed0d)
  • Neue NavigationSuiteScaffold- und NavigationSuiteScaffoldLayout-Funktionen zur Unterstützung neuer Layouttypen und zum Hinzufügen von Unterstützung für optionalen primären Aktionsinhalt. (Ib262a, b/353144478)
  • Modifier.weight mit dem Parameter „fill“ in ButtonGroup wird eingestellt. Version ohne Füllung hinzufügen (Id32bb)
  • Benennen Sie xSmall- und xLarge- um. Die Standardeinstellungen der IconButton-Komponente sind auf extra festgelegt. (Ib6e0f)
  • Es wurden neue NavigationSuite-, NavigationSuiteItem- und NavigationSuiteColors-Funktionen hinzugefügt, um neue Layouttypen zu unterstützen. (I203d6)
  • Fügen Sie die neue NavigationSuiteTypes- und die neue navigationSuiteType-Funktion hinzu, die diese Layoutoptionen enthalten (If68f9).

Fehlerkorrekturen

  • ColorScheme.contentColorFor wird jetzt surfaceDim zu onSurface zugeordnet. (I8891a)
  • Die DateInputTextField-Implementierung wurde aktualisiert, um ein Problem zu beheben, bei dem das Eingabefeld das programmgesteuert festgelegte Datum nicht widerspiegelte. (I6c8d1, b/401143451)
  • Die TalkBack-Fokusreihenfolge für die Navigationsleiste und die breite Navigationsleiste wurde korrigiert (I6cf6f, b/407048224).

Version 1.4.0-alpha11

26. März 2025

androidx.compose.material3:material3-*:1.4.0-alpha11 wird veröffentlicht. Version 1.4.0-alpha11 enthält diese Commits.

API-Änderungen

  • Die Groß-/Kleinschreibung für zusammensetzbare Eigenschaften in Standardobjekten für Schaltflächen und Ein/Aus-Schaltflächen wurde aktualisiert. Fügen Sie in ToggleButtonDefaults und ButtonDefaults Methoden für das empfohlene Padding, die Formen, die Symbolgröße, den Symbolabstand und den Textstil für empfohlene Inhalte in Abhängigkeit von der Containerhöhe hinzu. (Iea69e)
  • Veraltete experimentelle Funktionen und Konstanten wurden aus der FloatingToolbar entfernt. (I8f339)
  • Höhenkomponenten haben jetzt eine gemeinsame Schnittstelle und öffentliche Konstruktoren und Eigenschaften. (Ibb172)
  • Hinzufügen des Modifikators animateWidth in ButtonGroupScope, der mit den untergeordneten Elementen der Schaltflächengruppe verwendet werden muss, um die untergeordneten Elemente richtig zu animieren. (Ia3bb6)

Fehlerkorrekturen

  • Das Padding der schwebenden Symbolleiste wurde korrigiert, um für ein ausgewogenes Erscheinungsbild beim Minimieren zu sorgen. Außerdem wurde die Flexibilität für größere Inhalte verbessert. (I06c00)

Version 1.4.0-alpha10

12. März 2025

androidx.compose.material3:material3-*:1.4.0-alpha10 wird veröffentlicht. Version 1.4.0-alpha10 enthält diese Commits.

API-Änderungen

  • TabRowDefaults.tabIndicatorOffset wurde zugunsten von TabIndicatorScope.tabIndicatorOffset eingestellt. (Ib36b3)
  • Rechtschreibfehler für kleines Content-Padding in Schaltflächen-Standardeinstellungen behoben. (I19bfe)
  • TabRow und ScrollableTabRow werden zugunsten von primären und sekundären Varianten der jeweiligen Elemente eingestellt. Die Zeilen auf den Tabs „Primär“ und „Sekundär“ sind leistungsfähiger und entsprechen genauer den Spezifikationen. (I918e2)
  • rememberSliderState und rememberRangeSliderState wurden hinzugefügt. (I8e384)
  • shouldAutoSnap wurde zu SliderState hinzugefügt, um den automatischen Einrastmechanismus zu steuern. Das Deaktivieren kann für benutzerdefinierte Animationen nützlich sein. (I07745)
  • Die Mindestbreite von Tabs in scrollbaren Tabzeilen ist jetzt ein Parameter. Die Varianten für die primäre und sekundäre Tabellenzeile sind nicht mehr experimentell. (If6f15, b/226665301)
  • Die Klasse ExitAlwaysFloatingToolbarScrollBehavior wurde öffentlich gemacht, sodass sie ohne Komposition erstellt werden kann. (Ibf31c)

Version 1.4.0-alpha09

26. Februar 2025

androidx.compose.material3:material3-*:1.4.0-alpha09 wird veröffentlicht. Version 1.4.0-alpha09 enthält diese Commits.

API-Änderungen

  • Die Einstellungsfelder von DragHandle im Standardstatus umbenennen, gedrückte und gezogene Status trennen und die Standardgrößen öffentlich machen. (I787b9)
  • Aktualisierungen der TowRowsTopAppBar API Der Lambda-Parameter expanded wurde entfernt und es wurden separate Parameter für die maximierte und minimierte Höhe hinzugefügt. (Idd677, b/306697446, b/229134133, b/268068946)

Fehlerkorrekturen

  • Die unteren App-Leisten berücksichtigen jetzt den Dienst zur Touch-Erkundung (z.B. TalkBack) und lassen Sie sie immer sichtbar, wenn der Dienst aktiv ist. (I4b34d)

Version 1.4.0-alpha08

12. Februar 2025

androidx.compose.material3:material3-*:1.4.0-alpha08 wird veröffentlicht. Version 1.4.0-alpha08 enthält diese Commits.

Neue Funktionen

  • Es wurde eine TimePickerDialog API hinzugefügt, die für TimePicker, TimeInput oder für eine umschaltbare Version verwendet werden kann. (Id2d83)

  • Neue APIs für die Suchleiste:

    • Minimierte Suchleisten und maximierte Suchansichten sind jetzt separate Composables.
    • SearchBar steht für eine Suchleiste im minimierten Zustand.
    • ExpandedFullScreenSearchBar und ExpandedDockedSearchBar stellen die Suchleiste im maximierten Zustand dar. Diese werden in einem neuen Fenster geöffnet.
    • SearchBarState zum Steuern des Status der Suchleiste
    • TopSearchBar, um die Verarbeitung von Insets und das Scrollverhalten hinzuzufügen
    • Neue Überladung von InputField, die SearchBarState verwendet (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)

API-Änderungen

  • Unterstützung für das Morphing der Eckenform von Symbolschaltflächen beim Drücken. (I21843)
  • Die APIs für Textfeld-Decorators/Dekorationsfelder sind nicht mehr experimentell. (I31d95)
  • Es wurden Beispiele und Standardwerte für die verbundene Variante für ButtonGroup hinzugefügt. (I5c8ce)
  • Machen Sie den Statusparameter zum letzten Parameter in NavigationSuiteScaffold und NavigationSuiteScaffoldLayout. (I9cc7b)

Fehlerkorrekturen

  • Benutzerdefinierte Bedienungshilfen für FloatingToolbars hinzugefügt, damit Bedienungshilfen jetzt alle FloatingToolbar-Varianten maximieren oder minimieren können. Bei der Version mit dem schwebenden Aktionsschaltfläche wird dies auf die schwebende Aktionsschaltfläche angewendet, bei der Version ohne schwebende Aktionsschaltfläche auf den Hauptinhalt. (I26420)
  • Die FloatingToolbars beobachten jetzt den Dienst zur Touch-Erkundung (z.B. TalkBack) und die Symbolleiste wird immer maximiert und sichtbar angezeigt, wenn der Dienst aktiviert ist. (I02172)
  • Ein Absturz bei den Fortschritts- und Ladesymbolen wurde behoben, wenn Float.NaN als Fortschrittswert übergeben wurde. (I4fa96, b/352364576)

Version 1.4.0-alpha07

29. Januar 2025

androidx.compose.material3:material3-*:1.4.0-alpha07 wird veröffentlicht. Version 1.4.0-alpha07 enthält diese Commits.

Neue Funktionen

  • Mit einer neuen API lässt sich das Aussehen von Checkboxen jetzt noch flexibler anpassen. Diese API bietet Strichparameter, mit denen Sie besser steuern können, wie das Häkchen und der Rahmen des Kästchens gerendert werden. (I65a88)
  • Die TwoRowsTopAppBar API wurde hinzugefügt. Sie ist eine anpassungsfähigere Alternative zu mittleren und großen App-Leisten zum Erstellen von zweizeiligen oberen App-Leisten. Entwickler haben jetzt die Möglichkeit, die Inhalte von Titeln und Untertiteln sowohl im minimierten als auch im maximierten Zustand zu steuern. Außerdem können sie die Höhe für jeden Zustand anpassen. (I0be3c, b/306697446, b/229134133, b/268068946)

API-Änderungen

  • Eine experimentelle BottomAppBar-Variante wurde in FlexibleBottomAppBar umbenannt. So haben Sie mehr Kontrolle über die Anordnung und Höhe von Inhalten. (Iaa448)
  • Die Benennung von Attributen im Standardobjekt für Schaltflächengruppen wurde in CapitalCase geändert. Aktualisieren Sie den Namen von animateFraction, damit er das Verhalten, das er repräsentiert, genauer widerspiegelt. (I545cd)
  • Es wurden Überladungen für gängige Schaltflächen hinzugefügt, die animierte Formen bei der Interaktion durch Drücken ermöglichen. Zwischengespeicherte Schaltflächenformen hinzugefügt. (I5ec20)
  • Sie können jetzt festlegen, wie ein FloatingToolbar mit einem schwebenden Aktionsschaltfläche (Floating Action Button, FAB) auf das Scrollen reagiert, indem Sie ein FloatingToolbarScrollBehavior angeben. Bei Toolbars, die an einer mittleren Kante (z. B. oben oder unten in der Mitte) positioniert sind, empfehlen wir, die gesamte Komponente beim Scrollen auszublenden, um ein übersichtlicheres Design zu erzielen. Außerdem wird so verhindert, dass der FAB nicht mehr zentriert ist, was beim Verwenden des Flags expanded zum Minimieren passieren könnte. (I33f67)
  • Die experimentellen TopAppBar-APIs wurden aktualisiert, sodass beim Festlegen der Ausrichtung von Titel und Untertitel Alignment.Horizontal anstelle eines benutzerdefinierten TopAppBarTitleAlignment verwendet wird. (I70ca2)
  • SliderState#onValueChange ist jetzt öffentlich, um Nutzern mehr Kontrolle zu geben (I104eb)
  • Führen Sie NavigationSuiteScaffoldState ein, um die Navigation zu animieren. Außerdem werden Überladungen von NavigationSuiteScaffold und NavigationSuiteScaffoldLayout mit einem Statusparameter eingeführt. (I6a8c9, b/328674235)

Fehlerkorrekturen

  • Verschieben Sie die Klassen IconButtonColors und IconToggleButtonColors von IconButtonDefaults.kt zurück zu IconButton.kt. (I3c233)

Externe Beiträge

  • SliderState#isDragging ist jetzt öffentlich. (I8458a)

Version 1.4.0-alpha06

15. Januar 2025

androidx.compose.material3:material3-*:1.4.0-alpha06 wird veröffentlicht. Version 1.4.0-alpha06 enthält diese Commits.

Verhaltensänderung

  • displayCutout wurde der Gruppe von Insets hinzugefügt, die Material-Komponenten standardmäßig berücksichtigen, um zu verhindern, dass Inhalte mit dem Displayausschnitt überlappen. Dies ist eine Verhaltensänderung, die sich darauf auswirkt, wie Komponenten, die Insets berücksichtigen, in der Nähe eines Displayausschnitts funktionieren. Dazu gehören der Standardwert des Parameters WindowInsets für inset-aware Material 3-Komponenten und die WindowInsets-Werte, die in den Komponenten-Standardobjekten für Material 2 und Material 3 angegeben sind. Wenn diese Änderung zu unerwünschtem Verhalten führt, geben Sie den Parameter WindowInsets manuell für jede Komponente an. (I43ee9, b/362508045)

API-Änderungen

  • Aktualisierungen der TopAppBar API Benennen Sie die mittleren und großen oberen App-Leisten mit einer Untertitel in *FlexibleTopAppBar um. Die Farbvariationen wurden in einer einzigen TopAppBarDefault.topAppBarColors()-Funktion zusammengefasst und ein subtitle-Farbparameter wurde hinzugefügt, der für eine bereitgestellte zusammensetzbare Untertitel-Funktion (I41b65) angewendet werden soll.
  • WideNavigationRailArrangement API zugunsten von Arrangement.Vertical entfernen (Id0341)
  • Fügen Sie eine neue VerticalSlider @Composable hinzu. (I2bfba)
  • Es wurde ein neuer Track @Composable hinzugefügt, mit dem benutzerdefinierte externe Track-Ecken und ‑Symbole angegeben werden können. (I436a4)
  • Aktualisieren Sie die APIs für die schwebende Symbolleiste, damit das FloatingToolbarColors-Objekt anstelle einer einzelnen Containerfarbe verwendet wird. (I9a054)
  • Neue experimentelle Annotation ExperimentalMaterial3ComponentOverrideApi (Ia1eaf) hinzufügen und verwenden
  • Modifier.indicatorLine akzeptiert jetzt eine Form für das Textfeld, um das Abschneiden zu verarbeiten. (I8c5f3, b/380704151)
  • Benennen Sie die experimentellen FloatingAppBar-Funktionen in FloatingToolbar um (I1dbf8).
  • Es wurde ein neues floatingToolbarVerticalNestedScroll hinzugefügt, das an einen scrollbaren Container angehängt werden kann, um den Erweiterungsstatus der unverankerten Symbolleiste basierend auf einer Scrollbewegung zu aktualisieren, die einen Schwellenwert überschreitet. (I6d65f)
  • Wir stellen eine neue API zum Erstellen einer schwebenden Symbolleiste mit einer angehängten Floating Action Button (FAB) vor. Die API bietet flexible Anpassungsoptionen, mit denen Sie die Symbolleiste horizontal oder vertikal anordnen und die Schaltfläche „+“ am Anfang oder Ende der Symbolleiste platzieren können. (I9e350)

Fehlerkorrekturen

  • Ein Problem mit der Barrierefreiheit von Snackbars wurde behoben, das dazu führte, dass sie sich beim Schließen selbst ankündigten, wenn TalkBack aktiviert war. (/I9db53)

Externe Beiträge

  • BasicTooltip wurde in Foundation und BasicTooltip/Tooltip in Material 3 vereinheitlicht. (Ifc2e6)

Version 1.4.0-alpha05

12. Dezember 2024

androidx.compose.material3:material3-*:1.4.0-alpha05 wird veröffentlicht. Version 1.4.0-alpha05 enthält diese Commits.

API-Änderungen

  • Ersetzen Sie den Typ im WideNavigationRailState.current/target-Wert durch ein Enum, um die Lesbarkeit zu verbessern (I2d6ab).
  • SplitButton – Die Shape API wurde aus Gründen der binären Kompatibilität von einer Datenklasse in eine Klasse geändert. (I53812)
  • Es wurde eine Tooltip-API mit dem Parameter onDismissRequest hinzugefügt, damit Ersteller festlegen können, was passiert, wenn ein Nutzer außerhalb des Tooltips klickt. Die alte API, die diesen neuen Parameter nicht enthält, wurde eingestellt. (I99aef)
  • Die Benennung von opticalCentering in horizontalCenterOptically ändern. Den Modifikator intern machen Ersetzen Sie den Padding-Parameter durch den maximalen Start- und End-Offset. (I0b904)
  • Ändern Sie WideNavigationRailState so, dass es den aktuellen/Zielwert enthält, und entfernen Sie Enums zugunsten von booleschen Werten. (Idfa29, b/356039090)
  • Fügen Sie NavigationBarItemComponentOverride hinzu. (I3a06a)

Fehlerkorrekturen

  • Das Verhalten der oberen und unteren App-Leiste wurde korrigiert, sodass die Farbe zuverlässig geändert wird, wenn der Inhalt vollständig gescrollt wird. (Idc4e8, b/293665988)
  • Scrollverhalten-Funktionen für obere und untere App-Leisten geben jetzt ein gespeichertes Verhalten zurück, um bei Neuzusammenstellungen eine bessere Leistung zu erzielen. (I0fdbe, b/207957336)
  • Der Parameter „Modifier“ wird jetzt nach internen Modifikatoren wie Drag-Verhalten und Semantik angewendet, nicht mehr davor. Dies wirkt sich auf die Reihenfolge aus, in der die Modifikatoren angewendet werden. (I8d83f)
  • Die maximierte Ansicht am unteren Rand bleibt auch nach einer Größenänderung maximiert. (I2870b, b/324934884)
  • Status- und Navigationsleisten-Flags für Fenstereigenschaften werden korrekt weitergeleitet. (Ie674d, b/362539765)
  • Verschieben Sie den Modifikatorparameter in das Stammverzeichnis der Gerüste, wie dokumentiert. Dadurch wird die Implementierung an M2 angepasst. (I0235e, b/372311595)

Externe Beiträge

  • Gemeinsame DatePickerDialog-Funktion. (I7dced)

Version 1.4.0-alpha04

13. November 2024

androidx.compose.material3:material3-*:1.4.0-alpha04 wird veröffentlicht. Version 1.4.0-alpha04 enthält diese Commits.

Geändertes Verhalten

  • Die in aosp/3212478 eingeführten Farbänderungen für iconButtonColors, iconToggleButtonColors, outlinedIconButtonColors, outlinedIconToggleButtonColors und outlinedIconToggleButtonBorder werden rückgängig gemacht. Das jetzt zurückgesetzte Verhalten wurde in eine neue Reihe von Funktionen mit dem Namen iconButtonVibrantColors usw. verschoben, um die zurückgegebenen Farben mit hohem Kontrast hervorzuheben. (Iffd8d)

Neue Funktionen

  • Einführung der VerticalDragHandle-Komponente (I6c770)

API-Änderungen

  • Benennen Sie DismissibleModalWideNavigationRailDefaults in ModalWideNavigationRailDefaults um. (I8e877)
  • Fügen Sie NavigationBarComponentOverrides hinzu. (I8a3f3)
  • Fügen Sie NavigationRailComponentOverride hinzu. (I83e13)
  • Wir führen WideNavigationRailState ein, um das Ein- und Ausblenden des Rails zu ermöglichen, ModalWideNavigationRail kann geschlossen werden und DismissibleModalWideNavigationRail wird gelöscht. (I88568)
  • Den Standardwerten für Ein/Aus-Schaltflächen werden Standardwerte für die Größen „xSmall“, „medium“, „large“ und „xLarge“ hinzugefügt. (Ie95d1)
  • Den Schaltflächen-Standardeinstellungen werden Standardgrößen für „xSmall“, „medium“, „large“ und „xLarge“ hinzugefügt. (If8b6d)

Fehlerkorrekturen

  • Die Farbe des nachgestellten Symbols des Filterchips wurde gemäß Spezifikation von „Primär“ zu OnSurfaceContainer aktualisiert. Alle Umrissfarben der Chips wurden gemäß Spezifikation von „Umriss“ zu „Umrissvariante“ aktualisiert. (I68bd4)

Version 1.4.0-alpha03

30. Oktober 2024

androidx.compose.material3:material3-*:1.4.0-alpha03 wird veröffentlicht. Version 1.4.0-alpha03 enthält diese Commits.

API-Änderungen

  • Der SheetState-Konstruktor mit Dichte wurde zugunsten von Positions- und Geschwindigkeitsgrenzwerten eingestellt. (Ifd16e)
  • rememberTooltipPositionProvider wurde hinzugefügt und enthält eine aktualisierte Logik für die Positionierung. rememberPlainTooltipPositionProvider und rememberRichTooltipPositionProvider wurden eingestellt. (Ie66e2)
  • Mit zusätzlichen ModalBottomSheetProperties können die Farben der Status- und Navigationsleiste angepasst werden. Standardmäßig werden sie basierend auf der Inhaltsfarbe und nicht auf dem Status des dunklen Designs des Systems aktualisiert. (Ib874e, b/362539765)
  • Die Eingabe für Datumsauswahlen wurde verbessert: Im Eingabemodus wird das Datumsfeld für die sofortige Texteingabe fokussiert. Durch die Änderung wird den DatePicker und DateRangePicker ein requestFocus-Parameter hinzugefügt. Sie können verhindern, dass der Fokus gesetzt wird, indem Sie false übergeben. (I12d09, b/286399710, b/340102743)
  • Die Standardeinstellungen für Formen werden im Shape-Objekt im Cache gespeichert. Die Form wird standardmäßig auf @Composable für die Ein/Aus-Schaltfläche festgelegt. Die Formen werden standardmäßig in einer Form zusammengefasst, da die Varianten auf dieselbe Token-Datei verweisen. (Iaa014)

Fehlerkorrekturen

  • Optimieren Sie das Verhalten von Scaffold contentPadding, um zu vermeiden, dass der Inhalt des Bodys immer neu zusammengesetzt wird, wenn sich contentPadding ändert. (I8c8e2, b/373904168)
  • TextFieldLabelScope progress wurde in labelMinimizedProgress umbenannt
  • TextFieldLabelPosition Default wurde in Attached umbenannt. Schnittstellenmitglieder wurden entfernt. (If75c6)
  • Es wurde ein Problem mit dem DatePicker im Eingabemodus behoben, bei dem Validierungsfehler dazu führen konnten, dass sich die Höhe der Komponente änderte. (I2e229, b/280462363)
  • Das Material „Slider“ soll seinen Wert ändern, wenn Steuertasten gedrückt werden. (I1c442)

Version 1.4.0-alpha02

16. Oktober 2024

androidx.compose.material3:material3-*:1.4.0-alpha02 wird veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.

API-Änderungen

  • Die Datumsauswahlen wurden aktualisiert, um eine konsistente Verwendung von Gebietsschemas in der gesamten DatePicker und DateRangePicker zu gewährleisten, wenn ein Gebietsschema direkt über ein DatePickerState oder ein DateRangePickerState festgelegt wird. Wenn Sie Gebietsschemas direkt auf den Status festlegen, müssen Sie dafür sorgen, dass die Titel- und Überschriftentexte entsprechend lokalisiert werden, da der Standardtext weiterhin gemäß dem Standardgebietsschema der Plattform angewendet wird. (I37073, b/326490763, b/321657276)
  • SheetState.isAnimationRunning ist jetzt verfügbar. (I9a3d7)
  • DatePickerColors haben jetzt Vorrang vor allen in den Textstilen der Typografie des Designs definierten Farben, die in Konflikt stehen. Außerdem wird mit diesem Update die Position des Parameters color in den Funktionen für die Datumsauswahl angepasst und ein Parameter contentColor zum Anpassen der Farben für Header- und Titeltext eingeführt. (I30d03, b/347031394)
  • Benennen Sie SplitButton in SplitButtonLayout um und entfernen Sie die APIs für Farbvarianten von SplitButton. Varianten werden durch die Wiederverwendung von Schaltflächenvarianten erreicht, die von SplitButtonDefaults bereitgestellt werden. (I44c36)
  • ModalBottomSheet hat jetzt den Parameter sheetGestureEnabled (I856cb, b/288211587)
  • Die standardMotionScheme und die expressiveMotionScheme wurden in „Standard“ und „Expressiv“ umbenannt. Beide Funktionen sind jetzt über das MotionScheme-Begleitobjekt durch Aufrufen von MotionScheme.standard() und MotionScheme.expressive() verfügbar. (Iceccf)
  • Der Parameter maxWidth wird einfachen und Rich-Tooltips hinzugefügt. Die Standardeinstellung ist die Designspezifikation von 200 dp für einfache Tooltips und 320 dp für Rich-Tooltips. (I30ce9)

Fehlerkorrekturen

  • Die DatePicker und DateRangePicker aktualisieren den angezeigten Monat jetzt korrekt, wenn sie über die displayedMonthMillis ihres Status festgelegt werden. (If9e47, b/333414302)
  • Bei ModalBottomSheet-Inhalten werden Inhalte jetzt von der Statusleiste weg verschoben. (I5114c, b/321877275, b/336962418, b/342093067)
  • [Bottom Sheet] Die Priorität des Rückrufs wird wieder auf PRIORITY_DEFAULT geändert, damit die IME-Tastatur zuerst geschlossen werden kann. (I447fb)
  • Abstürze in DatePicker und DateRangePicker behoben, wenn das minimal auswählbare Jahr auf ein zukünftiges Jahr festgelegt ist. (I78656, b/319395747)
  • Ein Problem mit der Datumsauswahl wurde behoben, damit die Benutzeroberfläche aktualisiert wird, wenn eine aktualisierte SelectableDates-Instanz angewendet wird. (Iad59a, b/290135807, b/339898760)

Version 1.4.0-alpha01

2. Oktober 2024

androidx.compose.material3:material3-*:1.4.0-alpha01 wird veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.

Geändertes Verhalten

  • Die Bibliothek fügt keine Abhängigkeit von material-icons-core mehr hinzu. Wenn Ihr Projekt darauf angewiesen war, müssen Sie diese Abhängigkeit explizit in Ihren build.gradle[.kts]-Dateien hinzufügen. (I735ff, b/349894318)
  • Die aktive Label-Farbe von NavigationBarItem und NavigationRailItem ändert sich von onSurface zu secondary, um die Nutzerfreundlichkeit und den Farbkontrast zu verbessern und die Kohärenz im System zu erhöhen (Ibc297). Wenn Sie zum vorherigen Verhalten zurückkehren möchten, kopieren Sie die Standardfarben und ändern Sie selectedTextColor in MaterialTheme.colorScheme.onSurface.
  • Material 3-Komponenten verwenden jetzt die neue MotionScheme, um ihre Bewegung zu definieren. (Ie0f93)
  • Bewegungsänderungen bei unbestimmter kreisförmiger Fortschrittsanzeige (I3c07e)
  • Aktualisieren Sie OutlinedIconButtonColors und OutlinedIconToggleButtonColors, um den Farbkontrast zu verbessern. (I2743d)
  • Die Container- und Inhaltsfarbe für FilledIconToggleButtonColors und FilledTonalIconToggleButtonColors wurde aktualisiert. (Ic5d0f)
  • Die Rahmenfarbe von OutlinedButton wurde von outline zu outlineVariant geändert. (057f00)

API-Änderungen

  • Der Funktion enterAlwaysScrollBehavior des TopAppBar wurde ein optionaler reverseLayout-Parameter hinzugefügt, um Inhalte, die mit einem reverseLayout festgelegt wurden, besser zu unterstützen. (I4e0e5)
  • SegmentedButton unterstützt jetzt das Argument contentPadding. (I5ad91, b/358414376)
  • PullToRefreshState hat keine Standardimplementierung mehr für isAnimating (I6a593)
  • Es wurden neue Überladungen von Material TextField und OutlinedTextField hinzugefügt, die TextFieldState verwenden. Es wurden APIs für Dekorationsfelder hinzugefügt, die mit TextFieldDecorator kompatibel sind. (If13a1)
  • Es wurde ein Parameter hinzugefügt, um die labelPosition des Textfelds zu steuern. Mit alwaysMinimize kann das UI-Muster verwendet werden, bei dem ein Label und ein Platzhalter gleichzeitig in einem Textfeld angezeigt werden, auch wenn das Feld nicht fokussiert ist. (I1ef2c)
  • Material SecureTextField und OutlinedSecureTextField für Passwort-Eingabefelder hinzugefügt. (I7e22d)
  • Den Textfeldlabels wurde ein Bereich hinzugefügt, um den Fortschritt der Animation abzufragen. (If5ec8)
  • Unterstützung für MotionEvent.CLASSIFICATION_DEEP_PRESS in Kurzinfos hinzugefügt. (I62e6a)
  • TimePickerStates isAfternoon ist jetzt ein Erweiterungswert anstelle einer Variablen in der Schnittstelle und wurde in isPm umbenannt (I89a97).
  • Die Typografieklasse wurde aktualisiert, um betonte Typografie-Skalen zu unterstützen. (Ifa13c)
  • Die ModalWideNavigationRail API wurde hinzugefügt und die ModalExpandedNavigationRail APIs wurden in DismissibleModalWideNavigationRail umbenannt. (Ic9118)
  • FloatingAppBarScrollBehavior wurde aktualisiert, um screenOffset automatisch zu berechnen und keine @Composable zu erfordern. (Idf349)
  • Aktualisierungen der LoadingIndicator API zur Korrektur der Benennung im Standardobjekt. Der PullToRefresh wurde eine LoadingIndicatorElevation-Konstante hinzugefügt. (I1d72b)
  • Aktualisierungen der LoadingIndicator API zur Korrektur der Benennung im Standardobjekt. Der PullToRefresh wurde eine LoadingIndicatorElevation-Konstante hinzugefügt. (I1d72b)
  • Den unbestimmten Varianten von LinearWavyProgressIndicator und CircularWavyProgressIndicator wurden die Parameter amplitude und waveSpeed hinzugefügt. (I2a0c5)
  • Unterstützung für das Ändern der Form einer Symbol-Umschaltfläche basierend auf dem gedrückten oder aktivierten Zustand. (Ibc781)
  • Die Typografieklasse wurde aktualisiert, um betonte Typografie-Skalen zu unterstützen. (Ifa13c)
  • Die Form von SplitButton ändert sich je nach Standard- oder gedrücktem Zustand. Die AnimatedTrailingButton API wurde entfernt, da die TrailingButton API dieselben Anpassungen bieten kann (I95066).
  • Fügen Sie einen Modifikator hinzu, um das Ein- und Ausblenden des schwebenden Aktionsschaltfläche zu animieren, z.B. wenn Inhalte gescrollt werden. (I8338d)
  • Hinzufügen von verbundenen Schaltflächengruppenformen und Abständen zu ButtonGroupDefaults zur Verwendung in einem Beispiel. (I68e30)
  • Bei der geteilten Schaltfläche wird horizontaler Abstand für die nachfolgende Schaltfläche hinzugefügt und die optische Zentrierung wird anhand der Differenzen zwischen Start- und Endpunkt berechnet (I122e2).
  • Wir führen ein neues Material MotionScheme ein, mit dem Sie ein Schema für die Bewegung der Komponente festlegen können. Das Schema wird über MaterialTheme festgelegt. (Id50c2)

Fehlerkorrekturen

  • Wenden Sie den richtigen Fokusdurchlaufindex auf untergeordnete Scaffold-Composables an. Die Reihenfolge ist topBar, bottomBar, fab, content, snackbar. (I5936b)
  • Ein Problem wurde bei DatePicker und DateRangePicker behoben, bei dem in bestimmten Gebietsschemas und Format-Skeletten einige der Datumsbestandteile (z.B. Monatsnamen) nicht mit einem Großbuchstaben begannen. (I1430f)
  • Tokens für FAB- und FAB-Menükomponenten integrieren (geringfügige visuelle Änderungen an Abständen und Text) (Ib57f3)
  • ModalBottomSheet ist jetzt das erste Element in der semantischen Reihenfolge, gefolgt vom Scrim. (I436f9, b/358594665)
  • Die untere App-Leiste verschwindet beim Scrollen unter dem Navigations-Pill im Edge-to-Edge-Modus nicht vollständig (I3ee21).

Compose Material3 Version 1.3

Version 1.3.2

9. April 2025

androidx.compose.material3:material3-*:1.3.2 wird veröffentlicht. Version 1.3.2 enthält diese Commits.

Fehlerkorrekturen

  • ListItem korrigiert die Berechnung der intrinsischen Höhe und reserviert jetzt die entsprechende Menge an Speicherplatz im Layout.
  • Entfernen Sie überflüssiges Padding für das Label NavigationBarItem, um die Spezifikation einzuhalten.
  • Korrigiert das TabRow-Layout im RTL-Modus.

Version 1.3.1

30. Oktober 2024

androidx.compose.material3:material3-*:1.3.1 wird veröffentlicht. Version 1.3.1 enthält diese Commits.

Fehlerkorrekturen

  • Die DatePicker und DateRangePicker aktualisieren den angezeigten Monat jetzt korrekt, wenn sie über die displayedMonthMillis ihres Status festgelegt werden. (If9e47, b/333414302)
  • Abstürze in DatePicker und DateRangePicker behoben, wenn das minimal auswählbare Jahr auf ein zukünftiges Jahr festgelegt ist. (I78656, b/319395747)
  • Ein Problem mit der Datumsauswahl wurde behoben, damit die Benutzeroberfläche aktualisiert wird, wenn eine aktualisierte SelectableDates-Instanz angewendet wird. (Iad59a, b/290135807, b/339898760)
  • Die Priorität des Rückrufs für Bottom Sheets wird auf PRIORITY_DEFAULT geändert, damit die IME-Tastatur zuerst geschlossen werden kann. (I447fb)

Version 1.3.0

4. September 2024

androidx.compose.material3:material3-*:1.3.0 wird veröffentlicht. Version 1.3.0 enthält diese Commits.

Wichtige Änderungen seit Version 1.2.0

Wichtige Funktionen von Version 1.3.0

Neue Material Design 3-Komponenten

  • Karussell
  • [ModalBottomSheet] unterstützt jetzt die vorhersagende Zurück-Geste auf U+ (Iccf32, b/281967264, b/304850357)
  • [SearchBar] unterstützt jetzt die intelligente „Zurück“-Geste auf U+ (I657f8)
  • Die Navigationsleiste (ModalDrawerSheet und DismissibleDrawerSheet) unterstützt jetzt die Funktion „Vorhersagender Zurück-Vorgang“ auf U+ als Opt-in (Ie5b0b).
  • DropdownMenu unterstützt jetzt benutzerdefinierte Farben, Formen, Erhebungen und Rahmen. (I8e981,b/289554448, b/301887035, b/283654243)
  • Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I3058e)
  • Die ProgressIndicator wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I21451)
  • Für Rich-Tooltips wurde ein Standard-Caret hinzugefügt. Es wird unterstützt, dass ein benutzerdefiniertes Caret für den Anker LayoutCoordinates gezeichnet wird. (Ifd42c) Funktionsgefährdende Änderungen
  • Neue APIs zum Aktualisieren durch Ziehen:
    • Vereinfachtes PullToRefreshState zur Verwendung von Bruchwerten anstelle von Dp-Einheiten.
    • Der isRefreshing-Status wird vom Nutzer und nicht von PullToRefreshState gesteuert.
    • Die verschachtelte Scrollverbindung wurde von PullToRefreshState getrennt. Dies wird vom neuen PullToRefreshBox oder Modifier.pullToRefresh übernommen.
    • Dieses Update ist eine grundlegende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Visuelle Änderungen
  • Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
  • Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in lightColorScheme und darkColorScheme. (I9db52)
  • Die Farben für den Schieberegler und ProgressIndicator wurden aktualisiert, um den neuen Spezifikationen für den Kontrast von Nicht-Text-Elementen zu entsprechen. (I26807)
  • SurfaceContainer-Varianten werden jetzt von Komponenten verwendet. Bei Komponenten, bei denen die Farbe bisher mit Surface und TonalElevation berechnet wurde, werden jetzt standardmäßig SurfaceContainer-Rollen verwendet, die nicht von der tonalen Erhebung betroffen sind. (b/304584161)
  • Die Baseline-Rollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, sodass in hellen und dunklen Designs mehr Farbton vorhanden ist. (I677a5)
  • Experimentelle APIs wurden zu stabilen APIs hochgestuft.
  • Leistungsverbesserungen

Version 1.3.0-rc01

21. August 2024

androidx.compose.material3:material3-*:1.3.0-rc01 wird veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • ModalBottomSheet ist jetzt das erste Element in der semantischen Reihenfolge, gefolgt vom Scrim. (I436f9, b/358594665)

Version 1.3.0-beta05

24. Juli 2024

androidx.compose.material3:material3-*:1.3.0-beta05 wird veröffentlicht. Version 1.3.0-beta05 enthält diese Commits.

  • Ein Problem wurde behoben, bei dem BottomSheet-Inhalte unter Android N und O fehlten oder abgeschnitten wurden (a10a2d).
  • Die semantischen Grenzen des Schiebereglers wurden erhöht, damit TalkBack die Fokusindikatoren um die Thumbnails herum richtig anzeigen kann. (0b5a1d)

Version 1.3.0-beta04

26. Juni 2024

androidx.compose.material3:material3-*:1.3.0-beta04 wird veröffentlicht. Version 1.3.0-beta04 enthält diese Commits.

Version 1.3.0-beta03

12. Juni 2024

androidx.compose.material3:material3-*:1.3.0-beta03 wird veröffentlicht. Version 1.3.0-beta03 enthält diese Commits.

Externe Beiträge

  • androidx.compose.material3.DropdownMenu aus dem gemeinsamen Quellenset verfügbar machen (If62c0)

Version 1.3.0-beta02

29. Mai 2024

androidx.compose.material3:material3-*:1.3.0-beta02 wird veröffentlicht. Version 1.3.0-beta02 enthält diese Commits.

API-Änderungen

  • Modifier.pullToRefreshIndicator unterstützt die Erhöhung. Die Pull-to-Refresh-APIs wurden aktualisiert, sodass „enabled“ ein boolescher Wert anstelle eines Lambda-Ausdrucks ist. Unterstützung der Inhaltsausrichtung in PullToRefreshBox (I75679)
  • TooltipScope als versiegeltes Interface festlegen und eine interne Implementierung für die Verwendung in TooltipBox und Label erstellen. (I3833e)
  • CarouselItemScope wurden zwei neue Modifizierer hinzugefügt: maskClip und maskBorder. Damit lassen sich ganz einfach Formen und Rahmen für Karussellelemente hinzufügen. (Id67a1)
  • TimePickerState ist jetzt eine Schnittstelle und ermöglicht das Einstellen der Uhrzeit (I88546).
  • Die API zum Formatieren der Links wurde aktualisiert: TextLinkStyles wurde zu TextStyle verschoben und TextDefaults wurde aus dem Material entfernt. (I5477b)

Fehlerkorrekturen

  • ModalBottomSheet-Status und Navigationsleistensymbole reagieren jetzt auf den Status des dunklen Designs. (Ie1fe7, b/338342149)
  • Dem ModalBottomSheet-Scrim wurde die Semantik zum Schließen des Blatts hinzugefügt. (0e61cb,b/328801864)

Externe Beiträge

  • androidx.compose.material3.AlertDialog aus dem gemeinsamen Quellset verfügbar machen (Ia33f5)
  • ModalBottomSheet aus dem gemeinsamen Quellenset (Id7cc7) verfügbar machen

Version 1.3.0-beta01

14. Mai 2024

androidx.compose.material3:material3-*:1.3.0-beta01 wird veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.

API-Änderungen

  • DpSize anstelle von CaretProperties verwenden CaretProperties wird entfernt. Benennen Sie CaretScope in TooltipScope um. (Id9a76)
  • Die API zum Abrufen von Links mit Material-Design im Text wurde aktualisiert. Konkret wurden die Methoden aus TextDefaults zum Erstellen thematischer LinkAnnotations und zum Parsen von HTML mit thematischen Links entfernt. Stattdessen wurde eine TextLinkStyles-Klasse hinzugefügt, mit der die Links als Parameter für die Text-Composable-Funktion formatiert werden können. (I31b93)

Version 1.3.0-alpha06

1. Mai 2024

androidx.compose.material3:material3-*:1.3.0-alpha06 wird veröffentlicht. Version 1.3.0-alpha06 enthält diese Commits.

Aktuelle Änderungen

  • Neue Pull-to-Refresh-APIs:

    • Vereinfachtes PullToRefreshState zur Verwendung von Bruchwerten anstelle von Dp-Einheiten.
    • Der isRefreshing-Status wird vom Nutzer und nicht von PullToRefreshState gesteuert.
    • Die verschachtelte Scrollverbindung wurde von PullToRefreshState getrennt. Dies wird vom neuen PullToRefreshBox oder Modifier.pullToRefresh übernommen.
    • Dieses Update ist eine grundlegende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)

API-Änderungen

  • RippleConfiguration#isEnabled wurde entfernt und LocalRippleConfiguration wurde auf „nullable“ gesetzt. Wenn Sie einen Ripple deaktivieren möchten, geben Sie statt eines RippleConfiguration mit isEnabled = false den Wert null bis LocalRippleConfiguration an. (I22725)
  • ModalBottomSheet – Der Scrim wird bei aktivierter Edge-to-Edge-Funktion genauer über die Statusleiste gezeichnet. Inhalte von modalen Bottom Sheets können jetzt Fenster-Insets nutzen, sodass Inhalte über der Navigationsleiste sichtbar sind. Der Parameter ModalBottomSheet windowInsets wurde in contentWindowInsets umbenannt, um anzugeben, wo die Insets angewendet werden. Sie sind nicht mehr an die Fensterlogik gebunden. Der Typ contentWindowInsets wurde in eine Funktion geändert, die WindowInsets zurückgibt, damit er im neuen Fenster aufgelöst werden kann. (I39630, b/274872542, b/300280229, b/290893168)
  • PrimaryScrollableTabRow und SecondaryScrollableTabRow verwenden jetzt ein benutzerdefiniertes Layout anstelle von Unterkompositionen, was die Leistung verbessern sollte. (I991e0)
  • Textlinks haben jetzt zusätzlich zum normalen Stil, zum Stil für den Mauszeiger und zum Fokusstil auch einen Stil für den gedrückten Zustand. Die TextDefaults-Methoden haben jeweils ein pressedStyle-Argument erhalten, um dies zu unterstützen. (Ic473f, b/139312671)

Fehlerkorrekturen

  • Die Ziehpunkte für die Navigationsleiste haben jetzt dieselbe Breite wie drawerContent. (Ibc72f, b/245355396)
  • Das obere Padding für das Label berücksichtigt jetzt die Schriftgröße des Systems.OutlinedTextField (Idc781)
  • Korrigierter Paketstandort: CalendarLocale. (Ifa235)
  • [Predictive Back] Update predictive back animations to use interpolation curve of (0.1, 0.1, 0, 1) (I2591a)

Version 1.3.0-alpha05

17. April 2024

androidx.compose.material3:material3-*:1.3.0-alpha05 wird veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.

Neue Funktionen

  • SearchBar und DockedSearchBar haben neue Überladungen, die einen Textfeldparameter akzeptieren. So lässt sich das Textfeld unabhängig vom Rest der Suchleiste gestalten und es können benutzerdefinierte Textfelder übergeben werden. Das Textfeld der aktuellen Implementierung ist als SearchBarDefaults.InputField verfügbar. (I50c73, b/275074248, b/278773336, b/326627700)
  • Die Lambda-Funktion drawTick wurde der öffentlichen API hinzugefügt, um die Ticks bei Bedarf anzupassen (I0c048).

API-Änderungen

  • Für Textlinks gibt es jetzt zusätzlich zum normalen Stil, zum Stil für den Mauszeiger und zum Fokusstil auch einen Stil für den gedrückten Zustand (I5f864, b/139312671).
  • CarouselItemInfo wurde aktualisiert, um ein Maskenrechteck zu präsentieren, durch das das Element beschnitten wird (I785d8).
  • BasicTooltipState wurde aus der öffentlichen Material 3-API entfernt. Die Funktionalität wird mit TooltipState kombiniert, bis die BasicTooltip von Foundation stabilisiert ist. (Icda29)
  • Das TextDefaults-Objekt wurde hinzugefügt. Es enthält Methoden zum Erstellen eines LinkAnnotation-Objekts und zum Parsen von HTML-getaggten Strings, die MaterialTheme auf die Links anwenden (I98532, b/139312671).
  • ExposedDropdownMenuBoxScope lässt keine Unterklassen mehr zu. Für Drop-down-Menüs, die angezeigt werden, gibt es jetzt ein MenuAnchorType, das an menuAnchor übergeben werden sollte, um die Barrierefreiheit zu verbessern. Diese Methode sollte anstelle der Übergabe von focusable an ExposedDropdownMenu verwendet werden, da Letzteres jetzt veraltet ist. menuAnchor hat einen neuen Parameter zum Steuern des enabled-Status. (I55ee6, b/257209915, b/308840226)
  • Die Rahmenfarbe von OutlinedButton wurde korrigiert, wenn die Funktion deaktiviert ist. Die Überladung ButtonDefaults.outlinedButtonBorder("enabled") wurde hinzugefügt, die den aktivierten Status übernimmt. (Ie650b, b/318461363)
  • Es wurde eine neue CarouselItemInfo-Klasse hinzugefügt, damit Clients Informationen zu den Artikelgrößen abrufen können. (I9070c)
  • Der ColorScheme-Konstruktor ohne Surface-Container ist jetzt veraltet. Migrieren Sie bitte zum Konstruktor, der Oberflächencontainer enthält. (I35c11)
  • [Outlined]TextFieldDefaults ContainerBox wurde in Container umbenannt. (Ie8d3b)

Fehlerkorrekturen

  • BottomSheetScaffold wird nicht mehr durch verschachteltes Scrollen gescrollt, wenn sheetSwipeEnabled auf „false“ gesetzt ist. (I5e1c1, b/306464779)
  • Die OptIn-Annotation ExperimentalMaterial3Api wurde in IconButtonSamples.kt entfernt. (I111d1)

Version 1.3.0-alpha04

3. April 2024

androidx.compose.material3:material3-*:1.3.0-alpha04 wird veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Es wurden zwei experimentelle Versionen des Material3-Karussells hinzugefügt: HorizontalMultiBrowseCarousel und HorizontalUncontainedCarousel (I88d64).
  • Die Compose M3-Navigationsleiste (ModalDrawerSheet und DismissibleDrawerSheet) wurde aktualisiert, um die Vorhersagefunktion für die Zurück-Geste auf U+ als Opt-in zu unterstützen (Ie5b0b).
  • Eine neue API wurde in „Icon“ hinzugefügt, mit der die Farbtonung als Lambda übergeben werden kann, um das erneute Zusammensetzen zu vermeiden. (I5b5a2)
  • Die APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen für feste und minimierbare Abschnitte. (Ib8b0c, b/323403446)

API-Änderungen

  • Die APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen für feste und minimierbare Abschnitte. Ein Problem wurde behoben, das dazu führte, dass einzeilige Top-App-Leisten beim Scrollen von Inhalten zu oft neu zusammengesetzt wurden. Ein Problem wurde behoben, bei dem MediumTopAppBar-Titel auf Geräten mit großen Schrift-/Anzeigeeinstellungen abgeschnitten wurden. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676)
  • SegmentedButton und zugehörige APIs sind jetzt stabil (I8a158)
  • SwipeToDismissBox, SwipeToDismissBoxDefaults, SwipeToDismissBoxState und SwipeToDismissBoxValue sind jetzt als stabil gekennzeichnet. (I5f000)
  • Die eingestellten Enums und APIs DismissDirection und DismissValue wurden entfernt. (I89ccd)
  • Dem CarouselState-Begleitobjekt von „Carousel“ wurde ein experimentelles Tag hinzugefügt. (I94154)
  • LocalMinimumInteractiveComponentEnforcement wurde eingestellt und durch LocalMinimumInteractiveComponentSize ersetzt. (I7a7ac)
  • Der Konstruktor für SearchBarColors ist jetzt öffentlich. (I769ca)
  • Der Parameter gesturesEnabled wurde zu SwipeToDismissBox hinzugefügt. (Idc59f, b/324170119)
  • Die als verworfen und experimentell markierten Textfeld-APIs wurden entfernt. (I1305f)

Version 1.3.0-alpha03

20. März 2024

androidx.compose.material3:material3-*:1.3.0-alpha03 wird veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.

Visuelle Breaking Changes

  • Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
  • Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in lightColorScheme und darkColorScheme. (I9db52)

Neue Funktionen

  • Es wurden Parameter hinzugefügt, um ExposedDropdownMenu anzupassen. Insbesondere haben Menüs jetzt einen focusable-Parameter (Standardwert true), der auf false gesetzt werden sollte, wenn Sie mit bearbeitbaren Textfeldern arbeiten. (I4184c, b/323694447, b/278609042)

API-Änderungen

  • Das Flag ScaffoldSubcomposeInMeasureFix wurde entfernt. (Ie2a4b)
  • NavigationRailItemColors ist jetzt als @Immutable markiert. (If6112, b/327660613)
  • NavigationBarItemColors ist jetzt als @Immutable markiert. (I42a30, b/298064514)
  • Parameter in der zusammensetzbaren Funktion „Slider Track“ neu anordnen. (I9f315)
  • ExposedDropdownMenu wird jetzt mit Popup implementiert. Das Verhalten sollte dasselbe sein, mit Ausnahme von fokussierbaren Menüs mit bearbeitbaren Textfeldern, die beim Tippen auf der Tastatur geschlossen werden können.

Fehlerkorrekturen

  • Die Baseline-Rollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, sodass in hellen und dunklen Designs mehr Farbton vorhanden ist. (I677a5)
  • Die Farben für den Schieberegler und ProgressIndicator wurden aktualisiert, um den neuen Spezifikationen für den Kontrast von Nicht-Text-Elementen zu entsprechen. (I26807)
  • Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
  • Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in lightColorScheme und darkColorScheme. (I9db52)

Version 1.3.0-alpha02

6. März 2024

androidx.compose.material3:material3-*:1.3.0-alpha02 wird veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.

API-Änderungen

  • Die Schieberegler werden wieder stabilisiert. State.onValueChangeFinished wird wieder zu einem Wert. onValueChangeFinished in ein rememberUpdatedState einfügen (I82ab2, b/322269951)
  • Die Navigationskomponenten verwenden jetzt die neuen SurfaceContainer-Rollen. DrawerDefaults bietet jetzt separate Attribute für standardContainerColor und modalContainerColor. DrawerDefaults.ModalDrawerElevation heißt jetzt 0.dp. (I7fbac)
  • @Stable wird aus den Status von Slider entfernt, da state.onValueChangeFinished in ein var geändert wird. (Ied34a, b/322269951)
  • Die Animationsspezifikation für ModalBottomSheet und StandardBottomSheet ist jetzt eine TweenSpec und wurde von einer federnden Animation aktualisiert. Damit wird ein Problem mit einem sichtbaren Überschwingen behoben. Die verworfenen SheetState-Konstruktoren ohne Dichte wurden entfernt. (I7babc, b/285847707)

Fehlerkorrekturen

  • SurfaceContainer-Varianten werden jetzt von Komponenten verwendet. Bei Komponenten, bei denen die Farbe bisher mit „Surface“ und TonalElevation berechnet wurde, werden jetzt standardmäßig SurfaceContainer-Rollen verwendet, die nicht von der tonalen Erhebung beeinflusst werden. (b/304584161)
  • Ein Fehler wurde behoben, durch den die nicht ausgewählte, deaktivierte Containerfarbe von ElevatedFilterChip schwarz war. (I400e6, b/322407043)
  • Problem mit unbestimmter Fortschrittsanzeige behoben, wenn der Fortschritt 0 ist (Id6582)
  • Ein Problem mit Slider und RangeSlider im RTL-Layout (Iab0e1) wurde behoben.
  • SliderRangeTolerance wird für die Berechnung des Schiebereglerbereichs hinzugefügt, da das Runden von Gleitkommazahlen ungenau sein kann. (Ic918a, b/324934900)
  • Die Schaltflächen von DatePickerDialog müssen angezeigt werden, wenn ein DateRangePicker verschachtelt wird oder wenn auf kleinen Bildschirmen mit größeren Schriftarten eine beliebige Art von Datumsauswahl angezeigt wird. (Ie4758, b/325107799, b/277768544)
  • Menu verwendet jetzt die Rolle SurfaceContainer für die Containerfarbe. MenuDefaults.TonalElevation heißt jetzt 0.dp. (I135b7)
  • TextField verwendet jetzt die Rolle SurfaceContainerHighest für die Containerfarbe. (I4dced)
  • Für die erhöhten Chips wird jetzt die Rolle SurfaceContainerLow (I7cd2f) verwendet.
  • Die Containerfarbe von DatePicker ist jetzt SurfaceContainerHigh. DatePickerDefaults.TonalElevation heißt jetzt 0.dp. (Ida753)
  • Aktualisiert die Containerfarbe und die Ziehgrifffarbe von Bottom Sheets. (I72a0a)
  • Die Containerfarbe von RichTooltip ist jetzt SurfaceContainer. (Ia8b45)
  • Die Containerfarbe von SearchBar ist jetzt SurfaceContainerHighest. SearchBarDefaults.TonalElevation heißt jetzt 0.dp. (I88604)
  • Der Schalter für Updates ist deaktiviert und nicht ausgewählte Tracks/Symbole nutzen die Farbrolle SurfaceContainerHighest. (I7687a)
  • Die Containerfarbe von AlertDialog ist jetzt SurfaceContainerHigh. (Ie0433)
  • Die Containerfarbe von BottomAppBar ist jetzt SurfaceContainer. Die Farbe TopAppBar onScroll ist jetzt SurfaceContainer. (I41630)
  • Die Containerfarbe von ElevatedCard ist jetzt SurfaceContainerLow. Die Containerfarbe von FilledCard ist SurfaceContainerHighest. (I35141)
  • Die Containerfarbe von ElevatedButton ist jetzt SurfaceContainerLow. FilledIconButton, die nicht ausgewählt sind, haben jetzt die Containerfarbe SurfaceContainerHighest. (I792c9)
  • Aktualisiert die Rolle für die Containerfarbe TimePicker und die Farbe des Zifferblatts auf SurfaceContainerHighest. (I43b93)

Version 1.3.0-alpha01

21. Februar 2024

androidx.compose.material3:material3-*:1.3.0-alpha01 wird veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Update für Compose M3 ModalBottomSheet zur Unterstützung von Predictive Back unter U+ (Iccf32, b/281967264, b/304850357)
  • Compose M3 SearchBar wurde aktualisiert, um die intelligente „Zurück“-Geste auf U+ zu unterstützen (I657f8)
  • Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I3058e)
  • Die ProgressIndicator wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I21451)
  • Es wurde ein Standard-Caret für Rich-Tooltips hinzugefügt. Die neue Rich-Tooltip-API ermöglicht jetzt das Zeichnen eines benutzerdefinierten Carets für den Anker LayoutCoordinates. (Ifd42c)

Geändertes Verhalten

  • Material-Komponenten wurden migriert, um die neuen Ripple-APIs zu verwenden. Sie fragen RippleTheme nicht mehr ab.

API-Änderungen

  • Die Funktion drawStopIndicator ist jetzt öffentlich verfügbar. (I3f59f)
  • Markieren Sie die formatWithSkeleton-Funktion des DatePicker als intern (Ic65dc).
  • DropdownMenu unterstützt jetzt benutzerdefinierte Farben, Formen, Erhebungen und Rahmen. (I8e981, b/289554448, b/301887035, b/283654243)
  • Material3-Komponenten, die in ihrer API ein MutableInteractionSource verfügbar machen, wurden aktualisiert und machen jetzt ein nullable MutableInteractionSource verfügbar, das standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie das MutableInteractionSource nicht verschieben. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie ein MutableInteractionSource zugewiesen wird. Außerdem kann es sein, dass für andere Komponenten nur dann eine Instanz erstellt wird, wenn sie benötigt wird. Das verbessert die Leistung dieser Komponenten. Wenn Sie die MutableInteractionSource, die Sie an diese Komponenten übergeben, nicht verwenden, sollten Sie stattdessen „null“ übergeben. Es wird auch empfohlen, ähnliche Änderungen in Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146)
  • Fügt RippleConfiguration und LocalRippleConfiguration hinzu, um die Anpassung von Ripples pro Komponente / Unterbaum mithilfe von festen Werten zu ermöglichen. Das kann beispielsweise sinnvoll sein, wenn Sie die Farbe einer Komponente ändern möchten, die Sie nicht steuern, oder wenn Sie die Wellenbewegung für eine Komponente deaktivieren möchten. In den meisten Fällen sollten die Standardwerte verwendet werden. Diese APIs sind ein Ausweg für die Anpassung einzelner Komponenten oder eingeschränkter Unterstrukturen. Bei größeren Änderungen und benutzerdefinierten Designsystemen sollten Sie stattdessen mit createRippleModifierNode eine eigene Ripple-Animation erstellen. (I7b5d6, b/298048146)
  • Fügt eine neue Ripple-API in Material 3 hinzu, die die verworfene rememberRipple ersetzt. Außerdem wird ein temporäres CompositionLocal, LocalUseFallbackRippleImplementation hinzugefügt, um Material 3-Komponenten auf die Verwendung der verworfenen APIs rememberRipple / RippleTheme zurückzusetzen. Diese wird in der nächsten stabilen Version entfernt und ist nur als vorübergehende Migrationshilfe für Fälle gedacht, in denen Sie eine benutzerdefinierte RippleTheme angeben. (I34cbc, b/298048146)

Fehlerkorrekturen

  • Die Unterkomposition in ModalBottomSheet wurde entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei dem ModalBottomSheet in bestimmten Szenarien in Kombination mit LookaheadScope abstürzen konnte. (I2a198)
  • Die Unterkomposition in BottomSheetScaffold wurde entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei dem BottomSheetScaffold in bestimmten Szenarien in Kombination mit LookaheadScope abstürzte. (Ie6401)
  • Die Ausrichtung des Logos wurde angepasst, sodass es sich näher an der Mitte des Ankerinhalts in Bezug auf die obere rechte Ecke befindet. (I18a28)
  • Es wurde ein Problem mit der Barrierefreiheit bei DateRangePicker behoben, bei dem der Texttitel „Monat–Jahr“ für Nutzer von Screenreadern, Switch Access und Voice Access als interaktiv dargestellt wurde. (I2ac55)
  • Der Fehler bei der Parameterreihenfolge mediumTopAppBarColors wurde behoben. (Ibe64a)

Version 1.2

Version 1.2.1

6. März 2024

androidx.compose.material3:material3-*:1.2.1 wird veröffentlicht. Version 1.2.1 enthält diese Commits.

Fehlerkorrekturen

  • Machen Sie die Schieberegler-Zustände wieder stabil. State.onValueChangeFinished wird wieder zu einem Wert. onValueChangeFinished in ein rememberUpdatedState einfügen (Ie8fd0, b/322269951)
  • @Stable wird aus den Status von Slider entfernt, da state.onValueChangeFinished in ein var geändert wird. (I82ba1, b/322269951)
  • NavigationBar Fehler bei benutzerdefinierten Farben beheben, die aus Standardfarben kopiert werden (80a779, b/326894020)
  • Regression in ExposedDropdownMenu beheben, damit das Element wieder fokussierbar ist (3fcec1, b/323694447)
  • Problem mit dem Caching der Schaltflächenfarbe behoben (3e5bbcb/327371655)

Version 1.2.0

7. Februar 2024

androidx.compose.material3:material3-*:1.2.0 wird veröffentlicht. Version 1.2.0 enthält diese Commits.

Bekanntes Problem

  • In PrimaryTabRow wurde im Rahmen einer Leistungsverbesserung ein Fehler beim Rendern der View-Compose-Interop eingeführt. Verwenden Sie als Behelfslösung TabRow mit TabRowDefaults.PrimaryIndicator.

Wichtige Änderungen seit Version 1.1.0

Neue Material Design 3-Komponenten

Verbesserungen an vorhandenen Material Design 3-Komponenten:

Experimentelle APIs wurden zu stabilen APIs hochgestuft.

Leistungsverbesserungen

Version 1.2.0-rc01

24. Januar 2024

androidx.compose.material3:material3-*:1.2.0-rc01 wird veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.

Fehlerkorrekturen

  • Der Fehler bei der Parameterreihenfolge mediumTopAppBarColors wurde behoben. (Ibe64a)
  • Ein Fehler wurde behoben, der in 1.2.0-beta02 in CardDefaults.cardColors eingeführt wurde und bei dem contentColor nicht auf Grundlage des containerColor-Parameterwerts aktualisiert wurde. (Iee041, b/319671246)
  • Ein Fehler in disabledContentColor, der in 1.2.0-beta02 eingeführt wurde, wurde behoben und es wurden kleine Optimierungen vorgenommen. (I6dda1, b/318428829)

Version 1.2.0-beta02

10. Januar 2024

androidx.compose.material3:material3-*:1.2.0-beta02 wird veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.

Bekannter Fehler

  • Aufgrund eines Fehlers in IconButtonColors wird standardmäßig disabledContentColor einem Alpha (0,38f) von LocalContentColor anstelle des vom Nutzer angegebenen contentColor zugewiesen. Das Problem lässt sich umgehen, indem Sie disabledContentColor explizit festlegen. Dieses Problem wird im nächsten Release behoben.

API-Änderungen

  • Es wurde die Möglichkeit hinzugefügt, Tooltip-Caret-Symbole für Plain Tooltip APIs zu aktivieren. (Ibf767)
  • SwipeToDismissState, rememberSwipeToDismiss und SwipeToDismissValue werden alle umbenannt und enthalten _SwipeToDismissBox_. (I68d6d)

Fehlerkorrekturen

  • Der End-Padding-Wert für ListItem wurde korrigiert, um der Spezifikation zu entsprechen. (Ibd68b, b/305342674)
  • Die Umrissfarbe für Karten mit Umriss wird jetzt korrekt OutlineVariant zugeordnet. (I75480, b/310979715)
  • Die dynamische Farbe wird jetzt aus vom System definierten Farbrollen abgerufen. Dadurch wird der Kontrast für barrierefreie Inhalte verbessert und die dynamische Farbe wird besser an die Material-Spezifikation angepasst. (I1de96)
  • Die Verarbeitung von ModalBottomSheet wurde auf Android T/13+ korrigiert, wenn android:enableOnBackInvokedCallback="true". (I728dc, b/306196110)

Version 1.2.0-beta01

13. Dezember 2023

androidx.compose.material3:material3-*:1.2.0-beta01 wird veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.

API-Änderungen

  • TabIndicatorScope als experimentell markieren (I45c88)
  • Entfernen der verworfenen experimentellen APIs für Tooltips. (I438cb)
  • Ändern Sie neue TabRow-Überladungen so, dass keine untergeordneten Kompositionen verwendet werden. Das führt zu einer anderen Methode zum Erstellen der TabRow-Indikatoren mit benutzerdefinierten Modifikatoren. (Ife741)
  • Die APIs DismissDirection und DismissValue werden eingestellt. Diese wurden in SwipeToDismissValue zusammengeführt. Die Werte geben sowohl die Position als auch die Richtung von SwipeToDismissBox an. DismissState.progress ist jetzt als FloatRange zwischen 0.0 und 1.0 markiert. Die verworfenen Saver- und Constructor-Klassen DismissState wurden entfernt. Die Komponente SwipeToDismiss, das Status- und das Standardobjekt wurden als experimentell gekennzeichnet. (Ib54f2)

Fehlerkorrekturen

  • Die Standardanzeige für PullToRefresh ist jetzt eine offene Pfeilspitze anstelle eines ausgefüllten Dreiecks. (I67be3)

Version 1.2.0-alpha12

29. November 2023

androidx.compose.material3:material3-*:1.2.0-alpha12 wird veröffentlicht. Version 1.2.0-alpha12 enthält diese Commits.

API-Änderungen

  • RangeSlider akzeptiert jetzt einen Kotlin-Bereich (z.B. 0f..1f) anstelle einer benutzerdefinierten FloatRange-Wertklasse. SnapFlingBehavior.kt verwendet jetzt auch einen Kotlin-Bereich. (I025cb)
  • Markieren Sie Modifier-Factory-Funktionen als @Stable. (Ib109f)

Version 1.2.0-alpha11

15. November 2023

androidx.compose.material3:material3-*:1.2.0-alpha11 wird veröffentlicht. Version 1.2.0-alpha11 enthält diese Commits.

Neue Funktionen

  • Implementiert PullToRefreshContainer und PullToRefreshState, die zusammen eine Pull-to-Refresh-Implementierung in Material3 ermöglichen. (I16456, b/261760718)

API-Änderungen

  • Markieren Sie SwipeToDismissBox DismissDirection und DismissValue als experimentell. (I517b0)
  • Benennen Sie SwipeToDismiss in SwipeToDismissBox um. Benennen Sie background in backgroundContent und dismissContent in nachgestelltes content-Lambda um. (I7f4d3)
  • Machen Sie den Konstruktor für ChipElevation und SelectableChipElevation öffentlich. (Ie0c48, b/308432421)
  • ModalBottomSheetProperties wird hinzugefügt. securePolicy wird in ModalBottomSheetProperties verschoben. Fügt isFocusable und shouldDismissOnBackPress zu ModalBottomSheetProperties hinzu. Mit diesen neuen booleschen Werten lässt sich festlegen, wie modale Bottom Sheets IME-Ereignisse verarbeiten sollen. (Iea56f, b/278216859)
  • Die Status RangeSlider und Slider wurden aktualisiert, um initialOnValueChange, die ursprünglichen Präfixe und die entsprechenden K-Dokumente zu entfernen. (I57d30)
  • Die Klasse ChipBorder und die zugehörigen Funktionsaufrufe werden eingestellt. Wir empfehlen, stattdessen BorderStroke direkt zu verwenden. (I89cc2)
  • Die Tooltip-APIs für Grundlagenmodelle sind jetzt @ExperimentalFoundationApi. (I30b0b)
  • TabRow und ScrollableTabRow sind nicht mehr veraltet. Die neuen primären und sekundären Varianten sind als experimentell gekennzeichnet. (I0def6)
  • Filter- und Eingabe-Chips verwenden jetzt direkt BorderStroke. (I07a8d)
  • SegmentedButton verwendet jetzt BorderStroke direkt. (I89b9b)
  • Die generische Funktion AlertDialog wurde in BasicAlertDialog umbenannt und die vorherige Funktion wurde eingestellt. (Idbe52)
  • Benennen Sie die SwipeToDismiss-APIs in SwipeDismiss um und stufen Sie die neuen SwipeDismiss-APIs auf „Stabil“ hoch. (I14cbe)
  • tonalElevation und shadowElevation werden den Tooltip-APIs hinzugefügt. Außerdem werden die APIs TooltipBox, PlainTooltip und RichTooltip wieder in den experimentellen Status zurückgesetzt, da sie versehentlich als stabil veröffentlicht wurden. (If0f66, b/293939035)
  • Experimentelle Chip-APIs werden in stabile APIs umgewandelt. (Iea2c3)
  • Die Annotation @ExperimentalMaterial3Api wurde aus den klickbaren Material3-Karten entfernt. (I88dbf)

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem SwipeToDismiss in bestimmten Szenarien mit verschachtelten Lookahead- und Lazy-Layouts abstürzte. (Ica8d1, b/297226562)

Version 1.2.0-alpha10

18. Oktober 2023

androidx.compose.material3:material3-*:1.2.0-alpha10 wird veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.

API-Änderungen

  • Badge und BadgedBox werden als stabil eingestuft. (I67f16, b/261565132)
  • securePolicy als Parameter für ModalBottomSheet hinzufügen, damit Nutzer das Verhalten für WindowManager.LayoutParams.FLAG_SECURE definieren können. (Icdac8, b/296250262)
  • Es wurden neue Überladungen von LinearProgressIndicator und CircularProgressIndicator hinzugefügt, die progress als Lambda verwenden. Diese sollten leistungsfähiger als die vorherigen Versionen sein. (I824e6, b/295616656)
  • Benennt StandardSizeClasses in AllSizeClasses um. (I8cb07)
  • Berechnungsfunktionen von Fenstergrößenklassen kombinieren (Iad935)

Fehlerkorrekturen

  • Ein DatePicker-Absturz wurde behoben, der auftrat, wenn schnell auf die Navigationspfeile geklickt wurde und der angezeigte Monat am Rand des zulässigen Jahresbereichs lag. (I46f36, b/290954897, b/297002119)
  • [Navigationsleiste] Unterstützung für transparente Farbe für Indikator. (Ie0a9b, b/267289987)

Version 1.2.0-alpha09

4. Oktober 2023

androidx.compose.material3:material3-*:1.2.0-alpha09 wird veröffentlicht. Version 1.2.0-alpha09 enthält diese Commits.

API-Änderungen

  • ModalNavigationDrawer und DismissibleNavigationDrawer wurden migriert, um die neuen AnchoredDraggable-APIs zu verwenden. DrawerStates animateTo wurde durch die Methoden „open“ und „close“ ersetzt. Der Offset wird jetzt als Gleitkommazahl und nicht als Statusobjekt bereitgestellt. Sie können direkt über currentOffset auf den Offset zugreifen. (I0a72c)
  • Es wurden nicht zusammensetzbare Funktionen zum direkten Erstellen von DatePickerState und DateRangePickerState hinzugefügt. Diese Funktionen können bei Bedarf als Alternative zu den zusammensetzbaren Funktionen rememberDatePickerState und rememberDateRangePickerState verwendet werden. (I70326, b/291524052)
  • Für die festen und scrollbaren TabRows gibt es jetzt primäre und sekundäre Varianten. Sie entsprechen der Farb- und Indikatorfunktion, die in Material 3 definiert ist.
  • PrimaryScrollableTabRow und SecondaryScrollableTabRow geben jetzt den Scrollstatus aus. (Iec8f5, b/260572337)
  • Es wurde ein neuer sheetMaxWidth-Parameter hinzugefügt, mit dem Entwickler eine maximale Breite für das Blatt festlegen können. Dp.Unspecified kann für den Parameter übergeben werden, wenn ein Sheet gewünscht wird, das die gesamte Bildschirmbreite einnimmt. (Ifb7c9, b/266697696)
  • Die APIs PlainTooltipBox und RichTooltipBox werden als eingestellte Methoden wieder hinzugefügt. (I246fa)

Fehlerkorrekturen

  • Ein Absturz wurde behoben, der aufgetreten ist, wenn DatePicker mit einem DatePickerFormatter initialisiert wurde, das bestimmte Datumsgerüste enthält, die bei der Konvertierung in Datumsmuster (z. B. YY) gleich bleiben. (I01f29)

Version 1.2.0-alpha08

20. September 2023

androidx.compose.material3:material3-*:1.2.0-alpha08 wird veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.

Funktionsgefährdende Verhaltensänderung

  • ColorScheme ist jetzt unveränderlich. Das macht einzelne Farbaktualisierungen weniger effizient, aber die häufigere Verwendung von Farben effizienter. Der Grund für diese Änderung ist, dass das Aktualisieren einzelner Farben für die meisten Apps kein Hauptanwendungsfall ist. Das ist weiterhin möglich, aber es wird mehr als zuvor neu zusammengesetzt. Dadurch wird die Anzahl der Statusabos im gesamten Material-Code deutlich reduziert, was sich auf die Initialisierungs- und Laufzeitkosten von Standardanwendungsfällen auswirkt. (Ic447d, b/297212873)
  • Die tonale Erhebung wird in verschiedenen Interaktionsstatus nicht mehr animiert, um der Spezifikation zu entsprechen. (Icdd12)

API-Änderungen

  • Es wurde ein neues BottomAppBar hinzugefügt, das ein BottomAppBarScrollBehavior als Parameter verwendet, um es beim Scrollen von Inhalten automatisch auszublenden. Außerdem wurde FabPosition.EndOverlay hinzugefügt, damit das FAB die untere App-Leiste im Scaffold überlagern kann, anstatt darüber verankert zu werden. (Iecb47)
  • Es wurde eine einfache Label-Komponente hinzugefügt, die auf BasicTooltipBox basiert und nicht geschlossen wird, wenn außerhalb der Grenzen des Labels getippt wird. (I821f9)

Fehlerkorrekturen

  • Die Verwendung von rememberSaveable für Tooltips wurde entfernt. (Icc131, b/299500338)
  • Es wurde ein temporäres Flag eingeführt, mit dem gesteuert werden kann, ob untergeordnete Elemente von Scaffold während der Messung oder während der Platzierung gemessen werden sollen. Standardmäßig wird die Messung in der Maßeinheit durchgeführt. Wenn Sie Probleme mit dem neuen Verhalten haben, melden Sie bitte ein Problem. (I0b354)
  • Die horizontale Edge-to-Edge-Anzeige in BottomSheet wurde korrigiert, indem die richtige Messung für die Bildschirmbreite des Geräts verwendet wurde. (I1df0c, b/299058752)
  • Ein Fehler wurde behoben, bei dem ModalBottomSheet nicht onDismissedRequest aufgerufen hat, wenn das Sheet durch Wischen nach unten geschlossen wurde. (Idfdd8)

Version 1.2.0-alpha07

6. September 2023

androidx.compose.material3:material3-*:1.2.0-alpha07 wird veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.

Neue Funktionen

  • In compose material 1.6.0-alpha05 wurde Unterstützung für das automatische Spiegeln von Symbolen hinzugefügt. Weitere Informationen finden Sie in den Versionshinweisen.

API-Änderungen

  • SliderState implementiert DraggableState (I9b116)
  • „shape“ als erforderlichen Parameter festlegen Benennen Sie position in der Formular-Hilfsfunktion in index um. (I34941)
  • Aktualisiert die DatePicker formatWithSkeleton, sodass sie eine Karte enthält, die als Cache zur Leistungssteigerung verwendet wird. (I3195f)
  • BasicTooltipBox wurde zu compose.foundation hinzugefügt und PlainTooltipBox und RichTooltipBox wurden aktualisiert, um TooltipBox mit den neuen Composables PlainTooltip und RichTooltip zu verwenden. (I79e1d)

Fehlerkorrekturen

  • dynamicLightColorScheme und dynamicDarkColorScheme geben jetzt Farben mit höherer Chroma für die Rollen „surface“ und surfaceContainer zurück. (I5e901)
  • Ein Problem wurde behoben, bei dem einige Komponenten, die die Unterkomposition (z.B. BottomSheetScaffold) innerhalb eines Scaffold innerhalb eines LookaheadScope verwenden, versuchten, ihre Größe zu früh zu lesen. (I297b4, I871f1, b/295536718)

Version 1.2.0-alpha06

23. August 2023

androidx.compose.material3:material3-*:1.2.0-alpha06 wird veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.

Fehlerkorrekturen

  • Die Berechnung von DropdownMenuoffset wurde korrigiert, sodass x-Offsets nur von der lokalen Layoutrichtung abhängen und y-Offsets nicht mehr umgekehrt werden, wenn sich das Menü unten auf dem Bildschirm befindet. (Iccc74, b/294103942)
  • Die Berechnung von DropdownMenuoffset wurde korrigiert, sodass x-Offsets nur von der lokalen Layoutrichtung abhängen und y-Offsets nicht mehr umgekehrt werden, wenn sich das Menü unten auf dem Bildschirm befindet. (Ib87a2, b/294103942)

Version 1.2.0-alpha05

9. August 2023

androidx.compose.material3:material3-*:1.2.0-alpha05 wird veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.

API-Änderungen

  • Aktualisierungen der Farben für das Kästchen und TriStateCheckbox. Die CheckboxDefaults.colors() disabledUncheckedColor wirkt sich jetzt nur noch auf den Rahmen des Kästchens aus. In Sonderfällen, in denen Sie die interne Kästchenfarbe festlegen müssen, wenn sie deaktiviert und nicht ausgewählt ist, ist eine benutzerdefinierte Instanz von CheckboxColors mit den gewünschten Farbwerten erforderlich. (I77d17, b/291943198)

Version 1.2.0-alpha04

26. Juli 2023

androidx.compose.material3:material3-*:1.2.0-alpha04 wird veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Experimentelle Segmented Button API (Ifc8fb)
  • Trennlinien haben jetzt einen Parameter, mit dem die Ausrichtung gesteuert werden kann, um vertikale Trennlinien zu unterstützen. (I4c899, b/288438593)

API-Änderungen

  • Die Abhängigkeit von der Dichte wird auf die Komponentenebene verschoben. Dies gilt für die folgenden Komponenten: SwipeToDismiss und blattbasierte Komponenten. Verwenden Sie die neue Überladung, bei der die Dichte ein Parameter ist. (I1846e)
  • Zusätzliche Anmerkungen zur Angabe zulässiger Eingaben für Composables (Ief234)
  • Fügen Sie einen Symbolparameter für segmentierte Schaltflächen hinzu, teilen Sie die Semantik auf, damit segmentierte Schaltflächen für die Einzelauswahl auswählbar und für die Mehrfachauswahl umschaltbar sind, mit SelectableSegmentedButtonRow bzw. ToggelableSegmentedButtonRow. (I38740)
  • Die Trennlinie wurde in HorizontalDivider umbenannt. VerticalDivider-Funktion hinzugefügt. (I5975c)
  • Die Verwendung von ClosedFloatingPointRange wurde in experimentellen Material3-APIs durch das schlankere FloatRange ersetzt, um das automatische Boxing zu minimieren. (I4aab5)
  • Neue Startausrichtung für FabPosition hinzugefügt (Ib7aea, b/170592777)

Fehlerkorrekturen

Version 1.2.0-alpha03

21. Juni 2023

androidx.compose.material3:material3-*:1.2.0-alpha03 wird veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.

Geändertes Verhalten

  • includeFontPadding ist jetzt standardmäßig false in der Material 3-Typografie. Die Standardeinstellung für die Zeilenhöhe wurde ebenfalls in Trim.None und Alignment.Center geändert. Außerdem wurde den TextStyles von Typography ein expliziter lineHeight (in sp) hinzugefügt. Wenn Sie diese Werte anpassen möchten, sehen Sie in der API-Dokumentation nach. Eine ausführliche Erläuterung dieser Änderungen finden Sie im Blogpost. (I6266f, Icabc3)

Neue Funktionen

  • Es wurde eine Überladung für RangeSlider hinzugefügt, die eine zustandsbehaftete Version der Komponente ist. RangeSliderState erstellt, die alle Informationen für den aktuell aktiven Track, die Messungen der Komponenten von RangeSlider sowie die Drag-and-Gesture-Logik enthält. (I8c270)
  • Die Suchleiste unterstützt jetzt Schatten über den neu hinzugefügten Parameter shadowElevation. (Ia5369, b/271040353)
  • ColorScheme unterstützt jetzt neue SurfaceContainer-Rollen.
  • Das Overlay für die tonale Erhebung der Oberfläche kann jetzt mit der lokalen Komposition LocalTonalElevationEnabled deaktiviert werden. (Ic203c, b/277774590)

API-Änderungen

  • Öffnen Sie die Konstruktoren für Komponentenfarben. (I8c4a6)
  • Der Parameter „focusable“ wurde beiden Tooltip-APIs hinzugefügt, damit Entwickler festlegen können, ob der Tooltip Touch-Ereignisse verarbeiten soll oder nicht. Beachten Sie, dass dies die automatische Bewegung des Fokus für die Barrierefreiheit unterbrechen kann. (Ie32d8)
  • Optimierte Barrierefreiheit für Leistung und Speicherzuweisungen. (Iede48)
  • DefaultSizeClasses freigeben und StandardSizeClasses für WindowSizeClasses erstellen (I91838)
  • Ändern Sie WindowWidth/HeightSizeClass in Gleitkommawertklassen (Ie686e).

Fehlerkorrekturen

  • Der contentWindowInsets-Parameter von Scaffold berücksichtigt jetzt die Insets des verarbeiteten Fensters. Das Verhalten des Content-Paddings basierend auf topBar und bottomBar bleibt unverändert, wenn diese Parameter angegeben werden. (I08b73, b/264601542)
  • Korrigieren Sie die Ausrichtung der oberen App-Leiste in der Mitte, damit ein langer Titel nicht über den Aktionssymbolen oder dem Navigationssymbol gerendert wird. (I4369f, b/236994621)
  • Für Tabpositionen wird jetzt eine Mindestbreite von 24 dp für den Inhalt erzwungen. Dadurch wird ein barrierefreies Touch-Ziel für Tab-Indikatoren bereitgestellt. (Id8861)
  • Dynamische Farbpaletten aus dynamicLightColorScheme und dynamicDarkColorScheme unterstützen jetzt neue Oberflächenrollen. (I1252e)
  • Die Ausrichtung von Benachrichtigungen mit Badges wurde aktualisiert, damit sie nicht abgeschnitten werden, wenn sie mit dem übergeordneten Element kollidieren. (Idf75a)

Version 1.2.0-alpha02

24. Mai 2023

androidx.compose.material3:material3-*:1.2.0-alpha02 wird veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.

API-Änderungen

  • Fügen Sie ModalBottomSheet den Parameter für Fenstereinsätze hinzu.
    • Der Scrim für ModalBottomSheet kann jetzt hinter der Statusleiste gezeichnet werden, wenn windowInsets auf null gesetzt ist.
    • Die Standardfunktion ModalBottomSheet wurde aktualisiert, um außerhalb der Systemleisten, einschließlich der Navigationsleiste, zu bleiben.
    • Die Verarbeitung von Insets in der Statusleiste erfolgt im Edge-to-Edge-Modus über den Ziehpunkt.
    • BottomSheetDefaults enthält Fenstereinsätze für BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
  • Indicator wird eingestellt und Primary/SecondaryIndicator wird hinzugefügt, um den M3-Spezifikationen zu entsprechen. PrimaryIndicator entspricht der Breite des Tabinhalts, während SecondaryIndicator die gesamte verfügbare Breite einnimmt. SecondaryIndicator entspricht dem jetzt eingestellten Indicator und kann als direkter Ersatz verwendet werden. (I27604)
  • Es wurde eine Option hinzugefügt, mit der ein ScrollState beim Erstellen eines DropdownMenu oder eines ExposedDropdownMenu übergeben werden kann, um den vertikalen Scrollstatus der angezeigten Menüelemente zu steuern. (Ia0734, b/185304441)
  • Es wurde eine Überladung für Slider hinzugefügt, die eine zustandsbehaftete Version der Komponente ist. SliderState erstellt, die alle Informationen für den aktuell aktiven Track, die Messungen der Komponenten von Slider sowie die Drag-and-Gesture-Logik enthält. (I124a5)
  • Umbenennung des Semantics-Attributs isContainer in isTraversalGroup (I121f6)
  • Optimierte TextStyle.merge(...) mit vollständiger Parameterliste hinzugefügt. (Iad234, b/246961787)
  • TooltipState, RichTooltipState und PlainTooltipState sind öffentliche Schnittstellen. RichTooltipStateImpl und PlainTooltipStateImpl für Standardstatus wurden hinzugefügt. Es wurden remember*State-Funktionen hinzugefügt, um diese implementierten Status abzurufen. TooltipSync wurde zugunsten von TooltipDefault.GlobalMutatorMutex entfernt. (I7813d)
  • Die DatePickerColors wurde aktualisiert und enthält jetzt zusätzliche Anpassungsoptionen für die Farben der Trennlinie der Datumsauswahl, der Navigation und der Texteingabefelder. (I1a685, b/274626815)
  • DatePickerState und DateRangePickerState sind jetzt öffentliche Schnittstellen mit Standardimplementierungen, die über rememberDatePickerState und rememberDateRangePickerState abgerufen werden können. (I71c52)
  • Die dateValidator wurde aus DatePicker und DateRangePicker entfernt und eine SelectableDates-Schnittstelle eingeführt, die im Status festgelegt werden kann, um zu steuern, welche Datumsangaben oder Jahre in der Benutzeroberfläche ausgewählt werden können. (Ic2fc6)
  • TimePicker aus stabiler API entfernt, weitere Änderungen in der Status-API werden erwartet (I3f39a)
  • ModalBottomSheet wurde nur auf Android verschoben. ModalBottomSheet wird für die Verwendung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv weiterentwickelt. (Ib3778)

Fehlerkorrekturen

  • Die Aktion zum Schließen von AlertDialog wird jetzt unter der Bestätigungsaktion angezeigt, wenn die Aktionen übereinander gestapelt werden, um in die Breite des Dialogfelds zu passen. Mit dieser Korrektur wird die Implementierung an die Material Design-Spezifikation angepasst. (I029de, b/235454277)
  • Ein Fehler in ListItem wurde behoben, bei dem für dreizeilige Elemente ein falscher Innenabstand verwendet wurde. (I6e235)
  • ModalBottomSheet kann jetzt die IME-Tastatur anzeigen (Idc508, b/262140644, b/268380384, b/272483584)

Version 1.2.0-alpha01

10. Mai 2023

androidx.compose.material3:material3:1.2.0-alpha01 und androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 werden veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.

Version 1.1

Version 1.1.2

20. September 2023

androidx.compose.material3:material3:1.1.2 und androidx.compose.material3:material3-window-size-class:1.1.2 werden veröffentlicht. Version 1.1.2 enthält diese Commits.

Fehlerkorrekturen

  • Ein Fehler wurde behoben, bei dem der Modifier fälschlicherweise an zwei Composables übergeben wurde. (b/282761472)
  • Der Fehler, dass TimePickerState bei der Initialisierung mit 23 Stunden falsche Stunden zurückgibt, wurde behoben. (b/278242122)
  • Der anfängliche Ein/Aus-Status für die Validierung von Mittag und Minute wurde korrigiert. (b/269768197, b/282790635)
  • Der Fehler wurde behoben, bei dem state.hour für 23:00 Uhr einen falschen Wert zurückgegeben hat. (b/282761472, b/278242122)

Version 1.1.1

21. Juni 2023

androidx.compose.material3:material3:1.1.1 und androidx.compose.material3:material3-window-size-class:1.1.1 werden veröffentlicht. Version 1.1.1 enthält diese Commits.

Fehlerkorrekturen

  • Ruft ModalBottomSheet ohne den Parameter windowInset für die binäre Kompatibilität auf. (Ib7959)
  • Fügen Sie ModalBottomSheet den Parameter für Fenstereinsätze hinzu.
    • Der Scrim für ModalBottomSheet kann jetzt hinter der Statusleiste gezeichnet werden, wenn windowInsets auf null gesetzt ist.
    • Die Standardfunktion ModalBottomSheet wurde aktualisiert, um außerhalb der Systemleisten, einschließlich der Navigationsleiste, zu bleiben.
    • Die Verarbeitung von Insets in der Statusleiste erfolgt im Edge-to-Edge-Modus über den Ziehpunkt.
    • BottomSheetDefaults enthält Fenstereinsätze für BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)

Version 1.1.0

10. Mai 2023

androidx.compose.material3:material3:1.1.0 und androidx.compose.material3:material3-window-size-class:1.1.0 werden veröffentlicht. Version 1.1.0 enthält diese Commits.

Wichtige Funktionen von Version 1.1.0

Neue Material Design 3-Komponenten

Verbesserungen an vorhandenen Material Design 3-Komponenten:

Experimentelle APIs wurden zu stabilen APIs hochgestuft.

Weitere Informationen finden Sie in diesem Blogpost.

Version 1.1.0-rc01

19. April 2023

androidx.compose.material3:material3:1.1.0-rc01 und androidx.compose.material3:material3-window-size-class:1.1.0-rc01 werden veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

API-Änderungen

  • TimePicker aus stabiler API entfernt, weitere Änderungen in der Status-API werden erwartet (I3f39a)
  • ModalBottomSheet wurde nur auf Android verschoben. ModalBottomSheet wird für die Verwendung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv weiterentwickelt. (Ib3778)

Version 1.1.0-beta02

5. April 2023

androidx.compose.material3:material3:1.1.0-beta02 und androidx.compose.material3:material3-window-size-class:1.1.0-beta02 werden veröffentlicht. Version 1.1.0-beta02 enthält diese Commits.

API-Änderungen

  • SheetState hat jetzt den optionalen Parameter skipHiddenState
  • rememberStandardBottomSheetState hat jetzt den optionalen Parameter skipHiddenState
  • BottomSheetScaffold hat jetzt einen definierten verborgenen Anker, der jedoch standardmäßig deaktiviert ist.
  • Die Dokumentation für SheetState.requireOffset wurde aktualisiert.
  • BottomSheetDefaults.MinimizedShape wurde in BottomSheetDefaults.HiddenShape umbenannt (I839f4, b/273870234).

Fehlerkorrekturen

  • Bei aktivierter Touch-Bedienung wird das Zifferblatt nicht von Stunde auf Minute umgeschaltet. (I717d0)
  • Die Semantik für das Ziehen von ModalBottomSheet und BottomSheetScaffold wurde zusammengeführt. (I05afb)
  • Der Modifikator BottomSheetScaffold sowie die Parameter containerColor und contentColor wirken sich jetzt nur noch auf Inhalte aus. (I992cb)
  • In BottomSheetScaffold nestedScroll für Tabellenblattinhalte werden jetzt Wischbewegungen unterstützt. (I992cb)

Version 1.1.0-beta01

22. März 2023

androidx.compose.material3:material3:1.1.0-beta01 und androidx.compose.material3:material3-window-size-class:1.1.0-beta01 werden veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

API-Änderungen

  • Füge dem TimePicker-Composable einen Parameter für den Layouttyp hinzu. Je nach Bildschirmkonfiguration (Ia0e16) können verschiedene Layouts verwendet werden.
  • SearchBarDefaults wurde als experimentell markiert. (I65561)
  • Schattenhöhe für BottomSheetScaffold hinzugefügt (I94e0f)
  • Unterstützung für die Anzeige der Datumsauswahl ohne Kopfzeile hinzugefügt. API-Änderungen, um beim Erstellen einer Datumsauswahl eine Null-Überschrift zu übergeben. Sie können jetzt „null“ für „headline“, „title“ und showToggleMode = false übergeben, um eine Headless-Auswahl zu präsentieren. (Id3f3a, b/266132421, b/267194809)

Fehlerkorrekturen

  • Suchleisten verlieren jetzt automatisch den Fokus, wenn sie inaktiv werden. (I22a7c, b/261444487)
  • Die DateRangePicker wurde aktualisiert, sodass ein Zeitraum mit demselben Start- und Enddatum ausgewählt werden kann. (I16529, b/272882497)
  • Textfelder positionieren ihre Textelemente jetzt richtig, wenn die Schriftgröße kleiner als erwartet ist. Je nach Schriftarteinstellungen und Skript kann sich das auf einige Pixel in Ihren Apps auswirken. (I8b8d0)
  • Semantische Aktionen in der Ansicht am unteren Rand haben jetzt Labels. (I277b0)

Version 1.1.0-alpha08

8. März 2023

androidx.compose.material3:material3:1.1.0-alpha08 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 werden veröffentlicht. Version 1.1.0-alpha08 enthält diese Commits.

Neue Funktionen

  • Unterstützung für BottomSheetScaffold und BottomSheetScaffoldState hinzugefügt. (I063d4)

API-Änderungen

  • Der DatePickerState und dem DateRangePickerState wurde die Funktion hinzugefügt, Datumsangaben nach der Erstellung des Status festzulegen und Auswahlen durch Festlegen von Null-Zeitstempeln zurückzusetzen. Das manuelle Festlegen von Datumsangaben sollte mit Vorsicht erfolgen. Die neue Funktion setSelection löst eine Ausnahme aus, wenn ein angegebenes Datum eine Vorbedingung nicht erfüllt (siehe Dokumentation). (Ifa645, b/268609314, b/270427389)
  • Benennen Sie „Collapsed SheetValue“ in „PartiallyExpanded“ um, um das Verhalten in diesem Status genauer und flexibler darzustellen. (Ia1491)
  • Die Namen der ListItem-Parameter wurden von „_text“ in „_content“ geändert. Standard-Getter sind jetzt ReadOnlyComposables, sofern relevant. (I69a25)
  • Interaktive Surface-APIs aus der experimentellen Phase herausnehmen. (I90d59, b/261561812)

Fehlerkorrekturen

  • Ein Problem wurde behoben, bei dem der Status von ModalBottomSheetHalfExpanded falsch berechnet wurde und das Blatt schwebend angezeigt wurde. (I45e84, b/268411386)
  • Füge die confirmValueChange-Prüfung für das Tippen auf den Scrim für ModalBottomSheet hinzu. (I2311a, b/270425759)
  • Semantische BottomSheet-Aktionen werden zum Ziehpunkt verschoben. (I158ba)
  • ModalBottomSheet-Befehle konzentrieren sich jetzt auf den Start und verarbeiten die Zurück-Schaltfläche. (I4d2ab)
  • ModalBottomSheet onDismissRequest wird jetzt auch bei verschachtelten Scroll-Flings berücksichtigt. (I655c5, b/268433166)

Version 1.1.0-alpha07

22. Februar 2023

androidx.compose.material3:material3:1.1.0-alpha07 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 werden veröffentlicht. Version 1.1.0-alpha07 enthält diese Commits.

Neue Funktionen

  • Fügen Sie ein zusammensetzbares Element für die Zeiteingabe hinzu, das mit rememberTimePickerState() funktioniert und der M3-Spezifikation für die Zeiteingabe (Ia4fab) entspricht.
  • Es wurde eine Material 3-DateRangePicker-API zum Auswählen eines Zeitraums hinzugefügt. (I7a6c3, b/267194809)
  • Unterstützung für die Auswahl von Zeiträumen über die DateRangePicker API im Material 3-Eingabemodus wurde hinzugefügt. (Ifdbc4)
  • Die Farben von Textfeldern können jetzt angepasst werden:
    • Die Farben des Eingabefelds und des Platzhaltertexts basierend auf dem Fokus und dem Fehlerstatus. Der Parameter textColor wurde in unfocusedTextColor und placeholderColor in unfocusedPlaceholderColor umbenannt.
    • Die Containerfarbe für ausgefüllte Textfelder basierend auf dem Fehlerstatus mit dem neuen Parameter errorContainerColor.
  • Die Farben der Textfelder für Drop-down-Menüs wurden mit Parametern aktualisiert, um die neue Prefix- und Suffix-API zu unterstützen. (I9c8b4, b/254284181, b/264766350)

API-Änderungen

  • Einige Slider API-Versionen werden zurückgesetzt und redundante Slider-Überladungen werden entfernt, die vom neuen experimentellen Slider mit benutzerdefiniertem Thumb und Track abgedeckt werden. RangeSlider als stabil einstufen. (Ie8fbd)
  • Die Erhebungsfunktionen des Chips wurden von defaultElevation in elevation umbenannt. (I0f872)
  • Die folgenden Material 3-Textfeld-APIs sind nicht mehr experimentell: TextField, OutlinedTextField, textFieldWithLabelPadding, textFieldWithoutLabelPadding, outlinedTextFieldPadding. (Ieb5c0, b/261561819)
  • TimePickers is24Hour verwendet die Systemeinstellung (I18856)
  • Die experimentelle Annotation wurde aus den Scaffold-APIs entfernt. (Ibb51e, b/261565765, b/261436953)

Fehlerkorrekturen

  • Die Standardform von ModalBottomSheet ist jetzt immer SheetDefaults.ExpandedShape. (I0dfca)
  • Verbesserungen bei den Bedienungshilfen für Material 3 DatePicker und DateRangePicker. (I5087e)
  • Es wurde ein Fehler behoben, durch den die Beschränkung für die maximale Höhe weitergegeben wurde und es zu einem Absturz kommen konnte. (I30d8c)
  • Semantische Rollen wurden aus klickbaren und auswählbaren Oberflächen entfernt. Komponenten, in denen sie verwendet wurden, wurden aktualisiert, um Rollen mit „modifier.semantics“ festzulegen. (I793d9)

Version 1.1.0-alpha06

8. Februar 2023

androidx.compose.material3:material3:1.1.0-alpha06 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 werden veröffentlicht. Version 1.1.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Textfelder unterstützen jetzt Präfix- und Suffixtext (Ia8578, b/179884561)
  • Die Funktion TimePicker wurde hinzugefügt, um eine Zeitauswahl gemäß der Material 3-Spezifikation anzuzeigen. Sie wird in Verbindung mit TimePickerState und der Convenience-Methode rememberTimePickerState verwendet (I71910).
  • Die Datumseingabe ist jetzt ein Anzeigemodus unter DatePicker. Unterstützung für das Umschalten zwischen der Datumsauswahl und der Datumeingabe hinzugefügt. (Ieeff7)
  • API für RichTextTooltips hinzugefügt. (I58ef3)
  • Implementierung des modalen Blatts am unteren Rand für Material 3, einschließlich ModalBottomSheet und ModalBottomSheetDefaults. Außerdem werden SheetState und rememberSheetState eingeführt, die für zukünftige Tabellenblattkomponenten verwendet werden können. (I0853a, b/244189383)

API-Änderungen

  • API showSnackbar stabilisieren (I195c2, b/261424370)
  • APIs für Assist-Chip und Vorschlagschip stabilisieren (Ibb67b, b/261424370)
  • Die APIs ListItem, ListItemDefaults und ListItemColors werden als nicht experimentell eingestuft (I7e7fa, b/261438882).
  • Die APIs SliderPositions, SliderDefaults.Thumb und SliderDefaults.Track werden als stabil eingestuft und es werden nicht experimentelle Slider- und RangeSlider-APIs mit benutzerdefinierten Thumbnails und Tracks hinzugefügt. Die bisherigen APIs Slider und RangeSlider werden ebenfalls eingestellt. (Ie5ea6, b/261566890)
  • Modifier.tooltipAnchor() wurde öffentlich gemacht, damit Entwickler es an den Anker übergeben können, um anzugeben, dass bei langem Drücken eine Kurzinfo angezeigt werden soll. Die PlainTooltipBox API wurde aktualisiert. TooltipState ist jetzt nicht mehr nullable und hat einen Standardwert. (Ie2fb7)
  • ProgressIndicatorDefaults.circularTrackColor wurde zur besseren Übersichtlichkeit mit @Composable markiert. (Id29cc)
  • Die Getter-Methode LocalMinimuTouchTargetEnforcement für die wiederhergestellte Property wurde wiederhergestellt, als eingestellt markiert und zur Methode LocalMinimumInteractiveComponentEnforcement weitergeleitet. (I60dd5)

Version 1.1.0-alpha05

26. Januar 2023

androidx.compose.material3:material3:1.1.0-alpha05 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 werden veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.

Neue Funktionen

  • DatePickerDialog und Support für Bedienungshilfen
  • Benutzerdefinierte Miniatur und benutzerdefinierter Track wurden RangeSlider hinzugefügt.

Abhängigkeitsupdates

Version 1.1.0-alpha04

11. Januar 2023

androidx.compose.material3:material3:1.1.0-alpha04 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 werden veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Erste DatePicker-API zum Auswählen eines einzelnen Datums über eine Kalender-Benutzeroberfläche. Diese API wird noch geändert. (I722b9)
  • Unterstützung für einfache Tooltips über PlainTooltipBox wurde hinzugefügt. (I0cdfb)
  • Suchleiste (Iad128)
  • SwipeToDismiss (I458a8, b/242889540)

API-Änderungen

  • Die Semantik-Property IsContainer wurde auf Plattformen hinzugefügt. Diese Eigenschaft wird bei einer späteren Änderung verwendet, bei der die Reihenfolge der Traversierung auf der Grundlage der semantischen Bedeutung von Elementen wie Oberflächen bestimmt wird. (I63379)
  • Markieren Sie APIs für die Navigationsleiste als stabil. (Iab01e, b/261439597)
  • Für kreisförmige Fortschrittsanzeigen wurde ein Parameter für die Farbe der Spur und für kreisförmige und lineare Fortschrittsanzeigen ein Parameter für die Form der Linienenden hinzugefügt. (Ie668c, b/216325962, b/222964817)
  • Weitere Informationen zur Nullable-Eigenschaft des Rückgabetyps von eingestellten, ausgeblendeten Funktionen (Ibf7b0)
  • Fügen Sie Modifier.minimumInteractiveComponentSize hinzu. Damit können Sie mindestens 48 dp für die eindeutige Unterscheidung von Berührungsinteraktionen reservieren, wenn das Element kleiner wäre. (I33f58, b/258495559)
  • Es wurde eine experimentelle API für die AlertDialog-Composable-Funktion mit einem Inhalts-Slot hinzugefügt. (Iec4a2)

Fehlerkorrekturen

  • Der Fortschritt für Fortschrittsindikatoren ist jetzt korrekt auf den erwarteten Bereich begrenzt. (I8a7eb, b/262262727)

Bekanntes Problem

  • Beim Aktualisieren von androidx.compose.foundation:1.4.0-alpha03 auf androidx.compose.foundation:1.4.0-alpha04 kann der Fehler java.lang.NoSuchFieldError auftreten. Hier wurde das Problem ursprünglich gemeldet. Ein Fix wurde eingereicht und ist im nächsten Compose-Update verfügbar. Als Behelfslösung können Sie Ihre androidx.compose.material- und androidx.compose.material3-Bibliotheken auf die neueste Version(1.1.0-alpha04) aktualisieren oder Ihre androidx.compose.foundation-Bibliothek auf Version 1.4.0-alpha03 downgraden.

Version 1.1.0-alpha03

7. Dezember 2022

androidx.compose.material3:material3:1.1.0-alpha03 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 werden veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.

API-Änderungen

  • consumedWindowInsets() wurde in consumeWindowInsets() und withConsumedWindowInsets() in onConsumedWindowInsetsChanged() umbenannt. Außerdem wurden die Modifikatoren öffentlich gemacht. (Ie44e1)
  • Es wurde ein neuer Standard-Inhaltsabstand für Textschaltflächen mit Symbol hinzugefügt. (I8f662)
  • Es wurden deaktivierte Farben für die Navigationsleiste und die Navigationsspalte hinzugefügt. (Ia7892, b/258867034)
  • Eine Modifier API zum Abfragen von Scrollinformationen für übergeordnete Elemente wurde hinzugefügt. (I2ba9d, b/203141462)
  • Wird in Clickable verwendet, um Tippinteraktionen richtig zu verzögern, wenn aus Gesten Scroll-Ereignisse werden könnten.
  • Das Problem, dass Clickables Ripples nicht richtig verzögert hat, wenn es in einem Scrollable ViewGroup verwendet wurde, wurde behoben.
  • Die Schubladen und Sheets wurden aktualisiert, um das Drücken korrekt zu verzögern, falls Gesten zu Scroll-Ereignissen werden können.

Abhängigkeitsupdates

  • Compose UI und Compose Material sind jetzt von Lifecycle 2.5.1 abhängig. (I05ab0, b/258038814)

Version 1.1.0-alpha02

9. November 2022

androidx.compose.material3:material3:1.1.0-alpha02 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 werden veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.

API-Änderungen

  • awaitFirstDown und waitForUpOrCancellation akzeptieren jetzt ein PointerEventPass für mehr Flexibilität. Außerdem wird das Problem behoben, dass bei ExposedDropdownMenuBox beim Scrollen ein Menü angezeigt wurde. (I7579a, b/212091796)
  • Der Parameter minLines wurde in die Material- und Material3-Textkomponenten TextField und OutlinedTextField eingefügt. Damit kann die Mindesthöhe der Komponente in Bezug auf die Anzahl der Zeilen festgelegt werden (I4af1d).
  • Die Funktion TopAppBarDefaults smallTopAppBarColors wird zugunsten einer neuen Funktion topAppBarColors eingestellt, die beim Erstellen eines TopAppBar verwendet werden sollte. (Ie6cb9)
  • Der Parameter minLines wurde den BasicText und BasicTextField hinzugefügt. Damit kann die Mindesthöhe dieser Composables in Bezug auf die Anzahl der Zeilen festgelegt werden (I24294, b/122476634).

Fehlerkorrekturen

  • Schneiden Sie den Inhalt eines Material3-IconButton und IconToggleBotton auf die Form der Status-Ebene der Komponente zu (z.B. kreisförmig). (I9da8f)
  • Die mittleren und großen oberen App-Leisten von Material3 wurden aktualisiert, sodass auf der gesamten Oberfläche dieselbe Hintergrundfarbe verwendet wird. Außerdem können die Standardfarben mit transparenten Farbwerten überschrieben werden. (I67659, b/249688556, b/250838918)

Version 1.1.0-alpha01

24. Oktober 2022

androidx.compose.material3:material3:1.1.0-alpha01 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 werden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

  • Es wurden Fehler in der oberen App-Leiste behoben, wenn der Titel mit einem TextStyle und einem Brush angewendet wird. (If667e)

Version 1.0

Version 1.0.1

9. November 2022

androidx.compose.material3:material3:1.0.1 und androidx.compose.material3:material3-window-size-class:1.0.1 werden veröffentlicht. Version 1.0.1 enthält diese Commits.

Fehlerkorrekturen

  • Die mittleren und großen oberen App-Leisten von Material3 wurden aktualisiert, sodass auf der gesamten Oberfläche dieselbe Hintergrundfarbe verwendet wird. Außerdem können die Standardfarben mit transparenten Farbwerten überschrieben werden. (I67659, b/249688556, b/250838918)

Version 1.0.0

24. Oktober 2022

androidx.compose.material3:material3:1.0.0 und androidx.compose.material3:material3-window-size-class:1.0.0 werden veröffentlicht. Version 1.0.0 enthält diese Commits.

Wichtige Funktionen von Version 1.0.0

Dies ist die erste stabile Version von Compose Material 3.

Material Design 3-Thematisierung und dynamische Material You-Farben

Material Design 3-Komponenten

Klasse für Fenstergröße

  • material3-window-size-class ist eine neue Bibliothek, die Unterstützung für Fenstergrößenklassen bietet. Das sind eine Reihe von Ansichtsfenster-Breakpoints, die Ihnen als Grundlage für das Design, die Entwicklung und das Testen von anpassbaren Anwendungslayouts dienen. Mit calculateWindowSizeClass können Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche dargestellt werden soll. Bei größeren Fenstergrößen kann beispielsweise eine Navigationsleiste anstelle der unteren Navigation angezeigt werden. Weitere Informationen und Beispiele zur Verwendung finden Sie in der API-Referenzdokumentation für WindowSizeClass.

  • Weitere Informationen finden Sie in diesem Blogpost.

Version 1.0.0-rc01

5. Oktober 2022

androidx.compose.material3:material3:1.0.0-rc01 und androidx.compose.material3:material3-window-size-class:1.0.0-rc01 werden veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

API-Änderungen

  • Es wurde ein Slot-Parameter zur Unterstützung der Text-zu-Textfeld-API hinzugefügt (Iaac0d, b/227146125).

Version 1.0.0-beta03

21. September 2022

androidx.compose.material3:material3:1.0.0-beta03 und androidx.compose.material3:material3-window-size-class:1.0.0-beta03 werden veröffentlicht. Version 1.0.0-beta03 enthält diese Commits.

API-Änderungen

  • ExposedDropdownMenuDefaults stellt jetzt einen Auffüllwert für Menüelemente bereit. (I34ee1)
  • ExposedDropdownMenuBoxScope hat jetzt einen Modifier.menuAnchor()-Modifikator, der für ein korrektes Verhalten in Bezug auf die Barrierefreiheit an das Textfeld übergeben werden sollte. (I27fa3)
  • Hinzufügen von zwei überladenen Methoden für die aktuelle Slider API, damit Nutzer einen Thumb oder Track übergeben können, um den Slider zu füllen. (I21c00)

Fehlerkorrekturen

  • Die Farbzuordnung für das dunkle Design für „On Error Container“ wurde zu Ton 90 (Ic5612) aktualisiert.
  • Es wurde ein Fehler behoben, der das Festlegen eines transparenten Hintergrunds für kleine Material 3-App-Leisten oben verhindert hat. (I645e2, b/245575782)

Version 1.0.0-beta02

7. September 2022

androidx.compose.material3:material3:1.0.0-beta02 und androidx.compose.material3:material3-window-size-class:1.0.0-beta02 werden veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.

API-Änderungen

  • Die in M3-Komponenten in der Beta01-Version eingeführten Standardkomponenteneinzüge berücksichtigen keine IME-Einzüge mehr.
  • Die Material3-Scaffold-Komponente hat jetzt einen contentWindowInsets-Parameter, mit dem Sie die Anzahl der Insets für den Inhalts-Slot angeben können. (Icf11a, b/243713323)
  • Die experimentelle Material 3-Funktion SmallTopAppBar wird eingestellt und eine entsprechende Funktion TopAppBar wird eingeführt. Migrieren Sie Ihre Nutzung bitte auf die neue. (I74404, b/226918634)
  • Fügt die Steuerung des Wisch- und Einrastverhaltens der oberen App-Leiste hinzu. (I15c81)
  • Entfernt „startIndent“ aus „Divider“ und verschiebt die Farbe in den letzten Parameter. (If7be2)

Fehlerkorrekturen

  • Dialogfelder müssen sich TalkBack-Nutzern gegenüber identifizieren, indem sie das Wort „Dialog“ ausgeben, wenn sie angezeigt werden. (I857ef)

Version 1.0.0-beta01

24. August 2022

androidx.compose.material3:material3:1.0.0-beta01 und androidx.compose.material3:material3-window-size-class:1.0.0-beta01 werden veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

API-Referenz

Die neuesten verfügbaren Composables für das Theming, Komponenten und andere Elemente finden Sie in der Compose Material 3 API-Referenzübersicht.

API-Änderungen

  • Die obere App-Leiste mit Material 3 kann jetzt vollständig minimiert oder maximiert werden. Außerdem wurde die Verhaltensfunktion TopAppBarDefaults aktualisiert, sodass sie Composables ist und Standardwerte für den Status der oberen App-Leiste und die Animationsspezifikation bereitstellt. (I642b3)
  • Aktualisierte Signaturen der FAB-Komponente, die der Surface API (I3afaa) entsprechen
  • Es wurde eine integrierte Unterstützung für Insets für obere App-Leisten, Drawers, Navigationsleisten und Rails hinzugefügt. Diese Komponenten, die separat oder mit Scaffold verwendet werden, verarbeiten automatisch Insets für Entwickler. Hinweis: Durch diese Änderung wird keine automatische Verarbeitung von Statusleistensymbolen und Transparenz der Status- und Navigationsleisten hinzugefügt. Bitte machen Sie das weiterhin manuell, um die beste Darstellung zu erzielen. (I7e4e6, b/183161866)
  • Die Standardeinstellungen für Komponenten wurden aktualisiert, um die API-Oberfläche für zukünftige Flexibilität und Leistungsverbesserungen zu verringern. (I31820)
  • Die Parameter für Chip und Navigationsleiste wurden neu angeordnet, um die Konsistenz innerhalb der API zu wahren (I45d0b).
  • startIndent wurde aus „Divider“ entfernt und die Farbe ist jetzt der letzte Parameter.(If7be2)

Version 1.0.0-alpha16

10. August 2022

androidx.compose.material3:material3:1.0.0-alpha16 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 werden veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.

Neue Funktionen

  • Unterstützung für die Angabe einer benutzerdefinierten Breite für eine Navigationsleiste. (Ia7f10)

API-Änderungen

  • Tab- und Leading-Icon-Tab-Parameter neu anordnen, um die Konsistenz innerhalb der API zu wahren (Ie2637)
  • BadgeDefaults als experimentell gekennzeichnet (I98ef3)
  • Die eingestellte Navigationsleistenfunktion wurde entfernt. (I4f2db)
  • Parameter für den Slider in Material 3 neu anordnen, um die Konsistenz innerhalb der API zu wahren (I0aee7)
  • NavigationBar- und NavigationRail-Parameter neu anordnen, um die Konsistenz innerhalb der API aufrechtzuerhalten (I51cda)
  • Parameter in Material 3 neu anordnen, um die Konsistenz in der gesamten API zu wahren. (If4ae1)
  • Slider-Parameter in Material 3 neu anordnen, um die Konsistenz innerhalb der API zu wahren (I62673)
  • Der Parameter „icons“ wurde in „actions“ umbenannt, um ihn an die obere App-Leiste anzupassen (Id75be).
  • Markiere Badge und BadgedBox als experimentell, da die Ankerausrichtung noch nicht endgültig festgelegt ist. (I1712e, b/236524516)
  • Ändere @ExperimentalMaterial3Api-Anmerkungen für Symbolschaltflächenvarianten in @OptIn (I070b5).
  • Der Inhalt des Navigationsbereichs wurde in eine eigene zusammensetzbare Funktion ausgelagert, um eine benutzerdefinierte Breite festlegen zu können. (Ia7f10)
  • Entfernt Divider aus MenuDefaults und TabDefaults (I4e33c)

Version 1.0.0-alpha15

27. Juli 2022

androidx.compose.material3:material3:1.0.0-alpha15 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 werden veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.

Neue Funktionen

  • Das Ziehen der oberen App-Leiste an der Leiste selbst zulassen. (I65c00, b/205873416)

API-Änderungen

  • Die APIs FilterChip und ElevatedFilterChip wurden aktualisiert, um den selectedIcon-Slot zu entfernen und die Wiederverwendung von leadingIcon zum Anzeigen eines ausgewählten Status zu fördern. (Ie5dc2)
  • Rollen für die Farbe von Scrim und Umrissvariante hinzufügen. (Id6d54)
  • Namenskonventionen für zusammensetzbare Standardeinstellungen korrigieren (I62b27)
  • ListItemDefaults und ListItemColors als experimentell markieren (I1f3ec)
  • Änderungen an der API für die obere App-Leiste, um die Bedeutung der Statusattribute besser widerzuspiegeln. Kennzeichnen Sie die Top-App-Leiste-API außerdem als experimentell. (Ic0ad8)
  • Die Farben für die Textauswahl wurden jetzt in TextFieldColors hinzugefügt, um die Auffindbarkeit zu verbessern. (Iba1b8)
  • ButtonDefault.ButtonWithIconContentPadding für Schaltflächen mit Symbolen hinzufügen. (I2bf9c)
  • Textfelder wurden als experimentell markiert, um mehr Flexibilität bei zukünftigen API-Änderungen zu ermöglichen. (I127b5)
  • Die Annotation @ExperimentalMaterial3Api wurde aus der Funktion Checkbox entfernt. (I5eefc)
  • Die Annotation @ExperimentalMaterial3Api wurde aus der Funktion RadioButton entfernt. (I17e2a)
  • Die Annotation @ExperimentalMaterial3Api wurde aus den nicht interaktiven Karten entfernt. (I9bd49)
  • Aktualisiert verschiedene Standardobjekte für Komponenten, um Farben, Formen usw. einzuschließen (I96e11)

Fehlerkorrekturen

  • Nicht funktionierende nachgestellte Symbole wurden aus den Beispielen für Eingabe-Chips entfernt, um Verwirrung bei Nutzern der Katalog-App zu vermeiden. (I9846a)

Version 1.0.0-alpha14

29. Juni 2022

androidx.compose.material3:material3:1.0.0-alpha14 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 werden veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.

Neue Funktionen

  • M3-Listenimplementierung hinzugefügt. Informationen zur Verwendung finden Sie in der Dokumentation (Id7a20).

API-Änderungen

  • Parametername von „values“ in „value“ in RangeSlider ändern (I3b79a)
  • API-Änderungen an der InputChip-Implementierung zur Unterstützung eines auswählbaren Status gemäß der Material Design-Spezifikation. Zusätzliche Unterstützung für die FilterChip-Farben für den ausgewählten deaktivierten Status. (I55244, b/235792432)
  • Standard-FAB für BottomAppBar hinzufügen (Ida4c8)
  • ColorScheme.surfaceColorAtElevation wurde hinzugefügt (Id41af)
  • Schnittstellen in Compose-Bibliotheken werden jetzt mit JDK8-Standardschnittstellenmethoden erstellt (I5bcf1).
  • WindowWidthSizeClass und WindowHeightSizeClass implementieren jetzt Comparable, sodass sie mit Operatoren (<, <=, >=, >) und anderen APIs verglichen werden können. (I747d0)

Fehlerkorrekturen

  • Aktualisieren Sie das Beispiel für das Logo, um eine aussagekräftigere Inhaltsbeschreibung zu liefern. (I10b9d)
  • Es wurde eine Option hinzugefügt, mit der die Systemschriftgröße in der Designauswahl des Material 3-Katalogs verwendet werden kann. (I10605)
  • Fügt Beispielcode für Badge- und unbestimmte Fortschrittsanzeigen hinzu. (I8fbe0)

Version 1.0.0-alpha13

1. Juni 2022

androidx.compose.material3:material3:1.0.0-alpha13 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 werden veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.

API-Änderungen

  • Unterstützt das Beibehalten der Position der oberen App-Leiste bei einer Konfigurationsänderung. (I10459, b/216160958)

Version 1.0.0-alpha12

18. Mai 2022

androidx.compose.material3:material3:1.0.0-alpha12 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 werden veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.

Fehlerkorrekturen

  • Das übergeordnete Element des Sliders kann jetzt eine Breite von 0 haben. (b/231707291)

Version 1.0.0-alpha11

11. Mai 2022

androidx.compose.material3:material3:1.0.0-alpha11 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 werden veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.

Neue Funktionen

  • RangeSlider wurde zu Material 3 (I18e38) hinzugefügt.
  • Unterstützung für Material3-AssistChip und InputChip hinzugefügt (I0d25a)
  • Unterstützung für Material3-FilterChip und SuggestionChip hinzugefügt (I9fdf3)

API-Änderungen

  • Die zusammensetzbare Funktion TextFieldDefaults.BorderStroke, mit der ein Rahmenstrich in OutlinedTextField gezeichnet wird, wurde in TextFieldDefaults.BorderBox umbenannt. (I5f295)
  • Visuelle Änderungen bei M3 (Iab30e)
  • Allow passing colors to the standard icon buttons. (Ia2445)

Fehlerkorrekturen

  • Lint-Prüfung für material3/Scaffold hinzufügen, um sicherzustellen, dass das innere Padding verwendet wird (I72293, b/226951418)

Version 1.0.0-alpha10

20. April 2022

androidx.compose.material3:material3:1.0.0-alpha10 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 werden veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

Neue Funktionen

  • material3-window-size-class ist eine neue Bibliothek, die Unterstützung für Fenstergrößenklassen bietet. Das sind eine Reihe von Ansichtsfenster-Breakpoints, die Ihnen als Grundlage für das Design, die Entwicklung und das Testen von anpassbaren Anwendungslayouts dienen. Mit calculateWindowSizeClass können Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche dargestellt werden soll. Bei größeren Fenstergrößen kann beispielsweise eine Navigationsleiste anstelle der unteren Navigation angezeigt werden. Weitere Informationen und Beispiele finden Sie in der API-Referenzdokumentation zu WindowSizeClass. Weitere Informationen zu den Definitionen der Fenstergrößenklassen finden Sie in der öffentlichen Anleitung zur Unterstützung verschiedener Bildschirmgrößen.

API-Änderungen

  • Fügt die Standard-UAS-Erhebung für BottomAppBar hinzu und entfernt das nachgestellte Lambda aus BottomAppBar mit UAS. (I92c47)
  • Fügt Material3-FilledIconButton, FilledTonalIconButton und OutlinedIconButton hinzu. (Ib2bda)
  • Die Material 3-Snackbar-API wurde aktualisiert, sodass Farbwerte für die optionale Aktion und die Schließen-Aktion akzeptiert werden. (Ibe4b4)
  • Die teilweise Nutzung (Down- oder Position) wurde in PointerInputChange eingestellt. Mit consume() können Sie die Änderung vollständig übernehmen. Mit isConsumed können Sie feststellen, ob die Änderung bereits von jemand anderem übernommen wurde.
  • PointerInputChange::copy() erstellt jetzt immer eine oberflächliche Kopie. Das bedeutet, dass Kopien von PointerInputChange verbraucht werden, sobald eine der Kopien verbraucht wird. Wenn Sie ein ungebundenes PointerInputChange erstellen möchten, verwenden Sie stattdessen den Konstruktor. (Ie6be4, b/225669674)
  • Änderungen an der Cards API, um die Container- und Inhaltsfarben über eine CardColors-Schnittstelle zu empfangen und einen deaktivierten Status für anklickbare Karten zu unterstützen. (I927df)
  • Der Parameter backgroundColor wurde in Material 3-Textfeldern in containerColor umbenannt, um die Konsistenz mit anderen Komponenten zu verbessern. (I6fbd9)

Fehlerkorrekturen

  • Aktualisierungen des Standard-IconButton, um es an die Material3-Spezifikation anzupassen. (I09eab)
  • Die Höhe der oberen Leiste von Material3 Scaffold wird in das Padding verschoben, das an „content“ übergeben wird. So kann der Inhalt unter der oberen App-Leiste gerendert werden. Wenn die PaddingValues ignoriert werden, kann der Inhalt durch die obere Leiste verdeckt werden. (I83cbc, b/217776202)

Version 1.0.0-alpha09

6. April 2022

androidx.compose.material3:material3:1.0.0-alpha09 wird veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.

Neue Funktionen

  • Material 3-Schalter-API (I2c3ad) hinzugefügt

API-Änderungen

  • Unterstützung für Drop-down-Menüs mit Textfeldern (auch als „offengelegte Drop-down-Menüs“ oder „Kombinationsfelder“ bezeichnet) hinzugefügt. (I1b832)
  • Dem MaterialTheme- und Shape-Subsystem wurde ein Formparameter hinzugefügt. (I37426)
  • ExtendedFloatingActionButton wurde ein erweiterter Parameter hinzugefügt, um zu steuern, ob das FAB maximiert oder minimiert wird. Zwischen den einzelnen Status werden Animationen angezeigt. Für erweiterte UASs ohne Symbol wurde eine Überladung für erweiterte UASs mit nachfolgendem Text hinzugefügt. (Iba7f1)

Version 1.0.0-alpha08

23. März 2022

androidx.compose.material3:material3:1.0.0-alpha08 wird veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.

Neue Funktionen

API-Änderungen

  • Standardtrennlinie für das Menü hinzufügen (I01374)
  • Der Klasse ColorScheme wurde der Farbparameter surfaceTint hinzugefügt. (I2f558)

Fehlerkorrekturen

  • Der Standardwert für den Textstil der Material3-Schaltfläche wird jetzt aus dem MaterialTheme gelesen. (Ie62fc)

Version 1.0.0-alpha07

9. März 2022

androidx.compose.material3:material3:1.0.0-alpha07 wird veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

API-Änderungen

  • Aktualisierungen der Material 3 Surface API, durch die die überladenen Funktionen für klickbare Surfaces zurückkehren. Außerdem wurde eine Funktion zur Unterstützung von auswählbaren und umschaltbaren Surfaces hinzugefügt. (I4bf18)
  • LazyVerticalGrid und LazyHorizontalGrid sind jetzt stabil. (I307c0)
  • LazyVerticalGrid/LazyHorizontalGrid und alle zugehörigen APIs wurden in das Unterpaket „.grid“ verschoben. Aktualisieren Sie Ihre Importe von „androidx.compose.foundation.lazy“ zu „androidx.compose.foundation.lazy.grid“. (I2d446)
  • Die vorherige Änderung, bei der nur eine Ansicht für WindowInsetsControllerCompat verwendet wurde, wurde rückgängig gemacht. Es ist wieder ein Fenster erforderlich, das für die Verwaltung einiger Fenster-Flags benötigt wird. ViewCompat.getWindowInsetsController wurde zugunsten von WindowCompat.getInsetsController eingestellt, um sicherzustellen, dass das richtige Fenster verwendet wird (z. B. wenn sich die Ansicht in einem Dialogfeld befindet). (I660ae, b/219572936)
  • Eine neue LazyVerticalGrid API zum Definieren von Größen für die Querachse wurde hinzugefügt (I17723).

Fehlerkorrekturen

  • Aktualisierungen der Card API aufgrund von Änderungen an der Surface API (I3c8b9)

Version 1.0.0-alpha06

23. Februar 2022

androidx.compose.material3:material3:1.0.0-alpha06 wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

  • NavigationDrawerItem wird hinzugefügt und steht für ein einzelnes Ziel in den Drawern (Ic396f, b/218286829).
  • PermanentNavigationDrawer und DismissibleNavigationDrawer wurden als experimentelle APIs hinzugefügt. Das sind die Schubladen, die sich gut für Geräte mit großen Bildschirmen eignen. (I5f8ab, b/218286829)
  • Unterstützung für die untere App-Leiste von Material 3 hinzugefügt (Ic432a)
  • NavigationDrawer wurde in ModalNavigationDrawer umbenannt (I1807d, b/218286829)
  • Material 3-Slider-Klasse und ‑Tokens hinzugefügt (I1ccee)
  • Die Tab-Implementierung wurde hinzugefügt. Informationen zur Beispielverwendung finden Sie in der Dokumentation (Ie0146).

Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das bei der linearen Navigation mit dem TalkBack-Screenreader ein leerer Titel der oberen App-Leiste ausgewählt wurde. (Id4690)
  • IconSize wurde zu FloatingActionButtonDefaults hinzugefügt. (Ia71cf)
  • Fehlerbehebung für ausgeblendete AlertDialog-Schaltflächen, wenn mit einem LazyColumn langer Text hinzugefügt wird. (Ib2cc9, b/216663029)

Version 1.0.0-alpha05

9. Februar 2022

androidx.compose.material3:material3:1.0.0-alpha05 wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

Material Design 3-Komponenten hinzugefügt

API-Änderungen

  • Die eingestellte Funktion Surface, die einen onClick-Callback verwendet. Klickbare Oberflächen sollten mit einem InteractionSource und einem Modifier.clickable() erstellt werden. (I211c6)
  • Unterstützung für die Erhebung von „Gedrückt“ und „Fokus“ für den schwebenden Aktionsbutton hinzugefügt. (Ibb584)
  • Die Surface API wurde so geändert, dass sie eine InteractionSource empfängt, mit der ihr Erscheinungsbild in verschiedenen Status gesteuert werden kann. (Iafbc8)

Fehlerkorrekturen

  • Fehlende tertiäre Farben in dynamischen Farbschemas wurden hinzugefügt (I456c4, b/214588434).

Version 1.0.0-alpha04

26. Januar 2022

androidx.compose.material3:material3:1.0.0-alpha04 wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

API-Änderungen

  • NonRestartableComposable wurde Methoden hinzugefügt, die Überladungen vorhandener Methoden ohne komplexe Logik sind. Dadurch werden die vom Compiler generierten Memoization-Prüfungen (equals) für alle Parameter reduziert, die in der aufgerufenen inneren Funktion wiederholt werden. (I90490)
  • Material 3-Trennlinie hinzugefügt. (Ica5fc)
  • Markieren Sie das Checkbox- und das RadioButton-Element mit einer experimentellen API-Annotation. (Ie44bb)
  • Unterstützung für Material 3-Statusanzeigen hinzugefügt. (Iff232, b/205023841)

Fehlerkorrekturen

  • Die Farbe eines deaktivierten TextButton's-Containers wird auf „transparent“ aktualisiert (I6b248, b/213339737).

Version 1.0.0-alpha03

12. Januar 2022

androidx.compose.material3:material3:1.0.0-alpha03 wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Fehlerkorrekturen

Abhängigkeitsupdates

  • Jetzt von Kotlin 1.6.10 abhängig.

Version 1.0.0-alpha02

1. Dezember 2021

androidx.compose.material3:material3:1.0.0-alpha02 wird veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

  • Unterstützung für Checkboxen und Optionsfelder hinzugefügt.
  • Aktualisiert, um mit Kotlin 1.6.0 kompatibel zu sein

API-Änderungen

  • Entfernen Sie die Schublade aus dem Scaffold von Material 3. (I04f51)
  • Unterstützung für Material 3 Checkbox wird hinzugefügt. (Id5542)
  • Unterstützung für Material 3 RadioButton wird hinzugefügt. (I20334)

Fehlerkorrekturen

  • Reduziere den Welleneffekt-Radius von IconButton von 40 dp auf 20 dp. (I68bbe, b/206674345)
  • Der Fast Path für den Port-String für Text ändert sich von compose.material (I30b03)
  • Es wurde behoben, dass die hartcodierte Schaltfläche immer aktiviert war. (Iea832, b/205335456)

Version 1.0.0-alpha01

27. Oktober 2021

androidx.compose.material3:material3:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Material Design 3-Thematisierung und dynamische Material You-Farben

Material Design 3-Komponenten

Weitere Informationen finden Sie im Abschnitt Material Design 3 und Material You im Leitfaden „Material-Theming in Compose“.