Material 3 zusammenstellen

Jetpack Compose-UIs mit Material Design 3 Components erstellen, der nächsten Entwicklung des Material Design Material 3 enthält aktualisierte Designs und Komponenten sowie Funktionen zur Personalisierung von Material You wie dynamische Farben. Das Produkt wurde so entwickelt, dass es zum visuellen Stil und zur System-UI von Android 12 passt.
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alpha-Release
26. Juni 2024 1.2.1 - 1.3.0-beta04 -

Gebäude

Compose besteht aus sieben Maven-Gruppen-IDs innerhalb von androidx. Jede Gruppe umfasst eine bestimmte Teilmenge von Funktionen mit jeweils eigenen Versionshinweisen.

In dieser Tabelle werden die Gruppen und Links zu den einzelnen Versionshinweisen erläutert.

GruppeBeschreibung
compose.animation:Animationen in den Jetpack Compose-Anwendungen erstellen, um die User Experience zu bereichern
compose.compiler@Composable-Funktionen transformieren und Optimierungen mit einem Kotlin-Compiler-Plug-in aktivieren.
compose.foundationSchreiben Sie Jetpack Compose-Anwendungen mit gebrauchsfertigen Bausteinen und erweitern Sie die Grundlage für den Aufbau Ihrer eigenen Designsysteme.
compose.materialJetpack Compose-UIs mit einsatzbereiten Material Design-Komponenten erstellen Dies ist der übergeordnete Einstiegspunkt von Compose. Hier werden Komponenten bereitgestellt, die den unter www.material.io beschriebenen Komponenten entsprechen.
compose.material3 einfügenJetpack Compose-UIs mit Material Design 3 Components erstellen, der nächsten Entwicklung des Material Design Material 3 enthält aktualisierte Designs und Komponenten sowie Funktionen zur Personalisierung von Material You wie dynamische Farben. Das Produkt wurde so entwickelt, dass es zum visuellen Stil und zur System-UI von Android 12 passt.
compose.runtimeGrundlegende Bausteine des Programmiermodells und der Statusverwaltung von Compose sowie die zentrale Laufzeit für das Compose-Compiler-Plug-in.
compose.uiGrundlegende Komponenten der Benutzeroberfläche zum Schreiben von E-Mails, die für die Interaktion mit dem Gerät erforderlich sind, darunter Layout, Zeichnen und Eingabe

Abhängigkeiten deklarieren

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

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

Groovig

dependencies {
    implementation "androidx.compose.material3:material3:1.2.1"
    implementation "androidx.compose.material3:material3-window-size-class:1.2.1"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0-beta03"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.2.1")
    implementation("androidx.compose.material3:material3-window-size-class:1.2.1")
    implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0-beta03")
}

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

Dein Feedback hilft uns, Jetpack zu verbessern. Teilen Sie uns mit, wenn Sie neue Ausgaben entdecken oder Verbesserungsvorschläge für diese Bibliothek haben. Bitte sieh dir die vorhandenen Probleme in dieser Bibliothek an, bevor du eine neue erstellst. Sie können einem vorhandenen Problem Ihre Stimme hinzufügen, indem Sie auf die Sternschaltfläche 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 wurden veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Designlose Komponenten, die zum Erstellen von Material Design-Komponenten verwendet 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 wurden veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.

API-Änderungen

  • Navigationssuite-APIs nicht experimentell verwenden (If62af)

