Compose Material 3
| Letzte Aktualisierung | Stabile Release | Releasekandidat | Beta-Release | Alpha-Release |
|---|---|---|---|---|
| 23. September 2026 | 1.4.0 | - | - | 1.5.0-alpha29 |
Struktur
Compose ist eine Kombination aus sieben Maven-Gruppen-IDs in androidx. Jede Gruppe enthält eine bestimmte Teilmenge von Funktionen mit jeweils eigenen Versionshinweisen.
In dieser Tabelle werden die Gruppen erläutert und es sind Links zu den einzelnen Versionshinweisen enthalten.
| Gruppe | Beschreibung |
|---|---|
| compose.animation | Animationen in Jetpack Compose-Anwendungen erstellen, um die User Experience zu verbessern |
| compose.compiler | @Zusammensetzbare Funktionen transformieren und Optimierungen mit einem Kotlin-Compiler-Plug-in ermöglichen |
| compose.foundation | Mit den einsatzbereiten Bausteinen können Sie Jetpack Compose-Anwendungen schreiben und die Foundation-Bibliothek erweitern, um eigene Designsystemkomponenten zu erstellen. |
| compose.material | Jetpack Compose-UIs mit einsatzbereiten Material Design-Komponenten erstellen Dies ist der Einstiegspunkt auf höherer Ebene für Compose. Er wurde entwickelt, um Komponenten bereitzustellen, die den auf www.material.io beschriebenen Komponenten entsprechen. |
| compose.material3 | Jetpack Compose-UIs mit Material Design 3-Komponenten erstellen – der nächsten Generation von Material Design. Material 3 umfasst aktualisierte Designs und Komponenten sowie Material You-Personalisierungsfunktionen wie dynamische Farben und ist auf den neuen visuellen Stil und die System-UI von Android 12 abgestimmt. |
| compose.runtime | Grundlegende Bausteine des Programmiermodells und der Statusverwaltung von Compose sowie die Core-Laufzeit für das Compose Compiler-Plug-in. |
| compose.ui | Grundlegende Komponenten der Compose-Benutzeroberfläche, die für die Interaktion mit dem Gerät erforderlich sind, einschließlich Layout, Zeichnen und Eingabe. |
Abhängigkeiten deklarieren
Wenn Sie eine Abhängigkeit von Compose hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie unter Google-Repository bei Maven.
Fügen Sie die Abhängigkeiten für die benötigten Artefakte in der Datei build.gradle für Ihre App oder Ihr Modul hinzu:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.4.0" implementation "androidx.compose.material3:material3-window-size-class:1.4.0" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha29" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.4.0") implementation("androidx.compose.material3:material3-window-size-class:1.4.0") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha29") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Ihr Feedback hilft uns, Jetpack zu verbessern. Wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben, lassen Sie es uns wissen. Bevor Sie ein neues Problem erstellen, sollten Sie sich jedoch die bereits gemeldeten Probleme in dieser Bibliothek ansehen. Wenn Sie sich einer Problemmeldung anschließen möchten, klicken Sie auf den Button mit dem Stern.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Compose Material3 A2UI Version 1.0
Version 1.0.0-alpha01
23. September 2026
androidx.compose.material3:material3-a2ui:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Der Jetpack Compose-Renderer für die Kommunikation zwischen KI-Agenten und Benutzeroberfläche (Agent-to-UI, A2UI) bietet eine Implementierung des A2UI-Protokolls. Damit können KI-Agenten umfangreiche, interaktive Benutzeroberflächen generieren, die native Compose-Komponenten rendern, ohne beliebigen Code auszuführen. Diese Bibliothek bietet eine sofort einsatzbereite Implementierung der A2UI Basic Catalog-Spezifikation, die mit Material Design 3-Komponenten erstellt wurde.
API-Änderungen
- Aktualisieren Sie die Reihenfolge der Komponenten in
A2uiBasicCatalogV, damit sie genau der grundlegenden Katalogspezifikation entspricht. (I23093, b/547851648) ChecksPropertywurde allen relevanten Komponentenschnittstellen unterA2uiBasicCatalogV1hinzugefügt. Der Property-Wert ist über einen Parameter verfügbar, der anTypedContentjeder Komponente übergeben wird. (I9f393, b/547851648)A2uiBasicCatalogV1.ChoicePickerundMaterialA2uiBasicCatalogV1Defaults.choicePickerwurden hinzugefügt. (I875a6, b/547851648)A2uiBasicCatalogV1.ModalundMaterialA2uiBasicCatalogV1Defaults.modalwurden hinzugefügt. (Icd553, b/547851648)AccessibilityPropertywurde allen Komponenten-Schnittstellen unterA2uiBasicCatalogV1hinzugefügt und der Property-Wert ist über einen Parameter verfügbar, der anTypedContentjeder Komponente übergeben wird. (I76b80, b/547851648)A2uiBasicCatalogV1.TextFieldundMaterialA2uiBasicCatalogV1Defaults.textFieldhinzugefügt. (Ifdaec, b/547851648)A2uiBasicCatalogV1.VideoundMaterialA2uiBasicCatalogV1Defaults.videowurden hinzugefügt. (I8595c, b/547851648)A2uiBasicCatalogV1.AudioPlayerundMaterialA2uiBasicCatalogV1Defaults.audioPlayerwurden hinzugefügt. (Ida509, b/547851648)A2uiBasicCatalogV1.SliderundMaterialA2uiBasicCatalogV1Defaults.sliderwurden hinzugefügt. (Ieb72d, b/547851648)A2uiBasicCatalogV1.CheckBoxundMaterialA2uiBasicCatalogV1Defaults.checkBoxwurden hinzugefügt. (I84525, b/547851648)A2uiBasicCatalogV1.DividerundMaterialA2uiBasicCatalogV1Defaults.dividerwurden hinzugefügt. (I91208, b/547851648)A2uiBasicCatalogV1.TabsundMaterialA2uiBasicCatalogV1Defaults.tabswurden hinzugefügt. (Ic33d3, b/547851648)A2uiBasicCatalogV1.ListundMaterialA2uiBasicCatalogV1Defaults.listhinzugefügt. (I89f73, b/547851648)A2uiBasicCatalogV1.IconundMaterialA2uiBasicCatalogV1Defaults.iconwurden hinzugefügt. (I65524, b/547851648)A2uiBasicCatalogV1.ImageundMaterialA2uiBasicCatalogV1Defaults.imagewurden hinzugefügt. (I673b3, b/547851648)A2uiBasicCatalogV1.ButtonundMaterialA2uiBasicCatalogV1Defaults.buttonwurden hinzugefügt. (I5215f, b/547851648)A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.ColumnundMaterialA2uiBasicCatalogV1Defaults.row/MaterialA2uiBasicCatalogV1Defaults.columnwurden hinzugefügt. (Ibcbe7, b/547851648)MaterialImageComponentwurde hinzugefügt, um das Rendern von Bildern im A2UI-Katalog zu unterstützen. Test:MaterialImageComponentTestin androidx-mainMaterialImageComponentwurde hinzugefügt, um das Rendern von Bildern im A2UI-Katalog zu unterstützen. (I868fe)A2uiBasicCatalogV1.CardundMaterialA2uiBasicCatalogV1Defaults.cardwurden hinzugefügt. (Icf604, b/547851648)- Die zustandslosen Überladungen
SliderundRangeSliderwurden zugunsten ihrer zustandsorientierten Versionen eingestellt.activeRangeStartundactiveRangeEndinRangeSliderStatewurden instartValueundendValueumbenannt. Ältere, nicht beworbene und experimentelle Slider-APIs mitDeprecationLevel.HIDDENwurden eingestellt. (If8995) - Die Composables
A2uiSurfaceundA2uiSurfaceDefaultszum Rendern von A2UI-Oberflächen wurden hinzugefügt. (I6e276, b/544713825) - Die zusammensetzbare Funktion
A2uiTestSurfacewurde hinzugefügt, um A2UI-Oberflächen und ‑Komponenten isoliert zu mounten und zu testen. (I03c8a, b/527415570)
Fehlerkorrekturen
compileSdkfür Compose-Bibliotheken auf Version 37.1 aktualisiert. Dazu musscompileSdkfür alle Apps und Bibliotheken, die Compose verwenden, transitiv aktualisiert werden. (I05b0f)
Compose Material3 Common Version 1.0
Version 1.0.0-alpha01
17. April 2024
androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01 und androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 sind veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Themenlose Komponenten, mit denen Material Design-Komponenten erstellt werden können:
- Tonale Palette
- Symbol
- Größe des Berührungszielbereichs
Compose Material3 Adaptive Navigation Suite Version 1.0
Version 1.0.0-alpha07
1. Mai 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 sind veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
- Navigation Suite APIs nicht mehr als experimentell kennzeichnen (If62af)
Fehlerkorrekturen
- Standardmäßig Insets für Inhalte verwenden (50266df)
Version 1.0.0-alpha06
17. April 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
- Fügen Sie
containerColorundcontentColorzuNavigationSuiteScaffoldDefaultshinzu. (I64e3a, b/331993720) - Die Funktion
itemColorswird zuNavigationSuiteDefaultshinzugefügt. (Idf719, b/328480012) NavigationSuiteScopeversiegeln (Iefa57)
Version 1.0.0-alpha05
6. März 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
API-Änderungen
- Machen Sie den
NavigationSuiteItemColors-Konstruktor öffentlich. (Ica83a, b/324886877)
Version 1.0.0-alpha04
21. Februar 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Abhängigkeitsupdates
- Aktualisieren Sie die adaptiven Material3-Abhängigkeiten auf die neuen Modulpfade. (Ibc421)
- Auf die Window Manager-Version von Fenstergrößenklassen umstellen (I3794d)
Version 1.0.0-alpha03
7. Februar 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
- Paketname von „navigation-suite“ in „navigationsuite“ ändern (I7eff7)
- Material3-Komponenten, die in ihrer API ein
MutableInteractionSourceverfügbar machen, wurden aktualisiert und machen jetzt ein nullableMutableInteractionSourceverfügbar, das standardmäßig auf „null“ gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dasMutableInteractionSourcenicht verschieben. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie einMutableInteractionSourcezugewiesen wird. Außerdem kann es sein, dass für andere Komponenten erst dann eine Instanz erstellt wird, wenn sie benötigt wird. Das verbessert die Leistung dieser Komponenten. Wenn Sie dieMutableInteractionSource, die Sie an diese Komponenten übergeben, nicht verwenden, sollten Sie stattdessen „null“ übergeben. Es wird auch empfohlen, ähnliche Änderungen in Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146)
Version 1.0.0-alpha02
13. Dezember 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- „Keine“ als
NavigationSuiteTypehinzufügen (If8cb1, b/313688598)
Fehlerkorrekturen
- Problem behoben: Die Navigationskomponente füllt den gesamten Bildschirm aus, wenn die Stammfläche
modifier.fillMaxSizehat. (c9cf250, b/312664933)
Version 1.0.0-alpha01
15. November 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Compose Material3 Adaptive Version 1.0
Version 1.0.0-alpha06
7. Februar 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
Neue Funktionen
- Es wurden zusätzliche Verhaltensoptionen für die
ThreePaneScaffoldNavigator-Rückwärtsnavigation hinzugefügt. (I858aa) - Dem Navigationsverlauf wurden optionale Zielinhalte hinzugefügt. (Ibd7e6)
Version 1.0.0-alpha05
24. Januar 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
- Unterstützung von Verlaufsdaten in der Gerüstnavigation und Wertberechnung (I71d46)
Version 1.0.0-alpha04
10. Januar 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Unterstützung für Edge-to-Edge-Darstellung in Bereichsgerüsten hinzugefügt (I1b462)
API-Änderungen
- Die Eigenschaften für die Scharniergrenzen wurden in „Posture“ in eine Liste mit Scharnierinformationen verschoben (I24f90).
Fehlerkorrekturen
- Fehlerbehebung:
AnimatedPanewird 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 sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
- Ändern Sie die Gerüstrollen in Aliase von
ThreePaneScaffoldRole. (I65bd1) - Basisklasse für Gerüstrollen erstellen (I4784d)
- Entfernen Sie unnötige Parameter aus den Inhalten von
AnimatedPane(Ibc73b). collectWindowSizeAsStatewird umbenannt und es werden stattdessen Rohwerte zurückgegeben (I480f4)
Version 1.0.0-alpha02
29. November 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
- Navigations-APIs von adaptiven Scaffold-APIs trennen. (Ic4045)
- Entfernen Sie die Klasse
GutterSize. (I785b3)
Fehlerkorrekturen
- Fix: Bereiche werden nicht gewechselt, wenn
AnimatedPanenicht verwendet wird (d88f181)
Version 1.0.0-alpha01
15. November 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
APIs für adaptive Bedingungen in Material 3:
Compose Material 3 Adaptive-APIs für die Anweisung „PaneScaffold“:
Adaptive Pane Scaffold-APIs für Material 3:
- Grundlegende APIs für die Gerüstung von Bereichen
Compose Material3 Version 1.5
Version 1.5.0-alpha29
23. September 2026
androidx.compose.material3:material3-*:1.5.0-alpha29 ist veröffentlicht. Version 1.5.0-alpha29 enthält diese Commits.
API-Änderungen
- Quelländerung:
onValueChangeist jetzt ein erforderlicher Parameter inSliderundRangeSliderund seine Reihenfolge in der Parameterliste hat sich geändert.
Fehlerkorrekturen
DatePickerwird jetzt in einem Frame aufgelöst, indem die Verfügbarkeit der Monatsnavigation direkt aus dem angezeigten Monatsindex berechnet wird. (I08db7)TimeInputverwendet jetzt intern die neuen APIs für das TextfeldTextFieldState. (Ia7492, b/353692863)DateInputverwendet jetzt intern die neuen APIs für das TextfeldTextFieldState. (I5ad3d, b/353692863)SliderundRangeSliderverarbeitenonValueChangeundonValueChangeFinishedjetzt direkt in ihren Implementierungen, anstatt sie anSliderStateundRangeSliderStatezu übergeben. (I959ac)
Version 1.5.0-alpha28
9. September 2026
androidx.compose.material3:material3-*:1.5.0-alpha28 ist veröffentlicht. Version 1.5.0-alpha28 enthält diese Commits.
API-Änderungen
- Die API für das Karussell mit mehreren Aspekten wurde umbenannt und vereinfacht. Sie ist jetzt ein globaler
carouselParallaxScrollEffect-Modifikator (I46b17). - Veraltete
ToggleButton-Überladungen wurden entfernt.ToggleButtonDefaults,ElevatedToggleButtonDefaults,FilledTonalToggleButtonDefaultsundOutlinedToggleButtonDefaultswurden Hilfsfunktionen (contentPaddingFor,shapesFor) und Standardkonstanten (einschließlichsize) hinzugefügt. (I998cf) Die zustandslosen Überladungen
SliderundRangeSliderwurden zugunsten ihrer zustandsorientierten Versionen eingestellt.activeRangeStartundactiveRangeEndinRangeSliderStatewurden instartValueundendValueumbenannt. Ältere, nicht beworbene und experimentelle Slider-APIs mitDeprecationLevel.HIDDENwurden eingestellt. (If8995)So migrieren Sie
Slidervon:kotlin var value by remember { mutableFloatStateOf(0.5f) } Slider(value = value, onValueChange = { value = it })nach:kotlin val state = remember { SliderState(value = 0.5f) } Slider(state = state)So migrieren Sie
RangeSlidervon:kotlin var range by remember { mutableStateOf(0.2f..0.8f) } RangeSlider(value = range, onValueChange = { range = it })nach:kotlin val state = remember { RangeSliderState(startValue = 0.2f, endValue = 0.8f) } RangeSlider(state = state)Boolesche Parameter „enabled“ und Farbparameter „disabled“ zu
ScrollField(Iab612) hinzufügen
Fehlerkorrekturen
- Unterstützung für den Fokusring für
ScrollFieldhinzugefügt. (If21d6) - Design-Feedback-Anpassungen für ausdrucksstarke
TimePickerim Wählmodus vornehmen. (I8795e) - Passen Sie das Padding für ausdrucksstarke
TimePickerim Scroll- und Eingabemodus an. (Iddb33) - Die Höhe/das Layout wird basierend auf der Anzahl der Elemente für ausdrucksstarke
TimePicker.ktim uncontained-Modus berechnet. (I30700) - Ein Problem wurde behoben, bei dem die AM/PM-Steuerelemente in
TimePickerabgeschnitten wurden, wenn großer Text oder Schriftartskalierung aktiviert war. (Iaca60) - Die Komponenten
SecureTextFieldundOutlinedSecureTextField(sowie die eingestelltenBasicSecureTextField-Überladungen) wurden aktualisiert, sodassTextObfuscationMode.Systemanstelle vonTextObfuscationMode.RevealLastTypedals Standardmodus für die Verschleierung verwendet wird. (I76c7e)
Version 1.5.0-alpha27
26. August 2026
androidx.compose.material3:material3-*:1.5.0-alpha27 ist veröffentlicht. Version 1.5.0-alpha27 enthält diese Commits.
API-Änderungen
RichTimePickerDialogwurde inVibrantTimePickerDialogumbenannt,richColorsinvibrantColorsinTimePickerDefaultsundTimeInputDefaults,richContainerColorundrichShapeinvibrantContainerColorundvibrantShapeinTimePickerDialogDefaultsund nicht ausgewählte Farbeigenschaften inperiodSelectorContainerColor,periodSelectorContentColor,timeSelectorContainerColor,timeSelectorContentColorundclockDialContentColor. (Iea5aa)- Aktualisieren Sie die Rich
TimePickerAPI, um ein nicht eingeschlossenes Scroll-/Eingabedialogfeld zu ermöglichen. (I2b3b6) SelectableDropdownMenuItemundCheckableDropdownMenuItemfür auswählbare und ankreuzbare expressive Menüelemente eingeführt.DropdownMenuItemwurde mit der Form für die Verwendung vonMenuItemColorsaktualisiert undMenuDefaults.itemVibrantColors()wurde hinzugefügt, um lebendigeMenuItemColorszu unterstützen. (I160ca)- Es wurden meinungsstarke expressive Überladungen für
ToggleButton,ElevatedToggleButton,FilledTonalToggleButtonundOutlinedToggleButtonmit den SlotsButtonSizeundiconhinzugefügt. Vereinfachte Methodennamen fürToggleButtonDefaults,ElevatedToggleButtonDefaults,FilledTonalToggleButtonDefaultsundOutlinedToggleButtonDefaultszucolors()undborder(). (Iab484) - Veraltete Überladungen von
pinnedScrollBehaviorundenterAlwaysScrollBehaviorausTopAppBarDefaultsentfernt. Verwenden Sie stattdessen die Überladungen, dieScrollableStateakzeptieren. (Idef9d) - Die verworfene experimentelle API
LocalMotionSchemewurde ausMaterialThemeentfernt. Verwenden Sie stattdessenMaterialTheme.motionScheme. (I4b61d) TimeInputDefaultsundTimeInputColorsfürTimeInputhinzugefügt. (I7534e)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem
ScrollDisplayModeToggleim Scrollmodus „Zum Scrollmodus wechseln“ angekündigt hat. (I2d588) - Ein Problem wurde behoben, bei dem nachgestellte Symbole in
DropdownMenuItemohne vorangestelltes Symbol nicht am Ende des Menüelements ausgerichtet wurden. (Ia24ff, b/542873381)
Version 1.5.0-alpha26
12. August 2026
androidx.compose.material3:material3-*:1.5.0-alpha26 ist veröffentlicht. Version 1.5.0-alpha26 enthält diese Commits.
API-Änderungen
ElevatedToggleButtonDefaults,FilledTonalToggleButtonDefaultsundOutlinedToggleButtonDefaultswurden hinzugefügt und nicht semantische Formattribute inToggleButtonDefaultswurden bereinigt. (Ia0a85)- Es wurde ein Problem mit dem Kontrast für die Barrierefreiheit für das Label des horizontalen
NavigationItemin kontrastreichen Designs behoben. Die Farbe des Labels wird jetzt überselectedTextColorTopIconPosition(Farbe des Labels für vertikale Elemente, die sich nicht geändert hat) undselectedTextColorStartIconPosition(Farbe des Labels für horizontale Elemente, die jetzt anselectedIconColorangepasst ist) angegeben. Wenn Sie diese Änderung rückgängig machen möchten, übergeben SieShortNavigationBarItemDefaults/WideNavigationRailItemDefaults.colors().copy(selectedTextColorStartIconPosition=MaterialTheme.colorScheme.secondary) (I85855, b/490910896). - Scroll-Offset-Variablen wurden aus
SearchBarScrollBehaviorentfernt und sollten jetzt über die neue KlasseSearchBarScrollStateaufgerufen werden. (Ib24e4) BottomAppBarund die zugehörigen Methoden wurden auf „stabil“ hochgestuft. Für diese APIs ist die @ExperimentalMaterial3Api-Anmeldung nicht mehr erforderlich. (I42c61)- Der aktive Auswahlmodus wird in
TimePickerStatebei der Wiederherstellung des Zustands gespeichert. Der ParameterinitialSelectionwurde der FabrikmethodeTimePickerStatehinzugefügt. (Iad905) ExposedDropdownMenuist jetzt eine Erweiterungsfunktion fürExposedDropdownMenuBoxScopeanstelle eines Members. Möglicherweise müssen Sie Ihren Code mit einem neuen Import aktualisieren. (Ie8a65, b/356452026)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem durch die teilweise Farbanpassung in
MenuDefaults.itemColorsnicht angegebene Farben mitColor.Unspecifiedüberschrieben wurden. (Iea847) - Es wurde ein Fehler behoben
TalkBack, der dazu führte, dass formatierte Zeitwerte in der scrollbarenTimePickernicht richtig angezeigt wurden. (Ice981) - Ein Absturz in
ExposedDropdownMenuwurde behoben, wenn die Bildschirmhöhe kleiner als die Menühöhe ist. (I6adf1) - Falsches Content-Padding der breiten Navigationsleiste wurde korrigiert. Das untere Padding ist jetzt 0. Wenn Sie diese Aktualisierung rückgängig machen möchten, können Sie
contentPadding = PaddingValues(0.dp,44.dp,0.dp,44.dp)festlegen. (I572bb) - Die öffentliche API wurde aktualisiert, um dem Feedback aus der letzten API-Überprüfung zu entsprechen. (I71aff, b/532657001)
Externer Beitrag
- Ein Problem wurde behoben, durch das das Material3-
SliderLabelnicht angezeigt wurde, wenn der Schieberegler mit einer Maus am Ziehpunkt gezogen wurde. (I97a6d, b/533483487)
Version 1.5.0-alpha25
29. Juli 2026
androidx.compose.material3:material3-*:1.5.0-alpha25 ist veröffentlicht. Version 1.5.0-alpha25 enthält diese Commits.
API-Änderungen
- Der Parameter
trailingIconwurde in der Form intrailingContentumbenannt. Die ÜberladungenDropdownMenuItemwurden geprüft und ausgewählt, wobei die binäre Kompatibilität beibehalten wurde. (I2ecbd) - In
MenuItemColorswurden neue Auswahl- und Containerfarbeneigenschaften hinzugefügt undtrailingIconwurde im neuen Farbkonstruktor intrailingContentumbenannt, wobei die binäre Kompatibilität beibehalten wurde. (I20b92) - Verbesserte
ScrollField-Bedienungshilfen und Unterstützung der Tastaturnavigation. (If7477) ComponentOverride-APIs entfernen (I3784b)- Die veralteten 2-Parameter-Funktionen
SliderState.SaverundRangeSliderState.Saverwurden zugunsten neuer Überladungen mit Schritten entfernt.SliderStateimplementiertDraggableStatenicht mehr öffentlich. (I7c91b) BasicAlertDialogAPI aus dem experimentellen Status entfernen (If157c)ButtonGroupScopeinButtonGroupwurde insealed interfacegeändert.Modifier.animateWidthwurde in zwei Überladungen aufgeteilt, damitcompressionLimitweggelassen und die Layoutrichtung dynamisch aufgelöst werden kann. Der Parametertyp voncompressionLimitwurde vonPaddingValuesinDpgeändert. (I8ef39)TonalToggleButtonwurde inFilledTonalToggleButtonumbenannt. FürOutlinedToggleButtonwurden Animationen für weiche Rahmenlinien hinzugefügt.ToggleButtonDefaults.shapeswurde zugunsten vonshapesForverworfen. (Icb433)LinearTrackStopIndicatorSize,LinearIndicatorTrackGapSizeundCircularIndicatorTrackGapSizeauf „Stabil“ hochstufen. (I794d0)- Die
SplitButtonLayout-API wurde verworfen. Verwenden Sie stattdessenSplitButton(Ic9840).
Fehlerkorrekturen
- Aktualisieren Sie die Fokusumschaltung im Fehlerfall für die
TimePickerTextField-Eingabe inTimePicker.kt. (Ieceec) - Die Form des segmentierten Listenelements wurde korrigiert, wenn die Liste nur ein Element enthält. (I2ea1c, b/479721696)
- KDocs für
TimePickerDialog.ktaktualisieren (Ia5fb8)
Version 1.5.0-alpha24
15. Juli 2026
androidx.compose.material3:material3-*:1.5.0-alpha24 ist veröffentlicht. Version 1.5.0-alpha24 enthält diese Commits.
Funktionen
- Neue Scroll-Variante für ausdrucksstarke
TimePickerhinzufügen (I46f6b) - Eine neue
material3-ripple-Bibliothek (I1b3a3) wurde hinzugefügt, die das Zeichnen von Ripples unterstützt, die den Fokus mithilfe von Fokusringen anstelle einer Deckkraftschicht visuell darstellen. Diese neue Bibliothek ersetztmaterial-ripple. Die erwartete Verwendung ist ähnlich:- Wenn Sie
material3selbst verwenden, nutzen Sie die integriertematerial3-Ripple-Konfiguration, die in das Theme eingebunden ist und internmaterial3-rippleals Implementierungsdetail verwendet. - Wenn Sie
material-rippledirekt verwendet haben oder Fokusringe mit Einzug unterstützen möchten, ohne vonmaterial3abhängig zu sein, verwenden Sie die neuematerial3-ripple-Bibliothek direkt.
- Wenn Sie
API-Änderungen
- Der Parameter „scrollbar“ (
ScrollIndicatorState) ist jetzt nicht mehr nullable. (Iab7c7, b/529445739) - Die Annotation
@ExperimentalMaterial3Apiwurde denAppBarWithSearchAPIs wieder hinzugefügt. (I0b61a) - Die APIs für beworbene
SearchBarStateund slotbasierteSearchBarwurden auf „stabil“ hochgestuft. ÄltereSearchBar-APIs, die erweiterteonExpandedChangeverwenden, wurden eingestellt. (Ia3793)
Fehlerkorrekturen
- Ein Problem mit der Rendering-Verzögerung wurde behoben, bei dem die Einfügemarken
RichTooltipundPlainTooltipwährend der Eingangsanimation erst spät angezeigt wurden. (I874b6, b/395753083) - Aktualisieren Sie die Grenzwerte für die Eingabe-/Scroll-Variante von
TimePicker. (I83f00) SplitButtonMessen Sie zuerst den nachfolgenden Button, um genügend Platz zu schaffen. (Id3a1e)- Ein Problem mit der Barrierefreiheit wurde behoben, bei dem Nutzer von Schalterzugriff bearbeitbare Textfelder in
ExposedDropdownMenuBoxnicht aktivieren konnten. (I0ea17) - Die Reihenfolge der TalkBack-Ankündigungen in
TextFieldundOutlinedTextFieldwurde korrigiert, wenn ein Präfix oder Suffix vorhanden ist. (Ie79e7) TimePicker-Ränder und Platzierung des Doppelpunkts aktualisieren (I6bfeb)- Fokusreihenfolge in TalkBack für
ScrollFieldkorrigieren. (I4ca9f, b/526870141) - Die Compose-Abhängigkeiten in Material 3 wurden auf Version 1.12.0-beta01 aktualisiert. (Ie9417)
- Tooltips werden jetzt an die Fenstergrenzen angepasst, damit sie auf kleinen Bildschirmen oder bei großen Schriftkonfigurationen nicht abgeschnitten werden. (I421ff)
ScrollFieldmit ausdrucksstärkeren Zahlenübergängen aktualisieren und Größe/Typografie anpassen (Ic1614)
Version 1.5.0-alpha23
01. Juli 2026
androidx.compose.material3:material3-*:1.5.0-alpha23 ist veröffentlicht. Version 1.5.0-alpha23 enthält diese Commits.
Funktionen - Komponente expressive timepicker (Iaa45f) - Es wurden neue nicht interaktive Varianten von Standardlistenelement und segmentiertem Listenelement hinzugefügt, die den Material Expressive-Spezifikationen entsprechen. Die nicht expressive Version ist veraltet. (Ide4de, b/491994186)
Verhaltensänderung
– Ein Problem wurde behoben, bei dem sich die Mindesthöhe von ausdrucksstarken Listenelementen nicht basierend auf den Inhaltszeilen geändert hat. Das Funktions-Flag isExpressiveListItemHeightBasedOnTextLinesFixEnabled wurde eingeführt, um die Migration zu erleichtern. (Ibbb91, b/484693233)
API-Änderungen
- Die APIs für ausdrucksstarke Listenelemente sind nicht mehr experimentell. (I2836a)
ComponentOverride-APIs entfernen (I820c4)- Entfernen Sie den nicht verwendeten Offsetparameter aus
DropdownMenuPopup. Die Standardmenüattribute wurden in die Menüstandardeinstellungen aufgenommen. Der Name des Labels für Gruppen wurde von „MenuDefaults.Label“ zu „MenuDefaults.DropdownMenuGroupLabel“ geändert.disabledContainerColorwurde inMenuDefaults.selectableItemColorsundMenuDefaults.selectableItemVibrantColorseingefügt. Der ParameterModifierwurde zu zusammensetzbaren Funktionen inMenuDefaultshinzugefügt, die ein Layout zurückgeben. (I3d2b1) TopAppBarDefaultswurde ein öffentlicherflingAnimationSpec-Getter hinzugefügt, um die Standardspezifikation für die Fling-Animation verfügbar zu machen. (Ic1daa)- Die Funktionen
TopAppBar,MediumFlexibleTopAppBar,LargeTopAppBar,LargeFlexibleTopAppBar,TwoRowsTopAppBar,FlexibleBottomAppBar,FlexibleContentPadding,FlexibleBottomAppBarHeight,FlexibleHorizontalArrangement,FlexibleFixedHorizontalArrangementwerden nicht mehr als experimentell eingestuft. Für diese APIs und Variablen ist die Einwilligung von @ExperimentalMaterial3ExpressiveApinicht mehr erforderlich. (Ia4af6) ExpandedDockedSearchBarWithGapundExpandedFullScreenContainedSearchBarauf nicht experimentell (Ie152d) umstellen
Fehlerkorrekturen
- API-Informationen werden bereinigt (Ia8066)
- Korrigieren Sie die Reihenfolge der Tastaturnavigation von
Scaffold. (I77194, b/462577176) - Anforderung für
compileSdk 37entfernen (If78b4) - Unterstützung für Barrierefreiheit für die ScrollField-Komponente hinzugefügt. Genauer gesagt, implementiert ScrollField jetzt die Auswahl und animiert bei einem Klick zum ausgewählten Element. Außerdem werden ausgewählte/nicht ausgewählte Elemente in Talkback angekündigt. (I7bdb7)
- Es wurde ein Fehler behoben, bei dem zusätzlicher unterer Abstand vorhanden war, wenn für den Inhalt des Navigationssuite-Scaffolds IME-Abstand festgelegt war. (I86d9d, b/389467593)
Version 1.5.0-alpha22
17. Juni 2026
androidx.compose.material3:material3-*:1.5.0-alpha22 ist veröffentlicht. Version 1.5.0-alpha22 enthält diese Commits.
API-Änderungen
- Der Klasse
TopAppBarDefaultswurde ein öffentlichersnapAnimationSpec-Getter hinzugefügt, um die Standardspezifikation für die Snap-Animation verfügbar zu machen. (Ic7b37, b/519193808) - Formen für interne und private Methoden der TimePicker.kt-API hinzugefügt (I9d09e, b/441573791)
- Unterstützung von Formen in
AnimatedPane(Ie7c60, b/470517507) - Kontrast der Ein/Aus-Buttons für AM/PM für TimePicker korrigiert (Ifc0b7, b/339079853)
- Expressive
FloatingToolbar-APIs aus der Testphase entfernen. (I5a4d8, b/497887216) - Veraltetes
transformOriginStateausDropdownMenuPopupPositionProviderentfernen. (I0d5b0, b/505481611) pinnedScrollBehaviorundenterAlwaysScrollBehaviorwurden aktualisiert, um einScrollableStatezu akzeptieren, das automatisch Grenzfälle wie umgekehrte Layouts und vorab gescrollte Inhalte verarbeitet. Legacy-Überladungen sind veraltet. Migrieren Sie die Verwendung vonisScrollingContentAtStartzu den neuen Überladungen mit dem ParameterscrollableState.TopAppBarScrollBehaviorund zugehörige APIs wurden auf „stabil“ hochgestuft. (Ib83cf, b/519193808)pinnedScrollBehaviorundenterAlwaysScrollBehaviorwurden aktualisiert, um einScrollableStatezu akzeptieren, das automatisch Grenzfälle wie umgekehrte Layouts und vorab gescrollte Inhalte verarbeitet.TopAppBarScrollBehaviorund zugehörige APIs wurden auf „Stabil“ hochgestuft. (Ieda4b, b/405129274)- Aktualisieren Sie
DropdownMenuPositionProvider, umMutableStateaustransformOriginzu entfernen. Fassen SieMenuAnchorPositionaus einem versiegelten Interface in einer einzelnen Klasse zusammen. FührtMenuAnchorPositionScopeein, das Informationen enthält, mit denen benutzerdefinierte x- und y-Kandidaten erstellt werden können. (I21f2b, b/505481611) ButtonGroup-APIs auf stabil hochstufen Veraltete experimentelle APIs entfernen, die in Version 1.5.0-alpha eingeführt wurden. (Idaf96, b/497876828)
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem die Komprimierungsanimation von
ButtonGroupasymmetrische Schaltflächenabstände oder RTL-Layoutrichtungen nicht richtig verarbeitet hat und bei bestimmten Anzeigedichten mitIllegalArgumentExceptionabstürzen konnte. (I35074, b/516743181) - Fehlerbehandlungsmechanismus für den TimePicker-Texteingabemodus korrigiert (If4541, b/405054265)
Version 1.5.0-alpha21
3. Juni 2026
androidx.compose.material3:material3-*:1.5.0-alpha21 ist veröffentlicht. Version 1.5.0-alpha21 enthält diese Commits.
API-Änderungen
- Der API für die Zeitachse wird die Möglichkeit hinzugefügt, Formen zu verwenden (I57f28, b/441573791).
compressionLimitwurde zuanimateWidthhinzugefügt. Damit wird das Padding des zu komprimierenden Elements angegeben, das die maximale Komprimierung angibt, die das Element erfahren kann. DieanimateWidthAPI wird ohne diesencompressionLimit-Parameter eingestellt. (I4a725, b/418822334, b/403281052)- Der Anker
BottomSheetundModalBottomSheetPartiallyExpandedwird nicht mehr programmatisch auf Grundlage von Layoutbedingungen entfernt. Nutzer können diesen Anker jetzt explizit überrememberBottomSheetStatesteuern. Das alte Verhalten für diese Komponenten kann aktiviert werden, indem Sie das Funktions-FlagisBottomSheetPartiallyExpandedDeterministicEnableddeaktivieren oder die eingestellten FunktionenrememberModalBottomSheetStateundrememberStandardBottomSheetStateverwenden.isAnchoredDraggableComponentsAnchorRecoveryEnabledwurde aus den Funktions-Flags entfernt. (Ia4167, b/478210200, b/512076811) - Das experimentelle Tag für
PullToRefreshDefaults.loadingIndicatorColorundPullToRefreshDefaults.loadingIndicatorContainerColorwird wieder eingeführt (Ib9d15, b/513225663) - Die
SelectableChipColors-Parameter wurden auf öffentlich aktualisiert (I559e0, b/512576750) - Parameter
horizontalArrangementzuMenuItemshinzufügen (Ie8088, b/497891817) - Die
contentPaddingFor-Funktion des Buttons als experimentell kennzeichnen. (I07d3e, b/500355872) - Die visuellen Konfigurationen für den ausdrucksstarken Stil
roundedShapeundtonalColors()wurden sowohl inTextFieldDefaultsals auch inOutlinedTextFieldDefaultseingeführt. (Id9185, b/448728288) TextFieldLabelPosition.Attachedwurde eingestellt und die UntertypenInsideundCutoutwurden eingeführt. Dadurch sind mehr Anpassungen möglich, z. B. die Platzierung einesOutlinedTextFieldmit Innenlabel. Außerdem wurdeOutlinedTextFieldDefaults.contentPadding()eingestellt undOutlinedTextFieldDefaults.contentPaddingWithLabel()undOutlinedTextFieldDefaults.contentPaddingWithoutLabel()eingeführt, um beide Labelpositionen zu unterstützen. (I40f62, b/448728288)
Fehlerkorrekturen
- Ein Problem mit der Barrierefreiheit in
TimePickerwurde behoben. Der Tastaturfokus ging verloren, wenn auf dem Zifferblatt von Stunden zu Minuten gewechselt wurde. Die Bedienungshilfen für den Tastaturfokus wurden verbessert. (I7dd81, b/498361169)
Externer Beitrag
- Die Physik der Schließen-Geste für BottomSheets wurde verbessert, um die Nutzerfreundlichkeit zu erhöhen. (I21df5)
Version 1.5.0-alpha20
19. Mai 2026
androidx.compose.material3:material3-*:1.5.0-alpha20 ist veröffentlicht. Version 1.5.0-alpha20 enthält diese Commits.
API-Änderungen
- Funktion „
shouldUsePrecisionPointerComponentSizing“ entfernt (I882c3, b/498698039) - Ein Problem wurde behoben, bei dem das Tooltip-Caret auf der falschen Seite angezeigt wurde, wenn der Tooltip aufgrund von Bildschirmrändern umgeklappt wurde. (Idc314, b/479224210)
rememberBottomSheetStatewurde als einheitliche API für denBottomSheet-Status eingeführt. Die APIsrememberModalBottomSheetStateundrememberStandardBottomSheetStatewurden zugunsten der neuen einheitlichen API eingestellt. (I2724e, b/500005697)- Entfernen veralteter experimenteller
WideNavigationRail-APIs (Iaadd6, b/497891040) SplitButton-APIs aus der Testphase entfernen. (I4d395, b/497876691)- Die
DropdownMenuItem-APIs mit aktivierten und ausgewählten Parametern, diesupportingTextals nachgestellte Lambda-Funktion haben, werden eingestellt.supportingTextwurde als Parameter direkt nachtrailingIconverschoben. (Icaf79, b/503047115)
Fehlerkorrekturen
- Den Handler für die intelligente „Zurück“-Geste der Navigationsleiste aktualisiert, damit das Zurückgehen möglich ist, während die Leiste geöffnet wird, und nicht erst, wenn sie vollständig geöffnet ist (I714ae, b/418556231)
Version 1.5.0-alpha19
6. Mai 2026
androidx.compose.material3:material3-*:1.5.0-alpha19 ist veröffentlicht. Version 1.5.0-alpha19 enthält diese Commits.
Neue Funktionen
- Für die Typografie wird jetzt eine Standardschriftfamilie unterstützt, die mit den bereitgestellten Textformatierungen zusammengeführt wird, wenn für diese keine Schriftfamilie explizit festgelegt ist. (I2e305, b/500356360)
API-Änderungen
- Entfernt
supportingTextals nachgestellte Lambda-Funktion fürDropdownMenuItem. Verschieben Sie sie stattdessen direkt nach demtrailingIcon. (I5694b, b/503047115) ToggleButtonsin die stabile Version hochstufen (I8a771, b/497876827)- Expressive Menü-APIs bewerben Entferne
DropdownMenuItem, da es sich um eine eingestellte experimentelle expressive API handelt, die Teil von 1.5.0-alpha war. (I1d556, b/497885285) - FAB- und FAB-Menü-APIs aus dem experimentellen Expressive-Status entfernen (Ie509c, b/497892373)
- Bewerben Sie APIs für expressive Schaltflächen. Die verworfene experimentelle API
SmallButtonContentPadding, die in Version 1.5.0-alpha eingeführt wurde, wurde entfernt. (Iee31e, b/497873833) - Scaffold-Bestell-APIs wieder auf „experimentell“ setzen (I01492, b/489424245)
- Eine weitere Überladung des Typography-Konstruktors hinzufügen (I8b3b3, b/500356360)
- Stellen Sie die Promotions
MaterialShapesundLoadingIndicatorauf „Stabil“ zurück. (I30e69, b/497876695, b/497877850)
Fehlerkorrekturen
- Ein Fehler in der Implementierung des Schiebereglers wurde behoben, der dazu führte, dass das Padding der Fokusringe mit Inset auf den Track und den Thumb angewendet wurde, wenn die Komponente nicht im Vordergrund war. (I16315, b/506158497)
- Ein Problem in
ModalBottomSheetwurde behoben, bei demimePaddingbedingungslos angewendet wurde. Dadurch konnte das IME-Verhalten nicht übercontentWindowInsetsgesteuert werden. (Ied801, b/289824811) - [FAB] Absturz in
Modifier.animateFloatingActionButtonbehoben, der durch die Rundung von Dichte-Integer zu Float verursacht wurde (I2d25f, b/489769219) - Das Problem, dass der Fokus in der Zeitraumauswahl hängen bleibt, wurde behoben. Mit der Tabulatortaste wird der Fokus auf die Datumsangaben und wieder von ihnen weg verschoben. Mit den Pfeiltasten wird der Fokus durch die Datumsangaben verschoben. (I7f3ea, b/498332749)
- Änderungen an mittelgroßen und großen Schaltflächen für den Präzisionszeigermodus rückgängig machen und die Standardsymbolgröße des Dialogfelds auch für den Präzisionszeigermodus festlegen (I58d8c, b/496938250, b/500356640)
- Ein Problem wurde behoben, durch das der Tastaturfokus in der Datums- und Uhrzeitauswahl ohne Dialogfeld hängen blieb. Außerdem wurde die Fokusreihenfolge der Schaltflächen zum Schließen und Bestätigen korrigiert, sodass sie der visuellen Reihenfolge entspricht. (Ibbe2e, b/500454457)
Version 1.5.0-alpha18
22. April 2026
androidx.compose.material3:material3-*:1.5.0-alpha18 ist veröffentlicht. Version 1.5.0-alpha18 enthält diese Commits.
Neue Funktionen
- Fügen Sie
FilterChip-,ElevatedFilterChip- undInputChip-Überlastungen mit Form-Morphing hinzu. Neue Standardwerte für Form, Abstand und Farbe für diese Überlastungen hinzufügen. (I84717, b/442678355) - Unterstützung für den Fokusring im Inset-Stil über eine Opt-in-API mit der neuen lokalen Komposition
LocalRippleThemeConfigurationhinzugefügt. (I0551a, b/282184440).
API-Änderungen
rememberWithGapSearchBarStatewurde inrememberSearchBarWithGapStateumbenannt. (I5f54b, b/498697243)- Die APIs
RippleThemeConfigurationundLocalRippleThemeConfigurationsind jetzt stabil. Es besteht die Möglichkeit, Wellen so zu konfigurieren, dass sie mit einem Fokusring mit Inset-Darstellung gezeichnet werden, anstatt mit einer opazitätsbasierten Fokusanzeige. APIs, die die Konfigurations-APIs für Material-Ripple verwenden, sind veraltet. (Ide5d0, b/485893129) WavyProgressIndicator-APIs bewerben (Id72a3, b/497877853)- Promote
materialExpressTheme,expressiveLightColorScheme(I40eab, b/497876844) - Die zusammensetzbare Funktion
BottomSheetwurde nachBottomSheet.ktverschoben (If7e33, b/500091309). - Fügen Sie die
Material3ExpressiveApi-Annotation hinzu, für dieOptInnicht erforderlich ist. (Ib9f2e, b/499994043) - Fügt
DropdownMenuPopupPositionProviderszuDropdownMenuPopuphinzu, damit Entwickler jetzt die Position des Menüs relativ zum Anker konfigurieren können. Dadurch werden Untermenüs in Dropdown-Menüs unterstützt. Sie können jetzt mithilfe neuer ankerbezogener Positionierungen kaskadierende Untermenüs erstellen. Übergeben Sie diese neuen Positionierungsoptionen anrememberDropdownMenuPopupPositionProvider, um das Menü zu konfigurieren. Eine vollständige Implementierung finden Sie im Beispiel für das Katalogmenü. (Ic1ace, b/476161294)
Fehlerkorrekturen
- Material3-Komponenten aktualisieren, um Fokusring-Hinweise zu unterstützen (I88006, b/498610244, b/467984300, b/498281359)
- Ein Problem in
TimePicker-Beispielen wurde behoben, bei dem der Fokus vonTalkBackverschoben wurde, sodass eine ungültige Zeiteingabe möglich war (I51690, b/498364606).
Version 1.5.0-alpha17
8. April 2026
androidx.compose.material3:material3-*:1.5.0-alpha17 ist veröffentlicht. Version 1.5.0-alpha17 enthält diese Commits.
API-Änderungen
TopAppBarScrollBehaviorund die zugehörigen Methoden wurden auf „stabil“ hochgestuft. Für diese APIs ist das@ExperimentalMaterial3Api-Opt-in nicht mehr erforderlich. (Ieb2d1, b/496918628)
Version 1.5.0-alpha16
25. März 2026
androidx.compose.material3:material3-*:1.5.0-alpha16 ist veröffentlicht. Version 1.5.0-alpha16 enthält diese Commits.
Neue Funktionen
Typography-Konstruktoren und ‑Attribute werden unterstützt. Es wurde einTypography-Konstruktor hinzugefügt, der einen Standardwert fürFontFamilyakzeptiert, der auf alleTextStylesin der Skala angewendet werden soll. (I3f6f1, b/236358112)- Experimentelle APIs für Schieberegler in stabile APIs umwandeln (I5efb3, b/304811984)
API-Änderungen
- Das
isAnchoredDraggableComponentsAnchorRecoveryEnabled-Funktions-Flag wurde für ziehbare Komponenten eingeführt, bei denen mehrdeutige Zielfehler auftreten. Zu den Komponenten gehörenModalBottomSheet,BottomSheetScaffold,SwipeToDismissBoxundWideNavigationRail(I5b0e5, b/487941042, b/478210200, b/477038695). - Die Standardfunktion
DropdownMenuItemTrailingLabelund optimierte UI-Abstände für Zeiger für segmentierte Menüs wurden hinzugefügt (I28977, b/485937388). - Es wurden Abstände für Dialogfelder hinzugefügt, wenn
ComposeMaterial3Flags.isPrecisionPointerComponentSizingEnabled„true“ ist, undAlertDialogDefaults.IconSizefür das Symbol. (Ib9652, b/485932651) - Die internen Berechnungen der Mindestgröße für
BasicTextFieldwurden optimiert. Diese werden vonComposeFoundationFlags#isBasicTextFieldMinSizeOptimizationEnabledgesteuert. Wenn Sie sie deaktivieren möchten, müssen Sie deaktivieren. (I70ade) - Die Parameterreihenfolge in
SearchBarDefaults.InputFieldwurde aktualisiert, um die Quellcodekompatibilität beizubehalten. (I20e3b, b/486964336) - Entfernen Sie die verworfenen APIs
FilterChipundAssistChipmit dem Parameter „horizontalSpacing“ (Iec623, b/483762893). - Der Parameter
isAtTopinTopAppBarDefaults.pinnedScrollBehaviorundTopAppBarDefaults.enterAlwaysScrollBehaviorwurde inisAtStartumbenannt (If7323, b/405129274).
Fehlerkorrekturen
BottomSheet-Komponenten berücksichtigen jetztMaterialTheme.motionSchemebei verschachtelten Scroll- und Drag-Gesten. (I5fe22, b/452071842, b/384959324)- Das Problem, dass der Abstand zwischen Symbol und Label angewendet wurde, wenn das Element ein
selectedLeadingIconhatte, das derzeit nicht angezeigt wird (Iba820), wurde behoben.
Version 1.5.0-alpha15
25. Februar 2026
androidx.compose.material3:material3-*:1.5.0-alpha15 ist veröffentlicht. Version 1.5.0-alpha15 enthält diese Commits.
Neue Funktionen
- Die Scrim-Komponente wurde für die Verwendung zusammen mit Modal-Komponenten eingeführt. (I29555, b/455862212, b/372395682, b/375853129)
- Einführung einer eigenständigen statischen Tabellenblattkomponente. (I0ef95, b/455862212, b/350779977, b/444176963, b/336349080)
API-Änderungen
MaterialThemewurde umgestaltet, um ein einzelnesCompositionLocalfür Themadaten zu verwenden. Auf Kompositions-Locals kann jetzt überMaterialTheme.LocalMaterialTheme.currentodercurrentValueOf(MaterialTheme.LocalMaterialTheme)inCompositionLocalAccessorScopezugegriffen werden (Idee2e, b/483676974).- Aktualisieren Sie das Standard-Content-Padding des ausdrucksstarken Text-Buttons, um die Spezifikationen zu korrigieren. Entfernen Sie auch die Einstellung von
TextButtonContentPaddingundTextButtonWithIconContentPadding. (I67283) - Parameter zum Deaktivieren des Backhandlers aus
BottomSheeteinführen (Iff81e, b/483763626) - Bewegungsschema aus dem Test entfernen (If822f, b/484003769)
- Die Parameter „enabled“ und „threshold“ wurden
PullToRefreshBoxin Material3 hinzugefügt. (I5610b, b/369044003) - Ersetzen Sie
horizontalSpacingdurchhorizontalArrangementinFilterChipundElevatedFilterChip. Die Standardeinstellung für „horizontalArrangementhinzufügen“ istFilterChipDefaults. (If3d6a, b/304853782) - Die KDoc für
TopAppBarDefaults-Scrollverhalten wurde verbessert, um die Verwendung mit umgekehrtem und vorab gescrolltem Inhalt besser zu erklären. (I247dd, b/405129274) - Ersetzen Sie den Parameter
horizontalSpacingdurch den ParameterhorizontalArrangmenet. Die Standardeinstellung für „horizontalArrangementhinzufügen“ istAssistChipDefaults. (I15cec, b/304853782) - Getter für
shouldUsePrecisionPointerComponentSizinghinzufügen (I234ce) - Es wurden Überladungen für
TopAppBarDefaults.enterAlwaysScrollBehaviorundTopAppBarDefaults.pinnedScrollBehaviorhinzugefügt, die einenisAtTopState-Parameter akzeptieren. So kann dieat top state-Erkennung bei Verwendung der Scroll-Verhaltensweisen angepasst werden. (I785b9, b/405129274) - Fügen Sie die Parameter
contentPaddingundhorizontalArrangementzuInputChipundElevatedInputChiphinzu. Die Standardeinstellung für „horizontalArrangement“ und „contentPadding“ ist „InputChipDefaults“. (Iae39c, b/304853782) - Die Größe und die Abstände des Präzisionszeigers für Schaltflächen wurden angepasst und der veraltete
TextButtonContentPadding-Wert wurde entfernt. (I6d7b6, b/479879803) rememberWithGapSearchBarStatewurde zur Verwendung mitExpandedDockedSearchBarWithGaphinzugefügt. (Ia3361)
Fehlerkorrekturen
- Das Problem wurde behoben, dass für schwebende Bereiche keine Schatten angezeigt wurden (Ie6108, b/470517507).
- Aktualisieren Sie
TextButtons, damit die richtigen Material 3-Padding-Spezifikationen verwendet werden. Wenn Sie die Vorabversion deaktivieren und zum alten Verhalten zurückkehren möchten, müssen SieisTextButtonContentPaddingFixEnabledin Ihrer Anwendung auf „false“ setzen. (I66c8e)
Version 1.5.0-alpha14
11. Februar 2026
androidx.compose.material3:material3-*:1.5.0-alpha14 ist veröffentlicht. Version 1.5.0-alpha14 enthält diese Commits.
Problemumgehung
isAnchoredDraggableComponentsStrictOffsetCheckEnabledwurde hinzugefügt. Mit diesem Flag wird gesteuert, ob für die RailsBottomSheetScaffold,ModalBottomSheet,SwipeToDismissBoxundWideNavigationdie internen Offsets initialisiert werden müssen. Wenn diese Option deaktiviert ist, werden die Inhalte der Komponenten erst platziert, wenn der Offset initialisiert wurde. Dieses Flag kann helfen, einen Fehler vorübergehend zu umgehen, bei dem diese Komponenten eine Ausnahme auslösen, weil der Offset nicht initialisiert wurde. (I36870, b/477038695, b/478210200, b/471818801, b/475249572, b/475598146)
API-Änderungen
- Fügen Sie
isTextButtonContentPaddingFixEnabledhinzu, damitTextButtonbei „true“ die richtigen Spezifikationen für den Innenabstand hat. (Ib986e) - Der Parameter
indicatorPaddingwurde fürWideNavigationRailItemhinzugefügt. (I3d5dc) - Fügen Sie die Parameter
contentPaddingundhorizontalArrangementzuSuggestionChipundElevatedSuggestionChiphinzu. Die Standardeinstellung für „horizontalArrangement“ und „ContentPadding“ ist „SuggestionChipDefaults“. Erstellen Sie den KursChipArrangement. (Ida874, b/304853782) - Aktualisieren Sie die auswählbaren Menüpunkte, damit sie einen Parameter für unterstützenden Text enthalten. Die bisherigen APIs, die den Parameter für unterstützenden Text nicht enthalten, werden eingestellt. Fügen Sie auch die empfohlenen Standardsymbolgrößen für das führende und das nachfolgende Symbol hinzu. (I89e4b, b/417731599)
- Das Snackbar-Layout wurde aktualisiert, um die Ausrichtung von mehrzeiligem Text zu verbessern. Um Störungen der Benutzeroberfläche zu minimieren, wurde das Flag
isSnackbarStylingFixEnabledeingeführt, um die Migration zu erleichtern. Aktivieren Sie dieses Flag manuell in Ihrer Anwendung. Es wird in einer zukünftigen Version entfernt. (I37d63, b/322866101) - Ein Fehler in
BottomSheetScaffold,ModalBottomSheet,SwipeToDismissBoxundWideNavigationRailwurde behoben, bei dem die Anker in einigen Fällen nicht neu berechnet wurden. Dieser Fix ist hinter einem Funktions-Flag,ComposeMaterial3Flags#isAnchoredDraggableComponentsInvalidationFixEnabled, verborgen. (I9acb1, b/478210200) - Fügen Sie den Parametern
WideNavigationRailundModalWideNavigationRailden Parameter für den Innenabstand hinzu, damit die Standardinnenabstände angepasst werden können. (I49106)
Fehlerkorrekturen
- Wenn Sie
BottomSheetScaffold sheetPeekHeightauf 0 setzen, wird derpartiallyExpanded-Anker deaktiviert. DerPartiallyExpanded-Anker wird im ersten Layoutdurchlauf beibehalten, um die Layoutberechnung zu ermöglichen. (Ia33a4, b/465158677) SheetState#targetValuebevorzugt den aktuellen Anker, wenn der aktuelle Offset gültig ist. Dadurch wird verhindert, dass „initialValue“ sofort aktualisiert wird. (Ied2c4, b/477279704)- Das Symbol für
WideNavigationRailItemwird nicht vertikal zentriert, wenn sich die Höhe des Elements ändert. (Ib8c83)
Version 1.5.0-alpha13
28. Januar 2026
androidx.compose.material3:material3-*:1.5.0-alpha13 ist veröffentlicht. Version 1.5.0-alpha13 enthält diese Commits.
API-Änderungen
- Unterstützung für die Suchleiste
animationSpecForContentExpandundanimationSpecForContentCollapsehinzugefügt. (I033a5)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem für den Inhalt eines maximierten
SearchBarkeine themenbezogene Farbe verwendet wurde (I878e0, b/379441904). - Es wurde ein Fehler behoben, durch den
BottomSheetScaffolddenconfirmValueChange-Callback vonSheetStatemit falschen Werten aufgerufen hat, wenn ein Ziehpunkt anBottomSheetScaffoldübergeben wurde.confirmValueChangesollte nur verwendet werden, um Statusänderungen zu verhindern. Verwenden Sie einsnapshotFlow, um Statusänderungen zu beobachten. (Ice9ee, b/465824174, b/477031833)
Version 1.5.0-alpha12
14. Januar 2026
androidx.compose.material3:material3-*:1.5.0-alpha12 ist veröffentlicht. Version 1.5.0-alpha12 enthält diese Commits.
API-Änderungen
- Aktualisiert
TopAppBarDefaults(enterAlwaysund angepinnte Verhaltensweisen), umlazyListState,scrollStateundreverseScrollingzu unterstützen. Dadurch werden Probleme mit der Layoutrichtung behoben und Inhalte, die anfangs gescrollt werden, werden richtig verarbeitet. (I9d5c2, b/262234750) - Fügen Sie die Parameter
contentPaddingundhorizontalSpacingzuAssistChipundElevatedAssistChiphinzu. Die Standardeinstellung für „HorizontalSpacing“ und „ContentPadding“ ist „AssistChipDefaults“. (I2ac90, b/304853782) - Die
DatePicker-APIs, die Java Time-Klassen verwenden, sind nicht mehr als experimentell gekennzeichnet. (I5039c, b/457537971)
Fehlerkorrekturen
- Absturz bei der
DatePickerDatumsformatierung auf API 23 behoben (I67a94, b/452713222) - Ein Fehler bei der visuellen Ausrichtung im Beispiel für den animierten Indikator wurde behoben, wenn er mit scrollbaren Tabzeilen verwendet wird. (Iae0f3, b/466790304)
- Ein Problem wurde behoben, bei dem für die AM/PM-Auswahl von
TimePickerkein Textstil verwendet wurde, der in der Material Design-Spezifikation definiert ist. (Ie908a, b/469788786) - Es wurde ein Absturz in
HorizontalFloatingToolbarbehoben, der im Querformat auftreten konnte, wenn die Bildschirmtastatur angezeigt wurde. (Ia13c1, b/466692323) - Ein Problem wurde behoben, bei dem sich der Titel
TopAppBarmit dem zugehörigenactionsüberschneiden konnte, wenn keinnavigationIconangegeben wurde. Der Titel wird jetzt korrekt auf den verfügbaren Platz beschränkt. (I2ba97, b/428697836) - Unterstützung von RTL mit Ankern zum Maximieren von Bereichen (I0770b, b/467775639)
Version 1.5.0-alpha11
17. Dezember 2025
androidx.compose.material3:material3-*:1.5.0-alpha11 ist veröffentlicht. Version 1.5.0-alpha11 enthält diese Commits.
Neue Funktionen
ExpandedFullScreenContainedSearchBarwurde hinzugefügt. (Ie472d,b/454658635)- Unterstützung für das Erstellen von Karussells mit mehreren Formaten mithilfe von Lazy Grids hinzugefügt. (I2b109, b/462137656)
- Es sind jetzt ausdrucksstarke Listenelemente verfügbar, die Interaktionen und segmentierte Formatierung unterstützen.
ListItemColorswurden zusätzliche Farbfelder hinzugefügt. (I54057, b/441569230) - Die APIs für das gleichzeitige Öffnen mehrerer Tabs und für Karussells ohne Container sind jetzt stabil. (I7a558, b/401537465)
- Fügen Sie die Parameter
contentPaddingundhorizontalSpacingzuFilterChipundElevatedFilterChiphinzu. Die Standardeinstellung für „HorizontalSpacing“ und „ContentPadding“ ist „FilterChipDefaults“. (Iec6e3, b/455596578)
Fehlerkorrekturen
- Wenn Sie
BottomSheetScaffold sheetPeekHeightauf 0 setzen, wird derpartiallyExpanded-Anker deaktiviert. (I52dc9, b/465158677)
Version 1.5.0-alpha10
3. Dezember 2025
androidx.compose.material3:material3-*:1.5.0-alpha10 ist veröffentlicht. Version 1.5.0-alpha10 enthält diese Commits.
Neue Funktionen
- Karussell mit mehreren Seitenverhältnissen hinzugefügt (I15247, b/411232854)
API-Änderungen
- Das Funktions-Flag
isCheckboxStylingFixEnabledwird jetzt über das ObjektComposeMaterial3Flagsbereitgestellt. (I97baf, b/457504316) - Der Parameter
disabledCheckmarkColorinCheckboxColorswurde an das Ende der Parameterliste verschoben, um die binäre Kompatibilität zu gewährleisten. (I734d8, b/457504316)
Fehlerkorrekturen
- Alle Änderungen an Schiebereglerwerten durch Pfeiltasten werden rückgängig gemacht, um zu verhindern, dass der Fokus auf bestimmten Geräten ohne Tabulatortaste hängen bleibt. (I154dd, b/460912699)
Version 1.5.0-alpha09
19. November 2025
androidx.compose.material3:material3-*:1.5.0-alpha09 ist veröffentlicht. Version 1.5.0-alpha09 enthält diese Commits.
Neue Funktionen
- Ausdrucksstarke Menü-Updates hinzufügen Dazu gehören ein neuer umschaltbarer Menüpunkt, ein auswählbarer Menüpunkt, Menügruppen und ein Menü-Pop-up. Außerdem sind neue Standardwerte für expressive Menüs in
MenuDefaultsenthalten. (I5cdd4, b/417731597, b/448646125, b/448646896, b/448646891) - Die
Modifier.minimumInteractiveComponentSizebietet jetzt zwei neue öffentlicheAlignmentLines: MinimumInteractiveTopAlignmentLineundMinimumInteractiveLeftAlignmentLine. Diese Linien markieren die visuellen Ränder einer Komponente, bevor zusätzlicher Abstand hinzugefügt wird, um die Mindestanforderungen für den Berührungszielbereich zu erfüllen. (I7f485, b/458124197) ExpandedDockedSearchBarWithGapwurde hinzugefügt. (Idb7f8)
API-Änderungen
- Es wurden Prüfungen hinzugefügt, um die Größenanpassung der Komponente für den Präzisionszeiger zu ermöglichen. (I8108d)
Modifier.alignzuButtonGroupScopehinzufügen (I03890, b/416590906)- Entfernen Sie die eingestellten experimentellen
ModalBottomSheet-APIs, die in mindestens einer stabilen Version enthalten waren. (Ifbe1d, b/449757604) - Neue
ButtonGroup-Überladung mit dem ParameterverticalAlignment. (I23a37, b/416590906) - Verworfene verborgene experimentelle APIs, die in mindestens einer stabilen Version enthalten waren, wurden entfernt. (I4f68d, b/449754465, b/449749933, b/401311419, b/449749928, b/449756019)
Fehlerkorrekturen
- Kurzinfo für den Standard-Überlauf-Button der unverankerten Symbolleiste hinzufügen. (Ife952, b/422781172)
- Das Problem, dass der Indikator von
WideNavigationRailabgeschnitten wird, wenn er durch eine größere Labelgröße auf eine größere Breite eingestellt wird, wurde behoben. (I9d740, b/444728723) - Die nachfolgenden Schaltflächen des geteilten Buttons werden aktualisiert, um das Symbol auch bei RTL-Sprachen je nach Form optisch zu zentrieren. (Icab82)
Version 1.5.0-alpha08
5. November 2025
androidx.compose.material3:material3-*:1.5.0-alpha08 ist veröffentlicht. Version 1.5.0-alpha08 enthält diese Commits.
API-Änderungen
- Die Properties
hourInputundminuteInputwurden derTimePickerState-Schnittstelle hinzugefügt. Diese Eigenschaften sind für die Aufnahme der rohen, nicht validierten Eingabe des Nutzers vorgesehen. Die vorhandenen Eigenschaften für Stunde und Minute bleiben erhalten und stellen die letzte bekannte gültige Zeit dar. (I09d74, b/394612017)
Fehlerkorrekturen
- Ein Fehler wurde behoben, durch den „Switch“ nicht ohne Animation mit
ReusableContentverwendet werden konnte. (I61093, b/455909150)
Version 1.5.0-alpha07
22. Oktober 2025
androidx.compose.material3:material3-*:1.5.0-alpha07 ist veröffentlicht. Version 1.5.0-alpha07 enthält diese Commits.
API-Änderungen
- Erweiterte
SearchBar.InputFieldmit einemkeyboardOptions-Parameter, der eine optimierte Texteingabe durch Angabe von Tastaturoptionen ermöglicht, und einemlineLimits-Parameter, mit dem das Scrollen des Textumbruchs angegeben werden kann (Id08a4, b/416991049)
Fehlerkorrekturen
- Ein Fehler im Slider wurde behoben, bei dem bei Berührungen keine Press-Interaktionen ausgegeben wurden. Durch diese Änderung wird sichergestellt, dass bei
awaitFirstDownsofort einPressInteraction.Pressausgegeben wird, sodass sofort visuelles Feedback erfolgt. (If9e25, b/308501482) - Ein Problem wurde behoben, bei dem sich die Richtung des Cursors
Tooltipbeim Scrollen nicht geändert hat. DasTooltipBoxlöst jetzt eine Neukomposition aus, wenn das Kurzinfo-Pop-up die Seite wechselt. So wird die Richtung des Caret-Zeichens richtig aktualisiert. (I5ad1e, b/438875827)
Version 1.5.0-alpha06
8. Oktober 2025
androidx.compose.material3:material3-*:1.5.0-alpha06 ist veröffentlicht. Version 1.5.0-alpha06 enthält diese Commits.
API-Änderungen
- Scrollfarben für
AppBarWithSearchhinzugefügt. Außerdem ist die Containerfarbe eines Suchleisten-Eingabefelds jetzt standardmäßig transparent. Die Standardcontainerfarbe der Suchleiste selbst bleibt unverändert. (I4fe32) FloatingToolbarwurde ein standardmäßiger Composable für die Überlaufanzeige hinzugefügt. (I6a6f8, b/415833723)- Aktualisieren Sie
isExpandedaufisShowingfür Menü-APIs in der Schaltflächengruppe. (I86309, b/412419514) initialIsExpandedwurde zuinitialIsShowingaktualisiert und inButtonGroupDefaultswurde eine standardmäßige Composable für den Überlaufindikator hinzugefügt. (I6e67c, b/412419514)- Die Funktion zum Ziehen zum Ändern der Größe wird aus der öffentlichen API entfernt (Ic85ba, b/437953743, b/442636084).
Fehlerkorrekturen
- Die Fokusreihenfolge der Tasten bei der Tastaturnavigation wurde korrigiert, auch für RTL. (Ibba27, b/422220597)
- Die Tastaturnavigation im Raster zur Auswahl des Jahres in der Datumsauswahl wurde korrigiert. (I02363, b/422425720, b/446814683)
- Die Tastaturnavigation für das Datumsauswahlfeld in Datumsauswahlen wurde korrigiert. (I594ef, b/422220597, b/422223115)
- Es wurde ein Fehler behoben, durch den die Tastaturfokus auf eine Symbolleiste außerhalb des Bildschirms gerichtet wurde. (I01a73, b/422786812)
- Die Tastaturnavigation für
RangeSliderund Schieberegler wurde korrigiert. (Ib6bcf, b/424845268, b/422942624)
Version 1.5.0-alpha04
10. September 2025
androidx.compose.material3:material3-*:1.5.0-alpha04 ist veröffentlicht. Version 1.5.0-alpha04 enthält diese Commits.
Neue Funktionen
- Es wurden
Text-Composable-Überladungen hinzugefügt, die eineColorProducer-Lambda-Funktion akzeptieren, die effiziente Farbänderungen ermöglicht, ohne dass eine vollständige Neukomposition ausgelöst wird. (I9ff25, b/407055128)
API-Änderungen
Scrim()inLevitatedPaneScrim()umbenennen und Attribute der Klassen „Levitated“ und „Reflowed“ ausblenden. (I090e1, b/427953101)calculatePosture()API als intern ausblenden (Ie7227, b/424442112)PaneScaffoldHorizontalOrderals versiegelte öffentliche API (Ia4ebe) verfügbar machen- APIs für Fenstergröße und Haltung als experimentell kennzeichnen (I4ee96)
Fehlerkorrekturen
- Die Reihenfolge der Tastaturnavigation wurde korrigiert, sodass der Fokus vom FAB-Button zum ersten Element oben wechselt. (Icaaa1, b/422762939)
- Verbesserte Tastatur-Barrierefreiheit für die Navigationsleiste: Die Leiste ist nicht mehr fokussierbar, wenn sie geschlossen ist. Sie kann über die Esc-Taste geschlossen werden und ihr Inhalt erhält den Fokus, wenn sie geöffnet wird. (Idb995, b/422793544, b/422793651, b/422797424)
- Das Zifferblatt der Zeitauswahl reagiert jetzt auf die Tastaturnavigation und ‑eingabe. (I9d5d9, b/425710631)
- Neuen anfänglichen Anker verwenden, wenn sich die Ankerliste für die Bereichserweiterung ändert (I91cd1, b/438829477)
Version 1.5.0-alpha03
27. August 2025
androidx.compose.material3:material3-*:1.5.0-alpha03 ist veröffentlicht. Version 1.5.0-alpha03 enthält diese Commits.
Verhaltensänderung
- Die Größe des Kästchens und die Farben der Indikatoren wurden an die Spezifikation angepasst. Um Störungen der Benutzeroberfläche zu minimieren, wurde das Flag
isCheckboxStylingFixEnabledhinzugefügt, um die Migration zu erleichtern. Aktivieren Sie sie manuell in Ihren Apps. Dieses Flag wird in einer zukünftigen Version entfernt. (I5bcd3, b/304300693)
API-Änderungen
- Parameter
contentPaddingfürTopAppBarhinzugefügt (Ia5fea) - Komponentenüberschreibung für Navigationssuite-Scaffold hinzufügen (I85312)
Fehlerkorrekturen
- Der Parameter
containerColorinTimePickerDialogwird jetzt korrekt angewendet, sodass die Hintergrundfarbe des Dialogfelds angepasst werden kann. (I47f89, b/403183883) - Der Fokus geht nicht mehr verloren, wenn die modale Navigationsleiste minimiert wird. Sie kann jetzt auch mit der ESC-Taste geschlossen werden. (4255257)
Snackbarhat jetzt die richtige Tastaturfokusreihenfolge für Aktions- und Schließen-Schaltflächen. Die Schließen-Schaltfläche unterstützt auch die Anzeige eines Tooltips. (11fa13d)
Version 1.5.0-alpha02
13. August 2025
androidx.compose.material3:material3-*:1.5.0-alpha02 ist veröffentlicht. Version 1.5.0-alpha02 enthält diese Commits.
API-Änderungen
- In
PullToRefreshDefaultswurdeshapeinindicatorShapeundcontainerColorinindicatorContainerColorumbenannt undindicatorMaxDistancefür die Verwendung von Indikatoren hinzugefügt. (Ib6cbe) - Entferne das Tag „Einstellung“ aus
PullToRefreshDefaults.indicatorColor(Iaaee2). AppBarWithSearchwurde hinzugefügt und ersetztTopSearchBar. Navigations- und Aktionssymbole werden unterstützt. (I213a5)
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem der Drawer-Offset durch die Rücktaste fälschlicherweise aktualisiert wurde. (I85624, b/427778135)
SwipeToDismissBoxgreift jetzt auf ein abgerechnetestargetValuezurück, wenn keine anderen Anker vorhanden sind.BottomSheetScaffoldwird jetzt auf eine erweitertetargetValuezurückgesetzt, wenn keine anderen Anker vorhanden sind. (I73d5e, b/428856426)- Der Innenabstand von Schaltflächen in
AlertDialogwurde korrigiert, wenn sie vertikal gestapelt sind. (Ia2118) - [FAB] Fehler behoben, bei dem das FAB nach dem Ausblenden durch
Modifier.animateFloatingActionButtonweiterhin angeklickt werden konnte (I8ea6c, b/430336834) - [Schieberegler] Tastaturnavigation für Schieberegler korrigiert (I3a405)
Version 1.5.0-alpha01
30. Juli 2025
androidx.compose.material3:material3-*:1.5.0-alpha01 ist veröffentlicht. Version 1.5.0-alpha01 enthält diese Commits.
Neue Funktionen
- Es wurden weitere Positionierungsoptionen für Tooltips hinzugefügt. Entwickler können jetzt festlegen, ob Tooltips über, unter, links oder rechts vom Anker platziert werden. Eine API wurde hinzugefügt, die eine Form für Carets akzeptiert, sodass mehr benutzerdefinierte Formen bereitgestellt werden können. (Ie513c)
API-Änderungen
TextFieldColorsMethoden zum Berechnen von Komponentenfarben basierend auf dem Status sind jetzt öffentlich. (I03165)- Die Anmerkung zur Sperrung wurde aus dem
onDismiss-Callback entfernt. (Ie3166) DatePickerState.getDisplayedMonth(): YearMonth?undDateRangePickerState.getDisplayedMonth(): YearMonth?wurden aktualisiert, um einen nicht nullable-Wert zurückzugeben. (Ice09c, b/427952972)- Entfernen Sie
ModalWideNavigationRailDefaults, verschieben Sie die Inhalte nachWideNavigationRailDefaultsund benennen Sie die zugehörigen Formnamen um. (Ic5e61) - Die Farben und der Text von
WideNavigationRailItem, die auf verworfenen Funktionen basieren, sollten auf der Ebene „Ausgeblendet“ sein. (Id7e82) - Ändern Sie die Ebene der eingestellten
WideNavigationRail-APIs in „Warnung“ und machen Sie sie experimentell. (I89085)
Fehlerkorrekturen
- Sorgt dafür, dass
DatePickerdie eigene Spracheinstellung für die Zahlenformatierung berücksichtigt. Bisher wurden bei der Konfiguration vonDatePickerfür ein arabisches Gebietsschema möglicherweise fälschlicherweise lateinische Ziffern gerendert, wenn im Systemgebietsschema des Geräts ein anderes Zahlensystem verwendet wurde. (Iccf76, b/432616196) - Ein Problem mit
LinearProgressIndicatorwurde behoben, bei dem eine Haltestellenanzeige in RTL-Layouts nicht richtig gerendert wurde. (I0734c) - Die Trennlinien
PrimaryScrollableTabRowundSecondaryScrollableTabRowerstrecken sich jetzt über die gesamte Displaygröße, auch wenn der Tabinhalt nicht bis zum Ende des Displays reicht. (Ic1e9c, b/261741384)
Compose Material3 Version 1.4
Version 1.4.0
24. September 2025
androidx.compose.material3:material3-*:1.4.0 ist veröffentlicht. Version 1.4.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.3.0:
Ankündigungen zu Änderungen an der Mediathek
Die androidx.compose.material.icons-Bibliothek wird nicht mehr empfohlen, um Material Icons in Compose darzustellen, da Material Symbols die neue Methode sind. Wir veröffentlichen keine Updates mehr für diese Bibliothek. Sie wurde aus der neuesten Version der Material 3-Bibliothek entfernt. Sie können weiterhin manuell darauf verweisen, wenn Sie noch nicht migrieren können.
Stattdessen empfehlen wir, eine XML-Datei für Vektordrawables über den Tab „Android“ auf https://fonts.google.com/icons herunterzuladen, um auf die neuesten stilisierten Symbole zuzugreifen: Material Symbols.
Warum empfehlen wir die Bibliothek nicht mehr? Die Symbolbibliothek („Material Icons“) wurde durch das neuere Design von Material Symbols ersetzt. Wir haben festgestellt, dass die Bibliothek die Build-Zeit Ihrer Apps erheblich verlängern kann, da sie alle verschiedenen Symbole enthält, die möglicherweise nicht benötigt werden.
Weitere Informationen: https://developer.android.com/develop/ui/compose/graphics/images/material
Geändertes Verhalten
Diese Bibliothek fügt keine Abhängigkeit zu
material-icons-coremehr hinzu. Wenn Ihr Projekt darauf angewiesen war, müssen Sie diese Abhängigkeit explizit in Ihren build.gradle[.kts]-Dateien hinzufügen. (I735ff, b/349894318)Die aktive Label-Farbe von
NavigationBarItemundNavigationRailItemwird vononSurfacein „Sekundär“ geändert, um die Nutzerfreundlichkeit und den Farbkontrast zu verbessern und die Kohärenz im System zu erhöhen (Ibc297). Wenn Sie zum vorherigen Verhalten zurückkehren möchten, kopieren Sie die Standardfarben und ändern SieselectedTextColorinMaterialTheme.colorScheme.onSurface.Material 3-Komponenten verwenden jetzt die neue
MotionScheme, um ihre Bewegung zu definieren. (Ie0f93)Bewegungsänderungen bei unbestimmter kreisförmiger Fortschrittsanzeige (I3c07e)
Neue Material Design 3-Komponenten
HorizontalCenteredHeroCarouselVerticalDragHandle- Sichere Textfelder für Passworteingabefelder
Verbesserungen an vorhandenen Material Design 3-Komponenten
- Text unterstützt jetzt
autoSize- Text mit string
- Text mit annotatedString
- Material 3-Dekoratoren für
BasicTextField2hinzugefügt - Es wurde eine
TimePickerDialogAPI hinzugefügt, die fürTimePicker,TimeInputoder für eine umschaltbare Version verwendet werden kann. - Neue APIs für die Suchleiste:
- Minimierte Suchleisten und maximierte Suchansichten sind jetzt separate Composables:
SearchBarsteht für eine Suchleiste im minimierten Zustand.ExpandedFullScreenSearchBarundExpandedDockedSearchBarstellen die Suchleiste im maximierten Zustand dar. Diese werden in einem neuen Fenster geöffnet.SearchBarStatezum Steuern des Status der Suchleiste
- Experimentelle APIs wurden in stabile APIs umgewandelt.
- Leistungsverbesserungen
Version 1.4.0-rc01
10. September 2025
androidx.compose.material3:material3-*:1.4.0-rc01 ist veröffentlicht. Version 1.4.0-rc01 enthält diese Commits.
Version 1.4.0-beta03
27. August 2025
androidx.compose.material3:material3-*:1.4.0-beta03 ist veröffentlicht. Version 1.4.0-beta03 enthält diese Commits.
Version 1.4.0-beta02
13. August 2025
androidx.compose.material3:material3-*:1.4.0-beta02 ist veröffentlicht. Version 1.4.0-beta02 enthält diese Commits.
Änderungen an Abhängigkeiten
graphics-shapes-Abhängigkeit entfernen (I219e0, b/436230765)
API-Änderungen
- In
PullToRefreshDefaultswurdeshapeinindicatorShapeundcontainerColorinindicatorContainerColorumbenannt undindicatorMaxDistancefür die Verwendung von Indikatoren hinzugefügt. (Ib6cbe) - Entferne das Tag „Einstellung“ aus
PullToRefreshDefaults.indicatorColor(Iaaee2). BasicAlertDialogOverrideScopewurde versehentlich auf „stabil“ hochgestuft und die experimentelle Annotation wurde in aosp/3701846 entfernt. Als intern markieren Sie bleibt in Version 1.5.0-alpha (I9182a) als öffentliche experimentelle Funktion verfügbar.
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem der Drawer-Offset durch die Rücktaste fälschlicherweise aktualisiert wurde. (I85624, b/427778135)
Version 1.4.0-beta01
30. Juli 2025
androidx.compose.material3:material3-*:1.4.0-beta01 ist veröffentlicht. Version 1.4.0-beta01 enthält diese Commits.
Funktionsgefährdende Änderungen
- Alle öffentlichen APIs, die mit
ExperimentalMaterial3ExpressiveApioderExperimentalMaterial3ComponentOverrideApigekennzeichnet sind, wurden entfernt. Wechseln Sie zu1.5.0-alpha, um diese Funktionen weiterhin nutzen zu können. (Ie4ae0) - Die folgenden stabilisierten
pullToRefresh-APIs werden in der nächsten Version umbenannt. (Ib6cbe)
Neue Funktionen
Tooltipunterstützt jetzt benutzerdefinierte Caret-Formen und ‑Positionen (über, unter, links oder rechts vom Anker). (Ie513c)
API-Änderungen
- Die Anmerkung „Suspend“ wurde aus dem
onDismiss-Callback entfernt. (Ie3166) DatePickerState.getDisplayedMonth(): YearMonth?undDateRangePickerState.getDisplayedMonth(): YearMonth?wurden aktualisiert, um einen nicht nullable-Wert zurückzugeben. (Ice09c, b/427952972)- Entfernen Sie
ModalWideNavigationRailDefaults, verschieben Sie die Inhalte nachWideNavigationRailDefaultsund benennen Sie die zugehörigen Formnamen um. (Ic5e61)
Fehlerkorrekturen
- Sorgt dafür, dass
DatePickerdie eigene Spracheinstellung für die Zahlenformatierung berücksichtigt. Bisher wurden bei der Konfiguration vonDatePickerfür ein arabisches Gebietsschema möglicherweise fälschlicherweise lateinische Ziffern gerendert, wenn im Systemgebietsschema des Geräts ein anderes Zahlensystem verwendet wurde. (Iccf76, b/432616196) - Ein Problem mit
LinearProgressIndicatorwurde behoben, bei dem eine Haltestellenanzeige in RTL-Layouts nicht richtig gerendert wurde. (I0734c) - Die Trennlinien
PrimaryScrollableTabRowundSecondaryScrollableTabRowerstrecken sich jetzt über die gesamte Displaygröße, auch wenn der Tabinhalt nicht bis zum Ende des Displays reicht. (Ic1e9c, b/261741384)
Version 1.4.0-alpha18
16. Juli 2025
androidx.compose.material3:material3-*:1.4.0-alpha18 ist veröffentlicht. Version 1.4.0-alpha18 enthält diese Commits.
Neue Funktionen
- In
ModalBottomSheetPropertieskann jetzt die Option „dismissRequest“ über einen Scrim-Klick deaktiviert werden. (I8e715) - Unterstützung für
trackCornerSizewird dem Track vonRangeSliderhinzugefügt. (Iec529)
API-Änderungen
railExpandedist jetzt ein erforderlicher Parameter fürWideNavigationRailItem.modalContentColorwurde fürWideNavigationRailColorshinzugefügt undWideNavigationRailDefaults.modalContainerShapewurde zuModalWideNavigationRailDefaults.containerShapeverschoben. (Id60c5)- Verschieben Sie den neuen Farbparameter von
WideNavigationRailan die letzte Stelle und stellen Sie die alte Funktion ein. (Iac7f7) PullToRefreshist jetzt eine stabile API (I18537)- Aktualisierungen der
DatePickersAPI. Wir haben das Standard-Null-Enddatum fürDateRangePickerentfernt und es ist jetzt obligatorisch, es zu übergeben. Außerdem haben wir die Verwendung der Datumsdarstellung in der API-Dokumentation um Mitternacht UTC präzisiert und die neuesten Getter und Setter, die die java.time-APIs verwenden, vorerst als experimentell gekennzeichnet. (I121b3, b/427952972) - Die API mit dem Parameter
tint: ColorProducerfür das Symbol ist nicht mehr experimentell. (Ia0133) - Die experimentellen Anmerkungen wurden aus
DatePicker,DateRangePickerund den zugehörigen Status, Klassen und Typen entfernt. (I0e4e0, b/391848485) - Der Standardwert für „focusable“ wurde in „false“ geändert, um das Problem mit dem Fokus für die Barrierefreiheit zu beheben. Außerdem wurde der Parameter
hasActionzuTooltipBoxhinzugefügt. (I62998) - Die experimentellen APIs
WideNavigationRail,ShortNavigationBarundNavigationItemsind jetzt allgemein verfügbar. (I3ca3c) - Entfernen Sie die
@ExperimentalMaterial3Api-Annotationen aus einigen der wichtigsten App-Leistenfunktionen, unterstützenden Klassen und Objekten. (I0a9b7)
Version 1.4.0-alpha17
2. Juli 2025
androidx.compose.material3:material3-*:1.4.0-alpha17 ist veröffentlicht. Version 1.4.0-alpha17 enthält diese Commits.
Neue Funktionen
- Die Animation der Schaltflächengruppe wird so aktualisiert, dass bei einem Klick statt bei einem Drücken 75% der Animation ausgeführt werden. (593942a, b/423596967)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem ein Karussellelement in einigen Fällen die Größe des großen Elements bei der Layoutberechnung überschreiten konnte, wodurch das gesamte Widget abgeschnitten wurde. (I1c3d7, b/397489534)
- Das Überspringen von
beforeContentPaddingbeim Scrollen von Karussells mit sich überschneidenden Start- und Endverschiebungen wurde behoben. (c3d5f3a, b/420618979) - Das aktivierte Verhalten von
SwipeToDismisswird so aktualisiert, dass der abgerechnete Status anstelle des aktuellen Status beobachtet wird. Das bisherige Verhalten wird wiederhergestellt, bei dem das Ankerverhalten nur deaktiviert wird, wenn sich die Komponente in einem geschlossenen Zustand befindet. (3844e07, b/425006844) - Das Pop-up-Menü von
ExposedDropdownMenukann jetzt über die Tastatur geöffnet werden. Außerdem ist das Menü für die bearbeitbare Variante jetzt über die Tastatur erreichbar. (46ead03)
Version 1.4.0-alpha16
18. Juni 2025
androidx.compose.material3:material3-*:1.4.0-alpha16 ist veröffentlicht. Version 1.4.0-alpha16 enthält diese Commits.
Neue Funktionen
- Eine zentriert ausgerichtete Hero-Karussellkomponente (I6f6d3) wurde hinzugefügt.
API-Änderungen
- Implementieren von XR-Überschreibungen für die vertikale Symbolleiste (Ia1604)
CarouselStatewurden programmatische Scrollfunktionen hinzugefügt (I12f8e)ComponentOverridefürModalWideNavigationRailhinzufügen (I4f440)ComponentOverridefürWideNavigationRailhinzufügen (I6354f)ComponentOverridefürHorizontalFloatingToolbarerstellen (I51116)ComponentOverridefürShortNavigationBarerstellen (I30e24)SwipeToDismissBoxState-Verweise aufconfirmValueChangewurden als veraltet markiert. Nutzer sollten stattdessen denSwipeToDismissBox-API-CallbackonDismissedverwenden. (Iee780)- Der Parameter „userScrollEnabled“ wurde den Carousel-Composables hinzugefügt. (I1d4d2)
- Die
currentItemdes Karussells kann jetzt überCarouselStatebeobachtet werden. (Ie87e9)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem eine beliebige Form auf einem FAB, die an ein
FloatingToolbarübergeben wurde, ihren Schatten nicht richtig angewendet hat. (Icdcc9, b/423336922) - Für alle Karussells wird jetzt standardmäßig die semantische Rolle „Karussell“ verwendet. (I7af12)
- Falsche Bewegung des Thumb behoben, wenn der Status des Sliders über
LaunchedEffectaktualisiert wurde (Id9f31, b/302774166)
Version 1.4.0-alpha15
20. Mai 2025
androidx.compose.material3:material3-*:1.4.0-alpha15 ist veröffentlicht. Version 1.4.0-alpha15 enthält diese Commits.
API-Änderungen
MotionTheme.LocalMotionSchemehinzugefügt, Komposition lokal. Dadurch kann überCompositionLocalConsumerModifierNodesmitcurrentValueOf(MotionTheme.LocalMotionScheme)auf das Bewegungsdesign zugegriffen werden. (I014b1)- Der
ColorScheme-Konstruktor ohne Rollen für feste Farben ist jetzt veraltet. Migrieren Sie bitte zum Konstruktor, der feste Rollen enthält. (Iad0ee) - Die M3-Textkomponente unterstützt jetzt
TextAutoSize. (I7f524) - API zum Erstellen von Varianten für die Größe von geteilten Schaltflächen und Beispiele hinzugefügt. (Ice30b)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem
SnackbarundFloatingActionButtonbei aktivierter Edge-to-Edge-Funktion falsch positioniert wurden. Scaffold wendet jetzt horizontale Insets korrekt auf diese Komponenten an. (Ib7c30, b/244400727) - Korrigieren Sie die
BottomSheet-Bewegung von vollständig maximiert zu teilweise maximiert. Für dasBottomSheetwird jetzt der schnelle Effekt desMotionSchemebeim Ausblenden oder Minimieren und der räumliche Standardeffekt beim Maximieren verwendet. (Ifa46f, b/416063171) - Der
ColorScheme-Konstruktor ohne Rollen für Oberflächencontainer wurde als ausgeblendet markiert und wird nicht mehr empfohlen. (Ia7237) - Die Anforderung
CircularWavyProgressIndicatorSize.minDimension > 0wurde entfernt, um mehr Flexibilität zu ermöglichen. Zuvor wurde in diesem Fall eine Ausnahme ausgelöst. (Ic9418, b/377531195) - Hyperlinks in
Text(AnnotatedString)haben jetzt standardmäßig das Material-Styling. (I78288, b/339843816) - Ein Problem wurde behoben, bei dem die Funktion
toShape()inRoundedPolygoneinen Pfad zwischenspeicherte und ein Problem verursachte, wenn mehrerecreateOutline-Aufrufe mit unterschiedlichen Größen erfolgten. (I4026d)
Version 1.4.0-alpha14
7. Mai 2025
androidx.compose.material3:material3-*:1.4.0-alpha14 ist veröffentlicht. Version 1.4.0-alpha14 enthält diese Commits.
API-Änderungen
- Es wurde eine neue zusammensetzbare Funktion
AppBarColumnhinzugefügt, die genauso funktioniert wieAppBarRow, aber für Inhalte, die in einer Spalte angeordnet sind. (Iaf6bd) AppBarRowwurde die maximale Anzahl von Elementen hinzugefügt. Dies ist erforderlich, um die Material-Spezifikation für obere App-Leisten korrekt zu implementieren. (I92ce4)- In
TooltipScopewurde eine Methode zum Abrufen derlayoutCoordinatesdes Ankers hinzugefügt. Die MethodedrawCaretwird eingestellt, da Entwickler mit dieser neuen Methode die AnkergrenzenlayoutCoordinatesabrufen und eine geeignete Form mit einem Caretzeichen erstellen können. (Ia2e12, b/329470609) java.time-Unterstützung für Datumsauswahlen hinzugefügt: Es wurdenrememberDatePickerState/rememberDateRangePickerState-Überladungen eingeführt, die java.time-Objekte (z.B. initialLocalDate,YearMonth) akzeptieren. Außerdem wurden Erweiterungsfunktionen für die Statusobjekte hinzugefügt, um Werte mit Typen wieLocalDateundYearMonthabzurufen/festzulegen. Erfordert API 26 oder höher oder Desugaring. (I70f29, b/266202516, b/281859606)- Fügen Sie die zusammensetzbare Funktion
CenteredTrackhinzu, damit ein Schieberegler mit einem Track verwendet werden kann, der in der Mitte beginnt. (I5b1d6)
Fehlerkorrekturen
- Die Leistung von wellenförmigen Fortschrittsanzeigen wurde verbessert: Lineare Typen werden jetzt etwa 8, 5% schneller geladen und es sind etwa 11% weniger Zuweisungen erforderlich.Bei kreisförmigen Typen ist die Geschwindigkeit um etwa 47% gestiegen und die Anzahl der Zuweisungen um etwa 39% gesunken. (I595d8)
Version 1.4.0-alpha13
23. April 2025
androidx.compose.material3:material3-*:1.4.0-alpha13 ist veröffentlicht. Version 1.4.0-alpha13 enthält diese Commits.
API-Änderungen
isAppearanceLightStatusBarsundisAppearanceLightNavigationBarswurden inModalBottomSheetPropertiesals reine Android-Parameter wieder eingeführt. (Id4bc0)- Fügen Sie eine
AppBarRow-Composable hinzu, die den Überlauf von Elementen verarbeitet, die außerhalb ihrer Grenzen liegen. (I742bd) - Aktualisieren Sie die APIs
DatePickerundDateRangePicker, um beim Wechsel in den Datumseingabemodus den Fokus anzufordern. Wir haben den booleschen ParameterrequestFocusdurch den optionalen ParameterfocusRequesterersetzt, der einenFocusRequesterakzeptiert. (I14b69) - Entfernen Sie den Modifikator und die Interaktionsquelle aus den standardmäßigen anklickbaren und umschaltbaren Elementen. Verwenden Sie es stattdessen als Implementierungsdetail. (I95ed6)
- Die
ButtonGroupwurde aktualisiert und wird in einem Drop-down-Menü angezeigt, wenn zu viele Schaltflächen auf dem Bildschirm vorhanden sind. (I7b88b)
Fehlerkorrekturen
- Das Bottomsheet berücksichtigt jetzt die oberen Insets, wenn es kleiner als der aktuelle Offset ist. So können Nutzer obere Insets für das erweiterte Verhalten angeben.
BottomSheetDefaults.windowInsetsenthält jetztWindowInsets.safeDrawing.Top. (I0ab67, b/321877275, b/336962418, b/342093067) - Ein- und Ausblendanimationen (Ein- und Ausblenden) für führende Chip-Symbole/Avatare und nachfolgende Symbole beim Hinzufügen oder Entfernen aktiviert. Das ist vor allem für auswählbare Chips (Filter, Eingabe) von Vorteil, gilt aber allgemein. (I9af21)
- Das fehlerhafte Verhalten des RTL-Schiebereglers, das durch
LookaheadScopeverursacht wurde, wurde behoben. (Ieb152, b/408118041) - Der Absturz von „Bottom
AppBar“ beim Scrollen mit einer ausgeblendeten System-UI wurde behoben. (Ic6140, b/405996228)
Version 1.4.0-alpha12
09. April 2025
androidx.compose.material3:material3-*:1.4.0-alpha12 ist veröffentlicht. Version 1.4.0-alpha12 enthält diese Commits.
API-Änderungen
- Android-spezifische Parameter aus
ModalBottomSheetPropertiesentfernt (Iab97f, b/362539765) - Überladen von Funktionen für Standardwerte für die Größe des Ziehpunkts (I0ed0d)
- Neue
NavigationSuiteScaffold- undNavigationSuiteScaffoldLayout-Funktionen zur Unterstützung neuer Layouttypen und für optionalen Inhalt für primäre Aktionen hinzugefügt. (Ib262a, b/353144478) Modifier.weightmit dem Parameter „fill“ inButtonGroupwird eingestellt. Eine Version ohne Füllung hinzufügen (Id32bb)- Die Standardwerte der IconButton-Komponenten
xSmall-undxLarge-werden inextraausgeschrieben. (Ib6e0f) - Neue
NavigationSuite-,NavigationSuiteItem- undNavigationSuiteColors-Funktionen zur Unterstützung neuer Layouttypen hinzugefügt. (I203d6) - Fügen Sie die neue Funktion
NavigationSuiteTypesund die neue FunktionnavigationSuiteTypehinzu, die diese Layoutoptionen enthalten (If68f9).
Fehlerkorrekturen
ColorScheme.contentColorForwird jetztsurfaceDimzugeordnet undonSurface. (I8891a)- Die
DateInputTextField-Implementierung wurde aktualisiert, um ein Problem zu beheben, bei dem das Eingabefeld das programmatisch festgelegte Datum nicht widerspiegelte. (I6c8d1, b/401143451) - Die TalkBack-Fokusreihenfolge für den Navigationsstreifen und den breiten Navigationsstreifen wurde korrigiert (I6cf6f, b/407048224).
Version 1.4.0-alpha11
26. März 2025
androidx.compose.material3:material3-*:1.4.0-alpha11 ist veröffentlicht. Version 1.4.0-alpha11 enthält diese Commits.
API-Änderungen
- Die Groß- und Kleinschreibung für zusammensetzbare Eigenschaften in Standardobjekten für Schaltflächen und Ein/Aus-Schaltflächen wurde aktualisiert. Fügen Sie in
ToggleButtonDefaultsundButtonDefaultsMethoden für das empfohlene Padding, die Formen, die Symbolgröße, den Symbolabstand und den Textstil für empfohlene Inhalte in Abhängigkeit von der Containerhöhe hinzu. (Iea69e) - Eingestellte experimentelle Funktionen und Konstanten wurden aus
FloatingToolbarentfernt. (I8f339) - Höhenkomponenten haben jetzt eine gemeinsame Schnittstelle und öffentliche Konstruktoren und Eigenschaften. (Ibb172)
- Hinzufügen des Modifikators
animateWidthinButtonGroupScope, der mit den untergeordneten Elementen der Schaltflächengruppe verwendet werden muss, um die untergeordneten Elemente richtig zu animieren. (Ia3bb6)
Fehlerkorrekturen
- Der Innenabstand der schwebenden Symbolleiste wurde korrigiert, um beim Minimieren für ein visuelles Gleichgewicht zu sorgen. Außerdem wurde die Flexibilität für größere Inhalte verbessert. (I06c00)
Version 1.4.0-alpha10
12. März 2025
androidx.compose.material3:material3-*:1.4.0-alpha10 ist veröffentlicht. Version 1.4.0-alpha10 enthält diese Commits.
API-Änderungen
TabRowDefaults.tabIndicatorOffsetwurde zugunsten vonTabIndicatorScope.tabIndicatorOffseteingestellt. (Ib36b3)- Rechtschreibfehler für kleines Content-Padding in den Button-Standardeinstellungen behoben. (I19bfe)
TabRowundScrollableTabRowsind zugunsten von primären und sekundären Varianten der einzelnen Elemente veraltet. Die Zeilen auf den primären und sekundären Tabs sind leistungsfähiger und entsprechen genauer den Spezifikationen. (I918e2)rememberSliderStateundrememberRangeSliderStatewurden hinzugefügt. (I8e384)shouldAutoSnapwurde zuSliderStatehinzugefügt, um den automatischen Einrastmechanismus zu steuern. Das Deaktivieren kann für benutzerdefinierte Animationen nützlich sein. (I07745)- Die Mindestbreite von Tabs in scrollbaren Tabzeilen ist jetzt ein Parameter. Die Varianten für die primäre und sekundäre Tabellenzeile sind nicht mehr experimentell. (If6f15, b/226665301)
- Die Klasse
ExitAlwaysFloatingToolbarScrollBehaviorwurde öffentlich gemacht, sodass sie ohne Komposition erstellt werden kann. (Ibf31c)
Version 1.4.0-alpha09
26. Februar 2025
androidx.compose.material3:material3-*:1.4.0-alpha09 ist veröffentlicht. Version 1.4.0-alpha09 enthält diese Commits.
API-Änderungen
- Die Einstellungsfelder von
DragHandleim Standardzustand umbenennen, gedrückte und gezogene Zustände trennen und die Standardgrößen öffentlich machen. (I787b9) - Aktualisierungen der
TowRowsTopAppBarAPI. Der Lambda-Parameterexpandedwurde entfernt und es wurden separate Parameter für die Höhe im maximierten und minimierten Zustand hinzugefügt. (Idd677, b/306697446, b/229134133, b/268068946)
Fehlerkorrekturen
- Die unteren App-Leisten berücksichtigen jetzt den Dienst zur Touch-Bedienung (z.B.
TalkBack) und bleiben sichtbar, solange der Dienst aktiviert ist. (I4b34d)
Version 1.4.0-alpha08
12. Februar 2025
androidx.compose.material3:material3-*:1.4.0-alpha08 ist veröffentlicht. Version 1.4.0-alpha08 enthält diese Commits.
Neue Funktionen
Es wurde eine
TimePickerDialogAPI hinzugefügt, die fürTimePicker,TimeInputoder für eine umschaltbare Version verwendet werden kann. (Id2d83)Neue APIs für die Suchleiste:
- Minimierte Suchleisten und maximierte Suchansichten sind jetzt separate Composables.
SearchBarsteht für eine Suchleiste im minimierten Zustand.ExpandedFullScreenSearchBarundExpandedDockedSearchBarstellen die Suchleiste im maximierten Zustand dar. Diese werden in einem neuen Fenster geöffnet.SearchBarStatezum Steuern des Status der SuchleisteTopSearchBar, um die Verarbeitung von Insets und das Scrollverhalten hinzuzufügen- Neue Überladung von
InputField, dieSearchBarStateverwendet (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)
API-Änderungen
- Unterstützung für das Morphing der Eckenform von Symbolschaltflächen beim Drücken. (I21843)
- Die APIs für Textfeld-Decorators/Decorations sind nicht mehr experimentell. (I31d95)
- Es wurden Beispiele und Standardwerte für die verbundene Variante für
ButtonGrouphinzugefügt. (I5c8ce) - Machen Sie den Statusparameter zum letzten in
NavigationSuiteScaffoldundNavigationSuiteScaffoldLayout. (I9cc7b)
Fehlerkorrekturen
- Benutzerdefinierte Bedienungshilfen wurden der
FloatingToolbarshinzugefügt, sodass Bedienungshilfen jetzt alleFloatingToolbar-Variationen maximieren oder minimieren können. In der Version mit dem schwebenden Aktionsschaltfläche wird dies auf die schwebende Aktionsschaltfläche angewendet, in der Version ohne schwebende Aktionsschaltfläche auf den Hauptinhalt. (I26420) - Die
FloatingToolbarsberücksichtigt jetzt den Dienst zur Touch-Bedienung (z.B. TalkBack) und die Symbolleiste bleibt immer maximiert und sichtbar, wenn der Dienst aktiviert ist. (I02172) - Es wurde ein Absturz bei den Fortschritts- und Ladeanzeigen behoben, wenn
Float.NaNals Fortschritt übergeben wurde. (I4fa96, b/352364576)
Version 1.4.0-alpha07
29. Januar 2025
androidx.compose.material3:material3-*:1.4.0-alpha07 ist veröffentlicht. Version 1.4.0-alpha07 enthält diese Commits.
Neue Funktionen
- Mit einer neuen API lässt sich das Aussehen von Checkboxen jetzt noch flexibler anpassen. Diese API bietet Strichparameter, mit denen Sie besser steuern können, wie das Häkchen und der Rahmen des Kästchens gerendert werden. (I65a88)
- Die
TwoRowsTopAppBarAPI wurde hinzugefügt. Sie ist eine anpassungsfähigere Alternative zu mittelgroßen und großen App-Leisten zum Erstellen von zweizeiligen oberen App-Leisten. Entwickler haben jetzt die Möglichkeit, die Inhalte von Titeln und Untertiteln sowohl im minimierten als auch im maximierten Zustand zu steuern. Außerdem können sie die Höhe für jeden Zustand anpassen. (I0be3c, b/306697446, b/229134133, b/268068946)
API-Änderungen
- Eine experimentelle
BottomAppBar-Variante wurde inFlexibleBottomAppBarumbenannt. So haben Sie mehr Kontrolle über die Anordnung und Höhe von Inhalten. (Iaa448) - Aktualisieren Sie die Benennung für Attribute im Standardobjekt „Button Group“ in
CapitalCase. Aktualisieren Sie den Namen vonanimateFraction, damit er das Verhalten, das er darstellt, genauer beschreibt. (I545cd) - Es wurden Überladungen für gängige Schaltflächen hinzugefügt, die animierte Formen bei der Interaktion ermöglichen. Zwischengespeicherte Schaltflächenformen hinzugefügt. (I5ec20)
- Sie können jetzt festlegen, wie ein
FloatingToolbarmit FAB auf das Scrollen reagiert, indem Sie einFloatingToolbarScrollBehaviorangeben. Für Symbolleisten, die an einer mittleren Kante (z. B. oben oder unten in der Mitte) positioniert sind, empfehlen wir, ein Scrollverhalten zu verwenden, um die gesamte Komponente beim Scrollen auszublenden und so ein übersichtlicheres Design zu erzielen. So wird auch verhindert, dass der FAB nicht mehr zentriert ist, was beim Verwenden des Flagsexpandedzum Minimieren passieren könnte. (I33f67) - Die experimentellen
TopAppBar-APIs wurden aktualisiert, sodass beim Festlegen der Ausrichtung von Titel und UntertitelAlignment.Horizontalanstelle vonTopAppBarTitleAlignmentverwendet wird. (I70ca2) SliderState#onValueChangeist jetzt öffentlich, um dem Nutzer mehr Kontrolle zu geben (I104eb).- Führen Sie
NavigationSuiteScaffoldStateein, um die Navigationskomponente zu animieren. Führen Sie auch Überladungen vonNavigationSuiteScaffoldundNavigationSuiteScaffoldLayoutein, die einen Statusparameter haben. (I6a8c9, b/328674235)
Fehlerkorrekturen
- Verschieben Sie die Klassen
IconButtonColorsundIconToggleButtonColorsvonIconButtonDefaults.ktzurück zuIconButton.kt. (I3c233)
Externer Beitrag
SliderState#isDraggingist jetzt öffentlich. (I8458a)
Version 1.4.0-alpha06
15. Januar 2025
androidx.compose.material3:material3-*:1.4.0-alpha06 ist veröffentlicht. Version 1.4.0-alpha06 enthält diese Commits.
Verhaltensänderung
displayCutoutwurde der Gruppe von Insets hinzugefügt, die Material-Komponenten standardmäßig berücksichtigen, um zu verhindern, dass Inhalte mit der Display-Aussparung überlappen. Dies ist eine Verhaltensänderung, die sich darauf auswirkt, wie inset-fähige Komponenten um eine Display-Aussparung herum funktionieren. Dazu gehören der Standardwert desWindowInsets-Parameters für inset-aware Material 3-Komponenten und dieWindowInsets-Werte, die in den Standardobjekten der Komponente für Material 2 und Material 3 angegeben sind. Wenn diese Änderung zu unerwünschtem Verhalten führt, geben Sie den ParameterWindowInsetsmanuell für jede Komponente an. (I43ee9, b/362508045)
API-Änderungen
- Aktualisierungen der
TopAppBarAPI. Benenne die mittleren und großen oberen App-Leisten mit einem Untertitel in*FlexibleTopAppBarum. Die Farbvariationen wurden in einer einzigenTopAppBarDefault.topAppBarColors()-Funktion zusammengefasst und einsubtitle-Farbparameter wurde hinzugefügt, der für eine bereitgestellte zusammensetzbare Untertitel-Funktion (I41b65) angewendet werden soll. WideNavigationRailArrangementAPI zugunsten vonArrangement.Verticalentfernen (Id0341)- Fügen Sie eine neue
VerticalSlider @Composablehinzu. (I2bfba) - Es wurde ein neuer Track
@Composablehinzugefügt, mit dem benutzerdefinierte externe Track-Ecken und ‑Symbole angegeben werden können. (I436a4) - Aktualisieren Sie die APIs für die unverankerte Symbolleiste, damit das
FloatingToolbarColors-Objekt anstelle einer einzelnen Containerfarbe verwendet wird. (I9a054) - Neue experimentelle Annotation
ExperimentalMaterial3ComponentOverrideApi(Ia1eaf) hinzufügen und verwenden Modifier.indicatorLineakzeptiert jetzt eine Form für das Textfeld, um das Zuschneiden zu verarbeiten. (I8c5f3, b/380704151)- Benennen Sie die experimentellen
FloatingAppBar-Funktionen inFloatingToolbar(I1dbf8) um. - Es wurde ein neues
floatingToolbarVerticalNestedScrollhinzugefügt, das an einen scrollbaren Container angehängt werden kann, um den Erweiterungsstatus der unverankerten Symbolleiste basierend auf einer Scrollbewegung zu aktualisieren, die einen Schwellenwert überschreitet. (I6d65f) - Wir stellen eine neue API zum Erstellen einer schwebenden Symbolleiste mit einer angehängten Floating Action Button (FAB) vor. Die API bietet flexible Anpassungsoptionen, mit denen Sie die Symbolleiste horizontal oder vertikal anordnen und die UAS am Anfang oder Ende der Symbolleiste platzieren können. (I9e350)
Fehlerkorrekturen
- Ein Problem mit der Barrierefreiheit von Snackbars wurde behoben, das dazu führte, dass sie sich beim Schließen ankündigten, wenn
TalkBackaktiviert war. (/I9db53)
Externer Beitrag
BasicTooltipwurde in Foundation undBasicTooltip/Tooltipin Material 3 vereinheitlicht. (Ifc2e6)
Version 1.4.0-alpha05
12. Dezember 2024
androidx.compose.material3:material3-*:1.4.0-alpha05 ist veröffentlicht. Version 1.4.0-alpha05 enthält diese Commits.
API-Änderungen
- Ersetze den Typ im
WideNavigationRailState.current/target-Wert für ein Enum, um die Lesbarkeit zu verbessern (I2d6ab) SplitButton– Die Shape API wurde aus Gründen der binären Kompatibilität von einer Datenklasse in eine Klasse geändert. (I53812)- Es wurde eine Tooltip-API mit dem Parameter
onDismissRequesthinzugefügt, damit Ersteller festlegen können, was passiert, wenn ein Nutzer außerhalb des Tooltips klickt. Die alte API, die diesen neuen Parameter nicht enthält, wurde eingestellt. (I99aef) - Die Benennung von
opticalCenteringinhorizontalCenterOpticallyändern Die Anpassung intern vornehmen Ersetzen Sie den Padding-Parameter durch den maximalen Start- und End-Offset. (I0b904) - Ändere
WideNavigationRailState, sodass es den aktuellen/Zielwert enthält, und entferne Enums zugunsten von booleschen Werten. (Idfa29, b/356039090) - Fügen Sie
NavigationBarItemComponentOverridehinzu. (I3a06a)
Fehlerkorrekturen
- Das Verhalten der oberen und unteren App-Leiste wurde korrigiert, sodass die Farbe zuverlässig geändert wird, wenn der Inhalt vollständig gescrollt wird. (Idc4e8, b/293665988)
- Scrollverhalten-Funktionen für obere und untere App-Leisten geben jetzt ein gespeichertes Verhalten zurück, um bei Neuzusammenstellungen eine bessere Leistung zu erzielen. (I0fdbe, b/207957336)
- Der Parameter „Modifier“ wird jetzt nach internen Modifikatoren wie Drag-Verhalten und Semantik angewendet, nicht mehr davor. Dies wirkt sich auf die Reihenfolge aus, in der die Modifikatoren angewendet werden. (I8d83f)
- Die maximierte Ansicht am unteren Rand bleibt auch bei einer Größenänderung maximiert. (I2870b, b/324934884)
- Status- und Navigationsleisten-Flags für Fenstereigenschaften korrekt weiterleiten. (Ie674d, b/362539765)
- Verschieben Sie den Parameter für den Modifier in das Stammverzeichnis der Scaffolds, wie dokumentiert. Dadurch wird die Implementierung an M2 angepasst. (I0235e, b/372311595)
Externer Beitrag
- Gemeinsame
DatePickerDialog-Funktion. (I7dced)
Version 1.4.0-alpha04
13. November 2024
androidx.compose.material3:material3-*:1.4.0-alpha04 ist veröffentlicht. Version 1.4.0-alpha04 enthält diese Commits.
Geändertes Verhalten
- Macht die in aosp/3212478 eingeführten Farbänderungen für
iconButtonColors,iconToggleButtonColors,outlinedIconButtonColors,outlinedIconToggleButtonColorsundoutlinedIconToggleButtonBorderrückgängig. Das jetzt zurückgesetzte Verhalten wurde in eine neue Reihe von Funktionen namensiconButtonVibrantColorsusw. verschoben, um die zurückgegebenen Farben mit hohem Kontrast hervorzuheben. (Iffd8d)
Neue Funktionen
VerticalDragHandle-Komponente einführen (I6c770)
API-Änderungen
- Benenne
DismissibleModalWideNavigationRailDefaultsinModalWideNavigationRailDefaultsum. (I8e877) - Fügen Sie
NavigationBarComponentOverrideshinzu. (I8a3f3) - Fügen Sie
NavigationRailComponentOverridehinzu. (I83e13) - Führe
WideNavigationRailStateein, um das Ein- und Ausblenden des Rails zu ermöglichen, sorge dafür, dassModalWideNavigationRailgeschlossen werden kann, und löscheDismissibleModalWideNavigationRail. (I88568) - Den Standardeinstellungen für Ein/Aus-Schaltflächen werden die Standardgrößen „xSmall“, „medium“, „large“ und „xLarge“ hinzugefügt. (Ie95d1)
- Den Button-Standardeinstellungen werden die Standardgrößen „Sehr klein“, „Mittel“, „Groß“ und „Sehr groß“ hinzugefügt. (If8b6d)
Fehlerkorrekturen
- Die Farbe des nachgestellten Symbols für Filter-Chips wurde gemäß Spezifikation von „Primär“ zu
OnSurfaceContaineraktualisiert. Alle Umrissfarben für Chips wurden gemäß Spezifikation von „Umriss“ zu „Umrissvariante“ aktualisiert. (I68bd4)
Version 1.4.0-alpha03
30. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha03 ist veröffentlicht. Version 1.4.0-alpha03 enthält diese Commits.
API-Änderungen
- Der
SheetState-Konstruktor mit Dichte wurde zugunsten von Positions- und Geschwindigkeitsschwellenwerten eingestellt. (Ifd16e) rememberTooltipPositionProviderwurde hinzugefügt und enthält eine aktualisierte Logik für die Positionierung.rememberPlainTooltipPositionProviderundrememberRichTooltipPositionProviderwurden eingestellt. (Ie66e2)- Mit zusätzlichen
ModalBottomSheetPropertieskönnen die Farben der Status- und Navigationsleiste angepasst werden. Standardmäßig werden sie anhand der Inhaltsfarbe und nicht anhand des Status des dunklen Systemdesigns aktualisiert. (Ib874e, b/362539765) - Die Eingabe in Datumsauswahlen wurde verbessert: Im Eingabemodus wird das Datumsfeld für die sofortige Texteingabe fokussiert. Durch die Änderung wird den
DatePicker- undDateRangePicker-Parametern einrequestFocus-Parameter hinzugefügt. Sie können verhindern, dass der Fokus gesetzt wird, indem Siefalseübergeben. (I12d09, b/286399710, b/340102743) - Die Standardeinstellungen für Formen werden im Shape-Objekt im Cache gespeichert. Die Form wird standardmäßig auf
@Composablefür Ein/Aus-Schaltflächen festgelegt. Die Formen werden standardmäßig in einer Form zusammengefasst, da die Varianten auf dieselbe Token-Datei verweisen. (Iaa014)
Fehlerkorrekturen
- Optimieren Sie das Verhalten von
contentPadding, um zu vermeiden, dass der Inhalt des Bodys immer neu zusammengesetzt wird, wenn sichcontentPaddingändert. (I8c8e2, b/373904168) TextFieldLabelScopeprogresswurde inlabelMinimizedProgressumbenanntTextFieldLabelPositionDefaultwurde inAttachedumbenannt. Schnittstellenmitglieder wurden entfernt. (If75c6)- Ein Problem mit dem
DatePickerim Eingabemodus wurde behoben. Validierungsfehler konnten dazu führen, dass sich die Höhe der Komponente änderte. (I2e229, b/280462363) - Sorgen Sie dafür, dass sich der Wert des Material-Schiebereglers ändert, wenn Steuertasten gedrückt werden. (I1c442)
Version 1.4.0-alpha02
16. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha02 ist veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.
API-Änderungen
- Die Datumsauswahlen wurden aktualisiert, um eine einheitliche Verwendung von Gebietsschemas in der gesamten
DatePickerundDateRangePickerzu gewährleisten, wenn ein Gebietsschema direkt über einDatePickerStateoder einDateRangePickerStatefestgelegt wird. Wenn Sie Gebietsschemas direkt auf den Status festlegen, müssen Sie dafür sorgen, dass die Titel- und Überschriftentexte entsprechend lokalisiert werden, da der Standardtext weiterhin gemäß dem Standardgebietsschema der Plattform angewendet wird. (I37073, b/326490763, b/321657276) SheetState.isAnimationRunningist jetzt verfügbar. (I9a3d7)DatePickerColorshaben jetzt Vorrang vor allen in Konflikt stehenden Farben, die in den Textstilen der Typografie des Designs definiert sind. Außerdem wird mit diesem Update die Position des Parameterscolorin den Funktionen für die Datumsauswahl angepasst und ein ParametercontentColorzum Anpassen der Farben für Kopf- und Titeltext eingeführt. (I30d03, b/347031394)- Benennen Sie
SplitButtoninSplitButtonLayoutum und entfernen Sie die APIs für Farbvarianten vonSplitButton. Die Varianten werden durch die Wiederverwendung der vonSplitButtonDefaultsbereitgestellten Schaltflächenvarianten erreicht. (I44c36) ModalBottomSheethat jetzt den ParametersheetGestureEnabled(I856cb, b/288211587)- Die Namen der Stile
standardMotionSchemeundexpressiveMotionSchemewurden in „Standard“ und „Ausdrucksstark“ geändert. Beide Funktionen sind jetzt über dasMotionScheme-Begleitobjekt verfügbar, indem SieMotionScheme.standard()undMotionScheme.expressive()aufrufen. (Iceccf) - Der Parameter
maxWidthwird einfachen und Rich-Tooltips hinzugefügt. Die Standardeinstellung ist die Designspezifikation von 200 dp für einfache Tooltips und 320 dp für Rich-Tooltips. (I30ce9)
Fehlerkorrekturen
- Die
DatePickerundDateRangePickeraktualisieren den angezeigten Monat jetzt korrekt, wenn sie über dendisplayedMonthMillisihres Status festgelegt werden. (If9e47, b/333414302) ModalBottomSheetverschiebt Inhalte jetzt von der Statusleiste weg. (I5114c, b/321877275, b/336962418, b/342093067)- [Bottom Sheet] Die Priorität des Rückrufs wird auf
PRIORITY_DEFAULTgeändert, damit die IME-Tastatur zuerst geschlossen werden kann. (I447fb) - Abstürze in
DatePickerundDateRangePickerbehoben, wenn das minimal auswählbare Jahr auf ein zukünftiges Jahr festgelegt ist. (I78656, b/319395747) - Beheben Sie ein Problem mit der Datumsauswahl, um die Benutzeroberfläche zu aktualisieren, wenn eine aktualisierte
SelectableDates-Instanz angewendet wird. (Iad59a, b/290135807, b/339898760)
Version 1.4.0-alpha01
2. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha01 ist veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.
Geändertes Verhalten
- Die Bibliothek fügt keine Abhängigkeit mehr zu
material-icons-corehinzu. Wenn Ihr Projekt also darauf angewiesen war, müssen Sie diese Abhängigkeit explizit in Ihrenbuild.gradle[.kts]-Dateien hinzufügen. (I735ff, b/349894318) - Die aktive Label-Farbe von
NavigationBarItemundNavigationRailItemändert sich vononSurfacezusecondary, um die Nutzerfreundlichkeit und den Farbkontrast zu verbessern und die Kohärenz im System zu erhöhen (Ibc297). Wenn Sie zum vorherigen Verhalten zurückkehren möchten, kopieren Sie die Standardfarben und ändern SieselectedTextColorinMaterialTheme.colorScheme.onSurface. - Material 3-Komponenten verwenden jetzt die neue
MotionScheme, um ihre Bewegung zu definieren. (Ie0f93) - Bewegungsänderungen bei unbestimmter kreisförmiger Fortschrittsanzeige (I3c07e)
- Aktualisieren Sie
OutlinedIconButtonColorsundOutlinedIconToggleButtonColors, um den Farbkontrast zu verbessern. (I2743d) - Die Container- und Inhaltsfarbe für
FilledIconToggleButtonColorsundFilledTonalIconToggleButtonColorswurde aktualisiert. (Ic5d0f) - Die Rahmenfarbe von
OutlinedButtonwurde vonoutlinezuoutlineVariantgeändert. (057f00)
API-Änderungen
- Der Funktion
enterAlwaysScrollBehaviordesTopAppBarwurde ein optionaler ParameterreverseLayouthinzugefügt, um Inhalte, die mit einemreverseLayoutfestgelegt wurden, besser zu unterstützen. (I4e0e5) SegmentedButtonunterstützt jetzt das ArgumentcontentPadding. (I5ad91, b/358414376)PullToRefreshStatehat keine Standardimplementierung mehr fürisAnimating(I6a593)- Es wurden neue Überladungen von „Material“
TextFieldundOutlinedTextFieldhinzugefügt, dieTextFieldStateverwenden. Es wurden APIs für Dekorationsfelder hinzugefügt, die mitTextFieldDecoratorkompatibel sind. (If13a1) - Es wurde ein Parameter hinzugefügt, um die
labelPositiondes Textfelds zu steuern. MitalwaysMinimizekann das UI-Muster verwendet werden, bei dem gleichzeitig ein Label und ein Platzhalter in einem Textfeld angezeigt werden, auch wenn das Feld nicht fokussiert ist. (I1ef2c) - Die Material-Komponenten
SecureTextFieldundOutlinedSecureTextFieldfür Passwort-Eingabefelder wurden hinzugefügt. (I7e22d) - Ein Bereich für Textfeldlabels wurde hinzugefügt, um den Fortschritt von Animationen abzufragen. (If5ec8)
- Unterstützung für
MotionEvent.CLASSIFICATION_DEEP_PRESSin Kurzinfos hinzugefügt. (I62e6a) TimePickerStatesisAfternoonist jetzt ein Erweiterungswert anstelle einer Variablen in der Schnittstelle und wurde inisPmumbenannt (I89a97)- Die Typografieklasse wurde aktualisiert, um betonte Typografie-Skalen zu unterstützen. (Ifa13c)
- Die
ModalWideNavigationRailAPI wurde hinzugefügt und dieModalExpandedNavigationRailAPIs wurden inDismissibleModalWideNavigationRailumbenannt. (Ic9118) FloatingAppBarScrollBehaviorwurde aktualisiert, sodassscreenOffsetautomatisch berechnet wird und keine@Composableerforderlich ist. (Idf349)- Aktualisierungen der
LoadingIndicatorAPI zur Korrektur der Benennung des Standardobjekts. EineLoadingIndicatorElevation-Konstante wurde beiPullToRefreshhinzugefügt. (I1d72b) - Aktualisierungen der
LoadingIndicatorAPI zur Korrektur der Benennung des Standardobjekts. EineLoadingIndicatorElevation-Konstante wurde beiPullToRefreshhinzugefügt. (I1d72b) - Den unbestimmten Varianten von
LinearWavyProgressIndicatorundCircularWavyProgressIndicatorwurden die ParameteramplitudeundwaveSpeedhinzugefügt. (I2a0c5) - Die Form einer Ein/Aus-Schaltfläche mit Symbol kann je nach gedrücktem oder ausgewähltem Zustand geändert werden. (Ibc781)
- Die Typografieklasse wurde aktualisiert, um betonte Typografie-Skalen zu unterstützen. (Ifa13c)
- Die Form von
SplitButtonändert sich je nach Standard- oder gedrücktem Zustand. DieAnimatedTrailingButton-API wurde entfernt, da dieTrailingButton-API dieselben Anpassungen bieten kann (I95066). - Fügen Sie einen Modifikator hinzu, um das Ein- und Ausblenden des schwebenden Aktionsschaltfläche zu animieren, z.B. beim Scrollen von Inhalten. (I8338d)
- Hinzufügen von Formen und Abständen für verbundene Button-Gruppen zu
ButtonGroupDefaultszur Verwendung in einem Beispiel. (I68e30) - Aufgeteilter Button: Horizontales Padding für den nachfolgenden Button wird hinzugefügt und die optische Zentrierung wird anhand der Differenzen zwischen Start- und End-Ecke berechnet (I122e2).
- Wir führen ein neues Material
MotionSchemeein, mit dem Sie ein Schema für die Bewegung der Komponente festlegen können. Das Schema wird überMaterialThemefestgelegt. (Id50c2)
Fehlerkorrekturen
- Wenden Sie den richtigen Fokusdurchlaufindex auf untergeordnete
Scaffold-Composables an. Die Reihenfolge isttopBar,bottomBar, fab, content, snackbar. (I5936b) - Es wurde ein Problem bei
DatePickerundDateRangePickerbehoben, bei dem in bestimmten Gebietsschemas und Format-Skeletten einige der Datumsbestandteile (z.B. Monatsnamen) nicht mit einem Großbuchstaben begannen. (I1430f) - Tokens für FAB- und FAB-Menükomponenten integrieren (geringfügige visuelle Änderungen an Abständen und Text) (Ib57f3)
ModalBottomSheetist jetzt das erste Element in der semantischen Reihenfolge, gefolgt vom Scrim. (I436f9, b/358594665)- Problem behoben: Die untere App-Leiste verschwindet beim Scrollen unter dem Navigations-Pill im Edge-to-Edge-Modus nicht vollständig (I3ee21).
Compose Material3 Version 1.3
Version 1.3.2
09. April 2025
androidx.compose.material3:material3-*:1.3.2 ist veröffentlicht. Version 1.3.2 enthält diese Commits.
Fehlerkorrekturen
ListItemkorrigiert die Berechnung der intrinsischen Höhe und reserviert jetzt die entsprechende Menge an Speicherplatz im Layout.- Entfernen Sie das überflüssige Padding des Labels
NavigationBarItem, um es korrekt an der Spezifikation auszurichten. - Korrigiert das
TabRow-Layout im RTL-Modus.
Version 1.3.1
30. Oktober 2024
androidx.compose.material3:material3-*:1.3.1 ist veröffentlicht. Version 1.3.1 enthält diese Commits.
Fehlerkorrekturen
- Die
DatePickerundDateRangePickeraktualisieren den angezeigten Monat jetzt korrekt, wenn sie über dendisplayedMonthMillisihres Status festgelegt werden. (If9e47, b/333414302) - Abstürze in
DatePickerundDateRangePickerbehoben, wenn das minimal auswählbare Jahr auf ein zukünftiges Jahr festgelegt ist. (I78656, b/319395747) - Beheben Sie ein Problem mit der Datumsauswahl, um die Benutzeroberfläche zu aktualisieren, wenn eine aktualisierte
SelectableDates-Instanz angewendet wird. (Iad59a, b/290135807, b/339898760) - Die Callback-Priorität, die von Bottom Sheets verwendet wird, wird in
PRIORITY_DEFAULTgeändert, damit die IME-Tastatur zuerst geschlossen werden kann. (I447fb)
Version 1.3.0
4. September 2024
androidx.compose.material3:material3-*:1.3.0 ist veröffentlicht. Version 1.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.2.0
Wichtige Funktionen von Version 1.3.0
Neue Material Design 3-Komponenten
- Karussell
HorizontalMultiBrowseCarouselundHorizontalUncontainedCarouselVerbesserungen an vorhandenen Material Design 3-Komponenten.
- [
ModalBottomSheet] unterstützt jetzt die Funktion „Vorhersagende Zurück-Geste“ auf U+ (Iccf32, b/281967264, b/304850357) - [
SearchBar] Unterstützung der intelligenten „Zurück“-Geste auf U+ (I657f8) - Die Navigationsleiste (
ModalDrawerSheetundDismissibleDrawerSheet) unterstützt jetzt die Funktion „Vorhersagende Zurück-Geste“ auf U+ als Opt-in (Ie5b0b). DropdownMenuunterstützt jetzt benutzerdefinierte Farben, Formen, Erhebungen und Rahmen. (I8e981,b/289554448, b/301887035, b/283654243)- Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Stoppanzeige hinzugefügt. (I3058e)
- Die
ProgressIndicatorwurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I21451) - Für Rich-Tooltips wurde ein Standard-Caret hinzugefügt. Es kann ein benutzerdefiniertes Caret gezeichnet werden, wenn der Anker
LayoutCoordinatesangegeben ist. (Ifd42c) Funktionsgefährdende Änderungen - Neue APIs für „Zum Aktualisieren ziehen“:
- Vereinfachtes
PullToRefreshStatezur Verwendung von Bruchwerten anstelle von Dp-Einheiten. - Der Status von
isRefreshingwird vom Nutzer und nicht vonPullToRefreshStategesteuert. - Die verschachtelte Scrollverbindung wurde von
PullToRefreshStategetrennt. Dies wird von der neuenPullToRefreshBoxoderModifier.pullToRefreshübernommen. - Dieses Update ist eine grundlegende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Visuelle Änderungen
- Vereinfachtes
- Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorSchemeunddarkColorScheme. (I9db52) - Die Farben des Schiebereglers und von
ProgressIndicatorwurden aktualisiert, um den neuen Spezifikationen für den Kontrast von Nicht-Text-Elementen zu entsprechen. (I26807) SurfaceContainer-Varianten werden jetzt von Komponenten verwendet. Komponenten, bei denen die Farbe bisher mitSurfaceundTonalElevationberechnet wurde, verwenden jetzt standardmäßigSurfaceContainer-Rollen, die nicht von der tonalen Erhebung betroffen sind. (b/304584161)- Die Baseline-Rollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, sodass in hellen und dunklen Designs mehr Farbton zu sehen ist. (I677a5)
- Experimentelle APIs wurden in stabile APIs umgewandelt.
- Leistungsverbesserungen
Version 1.3.0-rc01
21. August 2024
androidx.compose.material3:material3-*:1.3.0-rc01 ist veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.
Fehlerkorrekturen
ModalBottomSheetist jetzt das erste Element in der semantischen Reihenfolge, gefolgt vom Scrim. (I436f9, b/358594665)
Version 1.3.0-beta05
24. Juli 2024
androidx.compose.material3:material3-*:1.3.0-beta05 ist veröffentlicht. Version 1.3.0-beta05 enthält diese Commits.
- Ein Problem wurde behoben, bei dem
BottomSheet-Inhalte unter Android N und O fehlen oder abgeschnitten werden (a10a2d). - Die semantischen Grenzen des Schiebereglers wurden erhöht, damit
TalkBackdie Fokusindikatoren um die Thumbnails herum richtig anzeigen kann. (0b5a1d)
Version 1.3.0-beta04
26. Juni 2024
androidx.compose.material3:material3-*:1.3.0-beta04 ist 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 ist veröffentlicht. Version 1.3.0-beta03 enthält diese Commits.
Externer Beitrag
androidx.compose.material3.DropdownMenuaus dem gemeinsamen Quellenset verfügbar machen (If62c0)
Version 1.3.0-beta02
29. Mai 2024
androidx.compose.material3:material3-*:1.3.0-beta02 ist veröffentlicht. Version 1.3.0-beta02 enthält diese Commits.
API-Änderungen
Modifier.pullToRefreshIndicatorunterstützt die Erhebung. Aktualisieren Sie die Pull-to-Refresh-APIs so, dass „enabled“ ein boolescher Wert anstelle einer Lambda-Funktion ist. Unterstützung der Ausrichtung von Inhalten inPullToRefreshBox(I75679)TooltipScopeals versiegelte Schnittstelle festlegen und eine interne Implementierung für die Verwendung inTooltipBoxund Label erstellen. (I3833e)- Für
CarouselItemScope–maskClipundmaskBorderwurden zwei neue Modifizierer hinzugefügt, mit denen sich ganz einfach Formen und Rahmen für Karussellelemente hinzufügen lassen (Id67a1). TimePickerStateist jetzt eine Schnittstelle und ermöglicht das Einstellen der Zeit (I88546).- Die API zum Formatieren der Links wurde aktualisiert:
TextLinkStyleswurde inTextStyleverschoben undTextDefaultswurde aus „material“ entfernt. (I5477b)
Fehlerkorrekturen
- Die Symbole für die Status- und Navigationsleiste von
ModalBottomSheetreagieren jetzt auf den Status des dunklen Designs. (Ie1fe7, b/338342149) - Der
ModalBottomSheet-Scrim wurde um die Semantik zum Schließen des Blatts erweitert. (0e61cb,b/328801864)
Externer Beitrag
androidx.compose.material3.AlertDialogüber das gemeinsame Quellset verfügbar machen (Ia33f5)ModalBottomSheetaus dem gemeinsamen Source-Set (Id7cc7) verfügbar machen
Version 1.3.0-beta01
14. Mai 2024
androidx.compose.material3:material3-*:1.3.0-beta01 ist veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.
API-Änderungen
DpSizeanstelle vonCaretPropertiesverwendenCaretPropertieswird entfernt. BenenneCaretScopeinTooltipScopeum. (Id9a76)- Die API zum Abrufen von Links mit Material-Design im Text wurde aktualisiert. Insbesondere wurden die Methoden aus
TextDefaultszum Erstellen von thematischenLinkAnnotationsund zum Parsen von HTML mit thematischen Links entfernt. Stattdessen wurde eineTextLinkStyles-Klasse hinzugefügt, mit der die Links als Parameter für die Text-Composable-Funktion formatiert werden können. (I31b93)
Version 1.3.0-alpha06
1. Mai 2024
androidx.compose.material3:material3-*:1.3.0-alpha06 ist veröffentlicht. Version 1.3.0-alpha06 enthält diese Commits.
Aktuelle Änderungen
Neue Pull-to-Refresh-APIs:
- Vereinfachtes
PullToRefreshStatezur Verwendung von Bruchwerten anstelle von Dp-Einheiten. - Der Status von
isRefreshingwird vom Nutzer und nicht vonPullToRefreshStategesteuert. - Die verschachtelte Scrollverbindung wurde von
PullToRefreshStategetrennt. Dies wird von der neuenPullToRefreshBoxoderModifier.pullToRefreshübernommen. - Dieses Update ist eine grundlegende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- Vereinfachtes
API-Änderungen
RippleConfiguration#isEnabledwurde entfernt undLocalRippleConfigurationkann jetzt null sein. Wenn Sie einen Ripple deaktivieren möchten, geben Sie statt einesRippleConfigurationmitisEnabled = falseden WertnullbisLocalRippleConfigurationan. (I22725)ModalBottomSheetDie Statusleiste wird bei aktivierter Edge-to-Edge-Funktion genauer abgedunkelt. Inhalte von modalen Ansichten am unteren Rand können jetzt Fenster-Insets aufnehmen, sodass Inhalte über der Navigationsleiste sichtbar sind. Der ParameterModalBottomSheetwindowInsetswurde incontentWindowInsetsumbenannt, um anzugeben, wo die Insets angewendet werden. Sie sind nicht mehr an die Fensterlogik gebunden. Der TypcontentWindowInsetswurde in eine Funktion geändert, dieWindowInsetszurückgibt, damit er im neuen Fenster aufgelöst werden kann. (I39630, b/274872542, b/300280229, b/290893168)PrimaryScrollableTabRowundSecondaryScrollableTabRowverwenden jetzt ein benutzerdefiniertes Layout anstelle einer Unterkomposition, was die Leistung verbessern sollte. (I991e0)- Für Textlinks gibt es jetzt zusätzlich zum normalen Stil sowie den Stilen für „Hover“ und „Fokus“ auch einen Stil für den gedrückten Zustand. Die
TextDefaults-Methoden haben jeweils einpressedStyle-Argument erhalten, um dies zu unterstützen. (Ic473f, b/139312671)
Fehlerkorrekturen
- Die Ziehpunkte für die Navigationsleiste haben jetzt dieselbe Breite wie
drawerContent. (Ibc72f, b/245355396) - Der obere Innenabstand für das Label
OutlinedTextFieldberücksichtigt jetzt die Schriftgröße des Systems. (Idc781) - Der korrigierte Paketstandort von
CalendarLocale. (Ifa235) - [Intelligente „Zurück“-Geste] Aktualisieren der Animationen für die intelligente „Zurück“-Geste, sodass die Interpolationskurve (0.1, 0.1, 0, 1) verwendet wird (I2591a)
Version 1.3.0-alpha05
17. April 2024
androidx.compose.material3:material3-*:1.3.0-alpha05 ist veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.
Neue Funktionen
SearchBarundDockedSearchBarhaben neue Überladungen, die einen Textfeldparameter akzeptieren. So lässt sich das Textfeld unabhängig vom Rest der Suchleiste gestalten und es können benutzerdefinierte Textfelder übergeben werden. Das Textfeld der aktuellen Implementierung ist alsSearchBarDefaults.InputFieldverfügbar. (I50c73, b/275074248, b/278773336, b/326627700)- Die Lambda-Funktion
drawTickwurde der öffentlichen API hinzugefügt, um die Ticks bei Bedarf anzupassen (I0c048).
API-Änderungen
- Für Textlinks gibt es jetzt zusätzlich zur normalen Formatierung auch eine Formatierungsoption für den gedrückten Zustand sowie für den Mauszeiger und den Fokus. (I5f864, b/139312671)
CarouselItemInfowurde aktualisiert, um ein Maskenrechteck verfügbar zu machen, durch das das Element beschnitten wird (I785d8).BasicTooltipStatewurde aus der öffentlichen Material 3-API entfernt. Die Funktionalität wird mitTooltipStatekombiniert, bisBasicTooltipvon Foundation stabilisiert ist. (Icda29)- Es wurde ein
TextDefaults-Objekt hinzugefügt, das Methoden zum Erstellen einesLinkAnnotationund zum Parsen von HTML-getaggten Strings enthält, in denenMaterialThemeauf die Links angewendet wird (I98532, b/139312671). ExposedDropdownMenuBoxScopelässt keine Unterklassen mehr zu. Für Drop-down-Menüs, die angezeigt werden, gibt es jetzt einMenuAnchorType, das anmenuAnchorübergeben werden sollte, um die Barrierefreiheit zu verbessern. Diese Methode sollte anstelle der Übergabe vonfocusableanExposedDropdownMenuverwendet werden, da Letzteres jetzt eingestellt ist.menuAnchorhat einen neuen Parameter zum Steuern desenabled-Status. (I55ee6, b/257209915, b/308840226)- Die Rahmenfarbe von
OutlinedButtonwurde korrigiert, wenn die Funktion deaktiviert ist. Die ÜberladungButtonDefaults.outlinedButtonBorder("enabled")wurde hinzugefügt, die den aktivierten Status übernimmt. (Ie650b, b/318461363) - Es wurde eine neue
CarouselItemInfo-Klasse hinzugefügt, damit Clients Informationen zu den Artikelgrößen abrufen können. (I9070c) - Der
ColorScheme-Konstruktor ohne Surface-Container ist jetzt veraltet. Migrieren Sie bitte zum Konstruktor, der Oberflächencontainer enthält. (I35c11) - [Outlined]
TextFieldDefaultsContainerBoxwurde inContainerumbenannt. (Ie8d3b)
Fehlerkorrekturen
BottomSheetScaffoldwird nicht mehr durch verschachteltes Scrollen gescrollt, wennsheetSwipeEnabledauf „false“ gesetzt ist. (I5e1c1, b/306464779)- Einige
ExperimentalMaterial3Api-OptIn-Annotationen inIconButtonSamples.ktwurden entfernt. (I111d1)
Version 1.3.0-alpha04
3. April 2024
androidx.compose.material3:material3-*:1.3.0-alpha04 ist veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.
Neue Funktionen
- Es wurden zwei experimentelle Versionen des Material3-Karussells hinzugefügt:
HorizontalMultiBrowseCarouselundHorizontalUncontainedCarousel(I88d64). - Die Compose M3-Navigationsleiste (
ModalDrawerSheetundDismissibleDrawerSheet) wurde aktualisiert, um die intelligente „Zurück“-Geste auf U+ als Opt-in zu unterstützen (Ie5b0b). - Eine neue API wurde in „Icon“ hinzugefügt, um die Farbtonfarbe als Lambda zu übergeben und so das Neuzusammenstellen zu vermeiden. (I5b5a2)
- Die APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen für feste und minimierbare Bereiche. (Ib8b0c, b/323403446)
API-Änderungen
- Die APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen für feste und minimierbare Bereiche. Ein Problem wurde behoben, das dazu führte, dass einzeilige Top-App-Leisten beim Scrollen von Inhalten zu oft neu zusammengesetzt wurden. Es wurde ein Problem behoben, bei dem
MediumTopAppBarTitel auf Geräten mit großen Schrift-/Anzeigeeinstellungen abgeschnitten hat. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) SegmentedButtonund zugehörige APIs sind jetzt stabil (I8a158)SwipeToDismissBox,SwipeToDismissBoxDefaults,SwipeToDismissBoxStateundSwipeToDismissBoxValuesind jetzt als stabil gekennzeichnet. (I5f000)- Die verworfenen Enums und APIs
DismissDirectionundDismissValuewurden entfernt. (I89ccd) - Dem Companion-Objekt
CarouselStatevon „Carousel“ wurde ein experimentelles Tag hinzugefügt. (I94154) LocalMinimumInteractiveComponentEnforcementwurde eingestellt und durchLocalMinimumInteractiveComponentSizeersetzt. (I7a7ac)- Der Konstruktor
SearchBarColorsist jetzt öffentlich. (I769ca) - Der Parameter
gesturesEnabledwurde zuSwipeToDismissBoxhinzugefügt. (Idc59f, b/324170119) - Die als nicht mehr weitergeführt und experimentell gekennzeichneten Textfeld-APIs wurden entfernt. (I1305f)
Version 1.3.0-alpha03
20. März 2024
androidx.compose.material3:material3-*:1.3.0-alpha03 ist veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.
Visuelle Breaking Changes
- Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorSchemeunddarkColorScheme. (I9db52)
Neue Funktionen
- Es wurden Parameter hinzugefügt, um
ExposedDropdownMenuanzupassen. Insbesondere haben Menüs jetzt einenfocusable-Parameter (Standardwerttrue), der auffalsegesetzt werden sollte, wenn Sie mit bearbeitbaren Textfeldern arbeiten. (I4184c, b/323694447, b/278609042)
API-Änderungen
- Das Flag
ScaffoldSubcomposeInMeasureFixwurde entfernt. (Ie2a4b) NavigationRailItemColorsist jetzt als@Immutablemarkiert. (If6112, b/327660613)NavigationBarItemColorsist jetzt als@Immutablemarkiert. (I42a30, b/298064514)- Parameter in der zusammensetzbaren Funktion „Slider Track“ neu anordnen. (I9f315)
ExposedDropdownMenuwird jetzt mitPopupimplementiert. Das Verhalten sollte dasselbe sein, mit Ausnahme von Menüs mit Fokus und bearbeitbaren Textfeldern, die beim Tippen auf der Tastatur geschlossen werden können.
Fehlerkorrekturen
- Die Baseline-Rollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, sodass in hellen und dunklen Designs mehr Farbton zu sehen ist. (I677a5)
- Die Farben des Schiebereglers und von
ProgressIndicatorwurden aktualisiert, um den neuen Spezifikationen für den Kontrast von Nicht-Text-Elementen zu entsprechen. (I26807) - Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorSchemeunddarkColorScheme. (I9db52)
Version 1.3.0-alpha02
6. März 2024
androidx.compose.material3:material3-*:1.3.0-alpha02 ist veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.
API-Änderungen
- Die Schiebereglerzustände werden wieder stabil.
State.onValueChangeFinishedwird wieder zu einem Wert.onValueChangeFinishedin einerememberUpdatedStateeinfügen. (I82ab2, b/322269951) - Die Navigationskomponenten verwenden jetzt die neuen
SurfaceContainer-Rollen.DrawerDefaultsbietet jetzt separate Attribute fürstandardContainerColorundmodalContainerColor.DrawerDefaults.ModalDrawerElevationist jetzt0.dp. (I7fbac) @Stablewird aus den Status vonSliderentfernt, dastate.onValueChangeFinishedin einvargeändert wird. (Ied34a, b/322269951)- Die Animationsspezifikation für
ModalBottomSheetundStandardBottomSheetist jetzt einTweenSpecund wurde von einer federnden Animation aktualisiert. Dadurch wird ein Problem mit einem sichtbaren Überschwingen behoben. Die verworfenenSheetState-Konstruktoren ohne Dichte wurden entfernt. (I7babc, b/285847707)
Fehlerkorrekturen
SurfaceContainer-Varianten werden jetzt von Komponenten verwendet. Für Komponenten, bei denen die Farbe bisher mit „Surface“ undTonalElevationberechnet wurde, werden jetzt standardmäßigSurfaceContainer-Rollen verwendet, die nicht von der tonalen Erhebung betroffen sind. (b/304584161)- Ein Fehler wurde behoben, durch den die nicht ausgewählte, deaktivierte Containerfarbe von
ElevatedFilterChipschwarz war. (I400e6, b/322407043) - Unbestimmte Fortschrittsanzeige korrigieren, wenn der Fortschritt 0 ist (Id6582)
- Ein Problem mit
SliderundRangeSliderim RTL-Layout (Iab0e1) wurde behoben. SliderRangeTolerancewird für die Berechnung des Bereichs des Schiebereglers hinzugefügt, da das Runden von Gleitkommazahlen ungenau sein kann. (Ic918a, b/324934900)- Achte darauf, dass die Schaltflächen von
DatePickerDialogangezeigt werden, wenn du einDateRangePickereinbettest oder eine beliebige Art von Datumsauswahl auf kleinen Bildschirmen mit größeren Schriftarten anzeigst. (Ie4758, b/325107799, b/277768544) Menuverwendet jetzt die RolleSurfaceContainerfür die Containerfarbe.MenuDefaults.TonalElevationist jetzt0.dp. (I135b7)TextFieldverwendet jetzt die RolleSurfaceContainerHighestfür die Containerfarbe. (I4dced)- Für erhöhte Chips wird jetzt die Rolle
SurfaceContainerLow(I7cd2f) verwendet. - Die Containerfarbe für
DatePickerist jetztSurfaceContainerHigh.DatePickerDefaults.TonalElevationist jetzt0.dp. (Ida753) - Aktualisiert die Containerfarbe und die Ziehgrifffarbe von Bottom Sheets. (I72a0a)
- Die Containerfarbe für
RichTooltipist jetztSurfaceContainer. (Ia8b45) - Die Containerfarbe von
SearchBarist jetztSurfaceContainerHighest.SearchBarDefaults.TonalElevationist jetzt0.dp. (I88604) - Der Schalter „Updates“ ist deaktiviert und nicht ausgewählte Tracks/Symbole verwenden die Farbrolle
SurfaceContainerHighest. (I7687a) - Die Containerfarbe von
AlertDialogist jetztSurfaceContainerHigh. (Ie0433) - Die Containerfarbe für
BottomAppBarist jetztSurfaceContainer. Die Farbe vonTopAppBaronScrollist jetztSurfaceContainer. (I41630) - Die Containerfarbe für
ElevatedCardist jetztSurfaceContainerLow. Die Containerfarbe vonFilledCardistSurfaceContainerHighest. (I35141) - Die Containerfarbe für
ElevatedButtonist jetztSurfaceContainerLow.FilledIconButton, die nicht ausgewählt sind, haben jetzt die ContainerfarbeSurfaceContainerHighest. (I792c9) - Aktualisiert die Rolle für die Containerfarbe
TimePickerund die Farbe des Zifferblatts aufSurfaceContainerHighest. (I43b93)
Version 1.3.0-alpha01
21. Februar 2024
androidx.compose.material3:material3-*:1.3.0-alpha01 ist veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.
Neue Funktionen
- Update für Compose M3
ModalBottomSheetzur Unterstützung von Predictive Back unter U+ (Iccf32, b/281967264, b/304850357) - Compose M3
SearchBarwurde aktualisiert, um die intelligente „Zurück“-Geste auf U+ zu unterstützen (I657f8) - Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Stoppanzeige hinzugefügt. (I3058e)
- Die
ProgressIndicatorwurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I21451) - Standard-Caret für Rich-Kurzinfo hinzugefügt: Mit der neuen Rich-Kurzinfo-API kann jetzt ein benutzerdefiniertes Caret für den Anker
LayoutCoordinatesgezeichnet werden. (Ifd42c)
Geändertes Verhalten
- Material-Komponenten wurden migriert, um die neuen Ripple-APIs zu verwenden. Sie fragen
RippleThemenicht mehr ab.
API-Änderungen
- Der Fun
drawStopIndicatorist jetzt öffentlich. (I3f59f) - Markiere die
formatWithSkeleton-Funktion vonDatePickerals intern (Ic65dc). DropdownMenuunterstützt jetzt benutzerdefinierte Farben, Formen, Erhebungen und Ränder. (I8e981, b/289554448, b/301887035, b/283654243)- Material3-Komponenten, die in ihrer API ein
MutableInteractionSourceverfügbar machen, wurden aktualisiert und machen jetzt ein nullableMutableInteractionSourceverfügbar, das standardmäßig aufnullgesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dasMutableInteractionSourcenicht verschieben. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie einMutableInteractionSourcezugewiesen wird. Außerdem kann es sein, dass für andere Komponenten erst dann eine Instanz erstellt wird, wenn sie benötigt wird. Das verbessert die Leistung dieser Komponenten. Wenn Sie dieMutableInteractionSource, die Sie an diese Komponenten übergeben, nicht verwenden, sollten Sie stattdessen „null“ übergeben. Es wird auch empfohlen, ähnliche Änderungen in Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146) - Fügt
RippleConfigurationundLocalRippleConfigurationhinzu, um die Anpassung von Ripples pro Komponente / Unterbaum mithilfe von festen Werten zu ermöglichen. Das kann beispielsweise sinnvoll sein, wenn Sie die Farbe einer Komponente ändern möchten, die Sie nicht steuern, oder wenn Sie die Wellenbewegung für eine Komponente deaktivieren möchten. In den meisten Fällen sollten die Standardwerte verwendet werden. Diese APIs sind eine Möglichkeit, einzelne Komponenten oder begrenzte Unterbäume anzupassen. Bei größeren Änderungen und benutzerdefinierten Designsystemen sollten Sie stattdessen mitcreateRippleModifierNodeeine eigene Ripple-Animation erstellen. (I7b5d6, b/298048146) - Fügt eine neue Ripple-API in Material 3 hinzu, die die eingestellte
rememberRippleersetzt. Außerdem wird ein temporäresCompositionLocal,LocalUseFallbackRippleImplementationhinzugefügt, um Material 3-Komponenten auf die Verwendung der verworfenen APIsrememberRipple/RippleThemezurückzusetzen. Diese wird in der nächsten stabilen Version entfernt und ist nur als vorübergehende Migrationshilfe für Fälle gedacht, in denen Sie ein benutzerdefiniertesRippleThemeangeben. (I34cbc, b/298048146)
Fehlerkorrekturen
- Die Unterkomposition in
ModalBottomSheetwurde entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei demModalBottomSheetin bestimmten Szenarien in Kombination mitLookaheadScopeabstürzen konnte. (I2a198) - Die Unterkomposition in
BottomSheetScaffoldwurde entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei demBottomSheetScaffoldin bestimmten Szenarien in Kombination mitLookaheadScopeabstürzte. (Ie6401) - Die Ausrichtung des Logos wurde angepasst, sodass es sich näher an der Mitte des Ankerinhalts befindet, bezogen auf die obere rechte Ecke. (I18a28)
- Es wurde ein Problem mit der Barrierefreiheit bei der
DateRangePickerbehoben, bei dem der Texttitel „Monat – Jahr“ für Nutzer von Screenreadern, Switch Access und Voice Access als interaktiv dargestellt wurde. (I2ac55) - Der Fehler bei der Parameterreihenfolge
mediumTopAppBarColorswurde behoben. (Ibe64a)
Version 1.2
Version 1.2.1
6. März 2024
androidx.compose.material3:material3-*:1.2.1 ist veröffentlicht. Version 1.2.1 enthält diese Commits.
Fehlerkorrekturen
- Sorgen Sie dafür, dass die Schieberegler wieder stabil sind.
State.onValueChangeFinishedwird wieder zu einem Wert.onValueChangeFinishedin einerememberUpdatedStateeinfügen. (Ie8fd0, b/322269951) @Stablewird aus den Status vonSliderentfernt, dastate.onValueChangeFinishedin einvargeändert wird. (I82ba1, b/322269951)NavigationBarFehler bei benutzerdefinierten Farben beheben, die aus Standardfarben kopiert wurden (80a779, b/326894020)- Regression in
ExposedDropdownMenubehoben, damit das Element wieder fokussierbar ist (3fcec1, b/323694447) - Problem mit dem Caching der Schaltflächenfarbe behoben (3e5bbcb/327371655)
Version 1.2.0
7. Februar 2024
androidx.compose.material3:material3-*:1.2.0 ist veröffentlicht. Version 1.2.0 enthält diese Commits.
Bekanntes Problem
- In
PrimaryTabRowwurde im Rahmen einer Leistungsverbesserung ein Fehler beim Rendern der View-Compose-Interop eingeführt. Verwenden Sie als ProblemumgehungTabRowmitTabRowDefaults.PrimaryIndicator.
Wichtige Änderungen seit Version 1.1.0
Neue Material Design 3-Komponenten
- Zum Aktualisieren nach unten ziehen
- Segmented Button
Verbesserungen an vorhandenen Material Design 3-Komponenten
- Untere App-Leiste (RTL-Ausrichtung, automatisches Ausblenden beim Scrollen)
- Visuelle Aktualisierung der Tabs
- Logo (Ausrichtung aktualisiert)
Experimentelle APIs wurden zu stabilen APIs hochgestuft.
Leistungsverbesserungen
- Weitere Informationen finden Sie in diesem Blogpost.
Version 1.2.0-rc01
24. Januar 2024
androidx.compose.material3:material3-*:1.2.0-rc01 ist veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Der Fehler bei der Parameterreihenfolge
mediumTopAppBarColorswurde behoben. (Ibe64a) - Ein Fehler wurde behoben, der in
1.2.0-beta02inCardDefaults.cardColorseingeführt wurde und bei demcontentColornicht auf Grundlage des ParameterwertscontainerColoraktualisiert wurde. (Iee041, b/319671246) - Ein Fehler in
disabledContentColor, der in1.2.0-beta02eingeführt wurde, wurde behoben und es wurde eine kleine Optimierung hinzugefügt. (I6dda1, b/318428829)
Version 1.2.0-beta02
10. Januar 2024
androidx.compose.material3:material3-*:1.2.0-beta02 ist veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.
Bekannter Fehler
- Aufgrund eines Fehlers in
IconButtonColorswird standardmäßigdisabledContentColorfür einen Alpha-Wert (0,38f) vonLocalContentColoranstelle des vom Nutzer angegebenencontentColorzugewiesen. Das Problem lässt sich dadurch umgehen, dass SiedisabledContentColorexplizit festlegen. Dieses Problem wird mit dem nächsten Release behoben.
API-Änderungen
- Es wurde die Möglichkeit hinzugefügt, Tooltip-Caret-Symbole für Plain
TooltipAPIs zu aktivieren. (Ibf767) SwipeToDismissState,rememberSwipeToDismissundSwipeToDismissValuewurden alle umbenannt und haben jetzt_SwipeToDismissBox_. (I68d6d)
Fehlerkorrekturen
- Der Wert für den
ListItemEndabstand wurde korrigiert, um der Spezifikation zu entsprechen. (Ibd68b, b/305342674) - Die Umrissfarbe für die Karte mit Umriss wird jetzt korrekt
OutlineVariantzugeordnet. (I75480, b/310979715) - Die dynamische Farbe wird jetzt aus systemdefinierten Farbrollen abgerufen. Dadurch wird der Kontrast für barrierefreie Inhalte verbessert und die dynamische Farbe wird besser an die Material-Spezifikation angepasst. (I1de96)
- Die Verarbeitung von
ModalBottomSheetwurde auf Android T/13+ behoben, wennandroid:enableOnBackInvokedCallback="true". (I728dc, b/306196110)
Version 1.2.0-beta01
13. Dezember 2023
androidx.compose.material3:material3-*:1.2.0-beta01 ist veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.
API-Änderungen
TabIndicatorScopeals experimentell markieren (I45c88)- Verworfene experimentelle APIs für Tooltips werden entfernt. (I438cb)
- Ändern Sie neue
TabRow-Überladungen so, dass keine untergeordneten Kompositionen verwendet werden. Das führt zu einer anderen Art, dieTabRow-Indikatoren mit benutzerdefinierten Modifikatoren zu erstellen. (Ife741) - Die APIs
DismissDirectionundDismissValuewerden eingestellt. Diese wurden inSwipeToDismissValuezusammengeführt. Die Werte geben sowohl die Position als auch die Richtung vonSwipeToDismissBoxan.DismissState.progressist jetzt alsFloatRangezwischen0.0und1.0markiert. Die eingestellten Saver- und Constructor-KlassenDismissStatewurden entfernt. Die KomponenteSwipeToDismiss, das Status- und das Standardobjekt wurden als experimentell gekennzeichnet. (Ib54f2)
Fehlerkorrekturen
- Die Standardanzeige für
PullToRefreshist jetzt eine offene Pfeilspitze anstelle eines ausgefüllten Dreiecks. (I67be3)
Version 1.2.0-alpha12
29. November 2023
androidx.compose.material3:material3-*:1.2.0-alpha12 ist veröffentlicht. Version 1.2.0-alpha12 enthält diese Commits.
API-Änderungen
- Für
RangeSliderwird jetzt ein Kotlin-Bereich (z.B.0f..1f) anstelle einer benutzerdefiniertenFloatRange-Wertklasse verwendet.SnapFlingBehavior.ktverwendet jetzt auch einen Kotlin-Bereich. (I025cb) - Markieren Sie Modifier-Factory-Funktionen als
@Stable. (Ib109f)
Version 1.2.0-alpha11
15. November 2023
androidx.compose.material3:material3-*:1.2.0-alpha11 ist veröffentlicht. Version 1.2.0-alpha11 enthält diese Commits.
Neue Funktionen
- Implementiert
PullToRefreshContainerundPullToRefreshState, die zusammen eine Pull-to-Refresh-Implementierung in Material 3 ermöglichen. (I16456, b/261760718)
API-Änderungen
- Markieren Sie
SwipeToDismissBox,DismissDirectionundDismissValueals experimentell. (I517b0) - Benenne
SwipeToDismissinSwipeToDismissBoxum. Benennen SiebackgroundinbackgroundContentunddismissContentin das nachgestelltecontent-Lambda um. (I7f4d3) - Machen Sie den Konstruktor für
ChipElevationundSelectableChipElevationöffentlich. (Ie0c48, b/308432421) ModalBottomSheetPropertieswird hinzugefügt.securePolicywird inModalBottomSheetPropertiesverschoben.isFocusableundshouldDismissOnBackPresswerden zuModalBottomSheetPropertieshinzugefügt. Mit diesen neuen booleschen Werten lässt sich festlegen, wie modale Ansichten am unteren Rand IME-Ereignisse verarbeiten sollen. (Iea56f, b/278216859)- Die Status
RangeSliderundSliderwurden aktualisiert, uminitialOnValueChange, die ursprünglichen Präfixe und die entsprechenden K-Dokumente zu entfernen. (I57d30) - Die Klasse
ChipBorderund die zugehörigen Funktionsaufrufe werden eingestellt. Wir empfehlen, stattdessen direktBorderStrokezu verwenden. (I89cc2) - Die Foundation Tooltip APIs sind jetzt
@ExperimentalFoundationApi. (I30b0b) TabRowundScrollableTabRowsind nicht mehr veraltet. Die neuen primären und sekundären Varianten sind als experimentell gekennzeichnet. (I0def6)- Filter- und Eingabe-Chips verwenden jetzt direkt
BorderStroke. (I07a8d) SegmentedButtonverwendet jetztBorderStrokedirekt. (I89b9b)- Die generische Funktion
AlertDialogwurde inBasicAlertDialogumbenannt und die vorherige Funktion wurde eingestellt. (Idbe52) - Benennen Sie die
SwipeToDismiss-APIs inSwipeDismissum und stufen Sie die neuenSwipeDismiss-APIs auf „stabil“ hoch. (I14cbe) tonalElevationundshadowElevationwerden zu Tooltip-APIs hinzugefügt. Außerdem werden die APIsTooltipBox,PlainTooltipundRichTooltipwieder als experimentell eingestuft, da sie versehentlich als stabil veröffentlicht wurden. (If0f66, b/293939035)- Experimentelle Chip-APIs werden in die stabile Version überführt. (Iea2c3)
- Die Annotation „
@ExperimentalMaterial3Api“ wurde aus den klickbaren Material3-Karten entfernt. (I88dbf)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem
SwipeToDismissin 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 ist veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.
API-Änderungen
BadgeundBadgedBoxwerden als stabil eingestuft. (I67f16, b/261565132)securePolicyals Parameter fürModalBottomSheethinzufügen, damit Nutzer das Verhalten fürWindowManager.LayoutParams.FLAG_SECUREdefinieren können. (Icdac8, b/296250262)- Es wurden neue Überladungen von
LinearProgressIndicatorundCircularProgressIndicatorhinzugefügt, dieprogressals Lambda verwenden. Diese sollten leistungsfähiger als die vorherigen Versionen sein. (I824e6, b/295616656) - Benennt
StandardSizeClassesinAllSizeClassesum. (I8cb07) - Berechnungsfunktionen von Fenstergrößenklassen kombinieren (Iad935)
Fehlerkorrekturen
- Ein
DatePicker-Absturz wurde behoben, der auftrat, wenn schnell auf die Navigationspfeile geklickt wurde und der angezeigte Monat am Rand des zulässigen Jahresbereichs lag. (I46f36, b/290954897, b/297002119) - [Navigationsleiste] Unterstützung für transparente Farbe für Indikator. (Ie0a9b, b/267289987)
Version 1.2.0-alpha09
4. Oktober 2023
androidx.compose.material3:material3-*:1.2.0-alpha09 ist veröffentlicht. Version 1.2.0-alpha09 enthält diese Commits.
API-Änderungen
ModalNavigationDrawerundDismissibleNavigationDrawerwurden migriert, um die neuenAnchoredDraggable-APIs zu verwenden. DieanimateTovonDrawerStatewurde durch die Methoden „open“ und „close“ ersetzt. Der Offset wird jetzt als Gleitkommazahl anstelle eines Statusobjekts bereitgestellt. Sie können direkt übercurrentOffsetauf den Offset zugreifen. (I0a72c)- Es wurden nicht zusammensetzbare Funktionen zum direkten Erstellen von
DatePickerStateundDateRangePickerStatehinzugefügt. Diese Funktionen können bei Bedarf als Alternative zu den zusammensetzbaren FunktionenrememberDatePickerStateundrememberDateRangePickerStateverwendet werden. (I70326, b/291524052) - Für die
TabRows-Varianten „Fest“ und „Scrollbar“ gibt es jetzt primäre und sekundäre Varianten. Sie entsprechen der in Material3 definierten Farbe und dem Indikatorverhalten. PrimaryScrollableTabRowundSecondaryScrollableTabRowgeben jetzt den Scrollstatus aus. (Iec8f5, b/260572337)- Es wurde ein neuer
sheetMaxWidth-Parameter hinzugefügt, mit dem Entwickler eine maximale Breite für das Blatt festlegen können. Dp.Unspecified kann für den Parameter übergeben werden, wenn ein Sheet gewünscht wird, das die gesamte Bildschirmbreite einnimmt. (Ifb7c9, b/266697696) - Die APIs
PlainTooltipBoxundRichTooltipBoxwerden als eingestellte Methoden wieder hinzugefügt. (I246fa)
Fehlerkorrekturen
- Ein Absturz wird behoben, wenn
DatePickermit einemDatePickerFormatterinitialisiert wird, das bestimmte Datums-Skelette enthält, die bei der Konvertierung in Datumsmuster (z. B. YY) gleich bleiben. (I01f29)
Version 1.2.0-alpha08
20. September 2023
androidx.compose.material3:material3-*:1.2.0-alpha08 ist veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.
Funktionsgefährdende Verhaltensänderung
ColorSchemeist jetzt unveränderlich. Das macht einzelne Farbaktualisierungen weniger effizient, aber die häufigere Verwendung von Farben effizienter. Der Grund für diese Änderung ist, dass das Aktualisieren einzelner Farben für die meisten Apps kein Hauptanwendungsfall ist. Das ist weiterhin möglich, aber es wird häufiger neu zusammengesetzt als zuvor. Dadurch wird die Anzahl der Statusabos im gesamten Material-Code deutlich reduziert, was sich auf die Initialisierungs- und Laufzeitkosten von Standardanwendungsfällen auswirkt. (Ic447d, b/297212873)- Die tonale Erhebung wird in verschiedenen Interaktionsstatus nicht mehr animiert, um der Spezifikation zu entsprechen. (Icdd12)
API-Änderungen
- Es wurde eine neue
BottomAppBarhinzugefügt, die eineBottomAppBarScrollBehaviorals Parameter verwendet, um sie automatisch auszublenden, wenn Inhalte gescrollt werden. Außerdem wurdeFabPosition.EndOverlayhinzugefügt, damit das FAB die untere App-Leiste im Scaffold überlagern kann, anstatt darüber verankert zu werden. (Iecb47) - Es wurde eine einfache Label-Komponente hinzugefügt, die auf
BasicTooltipBoxbasiert und nicht geschlossen wird, wenn außerhalb der Grenzen des Labels getippt wird. (I821f9)
Fehlerkorrekturen
- Die Verwendung von
rememberSaveablefür Kurzinfos wurde entfernt. (Icc131, b/299500338) - Es wurde ein temporäres Flag eingeführt, mit dem gesteuert werden kann, ob das Scaffold-Element seine untergeordneten Elemente während der Messung oder während der Platzierung messen soll. Standardmäßig wird dies in der Analyse gemessen. Wenn Sie Probleme mit dem neuen Verhalten haben, melden Sie bitte ein Problem. (I0b354)
- Das horizontale Edge-to-Edge-Layout in
BottomSheetwurde korrigiert, indem die richtige Messung für die Bildschirmbreite des Geräts verwendet wurde. (I1df0c, b/299058752) - Ein Fehler wurde behoben, bei dem
ModalBottomSheetnichtonDismissedRequestaufgerufen hat, wenn es durch Wischen nach unten auf dem Sheet geschlossen wurde. (Idfdd8)
Version 1.2.0-alpha07
6. September 2023
androidx.compose.material3:material3-*:1.2.0-alpha07 ist veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.
Neue Funktionen
- In
compose material 1.6.0-alpha05wurde Unterstützung für das automatische Spiegeln von Symbolen hinzugefügt. Weitere Informationen finden Sie in den Versionshinweisen.
API-Änderungen
SliderStateimplementiertDraggableState(I9b116)- „shape“ als erforderlichen Parameter festlegen Benennen Sie
positionin der Form-Hilfsfunktion inindexum. (I34941) - Aktualisiert die
DatePickerformatWithSkeleton, sodass sie eine Karte enthält, die als Cache zur Leistungssteigerung verwendet wird. (I3195f) BasicTooltipBoxwurde zucompose.foundationhinzugefügt undPlainTooltipBoxundRichTooltipBoxwurden aktualisiert, umTooltipBoxmit den neuen ComposablesPlainTooltipundRichTooltipzu verwenden. (I79e1d)
Fehlerkorrekturen
dynamicLightColorSchemeunddynamicDarkColorSchemegeben jetzt Farben mit höherer Chroma für die Rollen „surface“ undsurfaceContainerzurück. (I5e901)- Ein Problem wurde behoben, bei dem einige Komponenten, die die Unterkomposition (z.B.
BottomSheetScaffold) innerhalb eines Scaffold innerhalb einesLookaheadScopeverwenden, 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 ist veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Die Berechnung von
DropdownMenuoffsetwurde korrigiert, sodass x-Offsets nur von der lokalen Layoutrichtung abhängen und y-Offsets nicht mehr umgekehrt werden, wenn sich das Menü unten auf dem Bildschirm befindet. (Iccc74, b/294103942) - Die Berechnung von
DropdownMenuoffsetwurde korrigiert, sodass x-Offsets nur von der lokalen Layoutrichtung abhängen und y-Offsets nicht mehr umgekehrt werden, wenn sich das Menü unten auf dem Bildschirm befindet. (Ib87a2, b/294103942)
Version 1.2.0-alpha05
9. August 2023
androidx.compose.material3:material3-*:1.2.0-alpha05 ist veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.
API-Änderungen
- Aktualisierungen der Farben für das Kästchen und
TriStateCheckbox. DieCheckboxDefaults.colors()disabledUncheckedColorwirkt sich jetzt nur noch auf den Rahmen des Kästchens aus. In Sonderfällen, in denen Sie die interne Kästchenfarbe festlegen müssen, wenn das Kästchen deaktiviert und nicht angeklickt ist, ist eine benutzerdefinierte Instanz vonCheckboxColorsmit den gewünschten Farbwerten erforderlich. (I77d17, b/291943198)
Version 1.2.0-alpha04
26. Juli 2023
androidx.compose.material3:material3-*:1.2.0-alpha04 ist veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.
Neue Funktionen
- Experimentelle Segmented Button API (Ifc8fb)
- Trennlinien haben jetzt einen Parameter, mit dem die Ausrichtung gesteuert werden kann, um vertikale Trennlinien zu unterstützen. (I4c899, b/288438593)
API-Änderungen
- Die Dichteabhängigkeit wird auf die Komponentenebene verschoben. Dies gilt für die folgenden Komponenten:
SwipeToDismissund blattbasierte Komponenten. Verwenden Sie stattdessen die neue Überladung, bei der die Dichte ein Parameter ist. (I1846e) - Zusätzliche Annotationen zur Angabe zulässiger Eingaben für Composables (Ief234)
- Fügen Sie einen Symbolparameter für segmentierte Schaltflächen hinzu, teilen Sie die Semantik auf, damit segmentierte Schaltflächen für die Einzelauswahl auswählbar und für die Mehrfachauswahl umschaltbar sind, mit
SelectableSegmentedButtonRowbzw.ToggelableSegmentedButtonRow. (I38740) - Die Trennlinie wurde in
HorizontalDividerumbenannt.VerticalDivider-Funktion hinzugefügt. (I5975c) - Die Verwendung von
ClosedFloatingPointRangewurde in experimentellen Material3-APIs durch das schlankereFloatRangeersetzt, um das automatische Boxing zu minimieren. (I4aab5) - Neue Startausrichtung für
FabPositionhinzugefügt (Ib7aea, b/170592777)
Fehlerkorrekturen
ModalBottomSheetberücksichtigt die lokale Layoutrichtung. (Ib4f44, b/285628622)
Version 1.2.0-alpha03
21. Juni 2023
androidx.compose.material3:material3-*:1.2.0-alpha03 ist veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.
Geändertes Verhalten
includeFontPaddingist jetzt standardmäßigfalsein der Material 3-Typografie. Der Standardstil für die Zeilenhöhe wurde ebenfalls inTrim.NoneundAlignment.Centergeändert und denTextStyles vonTypographywurden explizitelineHeight(in sp) hinzugefügt. Wenn Sie diese Werte anpassen möchten, sehen Sie in der API-Dokumentation nach. Eine ausführliche Erläuterung dieser Änderungen finden Sie im Blogpost. (I6266f, Icabc3)
Neue Funktionen
- Es wurde eine Überladung für
RangeSliderhinzugefügt, die eine zustandsbehaftete Version der Komponente ist.RangeSliderStatewurde erstellt und enthält alle Informationen für den aktuell aktiven Track, die Messungen der Komponenten vonRangeSlidersowie die Drag-and-Gesture-Logik. (I8c270) - Die Suchleiste unterstützt jetzt Schatten über den neu hinzugefügten Parameter
shadowElevation. (Ia5369, b/271040353) ColorSchemeunterstützt jetzt neueSurfaceContainer-Rollen.- Das Overlay für die tonale Erhebung der Oberfläche kann jetzt mit der lokalen Komposition
LocalTonalElevationEnableddeaktiviert werden. (Ic203c, b/277774590)
API-Änderungen
- Öffnen Sie die Konstruktoren für Komponentenfarben. (I8c4a6)
- Der Parameter „focusable“ wurde beiden Tooltip-APIs hinzugefügt, damit Entwickler festlegen können, ob das Tooltip Touch-Ereignisse verarbeiten soll oder nicht. Achten Sie darauf, dass dadurch die automatische Bewegung des Fokus für die Barrierefreiheit unterbrochen werden kann. (Ie32d8)
- Optimierte Barrierefreiheit für Leistung und Arbeitsspeicherzuweisungen. (Iede48)
DefaultSizeClassesfreigeben undStandardSizeClassesfürWindowSizeClasseserstellen (I91838)- Ändern Sie
WindowWidth/HeightSizeClassin Gleitkommawertklassen (Ie686e).
Fehlerkorrekturen
- Der
contentWindowInsets-Parameter von Scaffold berücksichtigt jetzt verbrauchte Fenstereinsätze. Das Verhalten des Content-Paddings basierend auftopBarundbottomBarbleibt unverändert, wenn diese Parameter angegeben werden. (I08b73, b/264601542) - Richten Sie die obere App-Leiste in der Mitte aus, damit ein langer Titel nicht über den Aktionssymbolen oder dem Navigationssymbol gerendert wird. (I4369f, b/236994621)
- Für Tab-Positionen wird jetzt eine Mindestbreite von 24 dp für den Inhalt erzwungen. Dadurch wird ein barrierefreier Berührungszielbereich für Tab-Indikatoren bereitgestellt. (Id8861)
- Dynamische Farbpaletten von
dynamicLightColorSchemeunddynamicDarkColorSchemeunterstützen jetzt neue Oberflächenrollen. (I1252e) - Die Ausrichtung der Benachrichtigungssymbole wurde so aktualisiert, dass sie nicht abgeschnitten werden, wenn sie mit dem übergeordneten Element kollidieren. (Idf75a)
Version 1.2.0-alpha02
24. Mai 2023
androidx.compose.material3:material3-*:1.2.0-alpha02 ist veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
API-Änderungen
- Fügen Sie den Parameter „window insets“ zu
ModalBottomSheethinzu.- Der Scrim für
ModalBottomSheetkann jetzt hinter der Statusleiste gezeichnet werden, wennwindowInsetsauf null gesetzt ist. - Die Standardfunktionalität von
ModalBottomSheetwurde aktualisiert, sodass sie nicht in Systemleisten wie der Navigationsleiste angezeigt wird. - Die Verarbeitung von Insets der Statusleiste erfolgt im Edge-to-Edge-Modus über den Ziehpunkt.
BottomSheetDefaultsenthält Fenstereinsätze fürBottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- Der Scrim für
Indicatorwird eingestellt undPrimary/SecondaryIndicatorwird hinzugefügt, um den M3-Spezifikationen zu entsprechen.PrimaryIndicatorentspricht der Breite des Tab-Inhalts, währendSecondaryIndicatordie gesamte verfügbare Breite einnimmt.SecondaryIndicatorentspricht dem jetzt eingestelltenIndicatorund kann direkt als Ersatz verwendet werden. (I27604)- Es wurde eine Option zum Übergeben eines
ScrollStatebeim Erstellen einesDropdownMenuoder einesExposedDropdownMenuhinzugefügt, um den vertikalen Scrollstatus der angezeigten Menüelemente zu steuern. (Ia0734, b/185304441) - Es wurde eine Überladung für
Sliderhinzugefügt, die eine zustandsbehaftete Version der Komponente ist.SliderStatewurde erstellt und enthält alle Informationen für den aktuell aktiven Track, die Messungen der Komponenten vonSlidersowie die Drag-and-Gesture-Logik. (I124a5) - Umbenennung des Attributs „Semantik“
isContainerinisTraversalGroup(I121f6) - Optimierte
TextStyle.merge(...)mit vollständiger Parameterliste hinzugefügt. (Iad234, b/246961787) TooltipState,RichTooltipStateundPlainTooltipStatesind jetzt öffentliche Schnittstellen.RichTooltipStateImplundPlainTooltipStateImplfür Standardstatus hinzugefügt.remember*State-Funktionen zum Abrufen dieser implementierten Status hinzugefügt.TooltipSyncwurde zugunsten vonTooltipDefault.GlobalMutatorMutexentfernt. (I7813d)- Die
DatePickerColorswurde aktualisiert und enthält jetzt zusätzliche Anpassungsoptionen für die Farben der Trennlinie, der Navigation und der Texteingabefelder der Datumsauswahl. (I1a685, b/274626815) DatePickerStateundDateRangePickerStatesind jetzt öffentliche Schnittstellen mit Standardimplementierungen, die überrememberDatePickerStateundrememberDateRangePickerStateabgerufen werden können. (I71c52)- Die
dateValidatorwurde ausDatePickerundDateRangePickerentfernt und eineSelectableDates-Schnittstelle eingeführt, die im Status festgelegt werden kann, um zu steuern, welche Datumsangaben oder Jahre in der Benutzeroberfläche ausgewählt werden können. (Ic2fc6) TimePickeraus stabiler API entfernt, weitere Änderungen an der Status-API werden erwartet (I3f39a)ModalBottomSheetwurde nur auf Android verschoben.ModalBottomSheetwird für die Verwendung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv weiterentwickelt. (Ib3778)
Fehlerkorrekturen
- Die
AlertDialog-Schaltfläche wird jetzt unter der Schaltfläche zum Bestätigen angezeigt, wenn die Schaltflächen übereinander angeordnet sind, um in die Breite des Dialogfelds zu passen. Mit dieser Korrektur wird die Implementierung an die Material Design-Spezifikation angepasst. (I029de, b/235454277) - Ein Fehler in
ListItemwurde behoben, bei dem für dreizeilige Elemente ein falscher Innenabstand verwendet wurde. (I6e235) ModalBottomSheetkann jetzt die IME-Tastatur anzeigen (Idc508, b/262140644, b/268380384, b/272483584)
Version 1.2.0-alpha01
10. Mai 2023
androidx.compose.material3:material3:1.2.0-alpha01 und androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 sind 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 sind veröffentlicht. Version 1.1.2 enthält diese Commits.
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem ein Modifikator fälschlicherweise an zwei Composables übergeben wurde. (b/282761472)
- Der Wert von
TimePickerStategibt bei der Initialisierung mit 23 Stunden falsche Stunden zurück. (b/278242122) - Der anfängliche Ein/Aus-Status für die Validierung von Mittag und Minute wurde korrigiert. (b/269768197, b/282790635)
- Der Fehler wurde behoben, bei dem für
state.hourum 23:00 Uhr ein falscher Wert zurückgegeben wurde. (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 sind veröffentlicht. Version 1.1.1 enthält diese Commits.
Fehlerkorrekturen
- Fügt einen Aufruf für
ModalBottomSheetohne den ParameterwindowInsetfür die binäre Kompatibilität hinzu. (Ib7959) - Fügen Sie den Parameter „window insets“ zu
ModalBottomSheethinzu.- Der Scrim für
ModalBottomSheetkann jetzt hinter der Statusleiste gezeichnet werden, wennwindowInsetsauf null gesetzt ist. - Die Standardfunktionalität von
ModalBottomSheetwurde aktualisiert, sodass sie nicht in Systemleisten wie der Navigationsleiste angezeigt wird. - Die Verarbeitung von Insets der Statusleiste erfolgt im Edge-to-Edge-Modus über den Ziehpunkt.
BottomSheetDefaultsenthält Fenstereinsätze fürBottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- Der Scrim für
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 sind veröffentlicht. Version 1.1.0 enthält diese Commits.
Wichtige Funktionen von Version 1.1.0
Neue Material Design 3-Komponenten
Verbesserungen an vorhandenen Material Design 3-Komponenten
Experimentelle APIs wurden zu stabilen APIs hochgestuft.
Weitere Informationen finden Sie in diesem Blogpost.
Version 1.1.0-rc01
19. April 2023
androidx.compose.material3:material3:1.1.0-rc01 und androidx.compose.material3:material3-window-size-class:1.1.0-rc01 sind veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.
API-Änderungen
TimePickeraus stabiler API entfernt, weitere Änderungen an der Status-API werden erwartet (I3f39a)ModalBottomSheetwurde nur auf Android verschoben.ModalBottomSheetwird für die Verwendung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv weiterentwickelt. (Ib3778)
Version 1.1.0-beta02
5. April 2023
androidx.compose.material3:material3:1.1.0-beta02 und androidx.compose.material3:material3-window-size-class:1.1.0-beta02 sind veröffentlicht. Version 1.1.0-beta02 enthält diese Commits.
API-Änderungen
SheetStatehat jetzt einen optionalen ParameterskipHiddenStaterememberStandardBottomSheetStatehat jetzt einen optionalen ParameterskipHiddenStateBottomSheetScaffoldhat jetzt einen definierten ausgeblendeten Anker, der jedoch standardmäßig deaktiviert ist.- Die Dokumentation für
SheetState.requireOffsetwurde aktualisiert. BottomSheetDefaults.MinimizedShapewurde inBottomSheetDefaults.HiddenShapeumbenannt (I839f4, b/273870234).
Fehlerkorrekturen
- Wenn die Touch-Bedienung aktiviert ist, darf das Zifferblatt nicht von Stunde auf Minute umgeschaltet werden. (I717d0)
- Die Semantik für das Ziehen von
ModalBottomSheetundBottomSheetScaffoldwurde zusammengeführt. (I05afb) - Der
BottomSheetScaffold-Modifikator sowie die ParametercontainerColorundcontentColorwirken sich jetzt nur noch auf Inhalte aus. (I992cb) BottomSheetScaffold nestedScrollfür Tabellenblattinhalte unterstützt jetzt Wischbewegungen. (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 sind veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.
API-Änderungen
- Füge dem zusammensetzbaren Element
TimePickerden Layouttypparameter hinzu. Je nach Bildschirmkonfiguration können verschiedene Layouts verwendet werden (Ia0e16). SearchBarDefaultswurde als experimentell markiert. (I65561)- Schattenhöhe zu
BottomSheetScaffoldhinzugefügt (I94e0f) - Unterstützung für die Anzeige der Datumsauswahl ohne Kopfzeile hinzugefügt API-Änderungen, um beim Erstellen einer Datumsauswahl eine Null-Überschrift zu übergeben. Sie können jetzt „null“ für „headline“, „title“ und
showToggleMode = falseübergeben, um eine Headless-Auswahl zu präsentieren. (Id3f3a, b/266132421, b/267194809)
Fehlerkorrekturen
- Suchleisten verlieren jetzt automatisch den Fokus, wenn sie inaktiv werden. (I22a7c, b/261444487)
- Die
DateRangePickerwurde aktualisiert, sodass ein Zeitraum mit demselben Start- und Enddatum ausgewählt werden kann. (I16529, b/272882497) - Textfelder positionieren ihre Textelemente jetzt richtig, wenn die Schriftgröße kleiner als erwartet ist. Je nach Schriftarteinstellungen und Skript kann sich dies auf einige Pixel in Ihren Apps auswirken. (I8b8d0)
- Semantische Aktionen in der Ansicht am unteren Rand haben jetzt Labels. (I277b0)
Version 1.1.0-alpha08
8. März 2023
androidx.compose.material3:material3:1.1.0-alpha08 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 sind veröffentlicht. Version 1.1.0-alpha08 enthält diese Commits.
Neue Funktionen
- Unterstützung für
BottomSheetScaffoldundBottomSheetScaffoldStatehinzugefügt. (I063d4)
API-Änderungen
- Der
DatePickerStateund derDateRangePickerStatewurden Funktionen hinzugefügt, mit denen sich Datumsangaben nach der Erstellung des Status festlegen und Auswahlen durch Festlegen von Null-Zeitstempeln zurücksetzen lassen. Das manuelle Festlegen von Datumsangaben sollte mit Vorsicht erfolgen. Die neue FunktionsetSelectionlöst eine Ausnahme aus, wenn ein angegebenes Datum eine Vorbedingung nicht erfüllt (siehe Dokumentation). (Ifa645, b/268609314, b/270427389) - Die Bezeichnung „Collapsed
SheetValue“ wurde in „PartiallyExpanded“ umbenannt, um das Verhalten in diesem Status genauer und flexibler darzustellen. (Ia1491) - Die Namen der
ListItem-Parameter wurden von „_text“ in „_content“ geändert. Standard-Getter sind jetztReadOnlyComposables, sofern relevant. (I69a25) - Interaktive Surface-APIs aus der experimentellen Phase herausnehmen. (I90d59, b/261561812)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem der
HalfExpanded-Status vonModalBottomSheetfalsch berechnet wurde und das Blatt schwebend angezeigt wurde. (I45e84, b/268411386) - Füge die
confirmValueChange-Prüfung für das Tippen auf den Scrim fürModalBottomSheethinzu. (I2311a, b/270425759) - Semantische
BottomSheet-Aktionen werden zum Ziehpunkt verschoben. (I158ba) ModalBottomSheetkonzentriert sich jetzt auf den Start und verarbeitet den Button „Zurück“. (I4d2ab)ModalBottomSheet onDismissRequestwird jetzt auch bei verschachtelten Scroll-Fling-Gesten berücksichtigt. (I655c5, b/268433166)
Version 1.1.0-alpha07
22. Februar 2023
androidx.compose.material3:material3:1.1.0-alpha07 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 sind veröffentlicht. Version 1.1.0-alpha07 enthält diese Commits.
Neue Funktionen
- Fügen Sie eine zusammensetzbare Zeit-Eingabe hinzu, die mit
rememberTimePickerState()funktioniert. Sie entspricht der M3-Spezifikation für die Zeiteingabe (Ia4fab). - Es wurde eine Material 3-
DateRangePicker-API zum Auswählen eines Zeitraums hinzugefügt. (I7a6c3, b/267194809) - Unterstützung für die Auswahl von Zeiträumen über die
DateRangePickerAPI im Material 3-Eingabemodus wurde hinzugefügt. (Ifdbc4) - Die Farben von Textfeldern lassen sich jetzt anpassen:
- Die Farben des Eingabefelds und des Platzhaltertexts basierend auf dem Fokus und dem Fehlerstatus. Der Parameter
textColorwurde inunfocusedTextColorumbenannt undplaceholderColorinunfocusedPlaceholderColor. - Die Containerfarbe für ausgefüllte Textfelder basierend auf dem Fehlerstatus mit dem neuen
errorContainerColor-Parameter.
- Die Farben des Eingabefelds und des Platzhaltertexts basierend auf dem Fokus und dem Fehlerstatus. Der Parameter
- Die Farben der Textfelder für Drop-down-Menüs wurden mit Parametern aktualisiert, um die neue API für Präfixe und Suffixe zu unterstützen. (I9c8b4, b/254284181, b/264766350)
API-Änderungen
- Einige Slider API-Versionen werden zurückgesetzt und redundante Slider-Überladungen werden entfernt, die durch den neuen experimentellen Slider mit benutzerdefiniertem Thumb und Track abgedeckt werden.
RangeSliderwird als stabil eingestuft. (Ie8fbd) - Die Erhebungsfunktionen des Chips wurden von
defaultElevationinelevationumbenannt. (I0f872) - Die folgenden Material 3-Textfeld-APIs sind nicht mehr experimentell:
TextField,OutlinedTextField,textFieldWithLabelPadding,textFieldWithoutLabelPadding,outlinedTextFieldPadding. (Ieb5c0, b/261561819) TimePickersis24Hourverwendet die Systemeinstellung (I18856)- Die experimentelle Anmerkung wurde aus den Scaffold-APIs entfernt. (Ibb51e, b/261565765, b/261436953)
Fehlerkorrekturen
- Die Standardform für
ModalBottomSheetist jetzt immerSheetDefaults.ExpandedShape. (I0dfca) - Verbesserungen der Bedienungshilfen für Material 3-
DatePickerundDateRangePicker. (I5087e) - Es wurde ein Fehler behoben, durch den die Beschränkung der maximalen Höhe weitergegeben wurde und es zu einem Absturz kommen konnte. (I30d8c)
- Semantische Rollen wurden von klickbaren und auswählbaren Oberflächen entfernt. Komponenten, in denen sie verwendet wurden, wurden aktualisiert, um Rollen mit „modifier.semantics“ festzulegen (I793d9).
Version 1.1.0-alpha06
8. Februar 2023
androidx.compose.material3:material3:1.1.0-alpha06 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 sind veröffentlicht. Version 1.1.0-alpha06 enthält diese Commits.
Neue Funktionen
- Textfelder unterstützen jetzt Präfix- und Suffixtext (Ia8578, b/179884561)
- Die Funktion
TimePickerwurde hinzugefügt, um eine Zeitauswahl gemäß der Material 3-Spezifikation anzuzeigen. Sie wird in Verbindung mitTimePickerStateund der Convenience-MethoderememberTimePickerStateverwendet. (I71910) - Die Datumseingabe ist jetzt ein Anzeigemodus unter
DatePicker. Unterstützung für das Umschalten zwischen der Datumsauswahl und der Datumeingabe hinzugefügt. (Ieeff7) - API für
RichTextTooltipshinzugefügt. (I58ef3) - Implementierung von modalen Ansichten am unteren Rand für Material 3, einschließlich
ModalBottomSheetundModalBottomSheetDefaults. Außerdem werdenSheetStateundrememberSheetStateeingeführt, die für zukünftige Tabellenblattkomponenten verwendet werden können. (I0853a, b/244189383)
API-Änderungen
- API
showSnackbarstabilisieren (I195c2, b/261424370) - APIs für Assist-Chip und Vorschlags-Chip stabilisieren (Ibb67b, b/261424370)
- Die APIs
ListItem,ListItemDefaultsundListItemColorswerden als nicht experimentell eingestuft (I7e7fa, b/261438882). - Die APIs
SliderPositions,SliderDefaults.ThumbundSliderDefaults.Trackwerden in die stabile Version aufgenommen. Außerdem werden die nicht experimentellen APIsSliderundRangeSliderhinzugefügt, die benutzerdefinierte Thumbnails und Tracks enthalten. Die bisherigen APIsSliderundRangeSliderwerden ebenfalls eingestellt. (Ie5ea6, b/261566890) Modifier.tooltipAnchor()wurde öffentlich gemacht, damit Entwickler es an den Anker übergeben können, um anzugeben, dass bei langem Drücken eine Kurzinfo angezeigt werden soll. DiePlainTooltipBoxAPI wurde aktualisiert, sodassTooltipStatenicht mehr auf „null“ gesetzt werden kann und jetzt einen Standardwert hat. (Ie2fb7)ProgressIndicatorDefaults.circularTrackColorwurde aus Gründen der Konsistenz mit@Composablemarkiert. (Id29cc)- Stellen Sie den Property-Getter
LocalMinimuTouchTargetEnforcementwieder her, markieren Sie ihn als eingestellt und leiten Sie ihn zuLocalMinimumInteractiveComponentEnforcementweiter. (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 sind veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.
Neue Funktionen
DatePickerDialogund Unterstützung für Barrierefreiheit- Benutzerdefiniertes Thumbnail und benutzerdefinierte Spur zu
RangeSliderhinzugefügt.
Abhängigkeitsupdates
Compose UIundCompose Materialsind jetzt von Lifecycle 2.6.0 abhängig.
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 sind veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.
Neue Funktionen
- Erste
DatePickerAPI zum Auswählen eines einzelnen Datums über eine Kalender-Benutzeroberfläche. Diese API wird noch geändert. (I722b9) - Unterstützung für einfache Tooltips über
PlainTooltipBoxhinzugefügt. (I0cdfb) - Suchleiste (Iad128)
SwipeToDismiss(I458a8, b/242889540)
API-Änderungen
- Die Semantikeigenschaft
IsContainerwurde auf Surfaces hinzugefügt. Diese Eigenschaft wird bei einer späteren Änderung verwendet, bei der die Reihenfolge der Bewegung basierend auf der semantischen Bedeutung von Elementen wie Oberflächen bestimmt wird. (I63379) - APIs für die Navigationsleiste als stabil markieren. (Iab01e, b/261439597)
- Für kreisförmige Fortschrittsanzeigen wurde ein Parameter für die Spurfarbe und für kreisförmige und lineare Fortschrittsanzeigen ein Parameter für die Strichkappe hinzugefügt. (Ie668c, b/216325962, b/222964817)
- Mehr Null-Zulässigkeit von Rückgabetypen für eingestellte, ausgeblendete Funktionen (Ibf7b0)
- Fügen Sie
Modifier.minimumInteractiveComponentSizehinzu. Damit können Sie mindestens 48 dp für die eindeutige Unterscheidung von Berührungsinteraktionen reservieren, wenn das Element kleiner ist. (I33f58, b/258495559) - Es wurde eine experimentelle API für die zusammensetzbare Funktion
AlertDialogmit einem Inhalts-Slot hinzugefügt. (Iec4a2)
Fehlerkorrekturen
- Der Fortschritt für Fortschrittsanzeigen ist jetzt korrekt auf den erwarteten Bereich begrenzt. (I8a7eb, b/262262727)
Bekanntes Problem
- Beim Aktualisieren von
androidx.compose.foundation:1.4.0-alpha03aufandroidx.compose.foundation:1.4.0-alpha04kann der Fehlerjava.lang.NoSuchFieldErrorauftreten. Hier wurde das Problem ursprünglich gemeldet. Ein Fix wurde eingereicht und ist im nächsten Compose-Update verfügbar. Als Behelfslösung können Sie Ihreandroidx.compose.material- undandroidx.compose.material3-Bibliotheken auf die neueste Version(1.1.0-alpha04) aktualisieren oder ein Downgrade Ihrerandroidx.compose.foundation-Bibliothek auf Version 1.4.0-alpha03 durchführen.
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 sind veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.
API-Änderungen
consumedWindowInsets()wurde inconsumeWindowInsets()undwithConsumedWindowInsets()inonConsumedWindowInsetsChanged()umbenannt. Außerdem wurden die Modifiers öffentlich gemacht. (Ie44e1)- Es wurde ein neuer Standard-Inhaltsabstand für Textschaltflächen mit Symbol hinzugefügt. (I8f662)
- Es wurden deaktivierte Farben für die Navigationsleiste und den Navigationsstreifen hinzugefügt. (Ia7892, b/258867034)
- Eine Modifier API zum Abfragen von Scrollinformationen für übergeordnete Elemente wurde hinzugefügt. (I2ba9d, b/203141462)
- Wird in
Clickableverwendet, um Tippinteraktionen richtig zu verzögern, wenn aus Gesten Scroll-Ereignisse werden könnten. - Der Fehler, dass
ClickablesWellen nicht richtig verzögert hat, wenn es in einemScrollable ViewGroupverwendet wurde, wurde behoben. - Die Funktion „Drawers and Sheets“ wurde aktualisiert, um das Drücken von Tasten richtig zu verzögern, falls aus Gesten Scroll-Ereignisse werden können.
Abhängigkeitsupdates
Compose UIundCompose Materialsind jetzt von Lifecycle 2.5.1 abhängig. (I05ab0, b/258038814)
Version 1.1.0-alpha02
9. November 2022
androidx.compose.material3:material3:1.1.0-alpha02 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 sind veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.
API-Änderungen
awaitFirstDownundwaitForUpOrCancellationakzeptieren jetzt einPointerEventPassfür mehr Flexibilität. Außerdem wird das Problem behoben, dass beiExposedDropdownMenuBoxbeim Scrollen ein Menü angezeigt wurde. (I7579a, b/212091796)- Der Parameter
minLineswurde in die Textkomponenten „material“ und „material3“ sowie inTextFieldundOutlinedTextFieldeingefügt. Damit kann die Mindesthöhe der Komponente in Zeilen angegeben werden (I4af1d). - Die Funktion
TopAppBarDefaults smallTopAppBarColorswird zugunsten einer neuen FunktiontopAppBarColorseingestellt, die beim Erstellen einesTopAppBarverwendet werden sollte. (Ie6cb9) - Der Parameter
minLineswurde denBasicTextundBasicTextFieldhinzugefügt. Damit kann die Mindesthöhe dieser Composables in Zeilen festgelegt werden (I24294, b/122476634).
Fehlerkorrekturen
- Schneiden Sie den Inhalt eines Material3-
IconButtonundIconToggleBottonauf die Form der Status-Ebene der Komponente zu (z.B. kreisförmig). (I9da8f) - Die oberen App-Leisten in Material3-Größe „Mittel“ und „Groß“ wurden aktualisiert, sodass auf der gesamten Oberfläche dieselbe Hintergrundfarbe verwendet wird. Außerdem können die Standardfarben mit transparenten Farbwerten überschrieben werden. (I67659, b/249688556, b/250838918)
Version 1.1.0-alpha01
24. Oktober 2022
androidx.compose.material3:material3:1.1.0-alpha01 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 sind veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Es wurden Fehler in der oberen App-Leiste behoben, wenn der Titel mit einem TextStyle und einem Brush angewendet wird. (If667e)
Version 1.0
Version 1.0.1
9. November 2022
androidx.compose.material3:material3:1.0.1 und androidx.compose.material3:material3-window-size-class:1.0.1 sind veröffentlicht. Version 1.0.1 enthält diese Commits.
Fehlerkorrekturen
- Die oberen App-Leisten in Material3-Größe „Mittel“ und „Groß“ wurden aktualisiert, sodass auf der gesamten Oberfläche dieselbe Hintergrundfarbe verwendet wird. Außerdem können die Standardfarben mit transparenten Farbwerten überschrieben werden. (I67659, b/249688556, b/250838918)
Version 1.0.0
24. Oktober 2022
androidx.compose.material3:material3:1.0.0 und androidx.compose.material3:material3-window-size-class:1.0.0 sind veröffentlicht. Version 1.0.0 enthält diese Commits.
Wichtige Funktionen von Version 1.0.0
Dies ist die erste stabile Version von Compose Material 3.
Material Design 3-Theming und dynamische Material You-Farben
Material Design 3-Komponenten
- Abzeichen
- Untere App-Leiste
- Schaltflächen
- UAS und erweitertes UAS
- Infokarten
- Kästchen
- Chips
- Dialogfelder
- Trennzeichen
- Drop-down-Menü
- Liste
- Navigationsleiste
- Navigationsleiste
- Navigationsleiste
- Fortschrittsanzeige
- Optionsfeld
- Schieberegler
- Wechseln
- Tabs
- Textfelder
- Obere App-Leiste
- Symbol
- Text
- Oberfläche
- Layout
- Inhaltsfarbe
Klasse der Fenstergröße
material3-window-size-classist eine neue Bibliothek, die Unterstützung für Fenstergrößenklassen bietet. Das sind eine Reihe von Ansichtsbereich-Breakpoints, die Ihnen beim Entwerfen, Entwickeln und Testen von Layouts für Anwendungen mit anpassbarer Größe helfen. MitcalculateWindowSizeClasskönnen Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche dargestellt werden soll. Bei größeren Fenstergrößen kann beispielsweise eine Navigationsleiste anstelle der unteren Navigation angezeigt werden. Weitere Informationen und Beispiele finden Sie in der API-Referenzdokumentation fürWindowSizeClass.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 sind veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
API-Änderungen
- Slot-Parameter zur Unterstützung der Text-zu-Textfeld-API hinzugefügt (Iaac0d, b/227146125)
Version 1.0.0-beta03
21. September 2022
androidx.compose.material3:material3:1.0.0-beta03 und androidx.compose.material3:material3-window-size-class:1.0.0-beta03 sind veröffentlicht. Version 1.0.0-beta03 enthält diese Commits.
API-Änderungen
ExposedDropdownMenuDefaultsstellt jetzt einen Auffüllwert für Menüelemente bereit. (I34ee1)ExposedDropdownMenuBoxScopehat jetzt einenModifier.menuAnchor()-Modifier, der für ein korrektes Verhalten in Bezug auf die Barrierefreiheit an das Textfeld übergeben werden sollte. (I27fa3)- Hinzufügen von zwei überladenen Methoden für die aktuelle Slider API, damit Nutzer einen Thumb oder Track übergeben können, um den Slider zu füllen. (I21c00)
Fehlerkorrekturen
- Die Farbzuordnung für das dunkle Design für „On Error Container“ wurde auf den Farbton 90 aktualisiert (Ic5612).
- Es wurde ein Fehler behoben, der das Festlegen eines transparenten Hintergrunds für kleine Material 3-App-Leisten oben verhindert hat. (I645e2, b/245575782)
Version 1.0.0-beta02
7. September 2022
androidx.compose.material3:material3:1.0.0-beta02 und androidx.compose.material3:material3-window-size-class:1.0.0-beta02 sind veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.
API-Änderungen
- Die in M3-Komponenten in Version beta01 eingeführten Standardkomponenteneinzüge berücksichtigen keine IME-Einzüge mehr.
- Die Material3-Scaffold-Komponente hat jetzt einen
contentWindowInsets-Parameter, mit dem Sie die Menge der Insets angeben können, die für den Inhaltsslot verarbeitet werden sollen. (Icf11a, b/243713323) - Die experimentelle Material 3-Funktion
SmallTopAppBarwird eingestellt und eine entsprechendeTopAppBar-Funktion eingeführt. Bitte migrieren Sie Ihre Nutzung auf die neue Version. (I74404, b/226918634) - Fügt die Steuerung des Fling- und Snap-Verhaltens der oberen App-Leiste hinzu. (I15c81)
- Entfernt „startIndent“ aus „Divider“ und verschiebt die Farbe in den letzten Parameter. (If7be2)
Fehlerkorrekturen
- Dialogfelder müssen sich TalkBack-Nutzern gegenüber identifizieren, indem sie das Wort „Dialog“ ausgeben, wenn sie angezeigt werden. (I857ef)
Version 1.0.0-beta01
24. August 2022
androidx.compose.material3:material3:1.0.0-beta01 und androidx.compose.material3:material3-window-size-class:1.0.0-beta01 sind veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
API-Referenz
Die neuesten Theming-, Komponenten- und anderen Composables finden Sie in der Compose Material 3 API-Referenz.
API-Änderungen
- Die obere App-Leiste von Material 3 kann jetzt vollständig minimiert oder maximiert werden. Außerdem wurde die Verhaltensfunktion
TopAppBarDefaultsso aktualisiert, dass sie Composables verwendet und Standardwerte für den Status der oberen App-Leiste und die Animationsspezifikation bereitstellt. (I642b3) - Aktualisierte Signaturen der FAB-Komponente, die der Surface API entsprechen (I3afaa)
- Eingefügte Unterstützung für obere App-Leisten, Drawers, Navigationsleisten und Navigationsstreifen wurde hinzugefügt. Wenn diese Komponenten separat oder mit Scaffold verwendet werden, werden Insets automatisch für Entwickler berücksichtigt. Hinweis: Durch diese Änderung wird die automatische Verarbeitung von Statusleistensymbolen und die Transparenz der Status- und Navigationsleisten nicht hinzugefügt. Bitte machen Sie das weiterhin manuell, um die beste Darstellung zu erzielen. (I7e4e6, b/183161866)
- Die Standardeinstellungen für Komponenten wurden aktualisiert, um die API-Oberfläche für zukünftige Flexibilität und Leistungsverbesserungen zu reduzieren. (I31820)
- Die Parameter für Chip und Navigationsleiste wurden neu angeordnet, um die Konsistenz innerhalb der API zu wahren (I45d0b).
startIndentwurde aus dem Trennzeichen entfernt und die Farbe ist jetzt der letzte Parameter.(If7be2)
Version 1.0.0-alpha16
10. August 2022
androidx.compose.material3:material3:1.0.0-alpha16 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 sind veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.
Neue Funktionen
- Unterstützung für die Angabe einer benutzerdefinierten Breite für eine Navigationsleiste. (Ia7f10)
API-Änderungen
- Tab- und Leading-Icon-Tab-Parameter neu anordnen, um die Konsistenz innerhalb der API zu wahren (Ie2637)
BadgeDefaultsals experimentell markiert. (I98ef3)- Die eingestellte Navigationsleistenfunktion wurde entfernt. (I4f2db)
- Parameter für den Schieberegler in Material 3 neu anordnen, um die Konsistenz innerhalb der API beizubehalten (I0aee7)
- Die Parameter
NavigationBarundNavigationRailwurden neu angeordnet, um die Konsistenz innerhalb der API zu wahren (I51cda). - Parameter in Material 3 neu anordnen, um die Konsistenz in der gesamten API zu wahren (If4ae1)
- Slider-Parameter in Material 3 neu anordnen, um die Konsistenz innerhalb der API zu wahren (I62673)
- Der Parameter „icons“ wurde in „actions“ umbenannt, um ihn an die obere App-Leiste anzupassen (Id75be).
- Markiere
BadgeundBadgedBoxals experimentell, da die Ankerausrichtung noch nicht stabil ist. (I1712e, b/236524516) - Ändern Sie die
@ExperimentalMaterial3Api-Anmerkungen für Symbolschaltflächenvarianten in@OptIn(I070b5). - Der Inhalt des Navigationsbereichs wurde in eine eigene zusammensetzbare Funktion ausgelagert, um eine benutzerdefinierte Breite festlegen zu können. (Ia7f10)
- Entfernt
DividerausMenuDefaultsundTabDefaults(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 sind veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.
Neue Funktionen
- Das Ziehen der oberen App-Leiste über die Leiste selbst zulassen. (I65c00, b/205873416)
API-Änderungen
- Die APIs
FilterChipundElevatedFilterChipwurden aktualisiert, um denselectedIcon-Slot zu entfernen und die Wiederverwendung vonleadingIconfür die Anzeige eines ausgewählten Status zu fördern. (Ie5dc2) - Rollen für die Farbe von Scrim und Umrissvariante hinzufügen. (Id6d54)
- Namenskonventionen für zusammensetzbare Standardeinstellungen korrigieren. (I62b27)
ListItemDefaultsundListItemColorsals experimentell markieren (I1f3ec)- Änderungen an der Top-App-Leisten-API, um die Bedeutung der Statusattribute besser widerzuspiegeln. Kennzeichnen Sie die Top-App-Leisten-API als experimentell. (Ic0ad8)
- Die Farben für die Textauswahl wurden jetzt in
TextFieldColorsaufgenommen, um die Auffindbarkeit zu verbessern. (Iba1b8) ButtonDefault.ButtonWithIconContentPaddingwird für Schaltflächen mit einem Symbol hinzugefügt. (I2bf9c)- Textfelder wurden als experimentell markiert, um mehr Flexibilität bei zukünftigen API-Änderungen zu ermöglichen. (I127b5)
- Die Annotation
@ExperimentalMaterial3Apiwurde aus der FunktionCheckboxentfernt. (I5eefc) - Die Annotation
@ExperimentalMaterial3Apiwurde aus der FunktionRadioButtonentfernt. (I17e2a) - Die Annotation
@ExperimentalMaterial3Apiwurde aus den nicht interaktiven Karten entfernt. (I9bd49) - Aktualisiert verschiedene Standardobjekte für Komponenten, um Farben, Formen usw. einzuschließen (I96e11).
Fehlerkorrekturen
- Nicht funktionierende nachgestellte Symbole wurden aus den Beispielen für Eingabe-Chips entfernt, um Verwirrung bei Nutzern der Katalog-App zu vermeiden. (I9846a)
Version 1.0.0-alpha14
29. Juni 2022
androidx.compose.material3:material3:1.0.0-alpha14 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 sind veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.
Neue Funktionen
- Die Implementierung der M3-Liste wurde hinzugefügt. Informationen zur Beispielnutzung finden Sie in der Dokumentation (Id7a20).
API-Änderungen
- Parametername von „values“ in „value“ in
RangeSliderändern (I3b79a) - API-Änderungen an der
InputChip-Implementierung zur Unterstützung eines auswählbaren Status gemäß der Material Design-Spezifikation. Zusätzliche Unterstützung bei denFilterChip-Farben für den ausgewählten deaktivierten Status. (I55244, b/235792432) - Standard-FAB für
BottomAppBarhinzufügen (Ida4c8) ColorScheme.surfaceColorAtElevationwurde hinzugefügt (Id41af)- Schnittstellen in Compose-Bibliotheken werden jetzt mit JDK8-Standard-Schnittstellenmethoden erstellt (I5bcf1).
WindowWidthSizeClassundWindowHeightSizeClassimplementieren jetzt Comparable, sodass sie mit Operatoren (<, <=, >=, >) und anderen APIs verglichen werden können. (I747d0)
Fehlerkorrekturen
- Aktualisieren Sie das Beispiel für das Logo, um eine aussagekräftigere Inhaltsbeschreibung zu liefern. (I10b9d)
- Fügt dem Theme-Picker des Material 3-Katalogs die Option hinzu, die Systemschriftgröße zu verwenden. (I10605)
- Beispielcode für Badge- und unbestimmte Fortschrittsanzeigen wird 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 sind veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.
API-Änderungen
- Unterstützt das Beibehalten der Position der oberen App-Leiste bei einer Konfigurationsänderung. (I10459, b/216160958)
Version 1.0.0-alpha12
18. Mai 2022
androidx.compose.material3:material3:1.0.0-alpha12 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 sind veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.
Fehlerkorrekturen
- Der übergeordnete Slider 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 sind veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.
Neue Funktionen
RangeSliderwurde zu Material 3 hinzugefügt. (I18e38)- Unterstützung für Material3-
AssistChipundInputChiphinzugefügt (I0d25a) - Unterstützung für Material3-
FilterChipundSuggestionChiphinzugefügt (I9fdf3)
API-Änderungen
- Die zusammensetzbare Funktion
TextFieldDefaults.BorderStroke, mit der ein Rahmenstrich inOutlinedTextFieldgezeichnet wird, wurde inTextFieldDefaults.BorderBoxumbenannt. (I5f295) - Wechsel von M3-Visualisierungen (Iab30e)
- Übergabe von Farben an die Standardschaltflächen mit Symbolen zulassen. (Ia2445)
Fehlerkorrekturen
- Lint-Prüfung für material3/Scaffold hinzugefügt, um sicherzustellen, dass das innere Padding verwendet wird (I72293, b/226951418)
Version 1.0.0-alpha10
20. April 2022
androidx.compose.material3:material3:1.0.0-alpha10 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 sind veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.
Neue Funktionen
material3-window-size-classist eine neue Bibliothek, die Unterstützung für Fenstergrößenklassen bietet. Das sind eine Reihe von Ansichtsbereich-Breakpoints, die Ihnen beim Entwerfen, Entwickeln und Testen von Layouts für Anwendungen mit anpassbarer Größe helfen. MitcalculateWindowSizeClasskönnen Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche dargestellt werden soll. Bei größeren Fenstergrößen kann beispielsweise eine Navigationsleiste anstelle der unteren Navigation angezeigt werden. Weitere Informationen und Beispiele finden Sie in der API-Referenzdokumentation zuWindowSizeClass. Weitere Informationen zu den Definitionen der Fenstergrößenklassen finden Sie in der öffentlichen Anleitung zur Unterstützung verschiedener Bildschirmgrößen.
API-Änderungen
- Fügt die Standard-FAB-Erhebung für
BottomAppBarhinzu und entfernt das nachgestellte Lambda ausBottomAppBarmit FAB. (I92c47) - Fügt Material3-
FilledIconButton,FilledTonalIconButtonundOutlinedIconButtonhinzu. (Ib2bda) - Die Material 3-Snackbar-API wurde aktualisiert, sodass Farbwerte für die optionale Aktion und die Schließen-Aktion akzeptiert werden. (Ibe4b4)
- Die teilweise Nutzung (Down- oder Position) wurde in
PointerInputChangeeingestellt. Mitconsume()können Sie die Änderung vollständig übernehmen. MitisConsumedkönnen Sie feststellen, ob die Änderung bereits von jemand anderem übernommen wurde. PointerInputChange::copy()erstellt jetzt immer eine oberflächliche Kopie. Das bedeutet, dass Kopien vonPointerInputChangeverbraucht werden, sobald eine der Kopien verbraucht wird. Wenn Sie ein nicht gebundenesPointerInputChangeerstellen 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 klickbare Karten zu unterstützen. (I927df) - Der Parameter
backgroundColorwurde in Material 3-Textfeldern incontainerColorumbenannt, um die Konsistenz mit anderen Komponenten zu verbessern. (I6fbd9)
Fehlerkorrekturen
- Aktualisierungen des Standards
IconButton, um ihn an die Material3-Spezifikation anzupassen. (I09eab) - Die Höhe der oberen Leiste von Material3-Scaffold wird in das Padding verschoben, das an „content“ übergeben wird. So kann der Inhalt unter der oberen App-Leiste gerendert werden. Wenn die
PaddingValuesignoriert werden, kann es sein, dass der Inhalt durch die obere Leiste verdeckt wird. (I83cbc, b/217776202)
Version 1.0.0-alpha09
6. April 2022
androidx.compose.material3:material3:1.0.0-alpha09 ist veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
Neue Funktionen
- Material 3-Schalter-API hinzugefügt (I2c3ad)
API-Änderungen
- Es wurde Unterstützung für Drop-down-Menüs mit Textfeldern (auch als „offengelegte Drop-down-Menüs“ oder „Kombinationsfelder“ bezeichnet) hinzugefügt. (I1b832)
- Der Formparameter wurde dem MaterialTheme- und dem Shape-Subsystem hinzugefügt. (I37426)
ExtendedFloatingActionButtonwurde ein erweiterter Parameter hinzugefügt, mit dem gesteuert werden kann, ob das FAB maximiert oder minimiert wird. Zwischen den einzelnen Status werden Animationen angezeigt. Es wurde eine Überlastung für erweiterte UAS mit nachfolgendem 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 ist veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
- Unterstützung für Material 3-Textfelder hinzugefügt. (I795cc, b/199377790)
API-Änderungen
- Standardtrennlinie für Menü hinzufügen (I01374)
- Der Klasse
ColorSchemewurde der FarbparametersurfaceTinthinzugefügt. (I2f558)
Fehlerkorrekturen
- Der Standardtextstilwert wird jetzt aus dem MaterialTheme gelesen. (Ie62fc)
Version 1.0.0-alpha07
9. März 2022
androidx.compose.material3:material3:1.0.0-alpha07 ist veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
- Aktualisierungen der Material 3 Surface API, durch die die überladenen Funktionen für klickbare Surfaces zurückkehren und eine Funktion zur Unterstützung von auswählbaren und umschaltbaren Surfaces hinzugefügt wird. (I4bf18)
LazyVerticalGridundLazyHorizontalGridsind jetzt stabil. (I307c0)LazyVerticalGrid/LazyHorizontalGridund alle zugehörigen APIs wurden in das Unterpaket „.grid“ verschoben. Aktualisieren Sie Ihre Importe von androidx.compose.foundation.lazy zu androidx.compose.foundation.lazy.grid. (I2d446)- Die vorherige Änderung, bei der nur eine Ansicht für
WindowInsetsControllerCompatverwendet wurde, wurde rückgängig gemacht. Es ist wieder ein Fenster erforderlich, das zum Verwalten einiger Fenster-Flags benötigt wird.ViewCompat.getWindowInsetsControllerwurde zugunsten vonWindowCompat.getInsetsControllereingestellt, um sicherzustellen, dass das richtige Fenster verwendet wird (z. B. wenn sich die Ansicht in einem Dialogfeld befindet). (I660ae, b/219572936) - Eine neue
LazyVerticalGridAPI zum Definieren von Größen für die Querachse wurde hinzugefügt (I17723).
Fehlerkorrekturen
- Updates für die Card API aufgrund von Änderungen an der Surface API (I3c8b9)
Version 1.0.0-alpha06
23. Februar 2022
androidx.compose.material3:material3:1.0.0-alpha06 ist veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
NavigationDrawerItemwird hinzugefügt und steht für ein einzelnes Ziel in den Bereichen (Ic396f, b/218286829).PermanentNavigationDrawerundDismissibleNavigationDrawerwurden als experimentelle APIs hinzugefügt. Das sind die Schubladen, die sich gut für Geräte mit großen Bildschirmen eignen. (I5f8ab, b/218286829)- Unterstützung für die untere App-Leiste von Material 3 hinzugefügt (Ic432a)
NavigationDrawerwurde inModalNavigationDrawerumbenannt (I1807d, b/218286829)- Material 3-Slider-Klasse und ‑Tokens hinzugefügt (I1ccee)
- Die Tab-Implementierung wurde hinzugefügt. Informationen zur Verwendung finden Sie in der Dokumentation (Ie0146).
Fehlerkorrekturen
- Ein Problem wurde behoben, durch das bei der linearen Navigation mit dem Screenreader
TalkBackein leerer Titel der oberen App-Leiste ausgewählt wurde. (Id4690) IconSizewurde zuFloatingActionButtonDefaultshinzugefügt. (Ia71cf)- Fehlerbehebung für ausgeblendete
AlertDialog-Schaltflächen, wenn mit einemLazyColumnlanger Text hinzugefügt wird. (Ib2cc9, b/216663029)
Version 1.0.0-alpha05
9. Februar 2022
androidx.compose.material3:material3:1.0.0-alpha05 ist veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
Material Design 3-Komponenten hinzugefügt
- Drop-down-Menü
- Infokarten
API-Änderungen
- Die Funktion
Surface, die einen onClick-Callback verwendet, ist veraltet. Klickbare Oberflächen sollten mit einemInteractionSourceund einemModifier.clickable()erstellt werden. (I211c6) - Unterstützung für die Erhebung von gedrückten und fokussierten FABs hinzugefügt. (Ibb584)
- Die
SurfaceAPI wurde so geändert, dass sie eine InteractionSource empfängt, mit der ihr Erscheinungsbild in verschiedenen Status gesteuert werden kann. (Iafbc8)
Fehlerkorrekturen
- Fehlende tertiäre Farben in dynamischen Farbschemas hinzugefügt (I456c4, b/214588434)
Version 1.0.0-alpha04
26. Januar 2022
androidx.compose.material3:material3:1.0.0-alpha04 ist veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
NonRestartableComposablewurde Methoden hinzugefügt, die Überladungen vorhandener Methoden ohne komplexe Logik sind. Dadurch werden die vom Compiler generierten Memoization-Prüfungen (equals) für alle Parameter reduziert, die in der aufgerufenen inneren Funktion wiederholt werden. (I90490)- Material 3-Trennzeichen hinzugefügt. (Ica5fc)
- Markieren Sie das Checkbox- und das RadioButton-Element mit der Anmerkung „experimental API“. (Ie44bb)
- Unterstützung für Material 3-Fortschrittsanzeigen hinzugefügt. (Iff232, b/205023841)
Fehlerkorrekturen
- Die Farbe eines deaktivierten
TextButton's-Containers wird in „Transparent“ geändert (I6b248, b/213339737).
Version 1.0.0-alpha03
12. Januar 2022
androidx.compose.material3:material3:1.0.0-alpha03 ist veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Fügen Sie
LocalIndicationzuMaterialThemevon Material 3 hinzu. (I7ce4e) - Eckradius für Checkboxen korrigieren (I38b03, b/175198975, b/202309440)
Abhängigkeitsupdates
- Jetzt hängt von Kotlin
1.6.10ab.
Version 1.0.0-alpha02
1. Dezember 2021
androidx.compose.material3:material3:1.0.0-alpha02 ist veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- Unterstützung für Kästchen und Optionsfelder hinzugefügt.
- Aktualisiert, um mit Kotlin
1.6.0kompatibel zu sein
API-Änderungen
- Entfernen Sie die Schublade aus dem Scaffold von Material 3. (I04f51)
- Unterstützung für Material 3
Checkboxwird hinzugefügt. (Id5542) - Unterstützung für Material 3
RadioButtonwird hinzugefügt. (I20334)
Fehlerkorrekturen
- Reduziere den Welleneffekt-Radius von
IconButtonvon 40 dp auf 20 dp. (I68bbe, b/206674345) - Schnellzugriff für Port-String für
Text-Änderungen voncompose.material(I30b03) - Behoben: 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 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Material Design 3-Theming und dynamische Material You-Farben
Material Design 3-Komponenten
- Buttons
- UAS und erweitertes UAS
- Dialogfelder
- Navigationsleiste
- Navigationsleiste
- Navigationsleiste
- Obere App-Leiste
- Badge
- Symbol
- Text
- Oberfläche
- Layout
- Inhaltsfarbe
Weitere Informationen finden Sie im Leitfaden „Material Theming in Compose“ im Abschnitt Material Design 3 und Material You.