Material 3 zusammenstellen
Letzte Aktualisierung | Stabile Version | Release Candidate | Beta-Ausgabe | Alphaversion |
---|---|---|---|---|
13. November 2024 | 1.3.1 | - | - | 1.4.0-alpha04 |
Struktur
Compose ist eine Kombination aus sieben Maven-Gruppen-IDs in androidx
. Jede Gruppe enthält eine gezielte Teilmenge von Funktionen, für die jeweils eigene Release-Notes gelten.
In dieser Tabelle werden die Gruppen und Links zu den einzelnen Versionshinweisen erläutert.
Gruppe | Beschreibung |
---|---|
compose.animation | Sie können Animationen in ihren Jetpack Compose-Anwendungen erstellen, um die Nutzerfreundlichkeit zu verbessern. |
compose.compiler | @Composable-Funktionen transformieren und Optimierungen mit einem Kotlin-Compiler-Plug-in aktivieren |
compose.foundation | Erstellen Sie Jetpack Compose-Anwendungen mit vorgefertigten Bausteinen und erweitern Sie die Grundlage, um eigene Designsystem-Elemente zu erstellen. |
compose.material | Erstellen Sie Jetpack Compose-UIs mit vorgefertigten Material Design-Komponenten. Dies ist der übergeordnete Einstiegspunkt von Compose. Er wurde entwickelt, um Komponenten bereitzustellen, die denen auf www.material.io entsprechen. |
compose.material3 | Erstellen Sie Jetpack Compose-UIs mit Material Design 3-Komponenten, der nächsten Weiterentwicklung von Material Design. Material 3 umfasst aktualisierte Themen und Komponenten sowie Personalisierungsfunktionen von Material You wie dynamische Farben. Es wurde so konzipiert, dass es zum neuen visuellen Stil und zur System-UI von Android 12 passt. |
compose.runtime | Grundlegende Bausteine des Programmiermodells und der Statusverwaltung von Compose sowie die Kernlaufzeit, auf die das Compose-Compiler-Plug-in ausgerichtet ist. |
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 im Maven-Repository von Google.
Fügen Sie der Datei build.gradle
für Ihre App oder Ihr Modul die Abhängigkeiten für die erforderlichen Artefakte hinzu:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.3.1" implementation "androidx.compose.material3:material3-window-size-class:1.3.1" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha05" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.1") implementation("androidx.compose.material3:material3-window-size-class:1.3.1") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha05") } 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. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
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
werden losgelassen. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Themenlose Komponenten, die zum Erstellen von Material Design-Komponenten verwendet 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
werden losgelassen. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
- Navigation Suite APIs nicht mehr als experimentell kennzeichnen (If62af)
Fehlerkorrekturen
- Standardmäßig Einblendungen 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
werden losgelassen. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
- Fügen Sie
containerColor
undcontentColor
zuNavigationSuiteScaffoldDefaults
hinzu. (I64e3a, b/331993720) itemColors
-Funktion zuNavigationSuiteDefaults
hinzufügen (Idf719, b/328480012)- Machen Sie
NavigationSuiteScope
versiegelt. (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
werden losgelassen. Version 1.0.0-alpha05 enthält diese Commits.
API-Änderungen
- Machen Sie den Konstruktor von
NavigationSuiteItemColors
ö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
werden losgelassen. Version 1.0.0-alpha04 enthält diese Commits.
Abhängigkeitsupdates
- Aktualisieren Sie die adaptiven Abhängigkeiten von Material 3 auf die neuen Modulpfade. (Ibc421)
- Verwenden Sie die Fenstermanagerversion der Fenstergrößenklassen. (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
werden losgelassen. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
- Paketnamen von „navigation-suite“ in „navigationsuite“ ändern (I7eff7)
- Material3-Komponenten, die eine
MutableInteractionSource
in ihrer API bereitstellen, wurden aktualisiert. Sie stellen jetzt eine nullableMutableInteractionSource
bereit, die standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dieMutableInteractionSource
nicht hochladen. Sie wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie zu „null“ wechseln, wird für einige Komponenten nie eineMutableInteractionSource
zugewiesen. Andere Komponenten können dann nur bei Bedarf eine Instanz erstellen, was die Leistung dieser Komponenten insgesamt verbessert. Wenn du denMutableInteractionSource
, den du an diese Komponenten weitergibst, nicht verwendest, solltest du stattdessen „null“ übergeben. Wir empfehlen Ihnen außerdem, ähnliche Änderungen an Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146)
Version 1.0.0-alpha02
13. Dezember 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02
und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02
werden losgelassen. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- Fügen Sie ein
NavigationSuiteType
für „Kein“ hinzu (If8cb1, b/313688598).
Fehlerkorrekturen
- Navigationskomponente füllt den gesamten Bildschirm aus, wenn die Stammoberfläche
modifier.fillMaxSize
enthält (c9cf250, b/312664933)
Version 1.0.0-alpha01
15. November 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01
wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Material3 Adaptive Version 1.0 erstellen
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
werden losgelassen. 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
werden losgelassen. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
- Unterstützung der Historie bei der Navigation im Navigations-Scaffold und bei der 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
werden losgelassen. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Unterstützung für die volle Breite in Bereichs-Scaffolds hinzugefügt (I1b462)
API-Änderungen
- Die Eigenschaften für Scharniergrenzen in „Körperhaltung“ wurden in eine Liste mit Scharnierinformationen verschoben (I24f90)
Fehlerkorrekturen
- Fehler beheben:
AnimatedPane
wird 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
werden losgelassen. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
- Ändern Sie die Scaffold-Rollen in Aliasse von
ThreePaneScaffoldRole
. (I65bd1) - Basisklasse für Scaffold-Rollen erstellen (I4784d)
- Unnötigen Parameter aus dem Inhalt von
AnimatedPane
entfernen (Ibc73b) - Benennt
collectWindowSizeAsState
um und gibt stattdessen Rohwerte zurück (I480f4)
Version 1.0.0-alpha02
29. November 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02
und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02
werden losgelassen. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
- Navigations-APIs von APIs für adaptives Scaffolding trennen. (Ic4045)
- Entfernen Sie die Klasse
GutterSize
. (I785b3)
Fehlerkorrekturen
- Es wird nicht mehr zwischen den Ansichten gewechselt, wenn
AnimatedPane
nicht verwendet wird (d88f181)
Version 1.0.0-alpha01
15. November 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
APIs für adaptive Material3-Bedingungen:
APIs für Material3-Richtlinien für adaptive Steuerfeldbereiche:
APIs für Material3-Adaptive-Steuerfeld-Scaffolding:
- Grundlegende APIs für Steuerfeld-Scaffolding
Material3 Version 1.4
Version 1.4.0-alpha04
13. November 2024
androidx.compose.material3:material3-*:1.4.0-alpha04
wird veröffentlicht. Version 1.4.0-alpha04 enthält diese Commits.
Verhaltensänderungen
- Die in aosp/3212478 eingeführten Farbänderungen für
iconButtonColors
,iconToggleButtonColors
,outlinedIconButtonColors
,outlinedIconToggleButtonColors
undoutlinedIconToggleButtonBorder
rückgängig machen Das jetzt rückgängig gemachte Verhalten wurde in eine neue Gruppe von Funktionen namensiconButtonVibrantColors
usw. verschoben, um die zurückgegebenen Farben mit hohem Kontrast hervorzuheben. (Iffd8d)
Neue Funktionen
- Einführung der
VerticalDragHandle
-Komponente (I6c770)
API-Änderungen
- Benennen Sie
DismissibleModalWideNavigationRailDefaults
inModalWideNavigationRailDefaults
um. (I8e877) - Fügen Sie
NavigationBarComponentOverrides
hinzu. (I8a3f3) - Fügen Sie
NavigationRailComponentOverride
hinzu. (I83e13) - Fügen Sie
WideNavigationRailState
hinzu, um das Minimieren/Maximieren der Leiste zu steuern, lassen SieModalWideNavigationRail
schließen und löschen SieDismissibleModalWideNavigationRail
. (I88568) - Fügen Sie den Standardgrößen „xSmall“, „Medium“, „Large“ und „xLarge“ Standardwerte für die Ein-/Aus-Schaltfläche hinzu. (Ie95d1)
- Fügen Sie den Standardgrößen „xSmall“, „Medium“, „Large“ und „xLarge“ zu den Standardeinstellungen für Schaltflächen hinzu. (If8b6d)
Fehlerkorrekturen
- Die Farbe des nachgestellten Symbols für Filter-Chips wurde gemäß den Spezifikationen von „Primär“ zu „
OnSurfaceContainer
“ geändert. Alle Chip-Umrissfarben wurden gemäß den Spezifikationen von „Umriss“ zu „Umrissvariante“ geändert. (I68bd4)
Version 1.4.0-alpha03
30. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha03
wird veröffentlicht. Version 1.4.0-alpha03 enthält diese Commits.
API-Änderungen
- Der
SheetState
-Konstruktor mit Dichte wurde zugunsten von Grenzwerten für Position und Geschwindigkeit eingestellt. (Ifd16e) rememberTooltipPositionProvider
mit aktualisierter Positionierungslogik hinzugefügtrememberPlainTooltipPositionProvider
undrememberRichTooltipPositionProvider
wurden eingestellt. (Ie66e2)- Mit zusätzlichen
ModalBottomSheetProperties
können Sie die Farben der Status- und Navigationsleiste anpassen. Standardmäßig werden sie anhand der Inhaltsfarbe und nicht anhand des Status des dunklen Systemdesigns aktualisiert. (Ib874e, b/362539765) - Die Eingabe für Datumsauswahlen wurde verbessert: Im Eingabemodus wird das Textfeld für das Datum aktiviert, damit sofort Text eingegeben werden kann. Durch die Änderung wird dem
DatePicker
und demDateRangePicker
einrequestFocus
-Parameter hinzugefügt. Sie können einen Fokus verhindern, indem Siefalse
übergeben. (I12d09, b/286399710, b/340102743) - Die Standardeinstellungen für die Form im Shape-Objekt im Cache speichern Die Standardform für die Ein-/Aus-Schaltfläche ist
@Composable
. Die Formen werden zu einer Standardform minimiert, da die Varianten auf dieselbe Tokendatei verweisen. (Iaa014)
Fehlerkorrekturen
- Optimieren Sie das Verhalten von
contentPadding
im Scaffold, damit der Textkörper nicht jedes Mal neu formatiert werden muss, wenn sichcontentPadding
ändert. (I8c8e2, b/373904168) TextFieldLabelScope
progress
inlabelMinimizedProgress
umbenanntTextFieldLabelPosition
Default
wurde inAttached
umbenannt. Benutzeroberflächenelemente wurden entfernt. (If75c6)- Ein Problem mit dem
DatePicker
im Eingabemodus wurde behoben, bei dem Validierungsfehler dazu führen konnten, dass sich die Höhe der Komponente änderte. (I2e229, b/280462363) - Der Material-Schieberegler soll seinen Wert ändern, wenn Steuertasten gedrückt werden. (I1c442)
Version 1.4.0-alpha02
16. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha02
wird veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.
API-Änderungen
- Aktualisierungen an den Datumsauswahlen, um eine einheitliche Spracheneinstellung in
DatePicker
undDateRangePicker
zu gewährleisten, wenn eine Sprache direkt über eineDatePickerState
oder eineDateRangePickerState
festgelegt wird. Wenn Sie die Sprachen direkt auf den Bundesstaat festlegen, müssen Sie dafür sorgen, dass der Titel und die Überschriften entsprechend lokalisiert werden, da der Standardtext weiterhin gemäß der Standardsprache der Plattform angewendet wird. (I37073, b/326490763, b/321657276) SheetState.isAnimationRunning
ist jetzt sichtbar. (I9a3d7)DatePickerColors
hat jetzt Vorrang vor eventuell abweichenden Farben, die in den Textstilen „Typografie“ des Designs definiert sind. Außerdem wird durch dieses Update die Position des Parameterscolor
in den Funktionen der Datumsauswahl angepasst und der ParametercontentColor
eingeführt, mit dem die Textfarben von Überschriften und Titeln angepasst werden können. (I30d03, b/347031394)- Benennen Sie
SplitButton
inSplitButtonLayout
um und entfernen Sie die APIs fürSplitButton
-Farbvarianten. Varianten werden durch Wiederverwendung der vonSplitButtonDefaults
bereitgestellten Schaltflächenvarianten erstellt. (I44c36) ModalBottomSheet
hat jetzt den ParametersheetGestureEnabled
(I856cb, b/288211587)standardMotionScheme
undexpressiveMotionScheme
wurden in „Standard“ und „Ausdrucksstark“ umbenannt. Beide Funktionen sind jetzt über dasMotionScheme
-Begleiterobjekt verfügbar. Rufen Sie dazuMotionScheme.standard()
undMotionScheme.expressive()
auf. (Iceccf)- Der Parameter
maxWidth
wurde einfachen und erweiterten Kurzinfos hinzugefügt. Standardmäßig wird die Designangabe von 200 dp für einfache Kurzinfos und 320 dp für umfangreiche Kurzinfos verwendet. (I30ce9)
Fehlerkorrekturen
- Der angezeigte Monat wird jetzt von
DatePicker
undDateRangePicker
korrekt aktualisiert, wenn er über diedisplayedMonthMillis
des jeweiligen Status festgelegt wird. (If9e47, b/333414302) ModalBottomSheet
-Inhalte werden jetzt nicht mehr in der Statusleiste angezeigt. (I5114c, b/321877275, b/336962418, b/342093067)- [Untere Leiste] Die Rückrufpriorität wird wieder auf
PRIORITY_DEFAULT
zurückgesetzt, damit die IME-Tastatur zuerst geschlossen wird. (I447fb) - Behebung von Abstürzen in
DatePicker
undDateRangePicker
, wenn das Jahr, das als Mindestwert für die Auswahl festgelegt ist, in der Zukunft liegt. (I78656, b/319395747) - Behebung eines Problems mit der Datumsauswahl, durch das die Benutzeroberfläche nicht aktualisiert wurde, wenn eine aktualisierte
SelectableDates
-Instanz angewendet wurde. (Iad59a, b/290135807, b/339898760)
Version 1.4.0-alpha01
2. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha01
wird veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.
Verhaltensänderungen
- Die Bibliothek fügt
material-icons-core
keine Abhängigkeit mehr hinzu. Wenn Ihr Projekt darauf angewiesen ist, müssen Sie diese Abhängigkeit in Ihrenbuild.gradle[.kts]
-Dateien explizit hinzufügen. (I735ff, b/349894318) - Die Farbe des aktiven Labels von
NavigationBarItem
undNavigationRailItem
ändert sich vononSurface
zusecondary
, um die Nutzerfreundlichkeit, den Farbkontrast und die Einheitlichkeit im System zu verbessern (Ibc297). Wenn Sie zum vorherigen Verhalten zurückkehren möchten, kopieren Sie die Standardfarben und ändern SieselectedTextColor
inMaterialTheme.colorScheme.onSurface
. - Für Material 3-Komponenten wird jetzt die neue
MotionScheme
verwendet, um ihre Bewegung zu definieren. (Ie0f93) - Änderungen der Bewegung der unbestimmten kreisförmigen Fortschrittsanzeige (I3c07e)
- Aktualisieren Sie
OutlinedIconButtonColors
undOutlinedIconToggleButtonColors
für einen besseren Farbkontrast. (I2743d) - Farbe von Container und Inhalt für
FilledIconToggleButtonColors
undFilledTonalIconToggleButtonColors
aktualisiert. (Ic5d0f) - Die Rahmenfarbe von
OutlinedButton
wurde vonoutline
zuoutlineVariant
geändert. (057f00)
API-Änderungen
- Der Funktion
enterAlwaysScrollBehavior
vonTopAppBar
wurde ein optionaler ParameterreverseLayout
hinzugefügt, um Inhalte zu unterstützen, die mit einemreverseLayout
festgelegt wurden. (I4e0e5) SegmentedButton
unterstützt jetzt das ArgumentcontentPadding
. (I5ad91, b/358414376)PullToRefreshState
hat keine Standardimplementierung mehr fürisAnimating
(I6a593)- Es wurden neue Überladungen von Material
TextField
undOutlinedTextField
hinzugefügt, dieTextFieldState
verwenden. APIs für Dekorationsboxen hinzugefügt, die mitTextFieldDecorator
kompatibel sind. (If13a1) - Dem Textfeld wurde der Parameter
labelPosition
hinzugefügt. MitalwaysMinimize
kann das UI-Muster so gestaltet werden, dass ein Label und ein Platzhalter in einem Textfeld gleichzeitig angezeigt werden, auch wenn das Feld nicht fokussiert ist. (I1ef2c) - Die Materialien
SecureTextField
undOutlinedSecureTextField
für Passwort-Eingabefelder wurden hinzugefügt. (I7e22d) - Textfeldlabels haben jetzt einen Bereich, um den Fortschritt der Animation abzufragen. (If5ec8)
- In den Kurzinfos wird die Unterstützung für
MotionEvent.CLASSIFICATION_DEEP_PRESS
hinzugefügt. (I62e6a) isAfternoon
vonTimePickerState
ist jetzt ein Erweiterungswert statt einer Variablen in der Benutzeroberfläche und wurde inisPm
umbenannt (I89a97)- Die Typografieklasse wird aktualisiert, um hervorgehobene Schriftskalierungen zu unterstützen. (Ifa13c)
- Die
ModalWideNavigationRail
API wurde hinzugefügt und dieModalExpandedNavigationRail
APIs inDismissibleModalWideNavigationRail
umbenannt. (Ic9118) FloatingAppBarScrollBehavior
wurde aktualisiert, damit diescreenOffset
automatisch berechnet wird und keine@Composable
erforderlich ist. (Idf349)- Aktualisierungen der
LoadingIndicator
API zur Korrektur der Benennung im Standardobjekt. An derPullToRefresh
wurde eineLoadingIndicatorElevation
-Konstante hinzugefügt. (I1d72b) - Aktualisierungen der
LoadingIndicator
API zur Korrektur der Benennung im Standardobjekt. An derPullToRefresh
wurde eineLoadingIndicatorElevation
-Konstante hinzugefügt. (I1d72b) - Den unbestimmten Varianten von
LinearWavyProgressIndicator
undCircularWavyProgressIndicator
wurden die Parameteramplitude
undwaveSpeed
hinzugefügt. (I2a0c5) - Die Form einer Symbolschaltfläche muss sich je nach gedrücktem oder angeklicktem Zustand ändern lassen. (Ibc781)
- Die Typografieklasse wird aktualisiert, um hervorgehobene Schriftskalierungen zu unterstützen. (Ifa13c)
SplitButton
Die Form ändert sich je nach Standard-/gedrücktem Status. DieAnimatedTrailingButton
API wurde entfernt, da dieTrailingButton
API dieselben Anpassungen bietet (I95066)- Fügen Sie einen Modifier hinzu, um das Ein- und Ausblenden des Floating Action Button zu animieren, z.B. beim Scrollen von Inhalten. (I8338d)
ButtonGroupDefaults
wird eine verbundene Schaltflächengruppenform und ein Abstand hinzugefügt, die in einem Beispiel verwendet werden sollen. (I68e30)- Für die geteilte Schaltfläche wird ein horizontaler Abstand für die hintere Schaltfläche hinzugefügt und die optische Zentrierung wird anhand der Unterschiede zwischen Start- und Endecke berechnet (I122e2)
- Einführung eines neuen Materials
MotionScheme
, mit dem ein Schema für die Bewegung der Komponente festgelegt werden kann. Das Schema wird über dieMaterialTheme
festgelegt. (Id50c2)
Fehlerkorrekturen
- Wenden Sie den richtigen Index für die Fokusüberprüfung auf
Scaffold
untergeordnete Composables an. Die Reihenfolge isttopBar
,bottomBar
, FAB, Inhalt, Snackbar. (I5936b) - Ein Problem bei
DatePicker
undDateRangePicker
wurde behoben, bei dem in bestimmten Sprachen und Format-Skeletten einige Datumselemente (z.B. Monatsnamen) nicht mit einem Großbuchstaben begannen. (I1430f) - FAB- und FAB-Menü-Komponenten-Tokens einbinden (kleine visuelle Änderungen an Rändern und Text) (Ib57f3)
ModalBottomSheet
steht jetzt in der semantischen Durchlaufreihenfolge an erster Stelle, gefolgt vom Scrim. (I436f9, b/358594665)- Die untere App-Leiste verschwindet nicht vollständig, wenn im Vollbildmodus unter der Navigationsschaltfläche gescrollt wird (I3ee21)
Compose Material3 Version 1.3
Version 1.3.1
30. Oktober 2024
androidx.compose.material3:material3-*:1.3.1
wird veröffentlicht. Version 1.3.1 enthält diese Commits.
Fehlerkorrekturen
- Der angezeigte Monat wird jetzt von
DatePicker
undDateRangePicker
korrekt aktualisiert, wenn er über diedisplayedMonthMillis
des jeweiligen Status festgelegt wird. (If9e47, b/333414302) - Behebung von Abstürzen in der
DatePicker
undDateRangePicker
, wenn das Jahr, das als Mindestwert für die Auswahl festgelegt ist, in der Zukunft liegt. (I78656, b/319395747) - Ein Problem mit der Datumsauswahl wurde behoben, damit die Benutzeroberfläche aktualisiert wird, wenn eine aktualisierte
SelectableDates
-Instanz angewendet wird. (Iad59a, b/290135807, b/339898760) - Ändern Sie die Rückrufpriorität, die von unteren Infofeldern verwendet wird, in
PRIORITY_DEFAULT
, damit die IME-Tastatur zuerst geschlossen wird. (I447fb)
Version 1.3.0
4. September 2024
androidx.compose.material3:material3-*:1.3.0
wird veröffentlicht. Version 1.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.2.0
Wichtige Funktionen von 1.3.0
Neue Material Design 3-Komponenten
- Karussell
HorizontalMultiBrowseCarousel
undHorizontalUncontainedCarousel
: Verbesserungen an vorhandenen Material Design 3-Komponenten.
- [
ModalBottomSheet
] Unterstützung der Vorhersagefunktion für Zurück bei U+ (Iccf32, b/281967264, b/304850357) - [
SearchBar
] Unterstützt jetzt die intelligente „Zurück“-Geste auf Android U und höher (I657f8) - Die Navigationsleiste (
ModalDrawerSheet
undDismissibleDrawerSheet
) unterstützt jetzt die vorausschauende Navigation auf U+ als Option (Ie5b0b) DropdownMenu
unterstützt jetzt benutzerdefinierte Farbe, Form, Höhe 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 Haltestellenanzeige hinzugefügt. (I3058e)
ProgressIndicator
wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Haltestellenanzeige hinzugefügt. (I21451)- Es wurde ein Standard-Cursor für Rich-Tooltips hinzugefügt. Außerdem wird unterstützt, dass ein benutzerdefinierter Cursor für einen bestimmten Anker
LayoutCoordinates
gezeichnet wird. (Ifd42c) Funktionsgefährdende Änderungen - Neue APIs für das Ziehen zum Aktualisieren:
PullToRefreshState
wurde vereinfacht, sodass anstelle von Dp-Einheiten Bruchteile verwendet werden.- Der Status von
isRefreshing
wird vom Nutzer und nicht vonPullToRefreshState
gesteuert. - Die verschachtelte Scrollverbindung von
PullToRefreshState
getrennt. Die Verarbeitung erfolgt über die neuePullToRefreshBox
oderModifier.pullToRefresh
. - Dieses Update ist eine inkompatibilitätsbedingte Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Visuelle Unterbrechungen
- Aktualisieren Sie das Overlay für den Fokusstatus auf 0,1f, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen an den Standardfarben für Oberfläche und Hintergrund in
lightColorScheme
unddarkColorScheme
. (I9db52) - Die Farben des Schiebereglers und von
ProgressIndicator
wurden an die neuen Spezifikationen für den Kontrast von Nichttextelementen angepasst. (I26807) SurfaceContainer
Varianten werden jetzt von Komponenten verwendet. Für Komponenten, bei denen die Farbe bisher mitSurface
undTonalElevation
berechnet wurde, werden jetzt standardmäßigSurfaceContainer
-Rollen verwendet, die nicht von der Tonhöhenänderung betroffen sind. (b/304584161)- Die Standardrollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, um in hellen und dunklen Designs mehr Färbung zu ermöglichen. (I677a5)
- Die experimentellen APIs wurden in stabile APIs umgewandelt.
- Leistungsverbesserungen
Version 1.3.0-rc01
21. August 2024
androidx.compose.material3:material3-*:1.3.0-rc01
wird veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.
Fehlerkorrekturen
ModalBottomSheet
steht jetzt in der semantischen Durchlaufreihenfolge an erster Stelle, gefolgt vom Scrim. (I436f9, b/358594665)
Version 1.3.0-beta05
24. Juli 2024
androidx.compose.material3:material3-*:1.3.0-beta05
wird veröffentlicht. Version 1.3.0-beta05 enthält diese Commits.
- Problem behoben, bei dem
BottomSheet
-Inhalte unter Android N und O fehlen oder abgeschnitten werden (a10a2d) - Die semantischen Grenzen des Schiebereglers wurden erhöht, damit
TalkBack
die Fokusindikatoren um die Schieberegler richtig anzeigen kann. (0b5a1d)
Version 1.3.0-beta04
26. Juni 2024
androidx.compose.material3:material3-*:1.3.0-beta04
wird veröffentlicht. Version 1.3.0-beta04 enthält diese Commits.
Version 1.3.0-beta03
12. Juni 2024
androidx.compose.material3:material3-*:1.3.0-beta03
wird veröffentlicht. Version 1.3.0-beta03 enthält diese Commits.
Externer Beitrag
- Machen Sie
androidx.compose.material3.DropdownMenu
aus dem gemeinsamen Quellsatz verfügbar. (If62c0)
Version 1.3.0-beta02
29. Mai 2024
androidx.compose.material3:material3-*:1.3.0-beta02
wird veröffentlicht. Version 1.3.0-beta02 enthält diese Commits.
API-Änderungen
Modifier.pullToRefreshIndicator
unterstützt die Höhe. Aktualisieren Sie die APIs für das Ziehen zum Aktualisieren, damit „aktiviert“ ein boolescher Wert statt eines Lambdas ist. Unterstützung der Inhaltsausrichtung inPullToRefreshBox
(I75679)TooltipScope
zu einer versiegelten Schnittstelle machen und eine interne Implementierung für die Verwendung inTooltipBox
und Label erstellen (I3833e)CarouselItemScope
wurde zwei neue Modifikatoren hinzugefügt:maskClip
undmaskBorder
. Damit können Sie jedem Karussellelement ganz einfach eine Form und einen Rahmen hinzufügen (Id67a1)TimePickerState
ist jetzt eine Benutzeroberfläche und ermöglicht das Einstellen der Uhrzeit (I88546)- Die API für das Stilisieren der Links wurde aktualisiert: Die
TextLinkStyles
wurde an dieTextStyle
verschoben und dieTextDefaults
aus dem Material entfernt. (I5477b)
Fehlerkorrekturen
- Der Status von
ModalBottomSheet
und die Symbole in der Navigationsleiste reagieren jetzt auf den Status des dunklen Designs. (Ie1fe7, b/338342149) - Dem
ModalBottomSheet
-Skim wurde die Semantik „Tabellenblatt schließen“ hinzugefügt. (0e61cb,b/328801864)
Externer Beitrag
androidx.compose.material3.AlertDialog
aus dem gemeinsamen Quellsatz (Ia33f5) verfügbar machenModalBottomSheet
aus dem gemeinsamen Quellsatz (Id7cc7) verfügbar machen
Version 1.3.0-beta01
14. Mai 2024
androidx.compose.material3:material3-*:1.3.0-beta01
wird veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.
API-Änderungen
- Verwenden Sie
DpSize
anstelle vonCaretProperties
.CaretProperties
wird entfernt. Benennen SieCaretScope
inTooltipScope
um. (Id9a76) - Die API zum Abrufen von Material-Links im Text wurde aktualisiert. Insbesondere wurden die Methoden aus der
TextDefaults
zum Erstellen von themenbezogenenLinkAnnotations
und zum Parsen von HTML mit themenbezogenen Links entfernt. Stattdessen wurde die KlasseTextLinkStyles
hinzugefügt, mit der die Links als Parameter für das Text-Element formatiert werden können. (I31b93)
Version 1.3.0-alpha06
1. Mai 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
wird veröffentlicht. Version 1.3.0-alpha06 enthält diese Commits.
Wichtige Änderungen
Neue APIs für das Ziehen zum Aktualisieren:
PullToRefreshState
wurde vereinfacht, sodass anstelle von Dp-Einheiten Bruchteile verwendet werden.- Der Status von
isRefreshing
wird vom Nutzer und nicht vonPullToRefreshState
gesteuert. - Die verschachtelte Scrollverbindung von
PullToRefreshState
getrennt. Die Verarbeitung erfolgt über die neuePullToRefreshBox
oderModifier.pullToRefresh
. - Dieses Update ist eine inkompatibilitätsverursachende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
API-Änderungen
RippleConfiguration#isEnabled
wurde entfernt undLocalRippleConfiguration
ist jetzt nullable. Wenn Sie eine Wellenbewegung deaktivieren möchten, geben Sie anstelle vonRippleConfiguration
mitisEnabled = false
null
bisLocalRippleConfiguration
an. (I22725)ModalBottomSheet
Der Scrim wird jetzt genauer über der Statusleiste dargestellt, wenn „Edge to Edge“ aktiviert ist. Der Inhalt modaler Unterbrechungen kann jetzt Fenster-Einsätze verwenden, sodass Inhalte über der Navigationsleiste sichtbar sind. Der ParameterModalBottomSheet
wurde incontentWindowInsets
umbenannt, um anzugeben, wo die Einzüge angewendet werden. Sie sind nicht mehr an die Fensterlogik gebunden.windowInsets
Der TypcontentWindowInsets
wurde in eine Funktion geändert, dieWindowInsets
zurückgibt, damit er innerhalb des neuen Fensters aufgelöst werden kann. (I39630, b/274872542, b/300280229, b/290893168)- Für
PrimaryScrollableTabRow
undSecondaryScrollableTabRow
wird jetzt ein benutzerdefiniertes Layout anstelle einer untergeordneten Komposition verwendet, was die Leistung verbessern sollte. (I991e0) - Textlinks haben jetzt neben dem normalen Stil auch einen Stil für den gedrückten Zustand, den Hover-Zustand und den Fokus. Die
TextDefaults
-Methoden haben jeweils einpressedStyle
-Argument, das dies unterstützt. (Ic473f, b/139312671)
Fehlerkorrekturen
- Die Anker für die Navigationsleiste entsprechen jetzt der Breite der
drawerContent
. (Ibc72f, b/245355396) OutlinedTextField
Der obere Abstand für das Label berücksichtigt jetzt die Systemschriftgröße. (Idc781)- Korrigierter Paketstandort:
CalendarLocale
(Ifa235) - [Intelligente „Zurück“-Geste] Animationen für die intelligente „Zurück“-Touch-Geste wurden aktualisiert, sodass jetzt 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
wird veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.
Neue Funktionen
- Für
SearchBar
undDockedSearchBar
gibt es neue Überladungen, die einen Textfeldparameter annehmen. So können Sie das Textfeld unabhängig vom Rest der Suchleiste formatieren und benutzerdefinierte Textfelder übergeben. Das Textfeld der aktuellen Implementierung wurde alsSearchBarDefaults.InputField
verfügbar gemacht. (I50c73, b/275074248, b/278773336, b/326627700) - Der Lambda-Wert
drawTick
wurde der öffentlichen API hinzugefügt, um die Markierungen bei Bedarf anzupassen (I0c048)
API-Änderungen
- Für Textlinks gibt es jetzt neben dem normalen Stil auch einen Stil für den gedrückten Zustand, den Hover-Zustand und den Fokus-Zustand (I5f864, b/139312671)
CarouselItemInfo
wurde aktualisiert, um einen Masken-Rechteck zu zeigen, durch den das Element zugeschnitten wird (I785d8)BasicTooltipState
wurde aus der öffentlichen Material 3 API entfernt. Die Funktionalität wird mitTooltipState
kombiniert, bisBasicTooltip
von Foundation stabilisiert ist. (Icda29)- Es wurde ein
TextDefaults
-Objekt hinzugefügt, das Methoden zum Erstellen einerLinkAnnotation
und zum Parsen von HTML-getaggten Strings enthält, dieMaterialTheme
auf die Links anwenden (I98532, b/139312671) ExposedDropdownMenuBoxScope
erlaubt keine Unterklassen mehr. Ausgeblendete Drop-down-Menüs haben jetzt einMenuAnchorType
, das anmenuAnchor
übergeben werden sollte, um die Barrierefreiheit zu verbessern. Diese Methode sollte anstelle der Weitergabe vonfocusable
anExposedDropdownMenu
verwendet werden, was jetzt nicht mehr unterstützt wird.menuAnchor
hat einen neuen Parameter zum Steuern des Statusenabled
. (I55ee6, b/257209915, b/308840226)- Die Rahmenfarbe von
OutlinedButton
wurde korrigiert, wenn die Funktion deaktiviert ist. Überladung vonButtonDefaults.outlinedButtonBorder("enabled")
hinzugefügt, die den aktivierten Status berücksichtigt. (Ie650b, b/318461363) - Es wurde eine neue
CarouselItemInfo
-Klasse hinzugefügt, damit Kunden Informationen zu den Artikelgrößen erhalten. (I9070c) - Der
ColorScheme
-Konstruktor ohne Oberflächencontainer ist jetzt eingestellt. Bitte migrieren Sie zum Konstruktor, der Oberflächencontainer enthält. (I35c11) - [Umrandet]
TextFieldDefaults
ContainerBox
wurde inContainer
umbenannt. (Ie8d3b)
Fehlerkorrekturen
BottomSheetScaffold
wird nicht mehr durch verschachtelte Scroll-Aktionen gescrollt, wennsheetSwipeEnabled
auf „falsch“ gesetzt ist. (I5e1c1, b/306464779)- Einige
ExperimentalMaterial3Api
-Opt-in-Hinweise inIconButtonSamples.kt
entfernt (I111d1)
Version 1.3.0-alpha04
3. April 2024
androidx.compose.material3:material3-*:1.3.0-alpha04
wird veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.
Neue Funktionen
- Zwei experimentelle Versionen des Material3-Karussells wurden hinzugefügt:
HorizontalMultiBrowseCarousel
undHorizontalUncontainedCarousel
(I88d64) - Der Navigationsbereich von Compose M3 (
ModalDrawerSheet
undDismissibleDrawerSheet
) wurde aktualisiert, um die vorausschauende Suche bei U+ als Option zu unterstützen (Ie5b0b). - In „Symbol“ wurde eine neue API hinzugefügt, mit der die Farbtonung als Lambda übergeben werden kann, um ein Neuzusammensetzen zu vermeiden. (I5b5a2)
- APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen sowohl für feste als auch für minimierbare Bereiche. (Ib8b0c, b/323403446)
API-Änderungen
- APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen sowohl für feste als auch für minimierbare Bereiche. Ein Problem wurde behoben, durch das sich App-Steuerfeldern mit einer Zeile beim Scrollen zu oft neu zusammensetzen. Ein Problem wurde behoben, bei dem
MediumTopAppBar
-Titel auf Geräten mit großen Schrift-/Displayeinstellungen abgeschnitten wurden. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) SegmentedButton
und die zugehörigen APIs sind jetzt stabil (I8a158)SwipeToDismissBox
,SwipeToDismissBoxDefaults
,SwipeToDismissBoxState
undSwipeToDismissBoxValue
sind jetzt als stabil gekennzeichnet. (I5f000)- Die eingestellten
DismissDirection
- undDismissValue
-Enumerierungen und ‑APIs wurden entfernt. (I89ccd) - Dem
CarouselState
-Begleiterobjekt des Karussells wurde ein experimentelles Tag hinzugefügt. (I94154) LocalMinimumInteractiveComponentEnforcement
wurde eingestellt und durchLocalMinimumInteractiveComponentSize
ersetzt. (I7a7ac)- Der Konstruktor von
SearchBarColors
ist jetzt öffentlich. (I769ca) SwipeToDismissBox
hat einengesturesEnabled
-Parameter erhalten. (Idc59f, b/324170119)- Textfeld-APIs, die als veraltet und experimentell gekennzeichnet waren, wurden entfernt. (I1305f)
Version 1.3.0-alpha03
20. März 2024
androidx.compose.material3:material3-*:1.3.0-alpha03
wird veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.
Visuelle Unterbrechungen
- Aktualisieren Sie das Overlay für den Fokusstatus auf 0,1f, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen an den Standardfarben für Oberfläche und Hintergrund in
lightColorScheme
unddarkColorScheme
. (I9db52)
Neue Funktionen
- Es wurden Parameter hinzugefügt, um
ExposedDropdownMenu
anzupassen. Insbesondere haben Menüs jetzt einenfocusable
-Parameter (Standardwerttrue
), der bei der Arbeit mit bearbeitbaren Textfeldern auffalse
gesetzt werden sollte. (I4184c, b/323694447, b/278609042)
API-Änderungen
- Das Flag
ScaffoldSubcomposeInMeasureFix
wurde entfernt. (Ie2a4b) NavigationRailItemColors
ist jetzt als@Immutable
gekennzeichnet. (If6112, b/327660613)NavigationBarItemColors
ist jetzt als@Immutable
gekennzeichnet. (I42a30, b/298064514)- Parameter im Slider Track-Composit neu anordnen (I9f315)
ExposedDropdownMenu
wird jetzt mitPopup
implementiert. Das Verhalten sollte gleich sein, mit der Ausnahme, dass Menüs, die fokussiert werden können und bearbeitbare Textfelder enthalten, geschlossen werden können, wenn auf der Tastatur getippt wird.
Fehlerkorrekturen
- Die Standardrollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, um in hellen und dunklen Designs mehr Färbung zu ermöglichen. (I677a5)
- Die Farben des Schiebereglers und von
ProgressIndicator
wurden an die neuen Spezifikationen für den Kontrast von Nichttextelementen angepasst. (I26807) - Aktualisieren Sie das Overlay für den Fokusstatus auf 0,1f, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen an den Standardfarben für Oberfläche und Hintergrund in
lightColorScheme
unddarkColorScheme
. (I9db52)
Version 1.3.0-alpha02
6. März 2024
androidx.compose.material3:material3-*:1.3.0-alpha02
wird veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.
API-Änderungen
- Die Schiebereglerpositionen sind wieder stabil.
State.onValueChangeFinished
wird wieder zu einem Wert.onValueChangeFinished
in einenrememberUpdatedState
einschließen (I82ab2, b/322269951) - Für die Navigationskomponenten werden jetzt die neuen
SurfaceContainer
-Rollen verwendet.DrawerDefaults
bietet jetzt separatestandardContainerColor
- undmodalContainerColor
-Attribute.DrawerDefaults.ModalDrawerElevation
heißt jetzt0.dp
. (I7fbac) @Stable
wird aus den Status vonSlider
entfernt, da wirstate.onValueChangeFinished
invar
ändern. (Ied34a, b/322269951)- Die
ModalBottomSheet
- undStandardBottomSheet
-Animationsspezifikation ist jetzt eineTweenSpec
, die aus einer federnden Animation aktualisiert wurde. Dadurch wird ein Problem mit einem sichtbaren Überlauf behoben. Die veraltetenSheetState
-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“ undTonalElevation
berechnet wurde, werden jetzt standardmäßigSurfaceContainer
-Rollen verwendet, die nicht von der Tonhöhenänderung betroffen sind. (b/304584161)- Ein Fehler wurde behoben, durch den die nicht ausgewählte, deaktivierte Containerfarbe von
ElevatedFilterChip
schwarz war. (I400e6, b/322407043) - Fehler bei der unbestimmten Fortschrittsanzeige bei 0 % behoben (Id6582)
- Ein Problem mit
Slider
undRangeSlider
im linksläufigen Layout wurde behoben (Iab0e1) SliderRangeTolerance
für die Berechnung des Schiebereglerbereichs hinzufügen, da die Rundung von Gleitkommazahlen ungenau sein kann. (Ic918a, b/324934900)- Achten Sie darauf, dass die Schaltflächen des
DatePickerDialog
angezeigt werden, wenn Sie einDateRangePicker
verschachteln oder eine beliebige Art von Datumsauswahl auf kleinen Bildschirmen mit größeren Schriftarten anzeigen. (Ie4758, b/325107799, b/277768544) Menu
nutzt jetzt die RolleSurfaceContainer
für die Containerfarbe.MenuDefaults.TonalElevation
heißt jetzt0.dp
. (I135b7)TextField
nutzt jetzt die RolleSurfaceContainerHighest
für die Containerfarbe. (I4dced)- Für erhöhte Chips wird jetzt die Rolle
SurfaceContainerLow
(I7cd2f) verwendet. - Die Containerfarbe von
DatePicker
ist jetztSurfaceContainerHigh
.DatePickerDefaults.TonalElevation
heißt jetzt0.dp
. (Ida753) - Die Farbe des Containers und des Ziehpunkts für untere Infofelder wurde aktualisiert. (I72a0a)
- Die Containerfarbe von
RichTooltip
ist jetztSurfaceContainer
. (Ia8b45) - Die Containerfarbe von
SearchBar
ist jetztSurfaceContainerHighest
.SearchBarDefaults.TonalElevation
heißt jetzt0.dp
. (I88604) - Deaktivierte und nicht ausgewählte Tracks/Symbole werden aktualisiert, um die Farbrolle
SurfaceContainerHighest
zu nutzen. (I7687a) - Die Containerfarbe von
AlertDialog
ist jetztSurfaceContainerHigh
. (Ie0433) - Die Containerfarbe von
BottomAppBar
ist jetztSurfaceContainer
. Die Farbe vonTopAppBar
onScroll
ist jetztSurfaceContainer
. (I41630) - Die Containerfarbe von
ElevatedCard
ist jetztSurfaceContainerLow
.FilledCard
hat die ContainerfarbeSurfaceContainerHighest
. (I35141) - Die Containerfarbe von
ElevatedButton
ist jetztSurfaceContainerLow
. Nicht ausgewählteFilledIconButton
haben jetzt die ContainerfarbeSurfaceContainerHighest
. (I792c9) - Die Rolle der
TimePicker
-Farbe des Containers und der Zifferblattfarbe der Uhr wird aufSurfaceContainerHighest
aktualisiert. (I43b93)
Version 1.3.0-alpha01
21. Februar 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
wird veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.
Neue Funktionen
- Aktualisierung von Compose M3
ModalBottomSheet
zur Unterstützung der Vorhersagefunktion für Rückwärtssuche bei U+ (Iccf32, b/281967264, b/304850357) - Compose M3
SearchBar
wurde aktualisiert, um die intelligente „Zurück“-Geste auf U+ zu unterstützen (I657f8) - Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Haltestellenanzeige hinzugefügt. (I3058e)
ProgressIndicator
wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Haltestellenanzeige hinzugefügt. (I21451)- Durch das Hinzufügen eines Standard-Cursors für die erweiterte Kurzinfo kann mit der neuen API für erweiterte Kurzinfos jetzt ein benutzerdefinierter Cursor für den Anker
LayoutCoordinates
gezeichnet werden. (Ifd42c)
Verhaltensänderungen
- Materialkomponenten wurden auf die neuen Ripple APIs umgestellt und
RippleTheme
wird nicht mehr abgefragt.
API-Änderungen
drawStopIndicator
ist jetzt öffentlich. (I3f59f)- Markieren Sie die
formatWithSkeleton
-Funktion derDatePicker
als intern (Ic65dc). DropdownMenu
unterstützt jetzt benutzerdefinierte Farbe, Form, Höhe und Rahmen. (I8e981, b/289554448, b/301887035, b/283654243)- Material 3-Komponenten, die in ihrer API eine
MutableInteractionSource
bereitstellen, wurden aktualisiert. Sie stellen jetzt eine nullableMutableInteractionSource
bereit, die standardmäßig aufnull
gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dieMutableInteractionSource
nicht hochladen. Sie wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie zu „null“ wechseln, wird für einige Komponenten nie eineMutableInteractionSource
zugewiesen. Andere Komponenten können dann nur bei Bedarf eine Instanz erstellen, was die Leistung dieser Komponenten insgesamt verbessert. Wenn du denMutableInteractionSource
, den du an diese Komponenten weitergibst, nicht verwendest, solltest du stattdessen „null“ übergeben. Wir empfehlen Ihnen außerdem, ähnliche Änderungen an Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146) - Hiermit werden
RippleConfiguration
undLocalRippleConfiguration
hinzugefügt, um Wellenmuster pro Komponente / untergeordnetem Baum mithilfe fester Werte anzupassen. So können Sie beispielsweise die Farbe einer Komponente ändern, die Sie nicht steuern, oder eine Wellenbewegung für eine Komponente deaktivieren. In den meisten Fällen sollten die Standardwerte verwendet werden. Diese APIs sind eine Notlösung für die Anpassung einzelner Komponenten oder begrenzter untergeordneter Bäume. Für umfassendere Änderungen und benutzerdefinierte Designsysteme sollten Sie stattdessen mitcreateRippleModifierNode
eine eigene Welle erstellen. (I7b5d6, b/298048146) - Es wird eine neue Ripple API in material3 hinzugefügt, die die verworfene
rememberRipple
ersetzt. Außerdem wird eine temporäreCompositionLocal
,LocalUseFallbackRippleImplementation
hinzugefügt, um Material 3-Komponenten wieder auf die veraltetenrememberRipple
-/RippleTheme
-APIs umzustellen. Diese Funktion wird in der nächsten stabilen Version entfernt. Sie dient nur als vorübergehende Migrationshilfe für Fälle, in denen Sie eine benutzerdefinierteRippleTheme
bereitstellen. (I34cbc, b/298048146)
Fehlerkorrekturen
- Unterkomposition in
ModalBottomSheet
entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei demModalBottomSheet
in bestimmten Szenarien in Kombination mitLookaheadScope
abstürzen konnte. (I2a198) - Unterkomposition in
BottomSheetScaffold
entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei demBottomSheetScaffold
in bestimmten Szenarien in Kombination mitLookaheadScope
abstürzte. (Ie6401) - Die Ausrichtung des Logos wird so angepasst, dass es im Vergleich zur rechten oberen Ecke näher am Mittelpunkt des Ankerinhalts liegt. (I18a28)
- Behebung eines A11Y-Problems mit der
DateRangePicker
, bei dem der Texttitel „Monat-Jahr“ für Screenreader, Switch Access und Voice Access-Nutzer als ausführbar übermittelt wurde. (I2ac55) - Fehler bei der Reihenfolge der Parameter
mediumTopAppBarColors
behoben. (Ibe64a)
Version 1.2
Version 1.2.1
6. März 2024
androidx.compose.material3:material3-*:1.2.1
wird veröffentlicht. Version 1.2.1 enthält diese Commits.
Fehlerkorrekturen
- Die Schiebereglerstatus wieder stabil machen
State.onValueChangeFinished
wird wieder zu einem Wert.onValueChangeFinished
in einenrememberUpdatedState
einschließen (Ie8fd0, b/322269951) @Stable
wird aus den Status vonSlider
entfernt, da wirstate.onValueChangeFinished
invar
ändern. (I82ba1, b/322269951)NavigationBar
Benutzerdefinierte Farben, die aus den Standardfarben kopiert werden sollen, korrigieren (80a779, b/326894020)- Regression in
ExposedDropdownMenu
behoben, damit es wieder fokussiert werden kann (3fcec1, b/323694447) - Problem mit dem Caching der Schaltflächenfarbe behoben (3e5bbcb/327371655)
Version 1.2.0
7. Februar 2024
androidx.compose.material3:material3-*:1.2.0
wird veröffentlicht. Version 1.2.0 enthält diese Commits.
Bekanntes Problem
- In
PrimaryTabRow
wurde im Rahmen einer Leistungsverbesserung ein Fehler beim Interop-Rendering von View-Compose eingeführt. Verwenden Sie als ProblemumgehungTabRow
mitTabRowDefaults.PrimaryIndicator
.
Wichtige Änderungen seit Version 1.1.0
Neue Material Design 3-Komponenten
- Zum Aktualisieren nach unten ziehen
- Segmentierte Schaltfläche
Verbesserungen an vorhandenen Material Design 3-Komponenten
- Untere App-Leiste (linksläufige Ausrichtung, automatisches Ausblenden beim Scrollen)
- Visuelle Aktualisierung von Tabs
- Logo (Ausrichtung aktualisiert)
Experimentelle APIs wurden zu stabilen APIs aufgewertet.
Leistungsverbesserungen
- Weitere Informationen findest du in diesem Blogpost.
Version 1.2.0-rc01
24. Januar 2024
androidx.compose.material3:material3-*:1.2.0-rc01
wird veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Fehler bei der Reihenfolge der Parameter
mediumTopAppBarColors
behoben. (Ibe64a) - Ein Fehler wurde behoben, der in
1.2.0-beta02
inCardDefaults.cardColors
aufgetreten ist und durch dencontentColor
nicht anhand descontainerColor
-Param-Werts aktualisiert wurde. (Iee041, b/319671246) - Ein in
1.2.0-beta02
eingeführter Fehler indisabledContentColor
wurde behoben und eine kleine Optimierung wurde hinzugefügt. (I6dda1, b/318428829)
Version 1.2.0-beta02
10. Januar 2024
androidx.compose.material3:material3-*:1.2.0-beta02
wird veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.
Bekannter Fehler
- Aufgrund eines Fehlers in
IconButtonColors
wirddisabledContentColor
standardmäßig einem Alphawert (0,38f) vonLocalContentColor
zugewiesen, anstatt dem vom Nutzer angegebenencontentColor
. Das Problem lässt sich dadurch umgehen, dass SiedisabledContentColor
explizit festlegen. Dieses Problem wird in der nächsten Version behoben.
API-Änderungen
- Es ist jetzt möglich, Kursivschrift für
Tooltip
-APIs zu aktivieren. (Ibf767) SwipeToDismissState
,rememberSwipeToDismiss
undSwipeToDismissValue
werden in_SwipeToDismissBox_
umbenannt. (I68d6d)
Fehlerkorrekturen
- Der Wert für das Ende des
ListItem
-Abstands wurde an die Spezifikation angepasst. (Ibd68b, b/305342674) - Die Umrissfarbe für Karten mit Umriss wird jetzt korrekt
OutlineVariant
zugeordnet. (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
ModalBottomSheet
-Rückgabe wurde unter Android T/13 und höher korrigiert, wennandroid:enableOnBackInvokedCallback="true"
. (I728dc, b/306196110)
Version 1.2.0-beta01
13. Dezember 2023
androidx.compose.material3:material3-*:1.2.0-beta01
wird veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.
API-Änderungen
TabIndicatorScope
als experimentell markieren (I45c88)- Entfernen von veralteten experimentellen APIs aus der Kurzinfo (I438cb)
- Ändern Sie neue
TabRow
-Überladungen so, dass keine Unterkompositionen verwendet werden. Dadurch können dieTabRow
-Indikatoren mit benutzerdefinierten Modifikatoren erstellt werden. (Ife741) - Einstellung der
DismissDirection
- undDismissValue
-APIs Diese wurden zuSwipeToDismissValue
zusammengeführt, dessen Werte sowohl die Position als auch die Richtung vonSwipeToDismissBox
angeben.DismissState.progress
ist jetzt alsFloatRange
zwischen0.0
und1.0
markiert. Der verworfeneDismissState
-Speicher und ‑Konstruktor wurden entfernt. Die Komponente „SwipeToDismiss
“, das Statusobjekt und das Standardobjekt wurden als experimentell gekennzeichnet. (Ib54f2)
Fehlerkorrekturen
- Der Standardindikator für
PullToRefresh
ist jetzt ein offener Pfeil statt eines durchgezogenen Dreiecks. (I67be3)
Version 1.2.0-alpha12
29. November 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
wird veröffentlicht. Version 1.2.0-alpha12 enthält diese Commits.
API-Änderungen
- Für
RangeSlider
kann jetzt ein Kotlin-Bereich verwendet werden (z.B.0f..1f
) anstelle einer benutzerdefiniertenFloatRange
-Wertklasse.SnapFlingBehavior.kt
verwendet jetzt auch einen Kotlin-Bereich. (I025cb) - Markieren Sie die werkseitigen Funktionen für Modifikatoren als
@Stable
. (Ib109f)
Version 1.2.0-alpha11
15. November 2023
androidx.compose.material3:material3-*:1.2.0-alpha11
wird veröffentlicht. Version 1.2.0-alpha11 enthält diese Commits.
Neue Funktionen
- Implementiert
PullToRefreshContainer
undPullToRefreshState
, die zusammen eine Pull-to-Refresh-Implementierung in Material3 bieten. (I16456, b/261760718)
API-Änderungen
- Markieren Sie
SwipeToDismissBox
,DismissDirection
undDismissValue
als experimentell. (I517b0) - Benennen Sie
SwipeToDismiss
inSwipeToDismissBox
um. Benennen Siebackground
inbackgroundContent
unddismissContent
incontent
lambda um. (I7f4d3) - Machen Sie den Konstruktor für
ChipElevation
undSelectableChipElevation
öffentlich. (Ie0c48, b/308432421) ModalBottomSheetProperties
wird hinzugefügt.securePolicy
wird inModalBottomSheetProperties
verschoben.isFocusable
undshouldDismissOnBackPress
werden zuModalBottomSheetProperties
hinzugefügt. Mit diesen neuen Booleschen Werten lässt sich festlegen, wie modale Unterbrechungen IME-Ereignisse verarbeiten sollen. (Iea56f, b/278216859)- Die Status
RangeSlider
undSlider
wurden aktualisiert, uminitialOnValueChange
, die ursprünglichen Präfixe und die entsprechenden KDocs zu entfernen. (I57d30) - Die Klasse
ChipBorder
und die zugehörigen Funktionsaufrufe werden eingestellt. Wir empfehlen stattdessen die direkte Verwendung vonBorderStroke
. (I89cc2) - Die Foundation Tooltip APIs sind jetzt
@ExperimentalFoundationApi
. (I30b0b) TabRow
undScrollableTabRow
sind nicht mehr eingestellt. Die neuen primären und sekundären Varianten sind als experimentell gekennzeichnet. (I0def6)- Filter- und Eingabe-Chips verwenden jetzt direkt
BorderStroke
. (I07a8d) SegmentedButton
verwendet jetztBorderStroke
direkt. (I89b9b)- Die generische Funktion
AlertDialog
wurde inBasicAlertDialog
umbenannt und die vorherige Funktion eingestellt. (Idbe52) - Benenne die
SwipeToDismiss
-APIs inSwipeDismiss
um und setze die neuenSwipeDismiss
-APIs auf „stabil“. (I14cbe) tonalElevation
undshadowElevation
wurden den API-Tooltips hinzugefügt. Außerdem wurden die APIsTooltipBox
,PlainTooltip
undRichTooltip
wieder in den experimentellen Status versetzt, da sie versehentlich als stabil veröffentlicht wurden. (If0f66, b/293939035)- Die experimentellen Chip-APIs werden zu stabilen APIs. (Iea2c3)
- Die Anmerkung
@ExperimentalMaterial3Api
wurde aus den anklickbaren Karten in Material 3 entfernt. (I88dbf)
Fehlerkorrekturen
- Ein Problem wurde behoben, durch das
SwipeToDismiss
in bestimmten Szenarien mit verschachtelten Lookahead- und Lazy-Layouts abstürzte. (Ica8d1, b/297226562)
Version 1.2.0-alpha10
18. Oktober 2023
androidx.compose.material3:material3-*:1.2.0-alpha10
wird veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.
API-Änderungen
Badge
undBadgedBox
werden zur stabilen Version hochgestuft. (I67f16, b/261565132)securePolicy
wird als Parameter zuModalBottomSheet
hinzugefügt, damit Nutzer das Verhalten fürWindowManager.LayoutParams.FLAG_SECURE
definieren können. (Icdac8, b/296250262)- Es wurden neue Überladungen von
LinearProgressIndicator
undCircularProgressIndicator
hinzugefügt, dieprogress
als Lambda-Funktion annehmen. Diese sollten eine bessere Leistung als die vorherigen Versionen bieten. (I824e6, b/295616656) StandardSizeClasses
wird inAllSizeClasses
umbenannt. (I8cb07)- Berechnungsfunktionen von Klassen für Fenstergrößen kombinieren (Iad935)
Fehlerkorrekturen
- Behebung eines Absturzes von
DatePicker
, wenn schnell auf die Navigationspfeile geklickt wird, während der angezeigte Monat am Rand des zulässigen Jahresbereichs liegt. (I46f36, b/290954897, b/297002119) - [Navigationsleiste] Unterstützung für transparente Farbe für den Indikator. (Ie0a9b, b/267289987)
Version 1.2.0-alpha09
4. Oktober 2023
androidx.compose.material3:material3-*:1.2.0-alpha09
wird veröffentlicht. Version 1.2.0-alpha09 enthält diese Commits.
API-Änderungen
ModalNavigationDrawer
undDismissibleNavigationDrawer
wurden auf die neuenAnchoredDraggable
APIs umgestellt. DasanimateTo
vonDrawerState
wurde durch die Methoden „open“ und „close“ ersetzt. Der Offset wird jetzt als Float statt als Statusobjekt angezeigt. Sie können direkt übercurrentOffset
auf den Versatz zugreifen. (I0a72c)- Es wurden nicht zusammensetzbare Funktionen hinzugefügt, mit denen
DatePickerState
undDateRangePickerState
direkt erstellt werden können. Diese Funktionen können bei Bedarf als Alternative zu den zusammensetzbaren FunktionenrememberDatePickerState
undrememberDateRangePickerState
verwendet werden. (I70326, b/291524052) - Für feste und scrollbare
TabRows
gibt es jetzt primäre und sekundäre Varianten. Sie entsprechen dem in Material3 definierten Farb- und Indikatorverhalten. PrimaryScrollableTabRow
undSecondaryScrollableTabRow
geben jetzt den Scrollstatus an. (Iec8f5, b/260572337)- Es wurde ein neuer Parameter
sheetMaxWidth
hinzugefügt, mit dem Entwickler die maximale Breite des Tabellenblatts festlegen können. Wenn Sie ein Tabellenblatt benötigen, das die gesamte Bildschirmbreite einnimmt, können Sie „Dp.Unspecified“ für den Parameter übergeben. (Ifb7c9, b/266697696) - Die APIs
PlainTooltipBox
undRichTooltipBox
werden als nicht mehr unterstützte Methoden wieder hinzugefügt. (I246fa)
Fehlerkorrekturen
- Ein Absturz wurde behoben, der beim Initialisieren von
DatePicker
mit einerDatePickerFormatter
aufgetreten ist, die bestimmte Datums-Grundmuster enthält, die bei der Umwandlung in Datumsmuster (z. B. JJ) unverändert bleiben. (I01f29)
Version 1.2.0-alpha08
20. September 2023
androidx.compose.material3:material3-*:1.2.0-alpha08
wird veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.
Funktionsgefährdende Änderung
ColorScheme
ist jetzt unveränderlich. Das macht einzelne Farbaktualisierungen weniger effizient, aber die gängige Verwendung von Farben effizienter. Der Grund für diese Änderung ist, dass in den meisten Apps das Aktualisieren einzelner Farben nicht der Hauptanwendungsfall ist. Das ist weiterhin möglich, aber es wird häufiger neu zusammengesetzt als zuvor. Dadurch reduzieren wir die Anzahl der Statusabonnements im gesamten Material-Code erheblich und wirken sich auf die Initialisierungs- und Laufzeitkosten bei Standardanwendungsfällen aus. (Ic447d, b/297212873)- Die Tonhöhenänderung wird nicht mehr in verschiedenen Interaktionsstatus animiert, um der Spezifikation zu entsprechen. (Icdd12)
API-Änderungen
- Es wurde eine neue
BottomAppBar
hinzugefügt, die als Parameter eineBottomAppBarScrollBehavior
annimmt, um sie automatisch auszublenden, wenn Inhalte gescrollt werden. Außerdem wurdeFabPosition.EndOverlay
hinzugefügt, damit das FAB die untere App-Leiste im Scaffold überlagern kann, anstatt darüber verankert zu sein. (Iecb47) - Es wurde eine einfache Labelkomponente hinzugefügt, die auf
BasicTooltipBox
basiert und nicht geschlossen wird, wenn außerhalb des Labels getippt wird. (I821f9)
Fehlerkorrekturen
- Die Verwendung von
rememberSaveable
für Kurzinfos wurde entfernt. (Icc131, b/299500338) - Einführung eines temporären Flags, mit dem festgelegt werden kann, ob die untergeordneten Elemente von Scaffold während der Messung oder während des Platzierens gemessen werden sollen. Standardmäßig wird dies in „Messung“ gemessen. Wenn Sie Probleme mit dem neuen Verhalten haben, reichen Sie bitte ein Problem ein. (I0b354)
- In
BottomSheet
wurde das horizontale Edge-to-Edge-Format korrigiert, indem die richtige Messung für die Gerätebildschirmbreite verwendet wurde. (I1df0c, b/299058752) - Ein Fehler wurde behoben, durch den
ModalBottomSheet
nicht aufgerufen wurde, wennonDismissedRequest
durch Wischen nach unten auf dem Tabellenblatt geschlossen wurde. (Idfdd8)
Version 1.2.0-alpha07
6. September 2023
androidx.compose.material3:material3-*:1.2.0-alpha07
wird veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.
Neue Funktionen
- In
compose material 1.6.0-alpha05
wurde die Unterstützung für automatisch gespiegelte Symbole hinzugefügt. Weitere Informationen finden Sie in den Release-Notes.
API-Änderungen
SliderState
implementiertDraggableState
(I9b116)- Ändern Sie „shape“ in einen erforderlichen Parameter. Benennen Sie
position
in der Hilfsfunktion für Formen inindex
um. (I34941) - Die
DatePicker
formatWithSkeleton
wird um eine Karte aktualisiert, die als Cache für Leistungsverbesserungen verwendet wird. (I3195f) BasicTooltipBox
wurde zucompose.foundation
hinzugefügt undPlainTooltipBox
undRichTooltipBox
wurden aktualisiert, damitTooltipBox
mit den neuenPlainTooltip
- undRichTooltip
-Kompositen verwendet werden kann. (I79e1d)
Fehlerkorrekturen
dynamicLightColorScheme
unddynamicDarkColorScheme
geben jetzt für Oberflächen- undsurfaceContainer
-Rollen Farben mit höherer Chroma zurück. (I5e901)- Ein Problem wurde behoben, bei dem einige Komponenten mit einer untergeordneten Komposition (z.B.
BottomSheetScaffold
) in einem Scaffold in einemLookaheadScope
versuchten, ihre Größe zu früh zu lesen. (I297b4, I871f1, b/295536718)
Version 1.2.0-alpha06
23. August 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
wird veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Die Berechnung von
DropdownMenu
wurde korrigiert, sodass die X-Achsenverschiebungen nur noch von der lokalen Layoutrichtung abhängen. Die Y-Achsenverschiebungen werden nicht mehr umgekehrt, wenn sich das Menü unten auf dem Bildschirm befindet.offset
(Iccc74, b/294103942) - Die Berechnung von
DropdownMenu
wurde korrigiert, sodass die X-Achsenverschiebungen nur noch von der lokalen Layoutrichtung abhängen. Die Y-Achsenverschiebungen werden nicht mehr umgekehrt, wenn sich das Menü unten auf dem Bildschirm befindet.offset
(Ib87a2, b/294103942)
Version 1.2.0-alpha05
9. August 2023
androidx.compose.material3:material3-*:1.2.0-alpha05
wird veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.
API-Änderungen
- Aktualisierte Farben für Kästchen und
TriStateCheckbox
DieCheckboxDefaults.colors()
disabledUncheckedColor
wirkt sich jetzt nur noch auf den Rahmen des Kästchens aus. In Sonderfällen, in denen die Farbe des inneren Felds festgelegt werden muss, wenn es deaktiviert und nicht angeklickt ist, ist eine benutzerdefinierte Instanz vonCheckboxColors
mit den gewünschten Farbwerten erforderlich. (I77d17, b/291943198)
Version 1.2.0-alpha04
26. Juli 2023
androidx.compose.material3:material3-*:1.2.0-alpha04
wird veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.
Neue Funktionen
- Experimentelle Segmented Button API (Ifc8fb)
- Trennlinien haben jetzt einen Parameter, mit dem die Ausrichtung gesteuert werden kann, um vertikale Trennlinien zu unterstützen. (I4c899, b/288438593)
API-Änderungen
- Wir verlagern die Abhängigkeit von der Dichte auf Komponentenebene. Dies gilt für die folgenden Komponenten:
SwipeToDismiss
und tabellenbasierte Komponenten. Verwenden Sie die neue Überladung, bei der die Dichte ein Parameter ist. (I1846e) - Zusätzliche Anmerkungen, um zulässige Eingaben für Composeables anzugeben (Ief234)
- Fügen Sie der segmentierten Schaltfläche einen Symbolparameter hinzu und teilen Sie die Semantik auf, damit segmentierte Schaltflächen mit
SelectableSegmentedButtonRow
bzw.ToggelableSegmentedButtonRow
ausgewählt werden können, um eine Einzelauswahl bzw. eine Mehrfachauswahl zu implementieren. (I38740) - Die Trennlinie wurde in
HorizontalDivider
umbenannt.VerticalDivider
-Funktionen hinzugefügt (I5975c) - Ersetzen Sie in den experimentellen Material3 APIs
ClosedFloatingPointRange
durch das leichtereFloatRange
, um das automatische Boxen zu minimieren. (I4aab5) - Neue Startausrichtung für
FabPosition
hinzugefügt (Ib7aea, b/170592777)
Fehlerkorrekturen
ModalBottomSheet
berücksichtigt die lokale Layoutrichtung. (Ib4f44, b/285628622)
Version 1.2.0-alpha03
21. Juni 2023
androidx.compose.material3:material3-*:1.2.0-alpha03
wird veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.
Verhaltensänderungen
includeFontPadding
ist in der Material 3-Typografie jetzt standardmäßigfalse
. Der Standardstil für die Zeilenhöhe wurde ebenfalls inTrim.None
undAlignment.Center
geändert. DenTextStyle
s vonTypography
wurden explizitelineHeight
(in sp) hinzugefügt. Wenn du diese Werte anpassen möchtest, findest du in der API-Dokumentation entsprechende Informationen. Im Blogpost werden diese Änderungen ausführlich erläutert. (I6266f, Icabc3)
Neue Funktionen
- Es wurde eine Überladung für
RangeSlider
hinzugefügt, die eine zustandsabhängige Version der Komponente ist.RangeSliderState
erstellt, die alle Informationen für den aktuell aktiven Titel, die Maße der Komponenten derRangeSlider
und die Logik für Ziehen und Gesten enthält (I8c270) - Die Suchleiste unterstützt jetzt Schatten über den neu hinzugefügten Parameter
shadowElevation
. (Ia5369, b/271040353) ColorScheme
unterstützt jetzt neueSurfaceContainer
-Rollen.- Das Overlay für die Oberflächenhöhe kann jetzt lokal in der Komposition
LocalTonalElevationEnabled
deaktiviert werden. (Ic203c, b/277774590)
API-Änderungen
- Öffnen Sie die Konstruktoren für Komponentenfarben. (I8c4a6)
- Den beiden Tooltip-APIs wurde der Parameter „focusable“ hinzugefügt, damit Entwickler festlegen können, ob Touch-Ereignisse vom Tooltip erfasst werden sollen oder nicht. Beachten Sie, dass dies die automatische Fokusübergabe für Barrierefreiheit beeinträchtigen kann. (Ie32d8)
- Optimierte Zugänglichkeit für Leistung und Speicherzuweisung. (Iede48)
DefaultSizeClasses
freigeben undStandardSizeClasses
fürWindowSizeClasses
erstellen (I91838)WindowWidth/HeightSizeClass
in Gleitkommawertklassen ändern (Ie686e)
Fehlerkorrekturen
- Der Parameter
contentWindowInsets
von Scaffold berücksichtigt jetzt die genutzten Fensterausschnitte. Das Verhalten des Inhaltsabstands, der auftopBar
undbottomBar
basiert, bleibt 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 dargestellt wird. (I4369f, b/236994621)
- Für Tab-Positionen gilt jetzt eine Mindestinhaltsbreite von 24 dp. Dadurch wird ein barrierefreies Touch-Ziel für Tab-Indikatoren bereitgestellt. (Id8861)
- Dynamische Farbpaletten von
dynamicLightColorScheme
unddynamicDarkColorScheme
unterstützen jetzt neue Oberflächenrollen. (I1252e) - Die Ausrichtung der Benachrichtigungssymbole wurde aktualisiert, damit sie nicht abgeschnitten werden, wenn sie mit dem übergeordneten Element kollidieren. (Idf75a)
Version 1.2.0-alpha02
24. Mai 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
wird veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
API-Änderungen
- Fügen Sie
ModalBottomSheet
den Parameter „Fenster-Einzüge“ hinzu.- Der Scrim für
ModalBottomSheet
kann jetzt hinter der Statusleiste gezeichnet werden, wennwindowInsets
auf null gesetzt ist. - Die Standardfunktion von
ModalBottomSheet
wurde aktualisiert, damit sie außerhalb der Systemleisten bleibt, einschließlich der Navigation. - Die Statusleiste kann im Vollbildmodus über einen Ziehpunkt minimiert werden.
BottomSheetDefaults
enthält Fenstereinzüge fürBottomSheetWindow
. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- Der Scrim für
Indicator
wird eingestellt undPrimary
/SecondaryIndicator
wird hinzugefügt, um den M3-Spezifikationen zu entsprechen.PrimaryIndicator
entspricht der Breite des Inhalts des Tabs, währendSecondaryIndicator
die gesamte verfügbare Breite einnimmt.SecondaryIndicator
entspricht der jetzt eingestelltenIndicator
und kann direkt ersetzt werden. (I27604)- Es wurde eine Option hinzugefügt, um beim Erstellen einer
DropdownMenu
oderExposedDropdownMenu
eineScrollState
zu übergeben, um den vertikalen Scrollstatus der angezeigten Menüpunkte zu steuern. (Ia0734, b/185304441) - Es wurde eine Überladung für
Slider
hinzugefügt, die eine zustandsabhängige Version der Komponente ist.SliderState
erstellt, die alle Informationen für den aktuell aktiven Titel, die Maße der Komponenten derSlider
und die Logik für Ziehen und Gesten enthält (I124a5) - Die Eigenschaft „Semantik“
isContainer
inisTraversalGroup
umbenannt (I121f6) - Optimierte
TextStyle.merge(...)
mit vollständiger Parameterliste hinzugefügt. (Iad234, b/246961787) TooltipState
,RichTooltipState
undPlainTooltipState
wurden zu öffentlichen Schnittstellen.RichTooltipStateImpl
undPlainTooltipStateImpl
wurden als Standardstatus hinzugefügt. Es wurdenremember*State
-Funktionen hinzugefügt, um diese implementierten Status abzurufen.TooltipSync
wurde durchTooltipDefault.GlobalMutatorMutex
ersetzt. (I7813d)- Die
DatePickerColors
wurde um zusätzliche Anpassungsoptionen für die Farben der Trennlinie, Navigation und Textfelder der Datumsauswahl erweitert. (I1a685, b/274626815) DatePickerState
undDateRangePickerState
sind jetzt öffentliche Schnittstellen mit Standardimplementierungen, die überrememberDatePickerState
undrememberDateRangePickerState
abgerufen werden können. (I71c52)- Die
dateValidator
wurde ausDatePicker
undDateRangePicker
entfernt und durch eineSelectableDates
-Benutzeroberfläche ersetzt, die für den Status festgelegt werden kann, um festzulegen, welche Datumsangaben oder Jahre in der Benutzeroberfläche ausgewählt werden können. (Ic2fc6) TimePicker
wurde aus der stabilen API entfernt. Weitere Änderungen an der Status-API sind zu erwarten (I3f39a)ModalBottomSheet
wurde auf Android umgestellt.ModalBottomSheet
wird für die Nutzung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv gepflegt. (Ib3778)
Fehlerkorrekturen
- Die
AlertDialog
-Schaltfläche zum Schließen wird jetzt unter der Bestätigungsschaltfläche angezeigt, wenn die Aktionen übereinander gestapelt werden, um in die Breite des Dialogfelds zu passen. Durch diese Korrektur wird die Implementierung an die Material Design-Spezifikation angepasst. (I029de, b/235454277) - Fehler in
ListItem
behoben, bei dem für Elemente mit drei Zeilen ein falsches Abstandselement verwendet wurde. (I6e235) ModalBottomSheet
kann jetzt die IME-Tastatur anzeigen (Idc508, b/262140644, b/268380384, b/272483584)
Version 1.2.0-alpha01
10. Mai 2023
androidx.compose.material3:material3:1.2.0-alpha01
und androidx.compose.material3:material3-window-size-class:1.2.0-alpha01
werden freigegeben. Version 1.2.0-alpha01 enthält diese Commits.
Version 1.1
Version 1.1.2
20. September 2023
androidx.compose.material3:material3:1.1.2
und androidx.compose.material3:material3-window-size-class:1.1.2
werden freigegeben. Version 1.1.2 enthält diese Commits.
Fehlerkorrekturen
- Der Fehler wurde behoben, dass ein Modifikator fälschlicherweise an zwei Elemente übergeben wurde. (b/282761472)
- Bei der Initialisierung mit 23 Stunden gibt die feste
TimePickerState
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)
- Fehler behoben, durch den
state.hour
für 23:00 Uhr einen falschen Wert zurückgab. (b/282761472, b/278242122)
Version 1.1.1
21. Juni 2023
androidx.compose.material3:material3:1.1.1
und androidx.compose.material3:material3-window-size-class:1.1.1
werden freigegeben. Version 1.1.1 enthält diese Commits.
Fehlerkorrekturen
- Ruft
ModalBottomSheet
ohnewindowInset
-Parameter für die Binärkompatibilität auf. (Ib7959) - Fügen Sie
ModalBottomSheet
den Parameter „Fenster-Einzüge“ hinzu.- Der Scrim für
ModalBottomSheet
kann jetzt hinter der Statusleiste gezeichnet werden, wennwindowInsets
auf null gesetzt ist. - Die Standardfunktion von
ModalBottomSheet
wurde aktualisiert, damit sie außerhalb der Systemleisten bleibt, einschließlich der Navigation. - Die Statusleiste kann im Vollbildmodus über einen Ziehpunkt minimiert werden.
BottomSheetDefaults
enthält Fenstereinzüge 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
werden freigegeben. Version 1.1.0 enthält diese Commits.
Wichtige Funktionen von 1.1.0
Neue Material Design 3-Komponenten
Verbesserungen an vorhandenen Material Design 3-Komponenten
Experimentelle APIs wurden zu stabilen APIs aufgewertet.
Weitere Informationen findest du in diesem Blogpost.
Version 1.1.0-rc01
19. April 2023
androidx.compose.material3:material3:1.1.0-rc01
und androidx.compose.material3:material3-window-size-class:1.1.0-rc01
werden freigegeben. Version 1.1.0-rc01 enthält diese Commits.
API-Änderungen
TimePicker
wurde aus der stabilen API entfernt. Weitere Änderungen an der Status-API sind zu erwarten (I3f39a)ModalBottomSheet
wurde auf Android umgestellt.ModalBottomSheet
wird für die Nutzung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv gepflegt. (Ib3778)
Version 1.1.0-beta02
5. April 2023
androidx.compose.material3:material3:1.1.0-beta02
und androidx.compose.material3:material3-window-size-class:1.1.0-beta02
werden freigegeben. Version 1.1.0-beta02 enthält diese Commits.
API-Änderungen
SheetState
hat jetzt den optionalen ParameterskipHiddenState
rememberStandardBottomSheetState
hat jetzt den optionalen ParameterskipHiddenState
BottomSheetScaffold
hat jetzt einen definierten verborgenen Anker, der standardmäßig deaktiviert ist.SheetState.requireOffset
Dokumentation wurde aktualisiertBottomSheetDefaults.MinimizedShape
wurde inBottomSheetDefaults.HiddenShape
umbenannt (I839f4, b/273870234)
Fehlerkorrekturen
- Wechseln Sie das Zifferblatt nicht von den Stunden zu den Minuten, wenn die Funktion „Tippen & Entdecken“ aktiviert ist. (I717d0)
- Die Drag-Handle-Semantik von
ModalBottomSheet
undBottomSheetScaffold
wurde zusammengeführt. (I05afb) - Die Parameter
BottomSheetScaffold
-Modifikator,containerColor
undcontentColor
wirken sich jetzt nur noch auf Inhalte aus. (I992cb) - Für
BottomSheetScaffold nestedScroll
für Tabelleninhalte werden jetzt Wischaktionen implementiert. (I992cb)
Version 1.1.0-beta01
22. März 2023
androidx.compose.material3:material3:1.1.0-beta01
und androidx.compose.material3:material3-window-size-class:1.1.0-beta01
werden freigegeben. Version 1.1.0-beta01 enthält diese Commits.
API-Änderungen
- Dem
TimePicker
-Kompositelement den Parameter „Layouttyp“ hinzufügen Es ermöglicht die Verwendung verschiedener Layouts je nach Bildschirmkonfiguration (Ia0e16) SearchBarDefaults
wurde als experimentell gekennzeichnet. (I65561)- Schattenhöhe für
BottomSheetScaffold
(I94e0f) hinzugefügt - Unterstützung für die Anzeige der Datumsauswahl ohne Kopfzeile hinzugefügt API-Änderungen, durch die beim Erstellen einer Datumsauswahl eine leere Überschrift übergeben werden kann. Sie können jetzt „null“ für Anzeigentitel, Titel und
showToggleMode = false
übergeben, um eine headless-Auswahl anzuzeigen. (Id3f3a, b/266132421, b/267194809)
Fehlerkorrekturen
- Der Fokus wird bei Suchleisten jetzt automatisch aufgehoben, wenn sie inaktiv sind. (I22a7c, b/261444487)
- Die
DateRangePicker
wurde aktualisiert, sodass ein Zeitraum mit demselben Datum für Start und Ende ausgewählt werden kann. (I16529, b/272882497) - In Textfeldern werden Textelemente jetzt richtig positioniert, wenn die Schriftgröße kleiner als erwartet ist. Je nach Schriftart und Schriftschnitt kann es zu einer Änderung von einigen Pixeln in Ihren Apps kommen. (I8b8d0)
- Semantische Aktionen im unteren Bereich haben jetzt Labels. (I277b0)
Version 1.1.0-alpha08
8. März 2023
androidx.compose.material3:material3:1.1.0-alpha08
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha08
werden freigegeben. Version 1.1.0-alpha08 enthält diese Commits.
Neue Funktionen
- Unterstützung für
BottomSheetScaffold
undBottomSheetScaffoldState
hinzugefügt. (I063d4)
API-Änderungen
- Die Funktionen von
DatePickerState
undDateRangePickerState
wurden erweitert, damit Datumsangaben auch nach dem Erstellen des Status festgelegt werden können. Außerdem können Auswahlen durch Festlegen von Nullzeitstempeln zurückgesetzt werden. Das manuelle Festlegen von Datumsangaben sollte mit Vorsicht erfolgen. Die neue FunktionsetSelection
wirft eine Ausnahme aus, wenn ein angegebenes Datum nicht die Vorbedingungen erfüllt (siehe Dokumentation). (Ifa645, b/268609314, b/270427389) - Benennen Sie „Zusammengefaltet“
SheetValue
inPartiallyExpanded
um, um das Verhalten in diesem Status genauer und flexibler darzustellen. (Ia1491) - Die Parameternamen von
ListItem
wurden in _content statt _text geändert. Standard-Getter sind jetztReadOnlyComposables
, sofern zutreffend. (I69a25) - Interaktive Surface APIs werden nicht mehr als experimentell eingestuft. (I90d59, b/261561812)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem der Status
HalfExpanded
vonModalBottomSheet
falsch berechnet wurde und das Tabellenblatt so erschien, als würde es schweben. (I45e84, b/268411386) - Füge ein Häkchen für
confirmValueChange
zum Tippen auf den Scribble fürModalBottomSheet
hinzu. (I2311a, b/270425759) - Verschieben Sie semantische
BottomSheet
-Aktionen zum Ziehpunkt. (I158ba) ModalBottomSheet
-Befehle konzentrieren sich jetzt auf die Ausführung und verarbeiten die Zurück-Schaltfläche. (I4d2ab)ModalBottomSheet onDismissRequest
wird jetzt auch bei verschachtelten Scroll-Wischaktionen verarbeitet. (I655c5, b/268433166)
Version 1.1.0-alpha07
22. Februar 2023
androidx.compose.material3:material3:1.1.0-alpha07
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha07
werden freigegeben. Version 1.1.0-alpha07 enthält diese Commits.
Neue Funktionen
- Fügen Sie ein Zeiteingabe-Composeable hinzu, das mit
rememberTimePickerState()
funktioniert und der M3-Spezifikation für die Zeiteingabe (Ia4fab) entspricht. - Die Material 3
DateRangePicker
API wurde hinzugefügt, um einen Zeitraum auszuwählen. (I7a6c3, b/267194809) - Unterstützung für den Material 3-Eingabemodus zur Auswahl von Zeitraum über die
DateRangePicker
API hinzugefügt. (Ifdbc4) - Die Farben von Textfeldern können jetzt angepasst werden:
- Die Farben des Eingabefelds und des Platzhaltertexts richten sich nach dem Fokus und dem Fehlerstatus. Der Parameter
textColor
wurde inunfocusedTextColor
umbenannt undplaceholderColor
inunfocusedPlaceholderColor
. - Die Containerfarbe für ausgefüllte Textfelder basierend auf dem Fehlerstatus mit dem neuen Parameter
errorContainerColor
.
- Die Farben des Eingabefelds und des Platzhaltertexts richten sich nach dem Fokus und dem Fehlerstatus. Der Parameter
- Die Textfeldfarben der angezeigten Drop-down-Menüs wurden um Parameter zur Unterstützung der neuen Prefix- und Suffix-API aktualisiert. (I9c8b4, b/254284181, b/264766350)
API-Änderungen
- Einige Slider API-Versionen wurden rückgängig gemacht und redundante Slider-Überladungen entfernt, die vom neuen experimentellen Slider mit benutzerdefiniertem Schieberegler und Track abgedeckt werden.
RangeSlider
wird als stabil eingestuft. (Ie8fbd) defaultElevation
wurde in den Höhenfunktionen des Chips inelevation
umbenannt. (I0f872)- Die folgenden APIs für Material 3-Textfelder sind nicht mehr experimentell:
TextField
,OutlinedTextField
,textFieldWithLabelPadding
,textFieldWithoutLabelPadding
undoutlinedTextFieldPadding
. (Ieb5c0, b/261561819) TimePickers
is24Hour
verwendet die Systemeinstellung (I18856)- Die experimentelle Anmerkung wurde aus den Scaffold-APIs entfernt. (Ibb51e, b/261565765, b/261436953)
Fehlerkorrekturen
- Die Standardform von
ModalBottomSheet
ist jetzt immerSheetDefaults.ExpandedShape
. (I0dfca) - Verbesserungen bei der Barrierefreiheit für Material 3
DatePicker
undDateRangePicker
(I5087e) - Fehler behoben, durch den die Einschränkung der maximalen Höhe weitergegeben wurde und es zu Abstürzen kommen konnte. (I30d8c)
- Semantische Rollen wurden von anklickbaren und auswählbaren Oberflächen entfernt. Komponenten, in denen sie verwendet wurden, um Rollen mit „modifier.semantics“ festzulegen, wurden aktualisiert (I793d9)
Version 1.1.0-alpha06
8. Februar 2023
androidx.compose.material3:material3:1.1.0-alpha06
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha06
werden freigegeben. Version 1.1.0-alpha06 enthält diese Commits.
Neue Funktionen
- Textfelder unterstützen jetzt Präfix- und Suffixtext (Ia8578, b/179884561)
- Die Funktion
TimePicker
wurde hinzugefügt, um eine Zeitauswahl gemäß der Material 3-Spezifikation anzuzeigen. Sie wird in Verbindung mitTimePickerState
und der Convenience-MethoderememberTimePickerState
verwendet (I71910) - Die Datumseingabe ist jetzt ein Anzeigemodus in
DatePicker
. Es wurde die Möglichkeit hinzugefügt, zwischen Datumsauswahl und Datumseingabe zu wechseln. (Ieeff7) - API für
RichTextTooltips
hinzugefügt. (I58ef3) - Implementierung eines modalen Blatts am unteren Rand für Material 3, einschließlich
ModalBottomSheet
undModalBottomSheetDefaults
. Außerdem werdenSheetState
undrememberSheetState
eingeführt, die für zukünftige Tabellenkomponenten verwendet werden können. (I0853a, b/244189383)
API-Änderungen
- Stabilisierung der API
showSnackbar
(I195c2, b/261424370) - APIs für Assistenz- und Vorschlagschip stabilisieren (Ibb67b, b/261424370)
- Die
ListItem
-,ListItemDefaults
- undListItemColors
-API sind nicht mehr experimentell (I7e7fa, b/261438882) SliderPositions
,SliderDefaults.Thumb
undSliderDefaults.Track
wurden zur stabilen Version hochgestuft und es wurden nicht experimentelleSlider
- undRangeSlider
-APIs hinzugefügt, die benutzerdefinierte Vorschaubilder und Tracks enthalten. Außerdem werden die bisherigen APIsSlider
undRangeSlider
eingestellt. (Ie5ea6, b/261566890)Modifier.tooltipAnchor()
wurde öffentlich gemacht, damit Entwickler es an den Anker übergeben können, um anzugeben, dass eine Kurzinfo bei langem Drücken angezeigt werden soll. DiePlainTooltipBox
API wurde aktualisiert.TooltipState
ist jetzt nicht mehr null zulässig und hat einen Standardwert. (Ie2fb7)ProgressIndicatorDefaults.circularTrackColor
wurde aus Gründen der Einheitlichkeit als@Composable
markiert. (Id29cc)- Property-Getter
LocalMinimuTouchTargetEnforcement
wiederhergestellt, als eingestellt markiert und aufLocalMinimumInteractiveComponentEnforcement
umgeleitet (I60dd5)
Version 1.1.0-alpha05
26. Januar 2023
androidx.compose.material3:material3:1.1.0-alpha05
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha05
werden freigegeben. Version 1.1.0-alpha05 enthält diese Commits.
Neue Funktionen
DatePickerDialog
und Unterstützung für Bedienungshilfen- Benutzerdefiniertes Vorschaubild und Track zu
RangeSlider
hinzugefügt.
Abhängigkeitsupdates
Compose UI
undCompose Material
sind 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
werden freigegeben. Version 1.1.0-alpha04 enthält diese Commits.
Neue Funktionen
- Erste
DatePicker
API zur Auswahl eines einzelnen Datums über eine Kalender-UI. Diese API wird derzeit noch geändert. (I722b9) - Unterstützung für einfache Kurzinfos über
PlainTooltipBox
hinzugefügt. (I0cdfb) - Suchleiste (Iad128)
SwipeToDismiss
(I458a8, b/242889540)
API-Änderungen
- Die
IsContainer
-Semantik-Property wurde auf Oberflächen hinzugefügt. Diese Property wird bei einer späteren Änderung verwendet, bei der die Durchlaufreihenfolge basierend auf der semantischen Bedeutung von Elementen wie Oberflächen bestimmt wird. (I63379) - Markieren Sie APIs für die Navigationsleiste als stabil. (Iab01e, b/261439597)
- Es wurde ein Parameter für die Farbe des Tracks für kreisförmige Fortschrittsanzeigen und ein Parameter für den Endpunkt des Strichs für kreisförmige und lineare Fortschrittsanzeigen hinzugefügt. (Ie668c, b/216325962, b/222964817)
- Mehr Informationen zur Nullbarkeit des Rückgabetyps von eingestellten und ausgeblendeten Funktionen (Ibf7b0)
- Fügen Sie
Modifier.minimumInteractiveComponentSize
hinzu. Damit kann eine Größe von mindestens 48 dp reserviert werden, um Touch-Interaktionen zu unterscheiden, wenn das Element kleiner wäre. (I33f58, b/258495559) - Es wurde eine experimentelle API für
AlertDialog
-Kompositionen mit einem Inhalts-Slot hinzugefügt. (Iec4a2)
Fehlerkorrekturen
- Der Fortschritt von Fortschrittsanzeigen ist jetzt korrekt auf den erwarteten Bereich begrenzt. (I8a7eb, b/262262727)
Bekanntes Problem
- Beim Aktualisieren von
androidx.compose.foundation:1.4.0-alpha03
aufandroidx.compose.foundation:1.4.0-alpha04
kann der Fehlerjava.lang.NoSuchFieldError
auftreten. Hier wurde das Problem ursprünglich gemeldet. Eine Lösung wurde eingereicht und ist im nächsten Update für Compose 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 Ihreandroidx.compose.foundation
auf 1.4.0-alpha03 downgraden.
Version 1.1.0-alpha03
7. Dezember 2022
androidx.compose.material3:material3:1.1.0-alpha03
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
werden freigegeben. Version 1.1.0-alpha03 enthält diese Commits.
API-Änderungen
consumedWindowInsets()
wurde inconsumeWindowInsets()
undwithConsumedWindowInsets()
inonConsumedWindowInsetsChanged()
umbenannt und die Modifikatoren wurden veröffentlicht. (Ie44e1)- Fügen Sie Textschaltflächen mit Symbolen ein neues Standardabstand für den Inhalt hinzu. (I8f662)
- Es wurden deaktivierte Farben für die Navigationsleiste und den Navigationspfad hinzugefügt. (Ia7892, b/258867034)
- Eine Modifier API zum Abfragen von Informationen zum Scrollen von Vorfahren hinzugefügt. (I2ba9d, b/203141462)
- Wird in
Clickable
verwendet, um die Interaktionen mit dem Drücken richtig zu verzögern, wenn Touch-Gesten zu Scrollereignissen werden könnten. - Bei Verwendung in einem
Scrollable ViewGroup
wurden beiClickables
keine korrekten Verzögerungen für Wellen erzeugt. Dieses Problem wurde behoben. - In Ausklappern und Ansichten werden Tastendrücke jetzt korrekt verzögert, falls Touch-Gesten zu Scrollereignissen führen können.
Abhängigkeitsupdates
Compose UI
undCompose Material
sind jetzt vom Lebenszyklus 2.5.1 abhängig. (I05ab0, b/258038814)
Version 1.1.0-alpha02
9. November 2022
androidx.compose.material3:material3:1.1.0-alpha02
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
werden freigegeben. Version 1.1.0-alpha02 enthält diese Commits.
API-Änderungen
- Für mehr Flexibilität können jetzt auch
PointerEventPass
-Zeichen inawaitFirstDown
undwaitForUpOrCancellation
verwendet werden. Außerdem wird dadurch behoben, dass beiExposedDropdownMenuBox
beim Scrollen ein Menü angezeigt wird. (I7579a, b/212091796) - Dem Material- und Material3-Text wurden die Parameter
minLines
,TextField
undOutlinedTextField
hinzugefügt, mit denen die minimale Höhe der Komponente in Bezug auf die Anzahl der Zeilen festgelegt werden kann (I4af1d) - Die Funktion
TopAppBarDefaults smallTopAppBarColors
wird zugunsten einer neuen FunktiontopAppBarColors
eingestellt, die beim Erstellen einerTopAppBar
verwendet werden sollte. (Ie6cb9) - Den Parametern
BasicText
undBasicTextField
wurde der ParameterminLines
hinzugefügt. Damit lässt sich die Mindesthöhe dieser Composeables in Bezug auf die Anzahl der Zeilen festlegen (I24294, b/122476634)
Fehlerkorrekturen
- Schneiden Sie den Inhalt von Material3
IconButton
undIconToggleBotton
an die Form der Statusebene der Komponente zu (z.B. kreisförmig). (I9da8f) - Die oberen App-Leisten von Material3 Medium und Large wurden aktualisiert, damit sie dieselbe Hintergrundfarbe auf der gesamten Oberfläche haben und die Standardfarben durch transparente Farbwerte überschrieben werden können. (I67659, b/249688556, b/250838918)
Version 1.1.0-alpha01
24. Oktober 2022
androidx.compose.material3:material3:1.1.0-alpha01
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
werden freigegeben. Version 1.1.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Der Titel wird an der oberen App-Leiste fixiert, wenn er mit einem TextStyle und einem Pinsel angewendet wird. (If667e)
Version 1.0
Version 1.0.1
9. November 2022
androidx.compose.material3:material3:1.0.1
und androidx.compose.material3:material3-window-size-class:1.0.1
werden freigegeben. Version 1.0.1 enthält diese Commits.
Fehlerkorrekturen
- Die oberen App-Leisten von Material3 Medium und Large wurden aktualisiert, damit die gleiche Hintergrundfarbe auf die gesamte Oberfläche angewendet wird und die Standardfarben durch transparente Farbwerte überschrieben werden können. (I67659, b/249688556, b/250838918)
Version 1.0.0
24. Oktober 2022
androidx.compose.material3:material3:1.0.0
und androidx.compose.material3:material3-window-size-class:1.0.0
werden freigegeben. Version 1.0.0 enthält diese Commits.
Wichtige Funktionen von 1.0.0
Dies ist die erste stabile Version von Compose Material 3.
Material Design 3-Designthemen und dynamische Material You-Farben
Material Design 3-Komponenten
- Abzeichen
- Untere App-Leiste
- Schaltflächen
- Floating Action Button und erweiterter Floating Action Button
- Infokarten
- Kästchen
- Chips
- Dialoge
- Trennlinie
- Drop-down-Menü
- Liste
- Navigationsleiste
- Navigationsleiste
- Navigationsleiste
- Fortschrittsanzeige
- Optionsfeld
- Schieberegler
- Wechsel
- Tabs
- Textfelder
- Obere App-Leiste
- Symbol
- Text
- Oberfläche
- Layout
- Inhaltsfarbe
Fenstergrößenklasse
material3-window-size-class
ist eine neue Bibliothek, die Fenstergrößenklassen unterstützt: eine Reihe von Ansichtsbereichen, anhand derer Sie anpassbare Anwendungslayouts entwerfen, entwickeln und testen können. MitcalculateWindowSizeClass
können Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche angezeigt werden soll, z. B. eine Navigationsleiste anstelle der Navigationsleiste unten bei größeren Fenstergrößen. Weitere Informationen und Anwendungsbeispiele finden Sie in der API-Referenzdokumentation fürWindowSizeClass
.Weitere Informationen findest du in diesem Blogpost.
Version 1.0.0-rc01
5. Oktober 2022
androidx.compose.material3:material3:1.0.0-rc01
und androidx.compose.material3:material3-window-size-class:1.0.0-rc01
werden freigegeben. Version 1.0.0-rc01 enthält diese Commits.
API-Änderungen
- Slotparameter für die Unterstützung der Text-zu-Textfeld-API hinzugefügt (Iaac0d, b/227146125)
Version 1.0.0-beta03
21. September 2022
androidx.compose.material3:material3:1.0.0-beta03
und androidx.compose.material3:material3-window-size-class:1.0.0-beta03
werden freigegeben. Version 1.0.0-beta03 enthält diese Commits.
API-Änderungen
ExposedDropdownMenuDefaults
gibt jetzt einen Abstandswert für Menüpunkte an. (I34ee1)ExposedDropdownMenuBoxScope
hat jetzt einenModifier.menuAnchor()
-Modifikator, der für die korrekte Barrierefreiheit an das Textfeld übergeben werden sollte. (I27fa3)- Es wurden zwei überladene Methoden für die aktuelle Slider API hinzugefügt, mit denen Nutzer einen Schieberegler oder einen Track übergeben können, um den Schieberegler zu füllen. (I21c00)
Fehlerkorrekturen
- Die Farbzuordnung für den On Error-Container im dunklen Design wurde auf Ton 90 (Ic5612) aktualisiert.
- Es kann jetzt ein transparenter Hintergrund für kleine Material 3-App-Leisten oben festgelegt werden. (I645e2, b/245575782)
Version 1.0.0-beta02
7. September 2022
androidx.compose.material3:material3:1.0.0-beta02
und androidx.compose.material3:material3-window-size-class:1.0.0-beta02
werden freigegeben. Version 1.0.0-beta02 enthält diese Commits.
API-Änderungen
- Die in der Betaversion 01 in m3-Komponenten eingeführten Standardkomponenteneinzüge berücksichtigen keine IME-Einzüge mehr.
- Die Material3-Scaffold-Komponente hat jetzt einen Parameter
contentWindowInsets
, mit dem die Anzahl der Einzüge für den Inhalts-Slot angegeben werden kann. (Icf11a, b/243713323) - Die experimentelle Material 3-Funktion
SmallTopAppBar
wird eingestellt und durch eine entsprechendeTopAppBar
-Funktion ersetzt. Bitte migrieren Sie Ihre Nutzung auf das neue Konto. (I74404, b/226918634) - Es gibt jetzt mehr Möglichkeiten, das Verhalten der oberen App-Leiste beim Wischen und Anpinnen zu steuern. (I15c81)
- Entfernt „startIndent“ aus „Divider“ und verschiebt die Farbe zum letzten Parameter. (If7be2)
Fehlerkorrekturen
- Sie können Dialogfelder für TalkBack-Nutzer identifizieren, indem Sie das Wort „Dialogfeld“ ansagen, wenn sie angezeigt werden. (I857ef)
Version 1.0.0-beta01
24. August 2022
androidx.compose.material3:material3:1.0.0-beta01
und androidx.compose.material3:material3-window-size-class:1.0.0-beta01
werden freigegeben. Version 1.0.0-beta01 enthält diese Commits.
API-Referenz
Die neuesten verfügbaren Designs, Komponenten und anderen Composeable-Elemente finden Sie in der Übersicht der Compose Material 3 API-Referenz.
API-Änderungen
- Die obere App-Leiste in Material 3 wurde aktualisiert, damit sie sich vollständig minimieren und maximieren lässt. Außerdem wurde die
TopAppBarDefaults
-Verhaltensfunktion zu Composables aktualisiert und es wurden Standardwerte für den Status der oberen App-Leiste und die Animationsspezifikation festgelegt. (I642b3) - Die Signaturen der FAB-Komponenten wurden an die Surface API angepasst (I3afaa).
- Integrierte Unterstützung für Einblendungen in oberen App-Leisten, Navigationsleisten, Navigationsbereichen und Navigationsleisten. Wenn diese Komponenten separat oder mit Scaffold verwendet werden, werden Einzüge für Entwickler automatisch verarbeitet. Hinweis: Durch diese Änderung werden die Statusleistensymbole nicht automatisch verarbeitet und die Status- und Navigationsleisten bleiben nicht transparent. Bitte machen Sie das weiterhin manuell, um die beste Bildqualität zu erhalten. (I7e4e6, b/183161866)
- Die Standardeinstellungen für Komponenten wurden aktualisiert, um die API-Oberfläche zu reduzieren und so für mehr Flexibilität und Leistungsverbesserungen in Zukunft zu sorgen. (I31820)
- Die Parameter für Chip- und Navigationsleistenblätter wurden neu angeordnet, um für Einheitlichkeit in der API zu sorgen (I45d0b)
startIndent
wurde aus „Divider“ entfernt und „color“ wurde zum letzten Parameter gemacht.(If7be2)
Version 1.0.0-alpha16
10. August 2022
androidx.compose.material3:material3:1.0.0-alpha16
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
werden freigegeben. 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 Tab-Parameter für das vorangestellte Symbol neu anordnen, um für Einheitlichkeit in der API zu sorgen (Ie2637)
BadgeDefaults
als experimentell gekennzeichnet (I98ef3)- Die eingestellte Navigationsleiste wurde entfernt. (I4f2db)
- Schiebereglerparameter in Material 3 neu anordnen, um für Einheitlichkeit in der API zu sorgen (I0aee7)
- Die Parameter
NavigationBar
undNavigationRail
neu anordnen, um für Konsistenz innerhalb der API zu sorgen (I51cda) - Ordnen Sie die Parameter in Material 3 neu an, um für Einheitlichkeit in der API zu sorgen. (If4ae1)
- Schiebereglerparameter in Material 3 neu anordnen, um für Einheitlichkeit in der API zu sorgen (I62673)
- Der Parameter „icons“ wurde in „actions“ umbenannt, um mit der oberen App-Leiste übereinzustimmen (Id75be)
- Markieren Sie
Badge
undBadgedBox
als experimentell, da die Ausrichtung der Anker noch nicht endgültig festgelegt ist. (I1712e, b/236524516) @ExperimentalMaterial3Api
-Hinweise für Symbolschaltflächenvarianten in@OptIn
ändern (I070b5)- Der Inhalt der Navigationsleiste wurde in ein eigenes Composeable-Element verschoben, um eine benutzerdefinierte Breite festlegen zu können. (Ia7f10)
- Entfernt
Divider
ausMenuDefaults
undTabDefaults
(I4e33c)
Version 1.0.0-alpha15
27. Juli 2022
androidx.compose.material3:material3:1.0.0-alpha15
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
werden freigegeben. Version 1.0.0-alpha15 enthält diese Commits.
Neue Funktionen
- Es soll möglich sein, die obere App-Leiste an der Leiste selbst zu ziehen. (I65c00, b/205873416)
API-Änderungen
- Die
FilterChip
- undElevatedFilterChip
-APIs wurden aktualisiert, um denselectedIcon
-Steckplatz zu entfernen und die Wiederverwendung vonleadingIcon
für die Anzeige eines ausgewählten Status zu fördern. (Ie5dc2) - Rollen für die Farben von skurillen Elementen und Umrissen hinzufügen (Id6d54)
- Namenskonventionen für zusammensetzbare Standardeinstellungen korrigieren (I62b27)
- Markieren Sie
ListItemDefaults
undListItemColors
als experimentell. (I1f3ec) - Änderungen an der API der oberen App-Leiste, um die Bedeutung ihrer Statuseigenschaften besser widerzuspiegeln. Markieren Sie außerdem die API für die obere App-Leiste als experimentell. (Ic0ad8)
- Für eine bessere Auffindbarkeit wurden
TextFieldColors
jetzt Farben für die Textauswahl hinzugefügt. (Iba1b8) ButtonDefault.ButtonWithIconContentPadding
für Schaltflächen mit Symbol hinzufügen (I2bf9c)- Textfelder wurden als experimentell gekennzeichnet, um bei zukünftigen API-Änderungen mehr Flexibilität zu ermöglichen. (I127b5)
- Die Anmerkung
@ExperimentalMaterial3Api
wurde aus der FunktionCheckbox
entfernt. (I5eefc) - Die Anmerkung
@ExperimentalMaterial3Api
wurde aus der FunktionRadioButton
entfernt. (I17e2a) - Die Anmerkung
@ExperimentalMaterial3Api
wurde aus den nicht interaktiven Karten entfernt. (I9bd49) - Verschiedene Standardobjekte für Komponenten wurden um Farben, Formen usw. ergänzt (I96e11)
Fehlerkorrekturen
- Nicht funktionierende nachgestellte Symbole wurden aus Eingabechip-Beispielen entfernt, um Verwirrung bei Nutzern in der Katalog-App zu vermeiden. (I9846a)
Version 1.0.0-alpha14
29. Juni 2022
androidx.compose.material3:material3:1.0.0-alpha14
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
werden freigegeben. Version 1.0.0-alpha14 enthält diese Commits.
Neue Funktionen
- M3-Listenimplementierung hinzugefügt. Beispielnutzung in der Dokumentation (Id7a20)
API-Änderungen
- Ändern Sie den Parameternamen von „values“ in „value“ in
RangeSlider
(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
BottomAppBar
hinzufügen (Ida4c8) ColorScheme.surfaceColorAtElevation
wurde hinzugefügt (Id41af)- Schnittstellen in Compose-Bibliotheken werden jetzt mit den Standardschnittstellenmethoden von JDK 8 erstellt (I5bcf1)
WindowWidthSizeClass
undWindowHeightSizeClass
implementieren jetzt „Vergleichbar“, sodass sie mithilfe von Operatoren (<, <=, >=, >) und anderen APIs verglichen werden können. (I747d0)
Fehlerkorrekturen
- Beispiel für das Gütesiegel aktualisieren, um eine aussagekräftigere Inhaltsbeschreibung zu liefern (I10b9d)
- In der Material 3-Katalog-Designauswahl gibt es jetzt die Option, die Systemschriftgröße zu verwenden. (I10605)
- Beispielcode für Logos und unbestimmte Fortschrittsanzeigen hinzugefügt (I8fbe0)
Version 1.0.0-alpha13
1. Juni 2022
androidx.compose.material3:material3:1.0.0-alpha13
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
werden freigegeben. Version 1.0.0-alpha13 enthält diese Commits.
API-Änderungen
- Die Position der App-Leiste oben wird bei Konfigurationsänderungen beibehalten. (I10459, b/216160958)
Version 1.0.0-alpha12
18. Mai 2022
androidx.compose.material3:material3:1.0.0-alpha12
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
werden freigegeben. Version 1.0.0-alpha12 enthält diese Commits.
Fehlerkorrekturen
- Das übergeordnete Element des Schiebereglers kann jetzt eine Breite von 0 px haben. (b/231707291)
Version 1.0.0-alpha11
11. Mai 2022
androidx.compose.material3:material3:1.0.0-alpha11
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
werden freigegeben. Version 1.0.0-alpha11 enthält diese Commits.
Neue Funktionen
RangeSlider
zu Material 3 (I18e38) hinzugefügt- Unterstützung für Material3-
AssistChip
undInputChip
hinzugefügt (I0d25a) - Unterstützung für Material3-
FilterChip
undSuggestionChip
hinzugefügt (I9fdf3)
API-Änderungen
- Das
TextFieldDefaults.BorderStroke
-Element, das inOutlinedTextField
einen Rahmenstrich zeichnet, wurde inTextFieldDefaults.BorderBox
umbenannt. (I5f295) - Visuelle Änderungen bei m3-Übergängen (Iab30e)
- Es ist möglich, Farben an die Standardsymbolschaltflächen zu übergeben. (Ia2445)
Fehlerkorrekturen
- Fügen Sie material3/Scaffold eine Lint-Prüfung hinzu, um sicherzustellen, dass das innere Padding verwendet wird (I72293, b/226951418)
Version 1.0.0-alpha10
20. April 2022
androidx.compose.material3:material3:1.0.0-alpha10
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
werden freigegeben. Version 1.0.0-alpha10 enthält diese Commits.
Neue Funktionen
material3-window-size-class
ist eine neue Bibliothek, die Fenstergrößenklassen unterstützt: eine Reihe von Ansichtsbereichen, anhand derer Sie anpassbare Anwendungslayouts entwerfen, entwickeln und testen können. MitcalculateWindowSizeClass
können Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche angezeigt werden soll, z. B. eine Navigationsleiste anstelle der Navigationsleiste unten bei größeren Fenstergrößen. Weitere Informationen und Anwendungsbeispiele finden Sie in der API-Referenzdokumentation zuWindowSizeClass
. Weitere Informationen zu Definitionen von Fenstergrößenklassen finden Sie in der öffentlichen Anleitung zur Unterstützung verschiedener Bildschirmgrößen.
API-Änderungen
- Fügen Sie die Standard-UAS-Ebene für
BottomAppBar
hinzu und entfernen Sie das abschließende Lambda vonBottomAppBar
mit UAS. (I92c47) - Fügen Sie „Material3“
FilledIconButton
,FilledTonalIconButton
undOutlinedIconButton
hinzu. (Ib2bda) - Die Material 3-Snackbar-API wurde aktualisiert, sodass Farbwerte für die optionale Aktion und die Schließaktion akzeptiert werden. (Ibe4b4)
- Der teilweise Verbrauch (nach unten ODER Position) wurde in
PointerInputChange
eingestellt. Mitconsume()
können Sie die Änderung vollständig übernehmen. MitisConsumed
kannst du feststellen, ob jemand anderes die Änderung bereits verwendet hat. PointerInputChange::copy()
erstellt jetzt immer eine flache Kopie. Das bedeutet, dass Kopien vonPointerInputChange
verbraucht werden, sobald eine der Kopien verbraucht wurde. Wenn Sie eine nicht gebundenePointerInputChange
erstellen möchten, verwenden Sie stattdessen den Konstruktor. (Ie6be4, b/225669674)- Änderungen an der Cards API, um die Container- und Inhaltsfarben über eine
CardColors
-Oberfläche zu empfangen und einen deaktivierten Status für anklickbare Karten zu unterstützen. (I927df) - Der Parameter
backgroundColor
wurde in den Textfeldern von Material 3 incontainerColor
umbenannt, um für mehr Einheitlichkeit mit anderen Komponenten zu sorgen. (I6fbd9)
Fehlerkorrekturen
- Aktualisierungen am Standard
IconButton
, um ihn an die Material3-Spezifikation anzupassen (I09eab) - Verschieben Sie die Höhe der oberen Leiste des Material 3-Scaffolds in den Abstand, der an den Inhalt übergeben wird, damit die Inhalte unter der oberen App-Leiste gerendert werden. Wenn die
PaddingValues
ignoriert werden, werden die Inhalte möglicherweise von der oberen Leiste verdeckt. (I83cbc, b/217776202)
Version 1.0.0-alpha09
6. April 2022
androidx.compose.material3:material3:1.0.0-alpha09
wird veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
Neue Funktionen
- Material 3 Switch API (I2c3ad) hinzugefügt
API-Änderungen
- Unterstützung für Drop-down-Menüs mit Textfeldern (auch „offene Drop-down-Menüs“ oder „Kombinationsfelder“ genannt) hinzugefügt. (I1b832)
- Dem MaterialTheme- und Shape-Subsystem wurde der Parameter „shape“ hinzugefügt. (I37426)
ExtendedFloatingActionButton
wurde ein Parameter hinzugefügt, mit dem Sie festlegen können, ob die FAB maximiert oder minimiert ist, und mit Animationen zwischen den einzelnen Status. Es wurde eine zusätzliche Option für erweiterte FABs mit nachgestelltem Text für erweiterte FABs ohne Symbol hinzugefügt. (Iba7f1)
Version 1.0.0-alpha08
23. März 2022
androidx.compose.material3:material3:1.0.0-alpha08
wird veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
- Unterstützung für Textfelder in Material 3 hinzugefügt. (I795cc, b/199377790)
API-Änderungen
- Standardtrennlinie für das Menü hinzufügen (I01374)
- Der Klasse
ColorScheme
wurde der FarbparametersurfaceTint
hinzugefügt. (I2f558)
Fehlerkorrekturen
- Fixieren Sie die Material3-Schaltfläche, um den Standardwert für den Textstil aus dem MaterialTheme zu lesen. (Ie62fc)
Version 1.0.0-alpha07
9. März 2022
androidx.compose.material3:material3:1.0.0-alpha07
wird veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
- Die Material 3 Surface API wurde aktualisiert. Die überladenen Funktionen für anklickbare Oberflächen wurden wieder eingeführt und es wurde eine Funktion hinzugefügt, die abwählbare und ausblendbare Oberflächen unterstützt. (I4bf18)
LazyVerticalGrid
undLazyHorizontalGrid
sind jetzt stabil. (I307c0)LazyVerticalGrid/LazyHorizontalGrid
und alle zugehörigen APIs wurden in das Unterpaket „.grid“ verschoben. Bitte aktualisieren Sie Ihre Importe von androidx.compose.foundation.lazy auf androidx.compose.foundation.lazy.grid. (I2d446)- Die vorherige Änderung, bei der nur eine Ansicht für
WindowInsetsControllerCompat
verwendet wurde, wurde rückgängig gemacht. Es ist wieder ein Fenster erforderlich, das zum Verwalten einiger Fensterflaggen benötigt wird.ViewCompat.getWindowInsetsController
wurde zugunsten vonWindowCompat.getInsetsController
eingestellt, damit das richtige Fenster verwendet wird, z. B. wenn sich die Ansicht in einem Dialogfeld befindet. (I660ae, b/219572936) - Neue
LazyVerticalGrid
API zum Definieren von Größen für Achsenkreuze hinzugefügt (I17723)
Fehlerkorrekturen
- Updates an der Card API, um Änderungen an der Surface API (I3c8b9) zu berücksichtigen
Version 1.0.0-alpha06
23. Februar 2022
androidx.compose.material3:material3:1.0.0-alpha06
wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
NavigationDrawerItem
wird hinzugefügt, das ein einzelnes Ziel innerhalb der Schubladen darstellt (Ic396f, b/218286829)PermanentNavigationDrawer
undDismissibleNavigationDrawer
wurden als experimentelle APIs hinzugefügt. Diese Schubladen eignen sich gut für Geräte mit großem Bildschirm. (I5f8ab, b/218286829)- Unterstützung für die untere App-Leiste in Material 3 hinzugefügt (Ic432a)
NavigationDrawer
wurde inModalNavigationDrawer
umbenannt (I1807d, b/218286829)- Material 3-Schiebereglerklasse und -Tokens hinzugefügt (I1ccee)
- Tab-Implementierung hinzugefügt, siehe Dokumentation für Beispielnutzung (Ie0146)
Fehlerkorrekturen
- Ein Problem wurde behoben, durch das bei der linearen Navigation des Screenreaders
TalkBack
ein leerer Titel in der oberen App-Leiste ausgewählt wurde. (Id4690) IconSize
wurde zuFloatingActionButtonDefaults
hinzugefügt. (Ia71cf)- Fehlerbehebung für ausgeblendete
AlertDialog
-Schaltflächen, wenn ein langer Text mit einerLazyColumn
hinzugefügt wird. (Ib2cc9, b/216663029)
Version 1.0.0-alpha05
9. Februar 2022
androidx.compose.material3:material3:1.0.0-alpha05
wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
Material Design 3-Komponenten hinzugefügt
- Drop-down-Menü
- Infokarten
API-Änderungen
- Die eingestellte
Surface
-Funktion, die einen onClick-Callback annimmt. Klickbare Oberflächen sollten mit einemInteractionSource
und einemModifier.clickable()
erstellt werden. (I211c6) - Unterstützung für die Erhöhung von FABs bei gedrücktem und fokussiertem Zustand hinzugefügt. (Ibb584)
- Die
Surface
API wurde so geändert, dass sie eine Interaktionsquelle empfängt, mit der sich die Darstellung in verschiedenen Status steuern lässt. (Iafbc8)
Fehlerkorrekturen
- Es wurden fehlende tertiäre Farben in dynamischen Farbschemata hinzugefügt (I456c4, b/214588434)
Version 1.0.0-alpha04
26. Januar 2022
androidx.compose.material3:material3:1.0.0-alpha04
wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
NonRestartableComposable
wurde Methoden hinzugefügt, die Überladungen vorhandener Methoden ohne komplexe Logik sind. Dadurch werden vom Compiler generierte Memoisierungsüberprüfungen (Gleichungen) für alle Parameter reduziert, die in der aufgerufenen inneren Funktion wiederholt werden. (I90490)- Material 3-Trennlinie hinzugefügt. (Ica5fc)
- Markieren Sie das Kästchen und das Optionsfeld mit einer Anmerkung zur experimentellen API. (Ie44bb)
- Unterstützung für Material 3-Fortschrittsanzeigen hinzugefügt. (Iff232, b/205023841)
Fehlerkorrekturen
- Farbe eines deaktivierten
TextButton's
-Containers in „Transparent“ ändern (I6b248, b/213339737)
Version 1.0.0-alpha03
12. Januar 2022
androidx.compose.material3:material3:1.0.0-alpha03
wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Fügen Sie
LocalIndication
zuMaterialTheme
von Material 3 hinzu. (I7ce4e) - Korrektur des Eckradius für Kästchen (I38b03, b/175198975, b/202309440)
Abhängigkeitsupdates
- Jetzt abhängig von Kotlin
1.6.10
.
Version 1.0.0-alpha02
1. Dezember 2021
androidx.compose.material3:material3:1.0.0-alpha02
wird veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- Unterstützung für Kästchen und Optionsschaltflächen hinzufügen
- Aktualisiert für die Kompatibilität mit Kotlin
1.6.0
API-Änderungen
- Entfernen Sie den Auszug aus dem Scaffolding von Material 3. (I04f51)
- Unterstützung für Material 3
Checkbox
(Id5542) - Unterstützung für Material 3
RadioButton
(I20334)
Fehlerkorrekturen
- Reduzieren Sie den Radius der
IconButton
-Welle von 40 dp auf 20 dp. (I68bbe, b/206674345) - Schnellpfad für Portstrings für
Text
ändert sich voncompose.material
(I30b03) - Problem behoben, aber die hartcodierte Schaltfläche ist immer aktiviert. (Iea832, b/205335456)
Version 1.0.0-alpha01
27. Oktober 2021
androidx.compose.material3:material3:1.0.0-alpha01
wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Material Design 3-Designthemen und dynamische Material You-Farben
Material Design 3-Komponenten
- Schaltflächen
- Floating Action Button und erweiterter Floating Action Button
- Dialoge
- Navigationsleiste
- Navigationsleiste
- Navigationsleiste
- Obere App-Leiste
- Abzeichen
- Symbol
- Text
- Oberfläche
- Layout
- Inhaltsfarbe
Weitere Informationen finden Sie im Abschnitt Material Design 3 und Material You im Leitfaden für Material-Design-Designthemen in Compose.