Fehlerkorrekturen

  • Einfügungen für Inhalte standardmäßig verarbeiten (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 wurden veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

  • Füge containerColor und contentColor zu NavigationSuiteScaffoldDefaults hinzu. (I64e3a, b/331993720)
  • Die Funktion itemColors wird zu NavigationSuiteDefaults hinzugefügt. (Idf719, b/328480012)
  • NavigationSuiteScope verschließen. (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 wurden 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 wurden veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Aktualisierung der Abhängigkeiten

  • Adaptive Material3-Abhängigkeiten auf die neuen Modulpfade aktualisieren. (Ibc421)
  • Migrieren Sie, um die Fenstermanager-Version der Fenstergrößenklassen zu verwenden. (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 wurden veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

  • Paketnamen von „Navigationssuite“ auf „Navigationssuite“ aktualisieren (I7eff7)
  • Material3-Komponenten, die eine MutableInteractionSource in ihrer API offenlegen, wurden aktualisiert. Sie enthalten jetzt eine MutableInteractionSource, für die Nullwerte zulässig sind, die standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn „null“ übergeben wird, bedeutet das, dass das MutableInteractionSource nicht gezogen werden soll. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf null ändern, können einige Komponenten niemals ein MutableInteractionSource zuweisen. Andere Komponenten können eine Instanz nur bei Bedarf langsam erstellen, wodurch die Leistung dieser Komponenten verbessert wird. Wenn Sie die MutableInteractionSource nicht verwenden, die Sie an diese Komponenten übergeben, empfiehlt es sich, stattdessen null zu übergeben. Es wird auch empfohlen, ähnliche Änderungen an 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 wurden veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

Fehlerkorrekturen

  • Die Navigationskomponente wurde korrigiert, die den gesamten Bildschirm ausfüllt, wenn die Stammoberfläche modifier.fillMaxSize enthält. (c9cf250, b/312664933)

Version 1.0.0-alpha01

15. November 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 wurde 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 wurden veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.

Neue Funktionen

  • Zusätzliche Verhaltensoptionen für die Rückwärtsnavigation von ThreePaneScaffoldNavigator hinzugefügt. (I858aa)
  • Dem Navigationsverlauf wurden optionale Inhalte zu Zielen 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 wurden veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Verlaufsbewusstsein bei der Scaffold-Navigation und Wertberechnung unterstützen (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 wurden veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Edge-to-Edge-Unterstützung in Fenster-Gerüsten (I1b462) hinzugefügt

API-Änderungen

  • Die Eigenschaften der Scharniergrenzen in Posture wurden in eine Liste mit Scharnierinformationen verschoben (I24f90).

Fehlerkorrekturen

  • Fehlerbehebung: AnimatedPane wurde nicht neu zusammengesetzt (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 wurden veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

  • Scaffold-Rollen in Aliasse von ThreePaneScaffoldRole ändern. (I65bd1)
  • Basisklasse für Scaffold-Rollen erstellen (I4784d)
  • Entfernen Sie unnötige Parameter aus dem Inhalt 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 wurden veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

API-Änderungen

  • Navigations-APIs von adaptiven Scaffold-APIs trennen (IC4045)
  • GutterSize Kurs entfernen. (I785b3)

Fehlerkorrekturen

  • Fehlerbehebungsbereiche 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 wurde veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Material3 Adaptive Condition APIs:

APIs für das Gerüst für adaptive Fenster von Material3:

Adaptive Panel Scaffold APIs von Material3:

Compose Material3 Version 1.3

Version 1.3.0-beta04

26. Juni 2024

androidx.compose.material3:material3-*:1.3.0-beta04 wurde 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 wurde veröffentlicht. Version 1.3.0-beta03 enthält diese Commits.

Externer Beitrag

  • androidx.compose.material3.DropdownMenu aus gemeinsamem Quellsatz verfügbar machen. (If62c0)

Version 1.3.0-beta02

29. Mai 2024

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

API-Änderungen

  • Modifier.pullToRefreshIndicator unterstützt Höhendaten. Aktualisieren Sie „Pull To Refresh APIs“ so, dass sie einen booleschen Wert anstelle einer Lambda-Funktion aktiviert haben. Abgleich von Supportinhalten in PullToRefreshBox (I75679)
  • TooltipScope zu einer versiegelten Schnittstelle machen und eine interne Implementierung zur Verwendung in TooltipBox und Label erstellen. (I3833e)
  • CarouselItemScope wurden zwei neue Modifikatoren hinzugefügt: maskClip und maskBorder, um ganz einfach eine Form und einen Rahmen zu einem Karussellelement hinzuzufügen (Id67a1).
  • TimePickerState ist jetzt eine Benutzeroberfläche und ermöglicht das Einstellen der Uhrzeit (I88546).
  • Die API zum Gestalten der Links wurde aktualisiert: TextLinkStyles wurde in TextStyle verschoben und TextDefaults aus Material entfernt. (I5477b)

Fehlerkorrekturen

  • Die Symbole für den Status von ModalBottomSheet und die Navigationsleiste reagieren jetzt auf den Status des dunklen Designs. (Ie1fe7, b/338342149)
  • Dem Scrum ModalBottomSheet wurde eine Semantik für das Schließen von Tabellenblättern hinzugefügt. (0e61cb,b/328801864)

Externer Beitrag

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

Version 1.3.0-beta01

14. Mai 2024

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

API-Änderungen

  • Verwendung von DpSize anstelle von CaretProperties. CaretProperties wird entfernt. Benennen Sie CaretScope in TooltipScope um. (Id9a76)
  • Die API zum Erhalten von Material-Links im Text wurde aktualisiert. Insbesondere wurden die Methoden aus dem TextDefaults zum Erstellen von themenbezogenen LinkAnnotations und zum Parsen von HTML mit themenbezogenen Links entfernt. Stattdessen wurde eine TextLinkStyles-Klasse hinzugefügt, mit der die Links als Parameter für die zusammensetzbare Textfunktion gestaltet werden können. (I31b93)

Version 1.3.0-alpha06

1. Mai 2024

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

Nicht abwärtskompatible Änderungen

  • Neue APIs zum Aktualisieren nach Ziehen:

    • PullToRefreshState wurde so vereinfacht, dass anstelle von Dp-Einheiten Bruchwerte verwendet werden.
    • Der Status isRefreshing wird vom Nutzer anstelle von PullToRefreshState gesteuert.
    • Die verschachtelte Scroll-Verbindung wurde von PullToRefreshState getrennt. Sie wird vom neuen PullToRefreshBox oder Modifier.pullToRefresh verarbeitet.
    • Dieses Update stellt eine funktionsgefährdende Änderung zu früheren experimentellen APIs dar. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)

API-Änderungen

  • RippleConfiguration#isEnabled wurde entfernt und LocalRippleConfiguration kann jetzt Nullwerte enthalten. Wenn Sie eine Verbreitung deaktivieren möchten, geben Sie null an LocalRippleConfiguration an, anstatt RippleConfiguration mit isEnabled = false anzugeben. (I22725)
  • Mit „ModalBottomSheet“ wird das Gitter genauer über die Statusleiste gezeichnet, wenn „Edge-to-Edge“ aktiviert ist. Modales Tabellenblatt am unteren Rand kann jetzt Fenstereinfügungen verarbeiten, wodurch sichtbare Inhalte über der Navigationsleiste sichtbar sind. Der ModalBottomSheet-Parameter windowInsets wurde in contentWindowInsets umbenannt, um anzugeben, wo die Einfügungen angewendet werden. Diese sind nicht mehr an die Fensterlogik gebunden. Der Typ contentWindowInsets wurde in eine Funktion geändert, die WindowInsets zurückgibt, damit der Wert in einem neuen Fenster aufgelöst werden kann. (I39630, b/274872542, b/300280229, b/290893168)
  • Für PrimaryScrollableTabRow und SecondaryScrollableTabRow wird jetzt ein benutzerdefiniertes Layout anstelle von Unterzusammensetzung verwendet. Dadurch sollte die Leistung verbessert werden. (I991e0)
  • Die Stiloption für Textlinks wurde neben der normalen Gestaltung auch gedrückt, wenn der Mauszeiger darauf bewegt wurde und der Text hervorgehoben wurde. TextDefaults-Methoden haben jeweils ein pressedStyle-Argument erhalten, um dies zu unterstützen. (IC473f, b/139312671)

Fehlerkorrekturen

  • Die Ziehanker in der Navigationsleiste entsprechen jetzt der Breite von drawerContent. (Ibc72f, b/245355396)
  • Der obere Abstand von OutlinedTextField für das Label berücksichtigt jetzt die Schriftgröße des Systems. (Idc781)
  • Korrigierter Paketspeicherort von CalendarLocale. (Ifa235)
  • [Vorhersagbare Zurück-Animation] Aktualisieren Sie die Vorhersageanimationen mit der Interpolationskurve von (0,1, 0,1, 0, 1) (I2591a).

Version 1.3.0-alpha05

17. April 2024

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

Neue Funktionen

  • SearchBar und DockedSearchBar haben neue Überlastungen, die einen Textfeldparameter verwenden. Auf diese Weise können Sie das Textfeld unabhängig vom Rest der Suchleiste gestalten und benutzerdefinierte Textfelder übergeben. Das Textfeld der aktuellen Implementierung ist jetzt als SearchBarDefaults.InputField verfügbar. (I50c73, b/275074248, b/278773336, b/326627700)
  • Die Lambda-drawTick wurde der öffentlichen API hinzugefügt, um die Ticks bei Bedarf anzupassen (I0c048).

API-Änderungen

  • Textlinks wurden neben dem normalen Stil auch mit der Gestaltungsoption „gedrückt“ angezeigt (I5f864, b/139312671)
  • CarouselItemInfo wurde aktualisiert, um eine Maske Rect anzuzeigen, durch die das Element abgeschnitten wird (I785d8).
  • BasicTooltipState wurde aus der Material 3 Public API entfernt. Die Funktionalität wird mit TooltipState kombiniert, bis BasicTooltip der Foundation stabilisiert ist. (ICDa29)
  • Es wurde ein TextDefaults-Objekt hinzugefügt, das Methoden zum Erstellen einer LinkAnnotation und zum Parsen von HTML-getaggten Strings enthält, die MaterialTheme auf die Links anwenden (I98532, b/139312671).
  • ExposedDropdownMenuBoxScope lässt keine Unterklassen mehr zu. Sichtbare Drop-down-Menüs weisen jetzt einen MenuAnchorType auf, der an menuAnchor übergeben werden sollte, um eine bessere Barrierefreiheit zu ermöglichen. Dies sollte verwendet werden, anstatt focusable an die mittlerweile eingestellte ExposedDropdownMenu zu übergeben. menuAnchor hat einen neuen Parameter zur Steuerung des enabled-Status. (I55ee6, b/257209915, b/308840226)
  • Die Rahmenfarbe von OutlinedButton wurde korrigiert, wenn sie deaktiviert war. ButtonDefaults.outlinedButtonBorder("enabled")-Überlastung hinzugefügt, die den aktivierten Status annimmt. (Ie650b, b/318461363)
  • Eine neue CarouselItemInfo-Klasse wurde hinzugefügt, damit Kunden Informationen zu den Artikelgrößen abrufen können. (I9070c)
  • Der ColorScheme-Konstruktor ohne Oberflächencontainer wurde verworfen. Migrieren Sie zum Konstruktor, der Oberflächencontainer enthält. (I35c11)
  • [Outlined]TextFieldDefaults ContainerBox wurde in Container umbenannt. (IE8d3b)

Fehlerkorrekturen

  • BottomSheetScaffold scrollt nicht mehr vom verschachtelten Scrollen aus, wenn sheetSwipeEnabled „false“ ist. (I5e1c1, b/306464779)
  • Einige ExperimentalMaterial3Api-OptIn-Hinweise in IconButtonSamples.kt wurden entfernt. (I111d1)

Version 1.3.0-alpha04

3. April 2024

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

Neue Funktionen

  • Es wurden zwei experimentelle Versionen von Material3 Carousel hinzugefügt: HorizontalMultiBrowseCarousel und HorizontalUncontainedCarousel (I88d64).
  • M3-Navigationsleiste verfassen (ModalDrawerSheet und DismissibleDrawerSheet) wurde aktualisiert, um Predictive Back auf U+ als Opt-in zu unterstützen (Ie5b0b)
  • In Icon wurde eine neue API hinzugefügt, mit der eine Farbfärbung als Lambda übergeben werden kann, um eine Neuzusammensetzung zu vermeiden. (I5b5a2)
  • APIs der oberen App-Leiste unterstützen jetzt benutzerdefinierte Höhen für feste und minimierbare Bereiche. (Ib8b0c, b/323403446)

API-Änderungen

  • APIs der oberen App-Leiste unterstützen jetzt benutzerdefinierte Höhen für feste und minimierbare Bereiche. Ein Problem wurde behoben, bei dem einzeilige obere 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 Schriftart-/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 verworfenen Enums DismissDirection und DismissValue sowie APIs wurden entfernt. (I89ccd)
  • Dem Companion-Objekt CarouselState des Karussells wurde ein Test-Tag hinzugefügt. (I94154)
  • LocalMinimumInteractiveComponentEnforcement wurde eingestellt und als Ersatz LocalMinimumInteractiveComponentSize eingeführt. (I7a7ac)
  • Der Konstruktor SearchBarColors ist jetzt öffentlich. (I769ca)
  • Der Parameter gesturesEnabled wurde zu SwipeToDismissBox hinzugefügt. (Idc59f, b/324170119)
  • Textfeld-APIs, die als veraltet und experimentell gekennzeichnet waren, wurden entfernt. (I1305f)

Version 1.3.0-alpha03

20. März 2024

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

Wichtige Änderungen am Design

  • Aktualisieren Sie das Fokusstatus-Overlay auf 0,1f, 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

  • Parameter zur Anpassung von ExposedDropdownMenu wurden hinzugefügt. Insbesondere haben Menüs jetzt einen focusable-Parameter (Standardeinstellung true), der auf false gesetzt werden sollte, wenn mit bearbeitbaren Textfeldern gearbeitet wird. (I4184c, b/323694447, b/278609042)

API-Änderungen

  • Das Flag ScaffoldSubcomposeInMeasureFix wurde entfernt. (Ie2a4b)
  • NavigationRailItemColors ist jetzt als @Immutable gekennzeichnet. (If6112, b/327660613)
  • NavigationBarItemColors ist jetzt als @Immutable gekennzeichnet. (I42a30, b/298064514)
  • Parameter in zusammensetzbaren Schieberegler-Tracks neu anordnen (I9f315)
  • ExposedDropdownMenu ist jetzt mit Popup implementiert. Das Verhalten sollte gleich sein, mit der Ausnahme, dass fokussierbare Menüs mit bearbeitbaren Textfeldern bei der Eingabe über die Tastatur ausgeblendet werden können.

Fehlerkorrekturen

  • Die Referenzrollen für Surface- und Surface-Container wurden leicht angepasst, sodass helle und dunkle Designs stärker verfärbt werden. (I677a5)
  • Farben für Schieberegler und ProgressIndicator wurden aktualisiert, um den neuen Spezifikationen für Nicht-Text-Kontrast zu entsprechen. (I26807)
  • Aktualisieren Sie das Fokusstatus-Overlay auf 0,1f, 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 wurde veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.

API-Änderungen

  • Die Schiebereglerstatus werden wieder stabil gestellt. State.onValueChangeFinished noch einmal als Wert festlegen. onValueChangeFinished wird in rememberUpdatedState eingeschlossen. (I82ab2, b/322269951)
  • Die Navigationskomponenten verwenden jetzt die neuen SurfaceContainer-Rollen. DrawerDefaults bietet jetzt unterschiedliche standardContainerColor- und modalContainerColor-Attribute. DrawerDefaults.ModalDrawerElevation ist jetzt 0.dp. (I7fbac)
  • @Stable wird aus den Status von Slider entfernt, da state.onValueChangeFinished in var geändert wird. (Ied34a, b/322269951)
  • Die Animationsspezifikation von ModalBottomSheet und StandardBottomSheet ist jetzt TweenSpec und wurde anhand einer Frühlingsanimation aktualisiert. Dies behebt ein Problem mit einer sichtbaren Überlappung. Veraltete SheetState-Konstruktoren ohne Dichte wurden entfernt. (I7babc, b/285847707)

Fehlerkorrekturen

  • SurfaceContainer-Varianten werden jetzt von Komponenten verwendet. Komponenten, die die Farbe formell mit Surface und TonalElevation berechnet haben, verwenden jetzt standardmäßig SurfaceContainer-Rollen, die von der Höhentonhöhe nicht betroffen sind. (b/304584161)
  • Es wurde ein Fehler behoben, durch den die nicht ausgewählte, deaktivierte Containerfarbe von ElevatedFilterChip zu Schwarz wurde. (I400e6, b/322407043)
  • Unbestimmte Fortschrittsanzeige korrigieren, 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 die Rundung per Gleitkommazahl ungenau sein kann. (IC918a, b/324934900)
  • Achte darauf, dass die Schaltflächen von DatePickerDialog angezeigt werden, wenn du eine DateRangePicker verschachtelst oder wenn eine beliebige Art von Datumsauswahl auf kleinen Bildschirmen mit größerer Schrift angezeigt wird. (Ie4758, b/325107799, b/277768544)
  • Menu verwendet jetzt die Rolle SurfaceContainer für die Containerfarbe. MenuDefaults.TonalElevation ist jetzt 0.dp. (I135b7)
  • TextField verwendet jetzt die Rolle SurfaceContainerHighest für die Containerfarbe. (I4dced)
  • Erhöhte Chips nutzen jetzt die Rolle SurfaceContainerLow (I7cd2f)
  • Die Containerfarbe „DatePicker“ ist jetzt SurfaceContainerHigh. DatePickerDefaults.TonalElevation ist jetzt 0.dp. (Ida753)
  • Aktualisiert die Farbe des Containers am unteren Rand und die Ziehpunktfarbe. (I72a0a)
  • Die Containerfarbe „RichTooltip“ ist jetzt SurfaceContainer. (Ia8b45)
  • Die Containerfarbe „SearchBar“ ist jetzt SurfaceContainerHighest. SearchBarDefaults.TonalElevation ist jetzt 0.dp. (I88604)
  • Der Schalter für Updates ist deaktiviert und die Auswahl der Tracks/Symbole ist deaktiviert, um die Farbrolle SurfaceContainerHighest zu nutzen. (I7687a)
  • Die Containerfarbe „AlertDialog“ ist jetzt SurfaceContainerHigh. (IE0433)
  • Die Containerfarbe „BottomAppBar“ ist jetzt SurfaceContainer. Die Farbe TopAppBar „onScroll“ ist jetzt „SurfaceContainer“. (I41630)
  • Die Containerfarbe „ElevatedCard“ ist jetzt SurfaceContainerLow. Die Containerfarbe von FilledCard (SurfaceContainerHighest). (I35141)
  • Die Containerfarbe „ElevatedButton“ ist jetzt SurfaceContainerLow. Nicht ausgewählte FilledIconButton haben jetzt die Containerfarbe SurfaceContainerHighest. (I792c9)
  • Die Rolle „TimePicker“ für die Containerfarbe und die Farbe des Zifferblatts wurde zu SurfaceContainerHighest geändert. (I43b93)

Version 1.3.0-alpha01

21. Februar 2024

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

Neue Funktionen

  • Aktualisieren Sie Compose M3 ModalBottomSheet zur Unterstützung von Predictive Back auf U+ (Iccf32, b/281967264, b/304850357)
  • Compose M3 SearchBar wurde aktualisiert, um Predictive Back auf U+ zu unterstützen (I657f8)
  • Der Schieberegler wurde aktualisiert, um die Barrierefreiheit durch Hinzufügen einer Lücke und Stoppanzeige zu verbessern. (I3058e)
  • ProgressIndicator wurde aktualisiert, um die Barrierefreiheit durch Hinzufügen einer Lücke und Stoppanzeige zu verbessern. (I21451)
  • Mit der neuen API für ausführliche Kurzinfos kann jetzt ein Standard-Caret für umfassende Kurzinfos hinzugefügt werden, um mit dem Anker LayoutCoordinates ein benutzerdefiniertes Caret-Zeichen zu zeichnen. (Ifd42c)

Änderungen im Verhalten

  • Materialkomponenten wurden migriert, um die neuen Ripple-APIs zu verwenden und nicht mehr RippleTheme abzufragen.

API-Änderungen

  • Der Spaß „drawStopIndicator“ ist jetzt öffentlich. (I3f59f)
  • Funktion formatWithSkeleton von DatePicker als intern markieren (Ic65dc)
  • DropdownMenu unterstützt jetzt benutzerdefinierte Farben, Formen, Höhen und Rahmen. (I8e981, b/289554448, b/301887035, b/283654243)
  • Material3-Komponenten, die eine MutableInteractionSource in ihrer API offenlegen, wurden aktualisiert. Sie enthalten jetzt eine MutableInteractionSource, für die Nullwerte zulässig sind, die standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn „null“ übergeben wird, bedeutet das, dass das MutableInteractionSource nicht gezogen werden soll. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf null ändern, können einige Komponenten niemals ein MutableInteractionSource zuweisen. Andere Komponenten können eine Instanz nur bei Bedarf langsam erstellen, wodurch die Leistung dieser Komponenten verbessert wird. Wenn Sie die MutableInteractionSource nicht verwenden, die Sie an diese Komponenten übergeben, empfiehlt es sich, stattdessen null zu übergeben. Es wird auch empfohlen, ähnliche Änderungen an Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146)
  • Fügt RippleConfiguration und LocalRippleConfiguration hinzu, um die Ripples-Anpassungen pro Komponente / Unterstruktur mithilfe fester Werte zu ermöglichen. Zum Beispiel, um die Farbe einer Komponente zu ändern, die Sie nicht steuern, oder um eine Welle für eine Komponente zu deaktivieren. In den meisten Fällen sollten die Standardwerte verwendet werden: Diese APIs sind eine Ausstiegsmöglichkeit für die Anpassung einzelner Komponenten bzw. begrenzter Unterstrukturen. Bei umfassenderen Änderungen und benutzerdefinierten Designsystemen sollten Sie stattdessen mit createRippleModifierNode eine eigene Welle erstellen. (I7b5d6, b/298048146)
  • Fügt eine neue Ripple API in material3 hinzu, die das verworfene rememberRipple ersetzt. Außerdem wird eine temporäre CompositionLocal (LocalUseFallbackRippleImplementation) hinzugefügt, damit Material3-Komponenten wieder die eingestellten rememberRipple / RippleTheme-APIs verwenden. Diese Funktion wird in der nächsten stabilen Version entfernt und dient nur als vorübergehende Migrationshilfe für Fälle, in denen du eine benutzerdefinierte RippleTheme bereitstellst. (I34cbc, b/298048146)

Fehlerkorrekturen

  • Die Unterzusammensetzung in ModalBottomSheet wurde zur Leistungsverbesserung entfernt. ModalBottomSheet konnte in bestimmten Szenarien in Kombination mit LookaheadScope abstürzen. Dieses Problem wurde behoben. (I2a198)
  • Die Unterzusammensetzung in BottomSheetScaffold wurde zur Leistungsverbesserung entfernt. BottomSheetScaffold wurde in bestimmten Szenarien in Verbindung mit LookaheadScope abgestürzt. Dieses Problem wurde behoben. (IE6401)
  • Die Ausrichtung des Logos wird so angepasst, dass es näher an der Mitte des Ankerinhalts in Bezug auf die obere rechte Ecke liegt. (I18a28)
  • Behebung eines a11y-Problems mit DateRangePicker, bei dem Nutzern der Screenreader, der Schalterzugriff und Voice Access der Texttitel Monat und Jahr als umsetzbar erklärt wurde. (I2ac55)
  • Fehler bei der Bestellung des mediumTopAppBarColors-Parameters wurde behoben. (Ibe64a)

Version 1.2

Version 1.2.1

6. März 2024

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

Fehlerkorrekturen

  • Mache die Status des Schiebereglers wieder stabil. State.onValueChangeFinished noch einmal als Wert festlegen. onValueChangeFinished wird in rememberUpdatedState eingeschlossen. (Ie8fd0, b/322269951)
  • @Stable wird aus den Status von Slider entfernt, da state.onValueChangeFinished in var geändert wird. (I82ba1, b/322269951)
  • Korrigieren Sie NavigationBar benutzerdefinierte Farben, um sie aus den Standardeinstellungen zu kopieren. (80a779, b/326894020)
  • Korrektur der Regression in ExposedDropdownMenu, um sie wieder fokussierbar zu machen (3fcec1, b/323694447)
  • Problem mit Schaltflächenfarben-Caching beheben (3e5bbcb/327371655)

Version 1.2.0

7. Februar 2024

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

Bekanntes Problem

  • In PrimaryTabRow wurde im Rahmen einer Leistungsverbesserung ein Interop-Renderingfehler vom Typ „View-Compose“ eingeführt. Verwenden Sie als Behelfslösung TabRow mit TabRowDefaults.PrimaryIndicator.

Wichtige Änderungen seit Version 1.1.0

Neues Material Design 3-Komponenten

Verbesserungen an bestehenden Komponenten von Material Design 3.

Experimentelle APIs wurden auf stabile Version hochgestuft.

Leistungsverbesserungen

Version 1.2.0-rc01

24. Januar 2024

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

Fehlerkorrekturen

  • Fehler bei der Bestellung des mediumTopAppBarColors-Parameters wurde behoben. (Ibe64a)
  • Ein Fehler in 1.2.0-beta02 in CardDefaults.cardColors wurde behoben, bei dem contentColor nicht auf Basis des Parameterwerts containerColor aktualisiert wurde. (Iee041, b/319671246)
  • Ein Fehler in disabledContentColor, der in 1.2.0-beta02 eingeführt wurde, wurde behoben und eine kleine Optimierung hinzugefügt. (I6dda1, b/318428829)

Version 1.2.0-beta02

10. Januar 2024

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

Bekannter Fehler

  • Ein Programmfehler in IconButtonColors weist standardmäßig disabledContentColor einer Alphaversion (0.38f) von LocalContentColor und nicht der vom Nutzer angegebenen contentColor zu. Die Problemumgehung besteht darin, den disabledContentColor explizit festzulegen. Dieses Problem wird in der nächsten Version behoben.

API-Änderungen

  • Die Funktion zum Aktivieren von Kurzinfo-Carets für einfache Tooltip APIs wurde hinzugefügt. (Ibf767)
  • SwipeToDismissState, rememberSwipeToDismiss und SwipeToDismissValue wurden in „_SwipeToDismissBox_“ umbenannt. (I68d6d)

Fehlerkorrekturen

  • Der ListItem-Wert für Abstände am Ende wurde korrigiert, um die Spezifikation einzuhalten (Ibd68b, b/305342674).
  • Umrissfarbe der umrissenen Karte ist jetzt OutlineVariant korrekt zugeordnet. (I75480, b/310979715)
  • Dynamische Farben werden jetzt aus systemdefinierten Farbrollen abgerufen. Dadurch wird der Kontrast für barrierefreie Inhalte verbessert und die dynamischen Farben besser an die Materialspezifikation angeglichen (I1de96).
  • Das ModalBottomSheet Back Handling unter Android T/13 und höher bei android:enableOnBackInvokedCallback="true" wurde korrigiert. (I728dc, b/306196110)

Version 1.2.0-beta01

13. Dezember 2023

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

API-Änderungen

  • TabIndicatorScope als zu testend markieren. (I45c88)
  • Verworfene experimentelle APIs werden für Kurzinfo entfernt. (I438cb)
  • Ändern Sie die neuen TabRow-Überlastungen so, dass keine Unterzusammensetzungen verwendet werden. Dies führt zu einer anderen Methode, um die TabRow-Indikatoren mit benutzerdefinierten Modifikatoren zu erstellen. (Ife741)
  • Die APIs DismissDirection und DismissValue werden eingestellt. Sie wurden zu SwipeToDismissValue zusammengeführt, dessen Werte sowohl die Position als auch die Richtung von SwipeToDismissBox angeben. DismissState.progress ist jetzt zwischen 0.0 und 1.0 als FloatRange gekennzeichnet. Die verworfenen Funktionen „Saver“ und „Konstruktor“ von DismissState wurden entfernt. SwipeToDismiss Komponente, Status und Standardobjekt wurden als experimentell gekennzeichnet. (Ib54f2)

Fehlerkorrekturen

  • Der Standardindikator für PullToRefresh ist jetzt ein offener Pfeil anstelle eines ausgefüllten Dreiecks. (I67be3)

Version 1.2.0-alpha12

29. November 2023

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

API-Änderungen

  • RangeSlider verwendet jetzt einen Kotlin-Bereich (z.B. 0f..1f) anstelle einer benutzerdefinierten FloatRange-Wertklasse. In SnapFlingBehavior.kt wird jetzt auch ein Kotlin-Bereich verwendet. (I025cb)
  • Markieren Sie die Funktionen der Modifikator-Werkseinstellungen als @Stable. (Ib109f)

Version 1.2.0-alpha11

15. November 2023

androidx.compose.material3:material3-*:1.2.0-alpha11 wurde 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

  • Kennzeichnen Sie SwipeToDismissBox DismissDirection und DismissValue als experimentell. (I517b0)
  • Benennen Sie SwipeToDismiss in SwipeToDismissBox um. Benenne 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. isFocusable und shouldDismissOnBackPress werden zu ModalBottomSheetProperties hinzugefügt. Mit diesen neuen booleschen Werten lässt sich festlegen, wie IME-Ereignisse in der modalen Ansicht am unteren Rand verarbeitet werden sollen. (Iea56f, b/278216859)
  • Die Status RangeSlider und Slider wurden aktualisiert, um initialOnValueChange, die Anfangspräfixe und geeignete Kdocs zu entfernen. (I57d30)
  • Die ChipBorder-Klasse und die zugehörigen Funktionsaufrufe werden eingestellt. Wir empfehlen, stattdessen direkt BorderStroke zu verwenden. (I89cc2)
  • Grundlagen-APIs sind jetzt @ExperimentalFoundationApi. (I30b0b)
  • TabRow und ScrollableTabRow wurden nicht mehr eingestellt. Die neue primäre und sekundäre Variante sind als experimentell gekennzeichnet. (I0def6)
  • Filter- und Eingabe-Chips verwenden jetzt direkt BorderStroke. (I07a8d)
  • SegmentedButton verwendet BorderStroke jetzt direkt. (I89b9b)
  • Die generische AlertDialog-Funktion wurde in BasicAlertDialog umbenannt und die vorherige Funktion wurde verworfen. (Idbe52)
  • Benennen Sie die SwipeToDismiss APIs in SwipeDismiss um und stufen Sie die neuen SwipeDismiss APIs zu „stable“ hoch. (I14cbe)
  • tonalElevation und shadowElevation werden zu Kurzinfo-APIs hinzugefügt. Außerdem werden die APIs TooltipBox, PlainTooltip und RichTooltip zurück in die Testphase verschoben, da sie versehentlich als stabil freigegeben wurden. (If0f66, b/293939035)
  • Experimentelle Chip-APIs auf stabile Version hochstufen (Iea2c3)
  • Die Anmerkung @ExperimentalMaterial3Api wurde aus den anklickbaren Karten in Material3 entfernt. (I88dbf)

Fehlerkorrekturen

  • Es wurde ein Problem 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 wurde veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.

API-Änderungen

  • Badge und BadgedBox werden auf stabile Version hochgestuft. (I67f16, b/261565132)
  • securePolicy wird als Parameter zu ModalBottomSheet hinzugefügt, damit Nutzer das Verhalten für WindowManager.LayoutParams.FLAG_SECURE definieren können. (Icdac8, b/296250262)
  • Es wurden neue Überlasten von LinearProgressIndicator und CircularProgressIndicator hinzugefügt, die progress als Lambda nutzen. Diese sollten leistungsstärker sein als die vorherigen Versionen. (I824e6, b/295616656)
  • Benennt StandardSizeClasses in AllSizeClasses um. (I8cb07)
  • Kombinieren Sie Berechnungsfunktionen von Fenstergrößenklassen. (ID 935)

Fehlerkorrekturen

  • Ein DatePicker-Absturz wurde behoben, der beim schnellen Klicken auf die Navigationspfeile aufgetreten ist, wenn der angezeigte Monat am Rand des zulässigen Zeitraums liegt. (I46f36, b/290954897, b/297002119)
  • [Nav rail/bar] Transparente Farbe für Indikatoren wird unterstützt. (Ie0a9b, b/267289987)

Version 1.2.0-alpha09

4. Oktober 2023

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

API-Änderungen

  • ModalNavigationDrawer und DismissibleNavigationDrawer wurden zur Verwendung der neuen AnchoredDraggable APIs migriert. Die animateTo von DrawerState wurde durch die Methoden „open“ und „close“ ersetzt und der Offset wird jetzt als Gleitkommazahl und nicht als Zustandsobjekt angezeigt. Sie können direkt über currentOffset auf das Offset zugreifen. (I0a72c)
  • Es wurden nicht zusammensetzbare Funktionen hinzugefügt, mit denen Sie DatePickerState und DateRangePickerState direkt erstellen können. Diese Funktionen können bei Bedarf als Alternative zu den zusammensetzbaren Funktionen rememberDatePickerState und rememberDateRangePickerState verwendet werden. (I70326, b/291524052)
  • TabRows mit festen und scrollbaren Elementen haben jetzt eine primäre und sekundäre Variante. Diese entsprechen der in Material3 definierten Farbe und dem Indikatorverhalten korrekt.
  • PrimaryScrollableTabRow und SecondaryScrollableTabRow zeigen jetzt den Scrollstatus an. (Iec8f5, b/260572337)
  • Es wurde ein neuer sheetMaxWidth-Parameter hinzugefügt, mit dem Entwickler eine maximale Breite angeben können, die das Tabellenblatt umfassen kann. „Dp.Nicht angegeben“ kann als Parameter übergeben werden, wenn ein Tabellenblatt gewünscht wird, das die gesamte Bildschirmbreite abdeckt. (Ifb7c9, b/266697696)
  • Die APIs PlainTooltipBox und RichTooltipBox werden wieder als eingestellte Methoden hinzugefügt. (I246fa)

Fehlerkorrekturen

  • Ein Absturz wurde behoben, der beim Initialisieren des DatePicker mit einem DatePickerFormatter-Element mit bestimmten Datumsskeletten gleich bleibt, wenn es in Datumsmuster konvertiert wird (z. B. YY). (I01f29)

Version 1.2.0-alpha08

20. September 2023

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

Wichtige Änderungen des Verhaltens

  • ColorScheme ist jetzt unveränderlich. Dadurch sind einzelne Farbaktualisierungen weniger effizient, während eine häufigere Verwendung von Farben effizienter ist. Der Grund für diese Änderung ist, dass die Aktualisierung einzelner Farben bei den meisten Apps nicht in erster Linie erforderlich wäre. Dies ist immer noch möglich, aber es wird mehr als zuvor zusammengefügt. Im Gegenzug verringern wir die Anzahl der Statusabos durch den gesamten Material-Code erheblich, was sich auf die Initialisierungs- und Laufzeitkosten von Standardanwendungsfällen auswirkt. (IC447d, b/297212873)
  • Die Höhen- und Tiefendarstellung in Tonformaten wird in verschiedenen Interaktionsstatus nicht mehr gemäß den Spezifikationen animiert (Icdd12).

API-Änderungen

  • Es wurde eine neue BottomAppBar hinzugefügt, die als Parameter BottomAppBarScrollBehavior verwendet, um sie beim Scrollen automatisch auszublenden. Außerdem wurde FabPosition.EndOverlay hinzugefügt, damit die UAS die untere App-Leiste im Gerüst überlagern kann, anstatt darüber verankert zu werden. (Iecb47)
  • Es wurde eine einfache Label-Komponente hinzugefügt, die auf BasicTooltipBox aufbaut und nicht geschlossen wird, wenn auf eine Stelle außerhalb des Labels getippt wird. (I821f9)

Fehlerkorrekturen

  • Die Verwendung von rememberSaveable für Kurzinfos wurde entfernt. (Icc131, b/299500338)
  • Es wurde ein temporäres Flag eingeführt, um zu steuern, ob die untergeordneten Elemente von Scaffold während der Messung oder während des Placements analysiert werden sollen. Standardmäßig wird dies bei der Messung erfasst. Wenn Sie Probleme mit dem neuen Verhalten haben, melden Sie dies bitte. (I0b354)
  • Horizontaler Rand-zu-Rand in BottomSheet korrigiert, indem das richtige Maß für die Bildschirmbreite des Geräts verwendet wurde. (I1df0c, b/299058752)
  • Es wurde ein Fehler behoben, bei dem ModalBottomSheet onDismissedRequest nicht aufrief, wenn es durch Wischen auf dem Tabellenblatt nach unten geschlossen wurde. (Idfdd8)

Version 1.2.0-alpha07

6. September 2023

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

Neue Funktionen

  • In compose material 1.6.0-alpha05 werden jetzt Symbole für die automatische Spiegelung unterstützt. Weitere Informationen zu den Symbolen für die automatische Spiegelung finden Sie in den Versionshinweisen.

API-Änderungen

  • SliderState implementiert DraggableState (I9b116)
  • Form in einen erforderlichen Parameter ändern. Benennen Sie position in der Formhilfsfunktion in index um. (I34941)
  • Aktualisiert DatePicker formatWithSkeleton, sodass eine Karte enthalten ist, die als Cache für Leistungsverbesserungen verwendet wird. (I3195f)
  • BasicTooltipBox wurde compose.foundation hinzugefügt und PlainTooltipBox und RichTooltipBox aktualisiert, um TooltipBox mit neuen Zusammensetzbaren PlainTooltip und RichTooltip zu verwenden. (I79e1d)

Fehlerkorrekturen

  • dynamicLightColorScheme und dynamicDarkColorScheme geben jetzt höhere Farbtöne für Oberflächen- und surfaceContainer-Rollen zurück. (I5e901)
  • Es wurde ein Problem behoben, bei dem einige Komponenten mit Unterzusammensetzung (z.B. BottomSheetScaffold) in einem Gerüst in einem LookaheadScope 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 wurde veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.

Fehlerkorrekturen

  • Die offset-Berechnung von DropdownMenu wurde so korrigiert, dass der x-Versatz ausschließlich von der lokalen Layoutrichtung abhängt und der y-Versatz nicht mehr umgekehrt wird, wenn sich das Menü unten auf dem Bildschirm befindet. (Iccc74, b/294103942)
  • Die offset-Berechnung von DropdownMenu wurde so korrigiert, dass der x-Versatz ausschließlich von der lokalen Layoutrichtung abhängt und der y-Versatz nicht mehr umgekehrt wird, 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 wurde veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.

API-Änderungen

  • Änderungen an den Farben „Kästchen“ und „TriStateCheckbox“. Das Feld CheckboxDefaults.colors() disabledUncheckedColor wirkt sich jetzt nur noch auf den Rand des Kästchens aus. In Sonderfällen, in denen Sie die Farbe des internen Kästchens festlegen müssen, wenn diese deaktiviert und nicht ausgewählt sind, ist eine benutzerdefiniert erstellte Instanz einer 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 wurde veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Experimentelle Segmented Button API (Ifc8fb)
  • Trennlinien verfügen jetzt über einen Parameter zur Steuerung der Ausrichtung, sodass vertikale Trennlinien unterstützt werden. (I4c899, b/288438593)

API-Änderungen

  • Wir verschieben die Dichteabhängigkeit auf die Komponentenebene. Dies gilt für die folgenden Komponenten: SwipeToDismiss und tabellenbasierte Komponenten. Verwenden Sie die neue Überlastung, bei der die Dichte ein Parameter ist. (I1846e)
  • Zusätzliche Annotationen zur Angabe zulässiger Eingaben für zusammensetzbare Funktionen (Ief234)
  • Fügen Sie der segmentierten Schaltfläche einen Symbolparameter hinzu und teilen Sie die Semantik auf, sodass segmentierte Schaltflächen für die Implementierung einer Einzelauswahl und umschalten können, um die Mehrfachauswahl mit SelectableSegmentedButtonRow bzw. ToggelableSegmentedButtonRow zu implementieren. (I38740)
  • Die Fahrbahntrennung wurde in HorizontalDivider umbenannt. VerticalDivider-Funktion hinzugefügt. (I5975c)
  • Ändere die Verwendung von ClosedFloatingPointRange für das schlanke FloatRange in experimentellen Material3 APIs, um das Autoboxing 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 wurde veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.

Änderungen im Verhalten

  • includeFontPadding ist jetzt in der Typografie von Material 3 standardmäßig auf false gesetzt. Der Standardstil für die Zeilenhöhe wurde ebenfalls in Trim.None und Alignment.Center geändert und explizite lineHeight (in sp) wurden den TextStyles von Typography hinzugefügt. Wenn Sie diese Werte anpassen möchten, lesen Sie die API-Dokumentation. Im Blogpost finden Sie eine ausführliche Erläuterung dieser Änderungen. (I6266f, Icabc3)

Neue Funktionen

  • Es wurde eine Überlastung für RangeSlider hinzugefügt, die eine zustandsorientierte Version der Komponente ist. Es wurde eine RangeSliderState erstellt, die alle Informationen für den aktuell aktiven Track, die Messwerte der Komponenten von RangeSlider sowie die Zieh- und Gestenlogik 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 Höhen-Overlay für die Oberfläche kann jetzt mit der lokalen Zusammensetzung von LocalTonalElevationEnabled deaktiviert werden. (IC203c, b/277774590)

API-Änderungen

  • Öffnen Sie die Farbkonstruktoren der Komponente. (I8c4a6)
  • Hinzufügen eines fokussierbaren Parameters zu beiden Kurzinfo-APIs, damit Entwickler festlegen können, dass die Kurzinfo Touch-Ereignisse verarbeitet oder nicht. Beachten Sie, dass dadurch der automatische Durchlauf für den Bedienungshilfenfokus beeinträchtigt werden kann. (Ie32d8)
  • Optimierte Zugänglichkeit für Leistung und Arbeitsspeicherzuweisung (Iede48)
  • DefaultSizeClasses freigeben und StandardSizeClasses für WindowSizeClasses erstellen (I91838)
  • WindowWidth/HeightSizeClass in Wertklassen mit Gleitkommazahl ändern (Ie686e)

Fehlerkorrekturen

  • Der contentWindowInsets-Parameter von Scaffold berücksichtigt jetzt aufgenommene Fenstereinfügungen. Das Verhalten des Abstands von Inhalten basierend auf topBar und bottomBar bleibt unverändert, wenn diese Parameter angegeben werden. (I08b73, b/264601542)
  • Korrigieren Sie die Ausrichtung der mittleren oberen App-Leiste, damit ein langer Titel nicht über den Aktionssymbolen oder dem Navigationssymbol gerendert wird. (I4369f, b/236994621)
  • Für Tabpositionen gilt jetzt eine Mindestinhaltsbreite von 24 dp. Dies bietet ein barrierefreies Berührungsziel für Tab-Anzeigen. (Id8861)
  • In den dynamischen Farbvorlagen von dynamicLightColorScheme und dynamicDarkColorScheme werden jetzt neue Oberflächenrollen unterstützt. (I1252e)
  • Die Ausrichtung der Badge-Benachrichtigungen wird so geändert, dass sie bei Stößen mit Urgroßeltern nicht abgeschnitten wird. (Idf75a)

Version 1.2.0-alpha02

24. Mai 2023

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

API-Änderungen

  • Fügen Sie ModalBottomSheet den Parameter für Insets für Fenster hinzu.
    • Der Kreis für ModalBottomSheet kann jetzt hinter der Statusleiste gezeichnet werden, wobei windowInsets auf null gesetzt ist
    • Die ModalBottomSheet-Standardfunktionalität wurde aktualisiert, sodass sie außerhalb der Systemleisten bleibt, einschließlich der Navigation.
    • Die Einfügung in die Statusleiste wird durch Ziehpunkte im Rand-zu-Rand-Modus gehandhabt.
    • BottomSheetDefaults enthält Fenster-Einsätze für BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/1065483){/265483){/265483){/265483.
  • Indicator verwerfen und Primary/SecondaryIndicator hinzufügen, um die M3-Spezifikationen zu erfüllen. PrimaryIndicator entspricht der Breite des Tabinhalts, während SecondaryIndicator die gesamte verfügbare Breite abdeckt. SecondaryIndicator entspricht dem mittlerweile verworfenen Indicator und kann ein direkter Ersatz sein. (I27604)
  • Es wurde eine Option hinzugefügt, um eine ScrollState zu übergeben, wenn ein DropdownMenu oder ein ExposedDropdownMenu konstruiert wird, um den vertikalen Scrollstatus der angezeigten Menüelemente zu steuern. (Ia0734, b/185304441)
  • Es wurde eine Überlastung für Slider hinzugefügt, die eine zustandsorientierte Version der Komponente ist. Es wurde eine SliderState erstellt, die alle Informationen für den aktuell aktiven Track, die Messwerte der Komponenten von Slider sowie die Zieh- und Gestenlogik enthält. (I124a5)
  • Semantikeigenschaft „isContainer“ wird in „isTraversalGroup“ umbenannt (I121f6)
  • Der optimierte TextStyle.merge(...) mit vollständiger Parameterliste wurde hinzugefügt. (Iad234, b/246961787)
  • TooltipState, RichTooltipState und PlainTooltipState wurden zu öffentlichen Schnittstellen hinzugefügt. RichTooltipStateImpl und PlainTooltipStateImpl für Standardzustände hinzugefügt. remember*State-Funktionen zum Abrufen dieser implementierten Status hinzugefügt. TooltipSync wurde zugunsten von TooltipDefault.GlobalMutatorMutex entfernt. (I7813d)
  • DatePickerColors wurde um zusätzliche Anpassungsoptionen für die Trennlinie, die Navigation und die Texteingabefelder der Datumsauswahl ergänzt. (I1a685, b/274626815)
  • DatePickerState und DateRangePickerState sind jetzt öffentliche Schnittstellen mit Standardimplementierungen, die von rememberDatePickerState und rememberDateRangePickerState abgerufen werden können. (I71c52)
  • dateValidator wurde aus DatePicker und DateRangePicker entfernt und eine SelectableDates-Oberfläche wurde eingeführt, die für den Status festgelegt werden kann, um zu steuern, welche Datumsangaben oder Jahre in der Benutzeroberfläche ausgewählt werden können. (Ic2fc6)
  • TimePicker wurde aus der stabilen API entfernt. Weitere Änderungen an der State API sind zu erwarten (I3f39a).
  • ModalBottomSheet nur für Android verfügbar. ModalBottomSheet wird nicht für die Verwendung auf einem Computer empfohlen und die Funktionalität wird nicht aktiv verwaltet. (Ib3778)

Fehlerkorrekturen

  • Die Aktion „AlertDialog“ zum Schließen wurde korrigiert, die jetzt unterhalb der Bestätigungsaktion angezeigt wurde, wenn die Aktionen übereinander gestapelt wurden, damit sie in die Breite des Dialogfelds passen. Durch diese Korrektur wird die Implementierung an die Material Design-Spezifikation angeglichen (I029de, b/235454277).
  • Der Fehler in ListItem mit falschem Abstand für drei Werbebuchungen wurde behoben. (I6e235)
  • ModalBottomSheet kann jetzt die IME-Tastatur (Idc508, b/262140644, b/268380384, b/272483584) anzeigen.

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 wurden 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 wurden veröffentlicht. Version 1.1.2 enthält diese Commits.

Fehlerkorrekturen

  • Ein Problem wurde behoben, durch das der Modifizierer fälschlicherweise an zwei zusammensetzbare Funktionen übergeben wurde. (b/282761472)
  • Der korrigierte TimePickerState gibt falsche Stunden zurück, wenn er mit 23 Stunden initialisiert wurde. (b/278242122)
  • Der anfängliche Umschaltstatus für die Validierung mit Mittag und Minuten wurde korrigiert. (b/269768197, b/282790635)
  • Problem behoben, bei dem state.hour einen falschen Wert für 23 Uhr zurückgibt. (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 wurden veröffentlicht. Version 1.1.1 enthält diese Commits.

Fehlerkorrekturen

  • Fügt einen Aufruf für ModalBottomSheet ohne windowInset-Parameter für die Binärkompatibilität hinzu. (Ib7959)
  • Fügen Sie ModalBottomSheet den Parameter für Insets für Fenster hinzu.
    • Der Kreis für ModalBottomSheet kann jetzt hinter der Statusleiste gezeichnet werden, wobei windowInsets auf null gesetzt ist
    • Die ModalBottomSheet-Standardfunktionalität wurde aktualisiert, sodass sie außerhalb der Systemleisten bleibt, einschließlich der Navigation.
    • Die Einfügung in die Statusleiste wird durch Ziehpunkte im Rand-zu-Rand-Modus gehandhabt.
    • BottomSheetDefaults enthält Fenster-Einsätze für BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/1065483){/265483){/265483){/265483.

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 wurden veröffentlicht. Version 1.1.0 enthält diese Commits.

Hauptfunktionen von Version 1.1.0

Neue Komponenten aus Material Design 3

Verbesserungen an bestehenden Komponenten von Material Design 3.

Experimentelle APIs wurden auf stabile Version 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 wurden veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.

API-Änderungen

  • TimePicker wurde aus der stabilen API entfernt. Weitere Änderungen an der State API sind zu erwarten (I3f39a).
  • ModalBottomSheet nur für Android verfügbar. ModalBottomSheet wird nicht für die Verwendung auf einem Computer empfohlen und die Funktionalität wird nicht aktiv verwaltet. (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 wurden veröffentlicht. Version 1.1.0-beta02 enthält diese Commits.

API-Änderungen

  • SheetState hat jetzt einen optionalen skipHiddenState-Parameter
  • rememberStandardBottomSheetState hat jetzt einen optionalen skipHiddenState-Parameter
  • BottomSheetScaffold hat jetzt einen definierten verborgenen Anker, obwohl er standardmäßig deaktiviert ist.
  • SheetState.requireOffset-Dokumentation wurde aktualisiert
  • BottomSheetDefaults.MinimizedShape wurde in BottomSheetDefaults.HiddenShape umbenannt (I839f4, b/273870234).

Fehlerkorrekturen

  • Ändern Sie das Zifferblatt nicht von Stunden zu Minuten, wenn die Touchscreen-Erkundung aktiviert ist. (I717d0)
  • Die Semantik der Ziehpunkte ModalBottomSheet und BottomSheetScaffold ist jetzt zusammengeführt. (I05afb)
  • Die Parameter BottomSheetScaffold, containerColor und contentColor wirken sich jetzt nur auf Inhalte aus. (I992cb)
  • In BottomSheetScaffold nestedScroll für Tabellenblattinhalte werden jetzt Flings implementiert. (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 wurden veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.

API-Änderungen

  • Parameter für Layouttyp zur zusammensetzbaren Funktion „TimePicker“ hinzufügen. Je nach Bildschirmkonfiguration können verschiedene Layouts verwendet werden (Ia0e16).
  • SearchBarDefaults wurde als experimentell gekennzeichnet. (I65561)
  • Schattenhöhe zu BottomSheetScaffold hinzugefügt (I94e0f)
  • Zusätzliche Unterstützung für die Anzeige der Datumsauswahl ohne Kopfzeilenteil. Die API wurde geändert, sodass beim Erstellen einer Datumsauswahl ein leerer Anzeigentitel übergeben werden kann. Sie können jetzt keine Anzeigentitel, Titel und showToggleMode = false übergeben, damit eine monitorlose Auswahl angezeigt wird. (Id3f3a, b/266132421, b/267194809)

Fehlerkorrekturen

  • Suchleisten heben den Fokus jetzt automatisch auf, wenn sie inaktiv sind. (I22a7c, b/261444487)
  • DateRangePicker wurde aktualisiert, sodass ein Zeitraum mit demselben Datum als Start- und Enddatum ausgewählt werden kann. (I16529, b/272882497)
  • Die Textelemente von Textfeldern werden jetzt korrekt positioniert, wenn die Schriftgröße kleiner als erwartet ist. Je nach Schrifteinstellungen und Skript können sich jedoch einige Pixel in Ihren Apps ändern. (I8b8d0)
  • Semantische Aktionen am unteren Rand sind jetzt mit Labels versehen. (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 wurden 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

  • Für DatePickerState und DateRangePickerState wurden eine Funktion hinzugefügt, mit der Datumsangaben nach der anfänglichen Erstellung des Status festgelegt und Auswahlen durch Festlegen von Nullzeitstempeln zurückgesetzt werden können. Das manuelle Festlegen von Datumsangaben sollte mit Vorsicht erfolgen. Die neue setSelection-Funktion löst eine Ausnahme aus, wenn ein angegebenes Datum eine Vorbedingung nicht erfüllt (siehe Dokumentation). (Ifa645, b/268609314, b/270427389)
  • Die minimierte SheetValue wurde in PartiallyExpanded umbenannt, um das Verhalten in diesem Zustand genauer und flexibler abzubilden. (Ia1491)
  • ListItem-Parameternamen wurden auf _content anstelle von _text aktualisiert. Standard-Getter sind jetzt ReadOnlyComposables, sofern relevant. (I69a25)
  • Interaktive Surface APIs aus der experimentellen Phase erweitern. (I90d59, b/261561812)

Fehlerkorrekturen

  • Der HalfExpanded-Status von ModalBottomSheet wurde nicht korrekt berechnet und das Tabellenblatt schien schwebend zu sein. Dieses Problem wurde behoben. (I45e84, b/268411386)
  • confirmValueChange-Überprüfung zu Scrim-Tap für ModalBottomSheet hinzufügen. (I2311a, b/270425759)
  • Semantische BottomSheet-Aktionen zum Ziehpunkt bewegen. (I158ba)
  • ModalBottomSheet benennt jetzt den Fokus auf den Start und bedient die Schaltfläche „Zurück“. (I4d2ab)
  • ModalBottomSheet onDismissRequest wird jetzt auch bei verschachtelten Scroll-Flips verarbeitet. (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 wurden veröffentlicht. Version 1.1.0-alpha07 enthält diese Commits.

Neue Funktionen

  • Fügen Sie eine zusammensetzbare Funktion für die Zeiteingabe hinzu, die mit rememberTimePickerState() funktioniert und der M3-Spezifikation für die Zeiteingabe folgt (Ia4fab).
  • Material 3-DateRangePicker-API zur Auswahl eines Zeitraums wurde hinzugefügt. (I7a6c3, b/267194809)
  • Eine Unterstützung des Material 3-Eingabemodus für die Auswahl von Zeiträumen über die DateRangePicker API wurde hinzugefügt. (Ifdbc4)
  • Die Farben von Textfeldern ermöglichen jetzt die Anpassung:
    • Die Farben des Eingabefelds und der Platzhaltertexte je nach Fokus- und Fehlerstatus. Der Parameter textColor wurde in unfocusedTextColor umbenannt und placeholderColor wurde in unfocusedPlaceholderColor umbenannt.
    • Die Containerfarbe für ausgefüllte Textfelder basierend auf dem Fehlerstatus mit dem neuen Parameter errorContainerColor.
  • Die Farben für die Textfelder im Drop-down-Menü wurden mit Parametern aktualisiert, um die neue Präfix- und Suffix-API zu unterstützen. (I9c8b4, b/254284181, b/264766350)

API-Änderungen

  • Einige Slider API-Versionen werden zurückgesetzt und redundante Slider-Überlastungen entfernt, die vom neuen experimentellen Slider mit benutzerdefiniertem Thumbnail und Track abgedeckt werden. RangeSlider wird auf die stabile Version hochgestuft. (Ie8fbd)
  • defaultElevation wurde in den Höhenfunktionen des Chips in elevation umbenannt. (I0f872)
  • Die folgenden Material 3-Textfeld-APIs befinden sich nicht mehr in der Testphase: TextField, OutlinedTextField, textFieldWithLabelPadding, textFieldWithoutLabelPadding und 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 der Bedienungshilfen für Material 3 DatePicker und DateRangePicker (I5087e)
  • Es wurde ein Fehler behoben, bei dem die Beschränkung für die maximale Höhe übernommen wurde, was zu einem Absturz führen kann. (I30d8c)
  • Semantische Rollen wurden aus anklickbaren und auswählbaren Oberflächen entfernt und Komponenten wurden aktualisiert, um Rollen mithilfe von „modifizierer.semantik“ 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 wurden veröffentlicht. Version 1.1.0-alpha06 enthält diese Commits.

Neue Funktionen

  • In Textfeldern wird jetzt Präfix- und Suffixtext unterstützt (Ia8578, b/179884561).
  • Es wurde eine TimePicker-Funktion hinzugefügt, um eine Zeitauswahl gemäß der Material 3-Spezifikation anzuzeigen, die in Verbindung mit TimePickerState und der Convenience-Methode rememberTimePickerState (I71910) verwendet wird.
  • Eine Datumseingabe wird jetzt als Anzeigemodus unter DatePicker verwendet. Unterstützung für den Wechsel zwischen Datumsauswahl und Datumseingabemodus wurde hinzugefügt. (IEff7)
  • API für RichTextTooltips wurde hinzugefügt. (I58ef3)
  • Modale Implementierung der Ansicht 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 Unterstützungs- und Vorschlags-Chip stabilisieren (Ibb67b, b/261424370)
  • Die API „ListItem“, „ListItemDefaults“ und „ListItemColors“ wird als nicht experimentell hochgestuft (I7e7fa, b/261438882).
  • SliderPositions, SliderDefaults.Thumb und SliderDefaults.Track werden auf stabile Version hochgestuft und nicht experimentelle Slider- und RangeSlider-APIs hinzugefügt, die benutzerdefinierte Thumbnails und Tracks enthalten. Außerdem werden die vorherigen APIs Slider und RangeSlider eingestellt. (Ie5ea6, b/261566890)
  • Modifier.tooltipAnchor() wurde auf „Öffentlich“ gesetzt, damit Entwickler es an den Anker übergeben können, um anzugeben, dass beim langen Drücken eine Kurzinfo angezeigt werden soll. Die PlainTooltipBox API wurde aktualisiert, sodass TooltipState keine Nullwerte mehr zulässt. Es gibt jetzt eine Standardeinstellung. (Ie2fb7)
  • ProgressIndicatorDefaults.circularTrackColor wurde aus Konsistenzgründen mit @Composable gekennzeichnet. (Id29cc)
  • Property-Getter LocalMinimuTouchTargetEnforcement wiederhergestellt, als veraltet markiert und zu 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 wurden veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.

Neue Funktionen

  • Unterstützung für DatePickerDialog und Bedienungshilfen
  • Benutzerdefinierter Thumbnail und Titel zu RangeSlider hinzugefügt.

Aktualisierung der Abhängigkeiten

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 wurden veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.

Neue Funktionen

  • Erste DatePicker API für die Auswahl eines einzelnen Datums über eine Kalender-UI. An dieser API werden noch Änderungen vorgenommen. (I722b9)
  • Unterstützung für einfache Kurzinfos über PlainTooltipBox wurde hinzugefügt. (I0cdfb)
  • Suchleiste (Iad128)
  • SwipeToDismiss (I458a8, b/242889540)

API-Änderungen

  • In der IsContainer-Semantikeigenschaft auf Oberflächen hinzugefügt. Diese Eigenschaft wird in einer späteren Änderung verwendet, mit der die Durchquerungsreihenfolge basierend auf der semantischen Bedeutung von Elementen wie Oberflächen festgelegt wird. (I63379)
  • APIs für Navigationsleisten als stabil markieren. (Iab01e, b/261439597)
  • Ein Farbparameter der Spurverfolgung für kreisförmige Fortschrittsanzeigen und ein Strichkappenparameter für kreisförmige und lineare Fortschrittsanzeigen wurden hinzugefügt. (Ie668c, b/216325962, b/222964817)
  • Höhere Null-Zulässigkeit für Rückgaben von nicht mehr unterstützten Funktionen (Ibf7b0)
  • Modifier.minimumInteractiveComponentSize hinzufügen. Damit kann eine Größe von mindestens 48 dp reserviert werden, um Berührungsinteraktionen zu unterscheiden, wenn das Element kleiner ist. (I33f58, b/258495559)
  • Es wurde eine experimentelle API für die zusammensetzbare Funktion AlertDialog mit einer Inhaltsfläche hinzugefügt. (Iec4a2)

Fehlerkorrekturen

  • Der Fortschritt der Fortschrittsanzeigen 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 ein java.lang.NoSuchFieldError-Fehler auftreten. Das Problem wurde an dieser Stelle gemeldet. Eine Korrektur wurde gesendet, die mit dem nächsten Update für das Schreiben von Änderungen verfügbar ist. Um das Problem zu umgehen, aktualisieren Sie Ihre androidx.compose.material- und androidx.compose.material3-Bibliotheken auf die neueste Version(1.1.0-alpha04) oder führen Sie ein Downgrade von androidx.compose.foundation auf 1.4.0-alpha03 durch.

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 wurden veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.

API-Änderungen

  • consumedWindowInsets() wurde in consumeWindowInsets() und withConsumedWindowInsets() in onConsumedWindowInsetsChanged() umbenannt und die Modifikatoren wurden veröffentlicht. (Ie44e1)
  • Fügen Sie einen neuen Standardinhaltsabstand für die Textschaltfläche mit dem zu verwendenden Symbol hinzu. (I8f662)
  • Deaktivierte Farben für die Navigationsleiste und die Schiene wurden hinzugefügt. (Ia7892, b/258867034)
  • Eine Modifier API wurde hinzugefügt, um die Scroll-Informationen von Ancestors abzufragen. (I2ba9d, b/203141462)
  • Wird in Clickable verwendet, um Interaktionen beim Drücken korrekt zu verzögern, wenn Gesten zu Scroll-Ereignissen werden können.
  • Das Problem, dass Clickables bei Verwendung innerhalb von Scrollable ViewGroup die Ripples nicht korrekt verzögerte, wurde behoben.
  • Leisten und Tabellen wurden aktualisiert, um das Drücken korrekt zu verzögern, falls Gesten zu Scroll-Ereignissen werden können.

Aktualisierung der Abhängigkeiten

  • Compose UI und Compose Material hängen jetzt von Lifecycle 2.5.1 ab. (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 wurden veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.

API-Änderungen

  • awaitFirstDown und waitForUpOrCancellation akzeptieren jetzt PointerEventPass für mehr Flexibilität (behebt auch ExposedDropdownMenuBox, das beim Scrollen ein Menü anzeigt.(I7579a, b/212091796)
  • Der Parameter minLines wurde zu material und material3 Text, TextField und OutlinedTextField hinzugefügt. Damit kann die Mindesthöhe der Komponente in Bezug auf die Anzahl der Zeilen festgelegt werden (I4af1d).
  • Die TopAppBarDefaults smallTopAppBarColors-Funktion wird durch die neue topAppBarColors-Funktion ersetzt, die beim Erstellen einer TopAppBar verwendet werden sollte. (Ie6cb9)
  • Der Parameter minLines wurde zu BasicText und BasicTextField hinzugefügt. Damit kann die Mindesthöhe dieser zusammensetzbaren Funktionen in Bezug auf die Anzahl der Zeilen festgelegt werden (I24294, b/122476634).

Fehlerkorrekturen

  • Schneide den Inhalt von IconButton und IconToggleBotton aus Material3 an die Form der Zustandsschicht der Komponente zu (z.B. runde Form). (I9da8f)
  • Die oberen App-Leisten von Material3 (mittel und groß) wurden aktualisiert, sodass die gleiche Hintergrundfarbe auf die gesamte Oberfläche angewendet wird und dass die Standardfarben mit transparenten Farbwerten überschrieben werden können. (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 wurden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

  • Korrekturen an der oberen App-Leiste, wenn der Titel mit einem TextStyle und einem Pinsel 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 wurden veröffentlicht. Version 1.0.1 enthält diese Commits.

Fehlerkorrekturen

  • Die oberen App-Leisten von Material3 (mittel und groß) wurden aktualisiert, sodass die gleiche Hintergrundfarbe auf die gesamte Oberfläche angewendet wird und dass die Standardfarben mit transparenten Farbwerten überschrieben werden können. (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 wurden veröffentlicht. Version 1.0.0 enthält diese Commits.

Hauptfunktionen von Version 1.0.0

Dies ist die erste stabile Version von Compose Material 3.

Design von Material Design 3 und dynamische Farbe von Material You

Material Design 3-Komponenten

Fenstergrößenklasse

  • material3-window-size-class ist eine neue Bibliothek, die Fenstergrößenklassen unterstützt. Dabei handelt es sich um eine Reihe von Haltepunkten für den Darstellungsbereich, mit denen Sie Anwendungslayouts mit anpassbarer Größe entwerfen, entwickeln und testen können. Sie können calculateWindowSizeClass verwenden, um eine Klasseninstanz der Fenstergröße abzurufen. Damit können Sie festlegen, wie Ihre UI angezeigt werden soll, z. B. eine Navigationsleiste anstelle der Navigation am unteren Rand für größere Fenster anzeigen. Weitere Informationen und Anwendungsbeispiele 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 wurden veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.

API-Änderungen

  • Slotparameter für unterstützenden Text zur 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 wurden veröffentlicht. Version 1.0.0-beta03 enthält diese Commits.

API-Änderungen

  • ExposedDropdownMenuDefaults weist jetzt einen Padding-Wert für Menüelemente auf. (I34ee1)
  • ExposedDropdownMenuBoxScope hat jetzt einen Modifier.menuAnchor()-Modifikator, der für ein korrektes a11y-Verhalten an das Textfeld übergeben werden muss. (I27fa3)
  • Es werden zwei überlastete Methoden für die aktuelle Slider API hinzugefügt, damit Nutzer einen Thumbnail oder einen Track eingeben können, um den Schieberegler zu befüllen. (I21c00)

Fehlerkorrekturen

  • Farbzuordnung des dunklen Designs für Container bei Fehler 90 (Ic5612) aktualisiert
  • Das Problem wurde behoben, damit für kleine obere App-Leisten von Material 3 ein transparenter Hintergrund festgelegt werden kann. (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 wurden veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.

API-Änderungen

  • Insets von Standardkomponenten, die in der Betaversion 01 in m3-Komponenten eingeführt wurden, werden IME-Einsätze nicht mehr berücksichtigt.
  • Die Material3-Gerüst-Komponente hat jetzt einen contentWindowInsets-Parameter, mit dem die Anzahl der Einfügungen angegeben werden kann, die für die Inhaltsfläche verarbeitet werden sollen. (Icf11a, b/243713323)
  • Die experimentelle Funktion SmallTopAppBar in Material 3 wird eingestellt und eine entsprechende TopAppBar-Funktion eingeführt. Migrieren Sie Ihre Nutzung auf die neue. (I74404, b/226918634)
  • Ermöglicht die Steuerung des Schwingens und Andockens der oberen App-Leiste. (I15c81)
  • Entfernt startIndent von der Trennlinie und verschiebt die Farbe zum letzten Parameter. (If7be2)

Fehlerkorrekturen

  • Dialogfelder sollen sich gegenüber TalkBack-Nutzern identifizieren, indem das Wort „Dialog“ angesagt wird, 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 wurden veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.

API-Referenz

Die neuesten Designs, Komponenten und andere zusammensetzbare Funktionen finden Sie in der Übersicht über die API-Referenz für Material 3.

API-Änderungen

  • Die obere App-Leiste von Material 3 wurde aktualisiert, sodass sie vollständig minimiert und vollständig maximiert einrastet. Außerdem wurde die TopAppBarDefaults-Verhaltensfunktion in „Combinables“ geändert, sodass Standardwerte für den Status der oberen App-Leiste und die Animationsspezifikation angegeben werden können (I642b3).
  • Signaturen der UAS-Komponenten wurden aktualisiert, damit sie der Surface API entsprechen (I3afaa).
  • Unterstützung der integrierten Einfügungen für obere App-Leisten, Leisten, Navigationsleiste und Leiste wurde hinzugefügt. Wenn diese Komponenten separat oder mit Scaffold verwendet werden, werden Einfügungen für Entwickler automatisch verarbeitet. Hinweis: Durch diese Änderung werden die Symbole der Statusleiste und die Transparenz der Status- und Navigationsleisten nicht automatisch verarbeitet. Bitte tun Sie dies weiterhin manuell, um bestmögliche Ergebnisse zu erzielen. (I7e4e6, b/183161866)
  • Die Standardeinstellungen der Komponenten wurden aktualisiert, um die API-Oberfläche zu verkleinern. Dies ermöglicht zukünftige Flexibilität und Leistungsverbesserungen. (I31820)
  • Die Parameter des Chips und der Navigationsleiste wurden neu angeordnet, um die Konsistenz innerhalb der API zu wahren (I45d0b).
  • startIndent wurde aus der Trennlinie entfernt und die Farbe ist 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 wurden veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.

Neue Funktionen

  • Unterstützung beim Angeben einer benutzerdefinierten Breite in einer Navigationsleiste. (Ia7f10)

API-Änderungen

  • Parameter für Tabs und Symbole auf dem Tab „Tabs“ und „Suggestivsymbol“ neu anordnen, um die Konsistenz innerhalb der API zu wahren (Beispiel 2637)
  • BadgeDefaults wurde als experimentell gekennzeichnet. (I98ef3)
  • Die eingestellte Navigationsleistenfunktion wurde entfernt. (I4f2db)
  • Ordnen Sie die Schieberegler-Parameter in Material 3 neu an, um die Einheitlichkeit innerhalb der API zu wahren (I0aee7).
  • Ordnen Sie die Parameter NavigationBar und NavigationRail neu an, um die Konsistenz innerhalb der API zu wahren (I51cda).
  • Ordnen Sie die Parameter in Material 3 neu an, um die Konsistenz in der API zu wahren. (If4ae1)
  • Ordnen Sie die Slider-Parameter in Material 3 neu an, um die Konsistenz innerhalb der API zu wahren (I62673).
  • Der Parameter „symbols“ wurde in Aktionen umbenannt, damit er mit der oberen App-Leiste konsistent ist (Id75be).
  • Markieren Sie Badge und BadgedBox als experimentell, da die Ankerausrichtung noch einflussreich ist. (I1712e, b/236524516)
  • @ExperimentalMaterial3Api-Anmerkungen für Varianten der Symbolschaltflächen in @OptIn ändern (I070b5)
  • Der Inhalt einer Navigationsleiste wurde in eine eigene zusammensetzbare Funktion unterteilt, um die Angabe einer benutzerdefinierten Breite zu unterstützen. (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 wurden veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.

Neue Funktionen

  • Ziehen Sie die obere App-Leiste von der Leiste selbst heraus. (I65c00, b/205873416)

API-Änderungen

  • Updates der APIs FilterChip und ElevatedFilterChip, um den Slot selectedIcon zu entfernen und die Wiederverwendung des leadingIcon zum Anzeigen eines ausgewählten Status zu fördern. (Ie5dc2)
  • Fügen Sie Farbrollen für Gitter- und Umrissvarianten hinzu. (Id6d54)
  • Die Namenskonventionen für zusammensetzbare Standardeinstellungen wurden korrigiert. (I62b27)
  • ListItemDefaults und ListItemColors als experimentell kennzeichnen. (I1f3ec)
  • Änderungen an der oberen App Bar API, um die Bedeutung der Statuseigenschaften besser widerzuspiegeln. Markieren Sie außerdem das API für die obere App-Leiste als experimentell. (Ic0ad8)
  • Für eine bessere Sichtbarkeit wurden TextFieldColors Farben für die Textauswahl hinzugefügt. (Iba1b8)
  • Hinzufügen von ButtonDefault.ButtonWithIconContentPadding zur Verwendung mit Schaltflächen, die ein Symbol enthalten. (I2bf9c)
  • Textfelder wurden als experimentell gekennzeichnet, um bei zukünftigen API-Änderungen flexibler zu sein. (I127b5)
  • Die Anmerkung @ExperimentalMaterial3Api wurde aus der Funktion Checkbox entfernt. (I5eefc)
  • Die Anmerkung @ExperimentalMaterial3Api wurde aus der Funktion RadioButton entfernt. (I17e2a)
  • Die Anmerkung @ExperimentalMaterial3Api wurde von den nicht interaktiven Infokarten entfernt. (I9bd49)
  • Aktualisiert verschiedene Standardobjekte für Komponenten, sodass diese Farben, Formen usw. enthalten (I96e11)

Fehlerkorrekturen

  • Nicht funktionierende nachgestellte Symbole aus Eingabe-Chip-Beispielen wurden entfernt, um Verwirrung bei den Nutzern in 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 wurden veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.

Neue Funktionen

  • Implementierung einer M3-Liste hinzugefügt; siehe Dokumentation zur Beispielverwendung (Id7a20)

API-Änderungen

  • Parameternamen in RangeSlider von Werten in Wert ändern (I3b79a)
  • Die API wurde an der InputChip-Implementierung geändert, um gemäß den Material Design-Spezifikationen einen auswählbaren Status zu unterstützen. Zusätzliche Unterstützung für die FilterChip-Farben für den ausgewählten deaktivierten Status. (I55244, b/235792432)
  • BottomAppBar-Standard-FAB hinzufügen (Ida4c8)
  • ColorScheme.surfaceColorAtElevation wurde hinzugefügt (Id41af)
  • Schnittstellen in Erstellungsbibliotheken werden jetzt mit jdk8-Standardschnittstellenmethoden (I5bcf1) erstellt.
  • WindowWidthSizeClass und WindowHeightSizeClass implementieren jetzt Comparable, damit sie mit Operatoren (<, <=, >=, >) und anderen APIs verglichen werden können. (I747d0)

Fehlerkorrekturen

  • Aktualisiere das Badge-Beispiel, um eine aussagekräftigere Inhaltsbeschreibung hinzuzufügen. (I10b9d)
  • Fügt der Designauswahl des Material 3-Katalogs eine Option zur Verwendung der Systemschriftgröße hinzu. (I10605)
  • Es wird Beispielcode für das Logo und unbestimmte Fortschrittsanzeigen hinzugefügt. (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 wurden veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.

API-Änderungen

  • Unterstützt das Beibehalten der oberen Position der App-Leiste bei Konfigurationsänderungen. (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 wurden veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.

Fehlerkorrekturen

  • Das übergeordnete Element des Schiebereglers 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 wurden veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.

Neue Funktionen

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

API-Änderungen

  • Die zusammensetzbare Funktion TextFieldDefaults.BorderStroke, die in OutlinedTextField einen Rahmenstrich zeichnet, wurde in TextFieldDefaults.BorderBox umbenannt. (I5f295)
  • Optische Änderungen am Design von m3 (Iab30e)
  • Übergeben von Farben an die Standardsymbolschaltflächen zulassen (Ia2445)

Fehlerkorrekturen

  • Fügen Sie eine Lint-Prüfung zu material3/Gerüst hinzu, um sicherzustellen, dass der innere Innenrand 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 wurden veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.

Neue Funktionen

  • material3-window-size-class ist eine neue Bibliothek, die Fenstergrößenklassen unterstützt. Dabei handelt es sich um eine Reihe von Haltepunkten für den Darstellungsbereich, mit denen Sie Anwendungslayouts mit anpassbarer Größe entwerfen, entwickeln und testen können. Sie können calculateWindowSizeClass verwenden, um eine Klasseninstanz der Fenstergröße abzurufen. Damit können Sie festlegen, wie Ihre UI angezeigt werden soll, z. B. eine Navigationsleiste anstelle der Navigation am unteren Rand für größere Fenster anzeigen. Weitere Informationen und Anwendungsbeispiele finden Sie in der API-Referenzdokumentation für WindowSizeClass. Weitere Informationen zu Definitionen für Fenstergrößenklassen finden Sie in der öffentlichen Anleitung zur Unterstützung verschiedener Bildschirmgrößen.

API-Änderungen

  • Fügt die Standard-FAB-Höhe für BottomAppBar hinzu und entfernt nachgestellte Lambda-Werte aus BottomAppBar mit UAS. (I92c47)
  • Fügt Material3 FilledIconButton, FilledTonalIconButton und OutlinedIconButton hinzu. (Ib2bda)
  • Material 3 Snackbar-API wird aktualisiert, um Farbwerte für die optionale Aktion und die Aktion zum Schließen zu akzeptieren. (Ibe4b4)
  • Der Teilverbrauch (nach unten ODER in der Position) wurde in PointerInputChange eingestellt. Sie können consume() verwenden, um die Änderung vollständig zu übernehmen. Mit isConsumed können Sie feststellen, ob die Änderung bereits von einer anderen Person übernommen wurde.
  • PointerInputChange::copy() erstellt jetzt immer eine oberflächliche Kopie. Das bedeutet, dass Kopien von „PointerInputChange“ genutzt werden, sobald eines der Exemplare genutzt wurde. Wenn Sie eine ungebundene 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 Einheitlichkeit mit anderen Komponenten zu verbessern. (I6fbd9)

Fehlerkorrekturen

  • Aktualisierung der Standard-IconButton, um sie an die Material3-Spezifikation anzupassen (I09eab)
  • Verschiebe die obere Leiste des Gerüsts „material3“ in das Padding, das dem Inhalt übergeben wird, damit der Inhalt unterhalb der oberen App-Leiste gerendert wird. Wenn PaddingValues ignoriert werden, ist der Inhalt möglicherweise durch die obere Leiste verdeckt. (I83cbc, b/217776202)

Version 1.0.0-alpha09

6. April 2022

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

Neue Funktionen

  • Material 3 Switch API (I2c3ad) hinzugefügt

API-Änderungen

  • Unterstützung für Dropdown-Menüs mit Textfeldern (auch bekannt als "Sichtbare Dropdown-Menüs" oder "Kombinationsfelder") hinzugefügt. (I1b832)
  • Ein Formparameter wurde zum MaterialTheme- und Shape-Subsystem hinzugefügt. (I37426)
  • ExtendedFloatingActionButton wurde ein erweiterter Parameter hinzugefügt, um zu steuern, ob die UAS maximiert oder minimiert wird. Zwischen den einzelnen Zuständen gibt es Animationen. Zusätzliche erweiterte UAS-Überlastung für erweiterte UAS mit abschließendem Text für erweiterte UAS ohne Symbol hinzugefügt. (Iba7f1)

Version 1.0.0-alpha08

23. März 2022

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

Neue Funktionen

  • Die Unterstützung für Textfelder im Material 3-Format wurde hinzugefügt. (I795cc, b/199377790)

API-Änderungen

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

Fehlerkorrekturen

  • Behebe das Problem auf der Material3-Schaltfläche, um den Standardwert für den Textstil aus MaterialTheme zu lesen. (Ie62fc)

Version 1.0.0-alpha07

9. März 2022

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

API-Änderungen

  • Updates für die Material 3 Surface API, bei der die überlasteten Funktionen für anklickbare Oberflächen wiederhergestellt und eine Funktion hinzugefügt wurde, die auswählbare und ein-/ausschaltbare Oberflächen unterstützt. (I4bf18)
  • LazyVerticalGrid und LazyHorizontalGrid sind jetzt stabil. (I307c0)
  • LazyVerticalGrid/LazyHorizontalGrid und alle zugehörigen APIs wurden in das .grid-Teilpaket verschoben. Bitte aktualisieren Sie Ihre Importe von androidx.compose.foundation.lazy in androidx.compose.foundation.lazy.grid. (I2d446)
  • Die vorherige Änderung, sich ausschließlich auf eine Ansicht für WindowInsetsControllerCompat zu verlassen, wurde rückgängig gemacht. Auch hier ist ein Fenster erforderlich, das zum Verwalten einiger Fenster-Flags erforderlich ist. ViewCompat.getWindowInsetsController wurde zugunsten von WindowCompat.getInsetsController eingestellt, damit das richtige Fenster verwendet wird (z. B. wenn sich die Ansicht in einem Dialogfeld befindet). (I660ae, b/219572936)
  • Neue LazyVerticalGrid API zum Definieren von Achsengrößen hinzugefügt (I17723)

Fehlerkorrekturen

  • Updates der Card API, um den Änderungen an der Surface API zu folgen (I3c8b9)

Version 1.0.0-alpha06

23. Februar 2022

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

API-Änderungen

  • NavigationDrawerItem wurde hinzugefügt, der ein einzelnes Ziel innerhalb der Schubladen darstellt (Ic396f, b/218286829).
  • PermanentNavigationDrawer und DismissibleNavigationDrawer wurden als experimentelle APIs hinzugefügt. Diese Schubladen eignen sich gut für Geräte mit großen Bildschirmen. (I5f8ab, b/218286829)
  • Unterstützung der unteren App-Leiste von Material 3 (Ic432a)
  • NavigationDrawer wurde in ModalNavigationDrawer umbenannt (I1807d, b/218286829).
  • Klasse und Tokens für Material 3 Slider wurden hinzugefügt (I1ccee).
  • Tab-Implementierung hinzugefügt; siehe Dokumentation zu Beispielverwendung (Ie0146)

Fehlerkorrekturen

  • Bei der linearen Navigation des Screenreaders „TalkBack“ wurde ein leerer Titel in der oberen App-Leiste ausgewählt. Dieses Problem wurde behoben. (ID4690)
  • „IconSize“ wurde zu „FloatingActionButtonDefaults“ hinzugefügt. (Ia71cf)
  • Fehlerkorrektur für ausgeblendete AlertDialog-Schaltflächen, wenn mit LazyColumn ein langer Text hinzugefügt wurde. (Ib2cc9, b/216663029)

Version 1.0.0-alpha05

9. Februar 2022

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

Neue Funktionen

Komponenten von Material Design 3 wurden hinzugefügt.

API-Änderungen

  • Verworfene Funktion Surface, für die ein onClick-Callback erforderlich ist. Anklickbare Oberflächen sollten mit einem InteractionSource und einem Modifier.clickable() erstellt werden. (I211c6)
  • Gedrückte und fokussierte Höhenunterstützung für UAS wurde hinzugefügt. (Ibb584)
  • Die Surface API erhält jetzt eine InteractionSource, mit der die Darstellung in verschiedenen Zuständen gesteuert werden kann. (Iafbc8)

Fehlerkorrekturen

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

Version 1.0.0-alpha04

26. Januar 2022

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

API-Änderungen

  • NonRestartableComposable wurde den Methoden hinzugefügt, die vorhandene Methoden ohne komplexe Logik überladen. Dadurch werden vom Compiler generierte Speicherprüfungen (ist gleich) für alle Parameter reduziert, die in der aufgerufenen inneren Funktion wiederholt werden. (I90490)
  • Trennlinie für Material 3 hinzugefügt. (Ica5fc)
  • Markieren Sie das Kästchen und RadioButton mit einer experimentellen API-Anmerkung. (Ie44bb)
  • Unterstützung für Fortschrittsanzeigen bei Material 3 wurde hinzugefügt. (Iff232, b/205023841)

Fehlerkorrekturen

  • Aktualisieren Sie die Farbe eines deaktivierten TextButton's-Containers auf transparent (I6b248, b/213339737).

Version 1.0.0-alpha03

12. Januar 2022

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

Fehlerkorrekturen

Aktualisierung der Abhängigkeiten

  • Jetzt abhängig von Kotlin-1.6.10.

Version 1.0.0-alpha02

1. Dezember 2021

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

Neue Funktionen

  • Unterstützung für Kästchen und Optionsfelder hinzufügen.
  • Aktualisiert, um mit Kotlin-1.6.0 kompatibel zu sein

API-Änderungen

  • Leiste aus dem Gerüst von Material 3 entfernen. (I04f51)
  • Unterstützung für Material 3-Checkbox wird hinzugefügt. (ID5542)
  • Unterstützung für Material 3-RadioButton wird hinzugefügt. (I20334)

Fehlerkorrekturen

  • Wellenradius von IconButton von 40 dp auf 20 dp reduzieren. (I68bbe, b/206674345)
  • Schneller Pfad des Portstrings für Text Änderungen von compose.material (I30b03)
  • Das Problem wurde behoben, aber die hartcodierte Schaltfläche war immer aktiviert. (Iea832, b/205335456)

Version 1.0.0-alpha01

27. Oktober 2021

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

Neue Funktionen

Design von Material Design 3 und dynamische Farbe von Material You

Material Design 3-Komponenten

Weitere Informationen findest du im Leitfaden zu Material Design 3 und Material You im Abschnitt Material Design 3 und Material You.