Compose Material 3
Letzte Aktualisierung | Stabile Version | Releasekandidat | Beta-Ausgabe | Alpharelease |
---|---|---|---|---|
2. Juli 2025 | 1.3.2 | - | - | 1.4.0-alpha17 |
Struktur
Compose ist eine Kombination aus sieben Maven-Gruppen-IDs in androidx
. Jede Gruppe enthält eine bestimmte Teilmenge von Funktionen mit jeweils eigenen Versionshinweisen.
In dieser Tabelle werden die Gruppen erläutert und es sind Links zu den jeweiligen Versionshinweisen enthalten.
Gruppe | Beschreibung |
---|---|
compose.animation | Animationen in Jetpack Compose-Anwendungen erstellen, um die Nutzerfreundlichkeit zu verbessern. |
compose.compiler | @Composable-Funktionen transformieren und Optimierungen mit einem Kotlin-Compiler-Plug-in ermöglichen |
compose.foundation | Mit den einsatzbereiten Bausteinen können Sie Jetpack Compose-Anwendungen schreiben und die Grundlage erweitern, um eigene Designsystemkomponenten zu erstellen. |
compose.material | Jetpack Compose-UIs mit einsatzbereiten Material Design-Komponenten erstellen Dies ist der Einstiegspunkt auf höherer Ebene für Compose. Er soll Komponenten bereitstellen, die den auf www.material.io beschriebenen Komponenten entsprechen. |
compose.material3 | Mit Material Design 3-Komponenten, der nächsten Generation von Material Design, können Sie Jetpack Compose-UIs erstellen. Material 3 umfasst aktualisierte Designs und Komponenten sowie Material You-Personalisierungsfunktionen wie dynamische Farben. Es ist auf den neuen visuellen Stil und die System-UI von Android 12 abgestimmt. |
compose.runtime | Grundlegende Bausteine des Programmiermodells und der Statusverwaltung von Compose sowie die Core-Laufzeit für das Compose Compiler-Plug-in. |
compose.ui | Grundlegende Komponenten der Compose-Benutzeroberfläche, die für die Interaktion mit dem Gerät erforderlich sind, einschließlich Layout, Zeichnen und Eingabe. |
Abhängigkeiten deklarieren
Wenn Sie eine Abhängigkeit von Compose hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.
Fügen Sie der Datei build.gradle
für Ihre App oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.3.2" implementation "androidx.compose.material3:material3-window-size-class:1.3.2" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.2") implementation("androidx.compose.material3:material3-window-size-class:1.3.2") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Ihr Feedback hilft uns, Jetpack zu verbessern. Lassen Sie es uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können für ein vorhandenes Problem abstimmen, indem Sie auf die Schaltfläche mit dem Stern klicken.
Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung.
Compose Material3 Common Version 1.0
Version 1.0.0-alpha01
17. April 2024
androidx.compose.material3:material3-common:1.0.0-alpha01
, androidx.compose.material3:material3-common-android:1.0.0-alpha01
und androidx.compose.material3:material3-common-desktop:1.0.0-alpha01
sind veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Themenlose Komponenten, mit denen Material Design-Komponenten erstellt werden können:
- Tonale Palette
- Symbol
- Größe des Berührungszielbereichs
Compose Material3 Adaptive Navigation Suite Version 1.0
Version 1.0.0-alpha07
1. Mai 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07
und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07
sind veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
- Navigationssuite-APIs nicht mehr als experimentell kennzeichnen (If62af)
Fehlerkorrekturen
- Standardmäßig Insets für Inhalte verwenden (50266df)
Version 1.0.0-alpha06
17. April 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06
und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06
sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
- Fügen Sie
containerColor
undcontentColor
zuNavigationSuiteScaffoldDefaults
hinzu. (I64e3a, b/331993720) - Die Funktion
itemColors
wirdNavigationSuiteDefaults
hinzugefügt. (Idf719, b/328480012) NavigationSuiteScope
versiegeln (Iefa57)
Version 1.0.0-alpha05
6. März 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05
und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05
sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
API-Änderungen
- Machen Sie den
NavigationSuiteItemColors
-Konstruktor öffentlich. (Ica83a, b/324886877)
Version 1.0.0-alpha04
21. Februar 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04
und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04
sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Abhängigkeitsupdates
- Aktualisieren Sie die adaptiven Material3-Abhängigkeiten auf die neuen Modulpfade. (Ibc421)
- Auf die Window Manager-Version der Fenstergrößenklassen umstellen (I3794d)
Version 1.0.0-alpha03
7. Februar 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03
und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03
sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
- Paketname von „navigation-suite“ in „navigationsuite“ ändern (I7eff7)
- Material3-Komponenten, die in ihrer API ein
MutableInteractionSource
verfügbar machen, wurden aktualisiert, sodass sie jetzt ein nullableMutableInteractionSource
verfügbar machen, das standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dasMutableInteractionSource
nicht verschieben. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie einMutableInteractionSource
zugewiesen wird. Außerdem kann es sein, dass für andere Komponenten nur dann eine Instanz erstellt wird, wenn sie benötigt wird. Das verbessert die Leistung dieser Komponenten. Wenn Sie dieMutableInteractionSource
, die Sie an diese Komponenten übergeben, nicht verwenden, sollten Sie stattdessen „null“ übergeben. Es wird auch empfohlen, ähnliche Änderungen in Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146)
Version 1.0.0-alpha02
13. Dezember 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02
und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02
sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
NavigationSuiteType
„Keine“ hinzufügen (If8cb1, b/313688598)
Fehlerkorrekturen
- Das Problem, dass die Navigationskomponente den gesamten Bildschirm ausfüllt, wenn die Stammoberfläche
modifier.fillMaxSize
hat, wurde behoben. (c9cf250, b/312664933)
Version 1.0.0-alpha01
15. November 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01
wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Compose Material3 Adaptive Version 1.0
Version 1.0.0-alpha06
7. Februar 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06
und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06
sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
Neue Funktionen
- Es wurden zusätzliche Verhaltensoptionen für die
ThreePaneScaffoldNavigator
-Zurück-Navigation hinzugefügt. (I858aa) - Dem Navigationsverlauf wurden optionale Zielinhalte hinzugefügt. (Ibd7e6)
Version 1.0.0-alpha05
24. Januar 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05
und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05
sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
- Unterstützung von Verlaufsdaten in der Gerüstnavigation und Wertberechnung (I71d46)
Version 1.0.0-alpha04
10. Januar 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04
und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04
sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Unterstützung für Edge-to-Edge-Darstellung in Bereichsgerüsten hinzugefügt (I1b462)
API-Änderungen
- Die Eigenschaften für die Scharniergrenzen in „Posture“ wurden in eine Liste mit Scharnierinformationen verschoben (I24f90).
Fehlerkorrekturen
- Problem mit
AnimatedPane
, das nicht neu zusammengesetzt wird, behoben (c3f573d)
Version 1.0.0-alpha03
13. Dezember 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03
und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03
sind veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
- Ändern Sie die Gerüstrollen in Aliase von
ThreePaneScaffoldRole
. (I65bd1) - Basisklasse für Gerüstrollen erstellen (I4784d)
- Entferne unnötige Parameter aus den Inhalten von
AnimatedPane
(Ibc73b) - Benennt
collectWindowSizeAsState
um und gibt stattdessen Rohwerte zurück (I480f4)
Version 1.0.0-alpha02
29. November 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02
und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02
sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
- Navigations-APIs von APIs für adaptive Gerüste trennen (Ic4045)
- Entfernen Sie den Kurs
GutterSize
. (I785b3)
Fehlerkorrekturen
- Fix: Bereiche werden nicht gewechselt, wenn
AnimatedPane
nicht verwendet wird (d88f181)
Version 1.0.0-alpha01
15. November 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Adaptive Condition APIs für Material 3:
Material3-APIs für adaptive Pane-Scaffold-Anweisungen:
Material3-APIs für adaptive Pane-Scaffolding:
- Grundlegende APIs für die Gerüststruktur von Bereichen
Compose Material3 Version 1.4
Version 1.4.0-alpha17
2. Juli 2025
androidx.compose.material3:material3-*:1.4.0-alpha17
wird veröffentlicht. Version 1.4.0-alpha17 enthält diese Commits.
Neue Funktionen
- Die Animation der Schaltflächengruppe wird jetzt bei einem Klick und nicht erst bei einem Druck zu 75% animiert. (593942a, b/423596967)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem ein Karussellelement in einigen Fällen die Größe des großen Elements bei der Layoutberechnung überschreiten konnte, wodurch das gesamte Widget abgeschnitten wurde. (I1c3d7, b/397489534)
- Das Überspringen von
beforeContentPadding
beim Scrollen von Karussells mit sich überschneidenden Start- und Endverschiebungen wurde behoben. (c3d5f3a, b/420618979) - Das aktivierte Verhalten von
SwipeToDismiss
wurde so aktualisiert, dass der abgerechnete Status anstelle des aktuellen Status berücksichtigt wird. Stellt das bisherige Verhalten wieder her, bei dem das Ankerverhalten nur deaktiviert wird, wenn sich die Komponente in einem geschlossenen Zustand befindet. (3844e07, b/425006844) - Das Pop-up-Menü von
ExposedDropdownMenu
kann jetzt über die Tastatur geöffnet werden. Außerdem ist das Menü für die bearbeitbare Variante jetzt über die Tastatur erreichbar. (46ead03)
Version 1.4.0-alpha16
18. Juni 2025
androidx.compose.material3:material3-*:1.4.0-alpha16
wird veröffentlicht. Version 1.4.0-alpha16 enthält diese Commits.
Neue Funktionen
- Eine zentriert ausgerichtete Hero-Karussellkomponente wurde hinzugefügt (I6f6d3).
API-Änderungen
- Implementierung von XR-Überschreibungen für die vertikale Symbolleiste (Ia1604)
CarouselState
wurden programmatische Scrollfunktionen hinzugefügt (I12f8e)ComponentOverride
fürModalWideNavigationRail
hinzufügen (I4f440)ComponentOverride
fürWideNavigationRail
hinzufügen (I6354f)ComponentOverride
fürHorizontalFloatingToolbar
erstellen (I51116)ComponentOverride
fürShortNavigationBar
erstellen (I30e24)SwipeToDismissBoxState
-Verweise aufconfirmValueChange
wurden als veraltet markiert. Nutzer sollten stattdessen denSwipeToDismissBox
API-CallbackonDismissed
verwenden. (Iee780)- Der Parameter „userScrollEnabled“ wurde den Carousel-Composables hinzugefügt. (I1d4d2)
- Die
currentItem
des Karussells können jetzt überCarouselState
beobachtet werden. (Ie87e9)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem eine beliebige Form auf einem FAB, die an eine
FloatingToolbar
übergeben wurde, ihren Schatten nicht richtig angewendet hat. (Icdcc9, b/423336922) - Für alle Karussells wird jetzt standardmäßig die semantische Rolle „Karussell“ verwendet. (I7af12)
- Falsche Daumenbewegung wurde korrigiert, wenn der Status des Schiebereglers über
LaunchedEffect
aktualisiert wurde (Id9f31, b/302774166)
Version 1.4.0-alpha15
20. Mai 2025
androidx.compose.material3:material3-*:1.4.0-alpha15
wird veröffentlicht. Version 1.4.0-alpha15 enthält diese Commits.
API-Änderungen
MotionTheme.LocalMotionScheme
hinzugefügt, Komposition lokal. Dadurch kann überCompositionLocalConsumerModifierNodes
mitcurrentValueOf(MotionTheme.LocalMotionScheme)
auf das Bewegungsdesign des Themas zugegriffen werden. (I014b1)- Der
ColorScheme
-Konstruktor ohne feste Farbrollen ist jetzt veraltet. Bitte migrieren Sie zum Konstruktor, der feste Rollen enthält. (Iad0ee) - Die M3-Textkomponente unterstützt jetzt
TextAutoSize
. (I7f524) - API zum Erstellen von Split-Button-Größenvarianten und Beispiele hinzugefügt. (Ice30b)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem
Snackbar
undFloatingActionButton
bei aktivierter Edge-to-Edge-Funktion falsch positioniert waren. Scaffold wendet jetzt horizontale Insets korrekt auf diese Komponenten an. (Ib7c30, b/244400727) - Korrigiere die
BottomSheet
-Bewegung von vollständig maximiert zu teilweise maximiert. Für dasBottomSheet
wird jetzt der schnelle Effekt vonMotionScheme
beim Ausblenden oder Minimieren und der räumliche Standardeffekt beim Maximieren verwendet. (Ifa46f, b/416063171) - Der
ColorScheme
-Konstruktor ohne Rollen für Oberflächencontainer wurde als ausgeblendet markiert und wird nicht mehr empfohlen. (Ia7237) - Die Anforderung
CircularWavyProgressIndicator
Size.minDimension > 0
wurde entfernt, um mehr Flexibilität zu ermöglichen. Zuvor wurde dadurch eine Ausnahme ausgelöst. (Ic9418, b/377531195) - Hyperlinks in
Text(AnnotatedString)
haben jetzt standardmäßig das Material-Design. (I78288, b/339843816) - Es wurde ein Problem behoben, bei dem die Funktion
toShape()
inRoundedPolygon
einen Pfad zwischenspeichert und ein Problem verursacht, wenn mehrerecreateOutline
-Aufrufe mit unterschiedlichen Größen erfolgen. (I4026d)
Version 1.4.0-alpha14
7. Mai 2025
androidx.compose.material3:material3-*:1.4.0-alpha14
wird veröffentlicht. Version 1.4.0-alpha14 enthält diese Commits.
API-Änderungen
- Es wurde eine neue zusammensetzbare Funktion
AppBarColumn
hinzugefügt, die genauso funktioniert wieAppBarRow
, aber für Inhalte, die in einer Spalte angeordnet sind. (Iaf6bd) - Die maximale Anzahl von Elementen wurde
AppBarRow
hinzugefügt. Dies ist erforderlich, um die Material-Spezifikation für obere App-Leisten korrekt zu implementieren. (I92ce4) - In
TooltipScope
wurde eine Methode zum Abrufen derlayoutCoordinates
des Ankers hinzugefügt. Die MethodedrawCaret
wird eingestellt, da Entwickler mit dieser neuen Methode die AnkergrenzenlayoutCoordinates
abrufen und eine geeignete Form mit einem Caretzeichen erstellen können. (Ia2e12, b/329470609) java.time
-Unterstützung für Datumsauswahlen hinzugefügt: Es wurdenrememberDatePickerState/rememberDateRangePickerState
-Überladungen eingeführt, die java.time-Objekte (z.B. initialLocalDate
,YearMonth
) akzeptieren. Außerdem wurden Erweiterungsfunktionen für die Statusobjekte hinzugefügt, um Werte mit Typen wieLocalDate
undYearMonth
abzurufen/festzulegen. Erfordert API 26 oder höher oder Desugaring. (I70f29, b/266202516, b/281859606)- Fügen Sie die zusammensetzbare Funktion
CenteredTrack
hinzu, damit ein Schieberegler mit einem Track verwendet werden kann, der in der Mitte beginnt. (I5b1d6)
Fehlerkorrekturen
- Die Leistung von wellenförmigen Fortschrittsanzeigen wurde verbessert: Lineare Typen werden jetzt etwa 8, 5% schneller geladen und es sind etwa 11% weniger Zuweisungen erforderlich.Bei kreisförmigen Typen ist die Geschwindigkeit um etwa 47% gestiegen und die Anzahl der Zuweisungen um etwa 39% gesunken. (I595d8)
Version 1.4.0-alpha13
23. April 2025
androidx.compose.material3:material3-*:1.4.0-alpha13
wird veröffentlicht. Version 1.4.0-alpha13 enthält diese Commits.
API-Änderungen
isAppearanceLightStatusBars
undisAppearanceLightNavigationBars
wurden inModalBottomSheetProperties
als reine Android-Parameter wieder eingeführt. (Id4bc0)- Fügen Sie eine
AppBarRow
-Composable hinzu, die den Überlauf von Elementen verarbeitet, die außerhalb ihrer Grenzen liegen. (I742bd) - Aktualisieren Sie die APIs
DatePicker
undDateRangePicker
, um den Fokus beim Wechsel in den Datumseingabemodus anzufordern. Wir haben den booleschen ParameterrequestFocus
durch den optionalen ParameterfocusRequester
ersetzt, der einenFocusRequester
akzeptiert. (I14b69) - Entfernen Sie die Modifikator- und Interaktionsquelle aus den standardmäßigen anklickbaren und umschaltbaren Elementen. Verwenden Sie es stattdessen als Implementierungsdetail. (I95ed6)
- Die Schaltfläche
ButtonGroup
wird jetzt in ein Drop-down-Menü verschoben, wenn zu viele Schaltflächen auf dem Bildschirm angezeigt werden. (I7b88b)
Fehlerkorrekturen
- Das Bottomsheet verwendet jetzt die oberen Insets, wenn es kleiner als der aktuelle Offset ist. So können Nutzer obere Insets für das erweiterte Verhalten angeben.
BottomSheetDefaults.windowInsets
enthält jetztWindowInsets.safeDrawing.Top
. (I0ab67, b/321877275, b/336962418, b/342093067) - Ein- und Ausblendeanimationen (Ein- und Ausblenden/Ein- und Ausschieben) für führende Symbole/Avatare und nachfolgende Symbole von Chips beim Hinzufügen oder Entfernen aktiviert. Das ist vor allem für auswählbare Chips (Filter, Eingabe) von Vorteil, gilt aber allgemein. (I9af21)
- Das fehlerhafte Verhalten des RTL-Schiebereglers, das durch
LookaheadScope
verursacht wurde, wird behoben. (Ieb152, b/408118041) - Behebung des Absturzes im unteren
AppBar
-Bereich beim Scrollen mit ausgeblendeter System-UI. (Ic6140, b/405996228)
Version 1.4.0-alpha12
9. April 2025
androidx.compose.material3:material3-*:1.4.0-alpha12
wird veröffentlicht. Version 1.4.0-alpha12 enthält diese Commits.
API-Änderungen
- Android-spezifische Parameter aus
ModalBottomSheetProperties
entfernt (Iab97f, b/362539765) - Überladen von Funktionen für Standardwerte für die Größe des Ziehpunkts (I0ed0d)
- Neue
NavigationSuiteScaffold
- undNavigationSuiteScaffoldLayout
-Funktionen zur Unterstützung neuer Layouttypen und zum Hinzufügen von Unterstützung für optionalen primären Aktionsinhalt. (Ib262a, b/353144478) Modifier.weight
mit dem Parameter „fill“ inButtonGroup
wird eingestellt. Version ohne Füllung hinzufügen (Id32bb)- Benennen Sie
xSmall-
undxLarge-
um. Die Standardeinstellungen der IconButton-Komponente sind aufextra
festgelegt. (Ib6e0f) - Es wurden neue
NavigationSuite
-,NavigationSuiteItem
- undNavigationSuiteColors
-Funktionen hinzugefügt, um neue Layouttypen zu unterstützen. (I203d6) - Fügen Sie die neue
NavigationSuiteTypes
- und die neuenavigationSuiteType
-Funktion hinzu, die diese Layoutoptionen enthalten (If68f9).
Fehlerkorrekturen
ColorScheme.contentColorFor
wird jetztsurfaceDim
zuonSurface
zugeordnet. (I8891a)- Die
DateInputTextField
-Implementierung wurde aktualisiert, um ein Problem zu beheben, bei dem das Eingabefeld das programmgesteuert festgelegte Datum nicht widerspiegelte. (I6c8d1, b/401143451) - Die TalkBack-Fokusreihenfolge für die Navigationsleiste und die breite Navigationsleiste wurde korrigiert (I6cf6f, b/407048224).
Version 1.4.0-alpha11
26. März 2025
androidx.compose.material3:material3-*:1.4.0-alpha11
wird veröffentlicht. Version 1.4.0-alpha11 enthält diese Commits.
API-Änderungen
- Die Groß-/Kleinschreibung für zusammensetzbare Eigenschaften in Standardobjekten für Schaltflächen und Ein/Aus-Schaltflächen wurde aktualisiert. Fügen Sie in
ToggleButtonDefaults
undButtonDefaults
Methoden für das empfohlene Padding, die Formen, die Symbolgröße, den Symbolabstand und den Textstil für empfohlene Inhalte in Abhängigkeit von der Containerhöhe hinzu. (Iea69e) - Veraltete experimentelle Funktionen und Konstanten wurden aus der
FloatingToolbar
entfernt. (I8f339) - Höhenkomponenten haben jetzt eine gemeinsame Schnittstelle und öffentliche Konstruktoren und Eigenschaften. (Ibb172)
- Hinzufügen des Modifikators
animateWidth
inButtonGroupScope
, der mit den untergeordneten Elementen der Schaltflächengruppe verwendet werden muss, um die untergeordneten Elemente richtig zu animieren. (Ia3bb6)
Fehlerkorrekturen
- Das Padding der schwebenden Symbolleiste wurde korrigiert, um für ein ausgewogenes Erscheinungsbild beim Minimieren zu sorgen. Außerdem wurde die Flexibilität für größere Inhalte verbessert. (I06c00)
Version 1.4.0-alpha10
12. März 2025
androidx.compose.material3:material3-*:1.4.0-alpha10
wird veröffentlicht. Version 1.4.0-alpha10 enthält diese Commits.
API-Änderungen
TabRowDefaults.tabIndicatorOffset
wurde zugunsten vonTabIndicatorScope.tabIndicatorOffset
eingestellt. (Ib36b3)- Rechtschreibfehler für kleines Content-Padding in Schaltflächen-Standardeinstellungen behoben. (I19bfe)
TabRow
undScrollableTabRow
werden zugunsten von primären und sekundären Varianten der jeweiligen Elemente eingestellt. Die Zeilen auf den Tabs „Primär“ und „Sekundär“ sind leistungsfähiger und entsprechen genauer den Spezifikationen. (I918e2)rememberSliderState
undrememberRangeSliderState
wurden hinzugefügt. (I8e384)shouldAutoSnap
wurde zuSliderState
hinzugefügt, um den automatischen Einrastmechanismus zu steuern. Das Deaktivieren kann für benutzerdefinierte Animationen nützlich sein. (I07745)- Die Mindestbreite von Tabs in scrollbaren Tabzeilen ist jetzt ein Parameter. Die Varianten für die primäre und sekundäre Tabellenzeile sind nicht mehr experimentell. (If6f15, b/226665301)
- Die Klasse
ExitAlwaysFloatingToolbarScrollBehavior
wurde öffentlich gemacht, sodass sie ohne Komposition erstellt werden kann. (Ibf31c)
Version 1.4.0-alpha09
26. Februar 2025
androidx.compose.material3:material3-*:1.4.0-alpha09
wird veröffentlicht. Version 1.4.0-alpha09 enthält diese Commits.
API-Änderungen
- Die Einstellungsfelder von
DragHandle
im Standardstatus umbenennen, gedrückte und gezogene Status trennen und die Standardgrößen öffentlich machen. (I787b9) - Aktualisierungen der
TowRowsTopAppBar
API Der Lambda-Parameterexpanded
wurde entfernt und es wurden separate Parameter für die maximierte und minimierte Höhe hinzugefügt. (Idd677, b/306697446, b/229134133, b/268068946)
Fehlerkorrekturen
- Die unteren App-Leisten berücksichtigen jetzt den Dienst zur Touch-Erkundung (z.B.
TalkBack
) und lassen Sie sie immer sichtbar, wenn der Dienst aktiv ist. (I4b34d)
Version 1.4.0-alpha08
12. Februar 2025
androidx.compose.material3:material3-*:1.4.0-alpha08
wird veröffentlicht. Version 1.4.0-alpha08 enthält diese Commits.
Neue Funktionen
Es wurde eine
TimePickerDialog
API hinzugefügt, die fürTimePicker
,TimeInput
oder für eine umschaltbare Version verwendet werden kann. (Id2d83)Neue APIs für die Suchleiste:
- Minimierte Suchleisten und maximierte Suchansichten sind jetzt separate Composables.
SearchBar
steht für eine Suchleiste im minimierten Zustand.ExpandedFullScreenSearchBar
undExpandedDockedSearchBar
stellen die Suchleiste im maximierten Zustand dar. Diese werden in einem neuen Fenster geöffnet.SearchBarState
zum Steuern des Status der SuchleisteTopSearchBar
, um die Verarbeitung von Insets und das Scrollverhalten hinzuzufügen- Neue Überladung von
InputField
, dieSearchBarState
verwendet (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)
API-Änderungen
- Unterstützung für das Morphing der Eckenform von Symbolschaltflächen beim Drücken. (I21843)
- Die APIs für Textfeld-Decorators/Dekorationsfelder sind nicht mehr experimentell. (I31d95)
- Es wurden Beispiele und Standardwerte für die verbundene Variante für
ButtonGroup
hinzugefügt. (I5c8ce) - Machen Sie den Statusparameter zum letzten Parameter in
NavigationSuiteScaffold
undNavigationSuiteScaffoldLayout
. (I9cc7b)
Fehlerkorrekturen
- Benutzerdefinierte Bedienungshilfen für
FloatingToolbars
hinzugefügt, damit Bedienungshilfen jetzt alleFloatingToolbar
-Varianten maximieren oder minimieren können. Bei der Version mit dem schwebenden Aktionsschaltfläche wird dies auf die schwebende Aktionsschaltfläche angewendet, bei der Version ohne schwebende Aktionsschaltfläche auf den Hauptinhalt. (I26420) - Die
FloatingToolbars
beobachten jetzt den Dienst zur Touch-Erkundung (z.B. TalkBack) und die Symbolleiste wird immer maximiert und sichtbar angezeigt, wenn der Dienst aktiviert ist. (I02172) - Ein Absturz bei den Fortschritts- und Ladesymbolen wurde behoben, wenn
Float.NaN
als Fortschrittswert übergeben wurde. (I4fa96, b/352364576)
Version 1.4.0-alpha07
29. Januar 2025
androidx.compose.material3:material3-*:1.4.0-alpha07
wird veröffentlicht. Version 1.4.0-alpha07 enthält diese Commits.
Neue Funktionen
- Mit einer neuen API lässt sich das Aussehen von Checkboxen jetzt noch flexibler anpassen. Diese API bietet Strichparameter, mit denen Sie besser steuern können, wie das Häkchen und der Rahmen des Kästchens gerendert werden. (I65a88)
- Die
TwoRowsTopAppBar
API wurde hinzugefügt. Sie ist eine anpassungsfähigere Alternative zu mittleren und großen App-Leisten zum Erstellen von zweizeiligen oberen App-Leisten. Entwickler haben jetzt die Möglichkeit, die Inhalte von Titeln und Untertiteln sowohl im minimierten als auch im maximierten Zustand zu steuern. Außerdem können sie die Höhe für jeden Zustand anpassen. (I0be3c, b/306697446, b/229134133, b/268068946)
API-Änderungen
- Eine experimentelle
BottomAppBar
-Variante wurde inFlexibleBottomAppBar
umbenannt. So haben Sie mehr Kontrolle über die Anordnung und Höhe von Inhalten. (Iaa448) - Die Benennung von Attributen im Standardobjekt für Schaltflächengruppen wurde in
CapitalCase
geändert. Aktualisieren Sie den Namen vonanimateFraction
, damit er das Verhalten, das er repräsentiert, genauer widerspiegelt. (I545cd) - Es wurden Überladungen für gängige Schaltflächen hinzugefügt, die animierte Formen bei der Interaktion durch Drücken ermöglichen. Zwischengespeicherte Schaltflächenformen hinzugefügt. (I5ec20)
- Sie können jetzt festlegen, wie ein
FloatingToolbar
mit einem schwebenden Aktionsschaltfläche (Floating Action Button, FAB) auf das Scrollen reagiert, indem Sie einFloatingToolbarScrollBehavior
angeben. Bei Toolbars, die an einer mittleren Kante (z. B. oben oder unten in der Mitte) positioniert sind, empfehlen wir, die gesamte Komponente beim Scrollen auszublenden, um ein übersichtlicheres Design zu erzielen. Außerdem wird so verhindert, dass der FAB nicht mehr zentriert ist, was beim Verwenden des Flagsexpanded
zum Minimieren passieren könnte. (I33f67) - Die experimentellen
TopAppBar
-APIs wurden aktualisiert, sodass beim Festlegen der Ausrichtung von Titel und UntertitelAlignment.Horizontal
anstelle eines benutzerdefiniertenTopAppBarTitleAlignment
verwendet wird. (I70ca2) SliderState#onValueChange
ist jetzt öffentlich, um Nutzern mehr Kontrolle zu geben (I104eb)- Führen Sie
NavigationSuiteScaffoldState
ein, um die Navigation zu animieren. Außerdem werden Überladungen vonNavigationSuiteScaffold
undNavigationSuiteScaffoldLayout
mit einem Statusparameter eingeführt. (I6a8c9, b/328674235)
Fehlerkorrekturen
- Verschieben Sie die Klassen
IconButtonColors
undIconToggleButtonColors
vonIconButtonDefaults.kt
zurück zuIconButton.kt
. (I3c233)
Externe Beiträge
SliderState#isDragging
ist jetzt öffentlich. (I8458a)
Version 1.4.0-alpha06
15. Januar 2025
androidx.compose.material3:material3-*:1.4.0-alpha06
wird veröffentlicht. Version 1.4.0-alpha06 enthält diese Commits.
Verhaltensänderung
displayCutout
wurde der Gruppe von Insets hinzugefügt, die Material-Komponenten standardmäßig berücksichtigen, um zu verhindern, dass Inhalte mit dem Displayausschnitt überlappen. Dies ist eine Verhaltensänderung, die sich darauf auswirkt, wie Komponenten, die Insets berücksichtigen, in der Nähe eines Displayausschnitts funktionieren. Dazu gehören der Standardwert des ParametersWindowInsets
für inset-aware Material 3-Komponenten und dieWindowInsets
-Werte, die in den Komponenten-Standardobjekten für Material 2 und Material 3 angegeben sind. Wenn diese Änderung zu unerwünschtem Verhalten führt, geben Sie den ParameterWindowInsets
manuell für jede Komponente an. (I43ee9, b/362508045)
API-Änderungen
- Aktualisierungen der
TopAppBar
API Benennen Sie die mittleren und großen oberen App-Leisten mit einer Untertitel in*FlexibleTopAppBar
um. Die Farbvariationen wurden in einer einzigenTopAppBarDefault.topAppBarColors()
-Funktion zusammengefasst und einsubtitle
-Farbparameter wurde hinzugefügt, der für eine bereitgestellte zusammensetzbare Untertitel-Funktion (I41b65) angewendet werden soll. WideNavigationRailArrangement
API zugunsten vonArrangement.Vertical
entfernen (Id0341)- Fügen Sie eine neue
VerticalSlider @Composable
hinzu. (I2bfba) - Es wurde ein neuer Track
@Composable
hinzugefügt, mit dem benutzerdefinierte externe Track-Ecken und ‑Symbole angegeben werden können. (I436a4) - Aktualisieren Sie die APIs für die schwebende Symbolleiste, damit das
FloatingToolbarColors
-Objekt anstelle einer einzelnen Containerfarbe verwendet wird. (I9a054) - Neue experimentelle Annotation
ExperimentalMaterial3ComponentOverrideApi
(Ia1eaf) hinzufügen und verwenden Modifier.indicatorLine
akzeptiert jetzt eine Form für das Textfeld, um das Abschneiden zu verarbeiten. (I8c5f3, b/380704151)- Benennen Sie die experimentellen
FloatingAppBar
-Funktionen inFloatingToolbar
um (I1dbf8). - Es wurde ein neues
floatingToolbarVerticalNestedScroll
hinzugefügt, das an einen scrollbaren Container angehängt werden kann, um den Erweiterungsstatus der unverankerten Symbolleiste basierend auf einer Scrollbewegung zu aktualisieren, die einen Schwellenwert überschreitet. (I6d65f) - Wir stellen eine neue API zum Erstellen einer schwebenden Symbolleiste mit einer angehängten Floating Action Button (FAB) vor. Die API bietet flexible Anpassungsoptionen, mit denen Sie die Symbolleiste horizontal oder vertikal anordnen und die Schaltfläche „+“ am Anfang oder Ende der Symbolleiste platzieren können. (I9e350)
Fehlerkorrekturen
- Ein Problem mit der Barrierefreiheit von Snackbars wurde behoben, das dazu führte, dass sie sich beim Schließen selbst ankündigten, wenn
TalkBack
aktiviert war. (/I9db53)
Externe Beiträge
BasicTooltip
wurde in Foundation undBasicTooltip/Tooltip
in Material 3 vereinheitlicht. (Ifc2e6)
Version 1.4.0-alpha05
12. Dezember 2024
androidx.compose.material3:material3-*:1.4.0-alpha05
wird veröffentlicht. Version 1.4.0-alpha05 enthält diese Commits.
API-Änderungen
- Ersetzen Sie den Typ im
WideNavigationRailState.current/target
-Wert durch ein Enum, um die Lesbarkeit zu verbessern (I2d6ab). SplitButton
– Die Shape API wurde aus Gründen der binären Kompatibilität von einer Datenklasse in eine Klasse geändert. (I53812)- Es wurde eine Tooltip-API mit dem Parameter
onDismissRequest
hinzugefügt, damit Ersteller festlegen können, was passiert, wenn ein Nutzer außerhalb des Tooltips klickt. Die alte API, die diesen neuen Parameter nicht enthält, wurde eingestellt. (I99aef) - Die Benennung von
opticalCentering
inhorizontalCenterOptically
ändern. Den Modifikator intern machen Ersetzen Sie den Padding-Parameter durch den maximalen Start- und End-Offset. (I0b904) - Ändern Sie
WideNavigationRailState
so, dass es den aktuellen/Zielwert enthält, und entfernen Sie Enums zugunsten von booleschen Werten. (Idfa29, b/356039090) - Fügen Sie
NavigationBarItemComponentOverride
hinzu. (I3a06a)
Fehlerkorrekturen
- Das Verhalten der oberen und unteren App-Leiste wurde korrigiert, sodass die Farbe zuverlässig geändert wird, wenn der Inhalt vollständig gescrollt wird. (Idc4e8, b/293665988)
- Scrollverhalten-Funktionen für obere und untere App-Leisten geben jetzt ein gespeichertes Verhalten zurück, um bei Neuzusammenstellungen eine bessere Leistung zu erzielen. (I0fdbe, b/207957336)
- Der Parameter „Modifier“ wird jetzt nach internen Modifikatoren wie Drag-Verhalten und Semantik angewendet, nicht mehr davor. Dies wirkt sich auf die Reihenfolge aus, in der die Modifikatoren angewendet werden. (I8d83f)
- Die maximierte Ansicht am unteren Rand bleibt auch nach einer Größenänderung maximiert. (I2870b, b/324934884)
- Status- und Navigationsleisten-Flags für Fenstereigenschaften werden korrekt weitergeleitet. (Ie674d, b/362539765)
- Verschieben Sie den Modifikatorparameter in das Stammverzeichnis der Gerüste, wie dokumentiert. Dadurch wird die Implementierung an M2 angepasst. (I0235e, b/372311595)
Externe Beiträge
- Gemeinsame
DatePickerDialog
-Funktion. (I7dced)
Version 1.4.0-alpha04
13. November 2024
androidx.compose.material3:material3-*:1.4.0-alpha04
wird veröffentlicht. Version 1.4.0-alpha04 enthält diese Commits.
Geändertes Verhalten
- Die in aosp/3212478 eingeführten Farbänderungen für
iconButtonColors
,iconToggleButtonColors
,outlinedIconButtonColors
,outlinedIconToggleButtonColors
undoutlinedIconToggleButtonBorder
werden rückgängig gemacht. Das jetzt zurückgesetzte Verhalten wurde in eine neue Reihe von Funktionen mit dem NameniconButtonVibrantColors
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) - Wir führen
WideNavigationRailState
ein, um das Ein- und Ausblenden des Rails zu ermöglichen,ModalWideNavigationRail
kann geschlossen werden undDismissibleModalWideNavigationRail
wird gelöscht. (I88568) - Den Standardwerten für Ein/Aus-Schaltflächen werden Standardwerte für die Größen „xSmall“, „medium“, „large“ und „xLarge“ hinzugefügt. (Ie95d1)
- Den Schaltflächen-Standardeinstellungen werden Standardgrößen für „xSmall“, „medium“, „large“ und „xLarge“ hinzugefügt. (If8b6d)
Fehlerkorrekturen
- Die Farbe des nachgestellten Symbols des Filterchips wurde gemäß Spezifikation von „Primär“ zu
OnSurfaceContainer
aktualisiert. Alle Umrissfarben der Chips wurden gemäß Spezifikation von „Umriss“ zu „Umrissvariante“ aktualisiert. (I68bd4)
Version 1.4.0-alpha03
30. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha03
wird veröffentlicht. Version 1.4.0-alpha03 enthält diese Commits.
API-Änderungen
- Der
SheetState
-Konstruktor mit Dichte wurde zugunsten von Positions- und Geschwindigkeitsgrenzwerten eingestellt. (Ifd16e) rememberTooltipPositionProvider
wurde hinzugefügt und enthält eine aktualisierte Logik für die Positionierung.rememberPlainTooltipPositionProvider
undrememberRichTooltipPositionProvider
wurden eingestellt. (Ie66e2)- Mit zusätzlichen
ModalBottomSheetProperties
können die Farben der Status- und Navigationsleiste angepasst werden. Standardmäßig werden sie basierend auf der Inhaltsfarbe und nicht auf dem Status des dunklen Designs des Systems aktualisiert. (Ib874e, b/362539765) - Die Eingabe für Datumsauswahlen wurde verbessert: Im Eingabemodus wird das Datumsfeld für die sofortige Texteingabe fokussiert. Durch die Änderung wird den
DatePicker
undDateRangePicker
einrequestFocus
-Parameter hinzugefügt. Sie können verhindern, dass der Fokus gesetzt wird, indem Siefalse
übergeben. (I12d09, b/286399710, b/340102743) - Die Standardeinstellungen für Formen werden im Shape-Objekt im Cache gespeichert. Die Form wird standardmäßig auf
@Composable
für die Ein/Aus-Schaltfläche festgelegt. Die Formen werden standardmäßig in einer Form zusammengefasst, da die Varianten auf dieselbe Token-Datei verweisen. (Iaa014)
Fehlerkorrekturen
- Optimieren Sie das Verhalten von Scaffold
contentPadding
, um zu vermeiden, dass der Inhalt des Bodys immer neu zusammengesetzt wird, wenn sichcontentPadding
ändert. (I8c8e2, b/373904168) TextFieldLabelScope
progress
wurde inlabelMinimizedProgress
umbenanntTextFieldLabelPosition
Default
wurde inAttached
umbenannt. Schnittstellenmitglieder wurden entfernt. (If75c6)- Es wurde ein Problem mit dem
DatePicker
im Eingabemodus behoben, bei dem Validierungsfehler dazu führen konnten, dass sich die Höhe der Komponente änderte. (I2e229, b/280462363) - Das Material „Slider“ soll seinen Wert ändern, wenn Steuertasten gedrückt werden. (I1c442)
Version 1.4.0-alpha02
16. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha02
wird veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.
API-Änderungen
- Die Datumsauswahlen wurden aktualisiert, um eine konsistente Verwendung von Gebietsschemas in der gesamten
DatePicker
undDateRangePicker
zu gewährleisten, wenn ein Gebietsschema direkt über einDatePickerState
oder einDateRangePickerState
festgelegt wird. Wenn Sie Gebietsschemas direkt auf den Status festlegen, müssen Sie dafür sorgen, dass die Titel- und Überschriftentexte entsprechend lokalisiert werden, da der Standardtext weiterhin gemäß dem Standardgebietsschema der Plattform angewendet wird. (I37073, b/326490763, b/321657276) SheetState.isAnimationRunning
ist jetzt verfügbar. (I9a3d7)DatePickerColors
haben jetzt Vorrang vor allen in den Textstilen der Typografie des Designs definierten Farben, die in Konflikt stehen. Außerdem wird mit diesem Update die Position des Parameterscolor
in den Funktionen für die Datumsauswahl angepasst und ein ParametercontentColor
zum Anpassen der Farben für Header- und Titeltext eingeführt. (I30d03, b/347031394)- Benennen Sie
SplitButton
inSplitButtonLayout
um und entfernen Sie die APIs für Farbvarianten vonSplitButton
. Varianten werden durch die Wiederverwendung von Schaltflächenvarianten erreicht, die vonSplitButtonDefaults
bereitgestellt werden. (I44c36) ModalBottomSheet
hat jetzt den ParametersheetGestureEnabled
(I856cb, b/288211587)- Die
standardMotionScheme
und dieexpressiveMotionScheme
wurden in „Standard“ und „Expressiv“ umbenannt. Beide Funktionen sind jetzt über dasMotionScheme
-Begleitobjekt durch Aufrufen vonMotionScheme.standard()
undMotionScheme.expressive()
verfügbar. (Iceccf) - Der Parameter
maxWidth
wird einfachen und Rich-Tooltips hinzugefügt. Die Standardeinstellung ist die Designspezifikation von 200 dp für einfache Tooltips und 320 dp für Rich-Tooltips. (I30ce9)
Fehlerkorrekturen
- Die
DatePicker
undDateRangePicker
aktualisieren den angezeigten Monat jetzt korrekt, wenn sie über diedisplayedMonthMillis
ihres Status festgelegt werden. (If9e47, b/333414302) - Bei
ModalBottomSheet
-Inhalten werden Inhalte jetzt von der Statusleiste weg verschoben. (I5114c, b/321877275, b/336962418, b/342093067) - [Bottom Sheet] Die Priorität des Rückrufs wird wieder auf
PRIORITY_DEFAULT
geändert, damit die IME-Tastatur zuerst geschlossen werden kann. (I447fb) - Abstürze in
DatePicker
undDateRangePicker
behoben, wenn das minimal auswählbare Jahr auf ein zukünftiges Jahr festgelegt ist. (I78656, b/319395747) - Ein Problem mit der Datumsauswahl wurde behoben, damit die Benutzeroberfläche aktualisiert wird, wenn eine aktualisierte
SelectableDates
-Instanz angewendet wird. (Iad59a, b/290135807, b/339898760)
Version 1.4.0-alpha01
2. Oktober 2024
androidx.compose.material3:material3-*:1.4.0-alpha01
wird veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.
Geändertes Verhalten
- Die Bibliothek fügt keine Abhängigkeit von
material-icons-core
mehr hinzu. Wenn Ihr Projekt darauf angewiesen war, müssen Sie diese Abhängigkeit explizit in Ihrenbuild.gradle[.kts]
-Dateien hinzufügen. (I735ff, b/349894318) - Die aktive Label-Farbe von
NavigationBarItem
undNavigationRailItem
ändert sich vononSurface
zusecondary
, um die Nutzerfreundlichkeit und den Farbkontrast zu verbessern und die Kohärenz im System zu erhöhen (Ibc297). Wenn Sie zum vorherigen Verhalten zurückkehren möchten, kopieren Sie die Standardfarben und ändern SieselectedTextColor
inMaterialTheme.colorScheme.onSurface
. - Material 3-Komponenten verwenden jetzt die neue
MotionScheme
, um ihre Bewegung zu definieren. (Ie0f93) - Bewegungsänderungen bei unbestimmter kreisförmiger Fortschrittsanzeige (I3c07e)
- Aktualisieren Sie
OutlinedIconButtonColors
undOutlinedIconToggleButtonColors
, um den Farbkontrast zu verbessern. (I2743d) - Die Container- und Inhaltsfarbe für
FilledIconToggleButtonColors
undFilledTonalIconToggleButtonColors
wurde aktualisiert. (Ic5d0f) - Die Rahmenfarbe von
OutlinedButton
wurde vonoutline
zuoutlineVariant
geändert. (057f00)
API-Änderungen
- Der Funktion
enterAlwaysScrollBehavior
desTopAppBar
wurde ein optionalerreverseLayout
-Parameter hinzugefügt, um Inhalte, die mit einemreverseLayout
festgelegt wurden, besser zu unterstützen. (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. Es wurden APIs für Dekorationsfelder hinzugefügt, die mitTextFieldDecorator
kompatibel sind. (If13a1) - Es wurde ein Parameter hinzugefügt, um die
labelPosition
des Textfelds zu steuern. MitalwaysMinimize
kann das UI-Muster verwendet werden, bei dem ein Label und ein Platzhalter gleichzeitig in einem Textfeld angezeigt werden, auch wenn das Feld nicht fokussiert ist. (I1ef2c) - Material
SecureTextField
undOutlinedSecureTextField
für Passwort-Eingabefelder hinzugefügt. (I7e22d) - Den Textfeldlabels wurde ein Bereich hinzugefügt, um den Fortschritt der Animation abzufragen. (If5ec8)
- Unterstützung für
MotionEvent.CLASSIFICATION_DEEP_PRESS
in Kurzinfos hinzugefügt. (I62e6a) TimePickerState
sisAfternoon
ist jetzt ein Erweiterungswert anstelle einer Variablen in der Schnittstelle und wurde inisPm
umbenannt (I89a97).- Die Typografieklasse wurde aktualisiert, um betonte Typografie-Skalen zu unterstützen. (Ifa13c)
- Die
ModalWideNavigationRail
API wurde hinzugefügt und dieModalExpandedNavigationRail
APIs wurden inDismissibleModalWideNavigationRail
umbenannt. (Ic9118) FloatingAppBarScrollBehavior
wurde aktualisiert, umscreenOffset
automatisch zu berechnen und keine@Composable
zu erfordern. (Idf349)- Aktualisierungen der
LoadingIndicator
API zur Korrektur der Benennung im Standardobjekt. DerPullToRefresh
wurde eineLoadingIndicatorElevation
-Konstante hinzugefügt. (I1d72b) - Aktualisierungen der
LoadingIndicator
API zur Korrektur der Benennung im Standardobjekt. DerPullToRefresh
wurde eineLoadingIndicatorElevation
-Konstante hinzugefügt. (I1d72b) - Den unbestimmten Varianten von
LinearWavyProgressIndicator
undCircularWavyProgressIndicator
wurden die Parameteramplitude
undwaveSpeed
hinzugefügt. (I2a0c5) - Unterstützung für das Ändern der Form einer Symbol-Umschaltfläche basierend auf dem gedrückten oder aktivierten Zustand. (Ibc781)
- Die Typografieklasse wurde aktualisiert, um betonte Typografie-Skalen zu unterstützen. (Ifa13c)
- Die Form von
SplitButton
ändert sich je nach Standard- oder gedrücktem Zustand. DieAnimatedTrailingButton
API wurde entfernt, da dieTrailingButton
API dieselben Anpassungen bieten kann (I95066). - Fügen Sie einen Modifikator hinzu, um das Ein- und Ausblenden des schwebenden Aktionsschaltfläche zu animieren, z.B. wenn Inhalte gescrollt werden. (I8338d)
- Hinzufügen von verbundenen Schaltflächengruppenformen und Abständen zu
ButtonGroupDefaults
zur Verwendung in einem Beispiel. (I68e30) - Bei der geteilten Schaltfläche wird horizontaler Abstand für die nachfolgende Schaltfläche hinzugefügt und die optische Zentrierung wird anhand der Differenzen zwischen Start- und Endpunkt berechnet (I122e2).
- Wir führen ein neues Material
MotionScheme
ein, mit dem Sie ein Schema für die Bewegung der Komponente festlegen können. Das Schema wird überMaterialTheme
festgelegt. (Id50c2)
Fehlerkorrekturen
- Wenden Sie den richtigen Fokusdurchlaufindex auf untergeordnete
Scaffold
-Composables an. Die Reihenfolge isttopBar
,bottomBar
, fab, content, snackbar. (I5936b) - Ein Problem wurde bei
DatePicker
undDateRangePicker
behoben, bei dem in bestimmten Gebietsschemas und Format-Skeletten einige der Datumsbestandteile (z.B. Monatsnamen) nicht mit einem Großbuchstaben begannen. (I1430f) - Tokens für FAB- und FAB-Menükomponenten integrieren (geringfügige visuelle Änderungen an Abständen und Text) (Ib57f3)
ModalBottomSheet
ist jetzt das erste Element in der semantischen Reihenfolge, gefolgt vom Scrim. (I436f9, b/358594665)- Die untere App-Leiste verschwindet beim Scrollen unter dem Navigations-Pill im Edge-to-Edge-Modus nicht vollständig (I3ee21).
Compose Material3 Version 1.3
Version 1.3.2
9. April 2025
androidx.compose.material3:material3-*:1.3.2
wird veröffentlicht. Version 1.3.2 enthält diese Commits.
Fehlerkorrekturen
ListItem
korrigiert die Berechnung der intrinsischen Höhe und reserviert jetzt die entsprechende Menge an Speicherplatz im Layout.- Entfernen Sie überflüssiges Padding für das Label
NavigationBarItem
, um die Spezifikation einzuhalten. - Korrigiert das
TabRow
-Layout im RTL-Modus.
Version 1.3.1
30. Oktober 2024
androidx.compose.material3:material3-*:1.3.1
wird veröffentlicht. Version 1.3.1 enthält diese Commits.
Fehlerkorrekturen
- Die
DatePicker
undDateRangePicker
aktualisieren den angezeigten Monat jetzt korrekt, wenn sie über diedisplayedMonthMillis
ihres Status festgelegt werden. (If9e47, b/333414302) - Abstürze in
DatePicker
undDateRangePicker
behoben, wenn das minimal auswählbare Jahr auf ein zukünftiges Jahr festgelegt ist. (I78656, b/319395747) - Ein Problem mit der Datumsauswahl wurde behoben, damit die Benutzeroberfläche aktualisiert wird, wenn eine aktualisierte
SelectableDates
-Instanz angewendet wird. (Iad59a, b/290135807, b/339898760) - Die Priorität des Rückrufs für Bottom Sheets wird auf
PRIORITY_DEFAULT
geändert, damit die IME-Tastatur zuerst geschlossen werden kann. (I447fb)
Version 1.3.0
4. September 2024
androidx.compose.material3:material3-*:1.3.0
wird veröffentlicht. Version 1.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.2.0
Wichtige Funktionen von Version 1.3.0
Neue Material Design 3-Komponenten
- Karussell
HorizontalMultiBrowseCarousel
undHorizontalUncontainedCarousel
Verbesserungen an vorhandenen Material Design 3-Komponenten.
- [
ModalBottomSheet
] unterstützt jetzt die vorhersagende Zurück-Geste auf U+ (Iccf32, b/281967264, b/304850357) - [
SearchBar
] unterstützt jetzt die intelligente „Zurück“-Geste auf U+ (I657f8) - Die Navigationsleiste (
ModalDrawerSheet
undDismissibleDrawerSheet
) unterstützt jetzt die Funktion „Vorhersagender Zurück-Vorgang“ auf U+ als Opt-in (Ie5b0b). DropdownMenu
unterstützt jetzt benutzerdefinierte Farben, Formen, Erhebungen und Rahmen. (I8e981,b/289554448, b/301887035, b/283654243)- Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I3058e)
- Die
ProgressIndicator
wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I21451) - Für Rich-Tooltips wurde ein Standard-Caret hinzugefügt. Es wird unterstützt, dass ein benutzerdefiniertes Caret für den Anker
LayoutCoordinates
gezeichnet wird. (Ifd42c) Funktionsgefährdende Änderungen - Neue APIs zum Aktualisieren durch Ziehen:
- Vereinfachtes
PullToRefreshState
zur Verwendung von Bruchwerten anstelle von Dp-Einheiten. - Der
isRefreshing
-Status wird vom Nutzer und nicht vonPullToRefreshState
gesteuert. - Die verschachtelte Scrollverbindung wurde von
PullToRefreshState
getrennt. Dies wird vom neuenPullToRefreshBox
oderModifier.pullToRefresh
übernommen. - Dieses Update ist eine grundlegende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Visuelle Änderungen
- Vereinfachtes
- Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorScheme
unddarkColorScheme
. (I9db52) - Die Farben für den Schieberegler und
ProgressIndicator
wurden aktualisiert, um den neuen Spezifikationen für den Kontrast von Nicht-Text-Elementen zu entsprechen. (I26807) SurfaceContainer
-Varianten werden jetzt von Komponenten verwendet. Bei Komponenten, bei denen die Farbe bisher mitSurface
undTonalElevation
berechnet wurde, werden jetzt standardmäßigSurfaceContainer
-Rollen verwendet, die nicht von der tonalen Erhebung betroffen sind. (b/304584161)- Die Baseline-Rollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, sodass in hellen und dunklen Designs mehr Farbton vorhanden ist. (I677a5)
- Experimentelle APIs wurden zu stabilen APIs hochgestuft.
- Leistungsverbesserungen
Version 1.3.0-rc01
21. August 2024
androidx.compose.material3:material3-*:1.3.0-rc01
wird veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.
Fehlerkorrekturen
ModalBottomSheet
ist jetzt das erste Element in der semantischen Reihenfolge, gefolgt vom Scrim. (I436f9, b/358594665)
Version 1.3.0-beta05
24. Juli 2024
androidx.compose.material3:material3-*:1.3.0-beta05
wird veröffentlicht. Version 1.3.0-beta05 enthält diese Commits.
- Ein Problem wurde behoben, bei dem
BottomSheet
-Inhalte unter Android N und O fehlten oder abgeschnitten wurden (a10a2d). - Die semantischen Grenzen des Schiebereglers wurden erhöht, damit
TalkBack
die Fokusindikatoren um die Thumbnails herum richtig anzeigen kann. (0b5a1d)
Version 1.3.0-beta04
26. Juni 2024
androidx.compose.material3:material3-*:1.3.0-beta04
wird veröffentlicht. Version 1.3.0-beta04 enthält diese Commits.
Version 1.3.0-beta03
12. Juni 2024
androidx.compose.material3:material3-*:1.3.0-beta03
wird veröffentlicht. Version 1.3.0-beta03 enthält diese Commits.
Externe Beiträge
androidx.compose.material3.DropdownMenu
aus dem gemeinsamen Quellenset verfügbar machen (If62c0)
Version 1.3.0-beta02
29. Mai 2024
androidx.compose.material3:material3-*:1.3.0-beta02
wird veröffentlicht. Version 1.3.0-beta02 enthält diese Commits.
API-Änderungen
Modifier.pullToRefreshIndicator
unterstützt die Erhöhung. Die Pull-to-Refresh-APIs wurden aktualisiert, sodass „enabled“ ein boolescher Wert anstelle eines Lambda-Ausdrucks ist. Unterstützung der Inhaltsausrichtung inPullToRefreshBox
(I75679)TooltipScope
als versiegeltes Interface festlegen und eine interne Implementierung für die Verwendung inTooltipBox
und Label erstellen. (I3833e)CarouselItemScope
wurden zwei neue Modifizierer hinzugefügt:maskClip
undmaskBorder
. Damit lassen sich ganz einfach Formen und Rahmen für Karussellelemente hinzufügen. (Id67a1)TimePickerState
ist jetzt eine Schnittstelle und ermöglicht das Einstellen der Uhrzeit (I88546).- Die API zum Formatieren der Links wurde aktualisiert:
TextLinkStyles
wurde zuTextStyle
verschoben undTextDefaults
wurde aus dem Material entfernt. (I5477b)
Fehlerkorrekturen
ModalBottomSheet
-Status und Navigationsleistensymbole reagieren jetzt auf den Status des dunklen Designs. (Ie1fe7, b/338342149)- Dem
ModalBottomSheet
-Scrim wurde die Semantik zum Schließen des Blatts hinzugefügt. (0e61cb,b/328801864)
Externe Beiträge
androidx.compose.material3.AlertDialog
aus dem gemeinsamen Quellset verfügbar machen (Ia33f5)ModalBottomSheet
aus dem gemeinsamen Quellenset (Id7cc7) verfügbar machen
Version 1.3.0-beta01
14. Mai 2024
androidx.compose.material3:material3-*:1.3.0-beta01
wird veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.
API-Änderungen
DpSize
anstelle vonCaretProperties
verwendenCaretProperties
wird entfernt. Benennen SieCaretScope
inTooltipScope
um. (Id9a76)- Die API zum Abrufen von Links mit Material-Design im Text wurde aktualisiert. Konkret wurden die Methoden aus
TextDefaults
zum Erstellen thematischerLinkAnnotations
und zum Parsen von HTML mit thematischen Links entfernt. Stattdessen wurde eineTextLinkStyles
-Klasse hinzugefügt, mit der die Links als Parameter für die Text-Composable-Funktion formatiert werden können. (I31b93)
Version 1.3.0-alpha06
1. Mai 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
wird veröffentlicht. Version 1.3.0-alpha06 enthält diese Commits.
Aktuelle Änderungen
Neue Pull-to-Refresh-APIs:
- Vereinfachtes
PullToRefreshState
zur Verwendung von Bruchwerten anstelle von Dp-Einheiten. - Der
isRefreshing
-Status wird vom Nutzer und nicht vonPullToRefreshState
gesteuert. - Die verschachtelte Scrollverbindung wurde von
PullToRefreshState
getrennt. Dies wird vom neuenPullToRefreshBox
oderModifier.pullToRefresh
übernommen. - Dieses Update ist eine grundlegende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- Vereinfachtes
API-Änderungen
RippleConfiguration#isEnabled
wurde entfernt undLocalRippleConfiguration
wurde auf „nullable“ gesetzt. Wenn Sie einen Ripple deaktivieren möchten, geben Sie statt einesRippleConfiguration
mitisEnabled = false
den Wertnull
bisLocalRippleConfiguration
an. (I22725)ModalBottomSheet
– Der Scrim wird bei aktivierter Edge-to-Edge-Funktion genauer über die Statusleiste gezeichnet. Inhalte von modalen Bottom Sheets können jetzt Fenster-Insets nutzen, sodass Inhalte über der Navigationsleiste sichtbar sind. Der ParameterModalBottomSheet
windowInsets
wurde incontentWindowInsets
umbenannt, um anzugeben, wo die Insets angewendet werden. Sie sind nicht mehr an die Fensterlogik gebunden. Der TypcontentWindowInsets
wurde in eine Funktion geändert, dieWindowInsets
zurückgibt, damit er im neuen Fenster aufgelöst werden kann. (I39630, b/274872542, b/300280229, b/290893168)PrimaryScrollableTabRow
undSecondaryScrollableTabRow
verwenden jetzt ein benutzerdefiniertes Layout anstelle von Unterkompositionen, was die Leistung verbessern sollte. (I991e0)- Textlinks haben jetzt zusätzlich zum normalen Stil, zum Stil für den Mauszeiger und zum Fokusstil auch einen Stil für den gedrückten Zustand. Die
TextDefaults
-Methoden haben jeweils einpressedStyle
-Argument erhalten, um dies zu unterstützen. (Ic473f, b/139312671)
Fehlerkorrekturen
- Die Ziehpunkte für die Navigationsleiste haben jetzt dieselbe Breite wie
drawerContent
. (Ibc72f, b/245355396) - Das obere Padding für das Label berücksichtigt jetzt die Schriftgröße des Systems.
OutlinedTextField
(Idc781) - Korrigierter Paketstandort:
CalendarLocale
. (Ifa235) - [Predictive Back] Update predictive back animations to use interpolation curve of (0.1, 0.1, 0, 1) (I2591a)
Version 1.3.0-alpha05
17. April 2024
androidx.compose.material3:material3-*:1.3.0-alpha05
wird veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.
Neue Funktionen
SearchBar
undDockedSearchBar
haben neue Überladungen, die einen Textfeldparameter akzeptieren. So lässt sich das Textfeld unabhängig vom Rest der Suchleiste gestalten und es können benutzerdefinierte Textfelder übergeben werden. Das Textfeld der aktuellen Implementierung ist alsSearchBarDefaults.InputField
verfügbar. (I50c73, b/275074248, b/278773336, b/326627700)- Die Lambda-Funktion
drawTick
wurde der öffentlichen API hinzugefügt, um die Ticks bei Bedarf anzupassen (I0c048).
API-Änderungen
- Für Textlinks gibt es jetzt zusätzlich zum normalen Stil, zum Stil für den Mauszeiger und zum Fokusstil auch einen Stil für den gedrückten Zustand (I5f864, b/139312671).
CarouselItemInfo
wurde aktualisiert, um ein Maskenrechteck zu präsentieren, durch das das Element beschnitten wird (I785d8).BasicTooltipState
wurde aus der öffentlichen Material 3-API entfernt. Die Funktionalität wird mitTooltipState
kombiniert, bis dieBasicTooltip
von Foundation stabilisiert ist. (Icda29)- Das
TextDefaults
-Objekt wurde hinzugefügt. Es enthält Methoden zum Erstellen einesLinkAnnotation
-Objekts und zum Parsen von HTML-getaggten Strings, dieMaterialTheme
auf die Links anwenden (I98532, b/139312671). ExposedDropdownMenuBoxScope
lässt keine Unterklassen mehr zu. Für Drop-down-Menüs, die angezeigt werden, gibt es jetzt einMenuAnchorType
, das anmenuAnchor
übergeben werden sollte, um die Barrierefreiheit zu verbessern. Diese Methode sollte anstelle der Übergabe vonfocusable
anExposedDropdownMenu
verwendet werden, da Letzteres jetzt veraltet ist.menuAnchor
hat einen neuen Parameter zum Steuern desenabled
-Status. (I55ee6, b/257209915, b/308840226)- Die Rahmenfarbe von
OutlinedButton
wurde korrigiert, wenn die Funktion deaktiviert ist. Die ÜberladungButtonDefaults.outlinedButtonBorder("enabled")
wurde hinzugefügt, die den aktivierten Status übernimmt. (Ie650b, b/318461363) - Es wurde eine neue
CarouselItemInfo
-Klasse hinzugefügt, damit Clients Informationen zu den Artikelgrößen abrufen können. (I9070c) - Der
ColorScheme
-Konstruktor ohne Surface-Container ist jetzt veraltet. Migrieren Sie bitte zum Konstruktor, der Oberflächencontainer enthält. (I35c11) - [Outlined]
TextFieldDefaults
ContainerBox
wurde inContainer
umbenannt. (Ie8d3b)
Fehlerkorrekturen
BottomSheetScaffold
wird nicht mehr durch verschachteltes Scrollen gescrollt, wennsheetSwipeEnabled
auf „false“ gesetzt ist. (I5e1c1, b/306464779)- Die OptIn-Annotation
ExperimentalMaterial3Api
wurde 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
- Es wurden zwei experimentelle Versionen des Material3-Karussells hinzugefügt:
HorizontalMultiBrowseCarousel
undHorizontalUncontainedCarousel
(I88d64). - Die Compose M3-Navigationsleiste (
ModalDrawerSheet
undDismissibleDrawerSheet
) wurde aktualisiert, um die Vorhersagefunktion für die Zurück-Geste auf U+ als Opt-in zu unterstützen (Ie5b0b). - Eine neue API wurde in „Icon“ hinzugefügt, mit der die Farbtonung als Lambda übergeben werden kann, um das erneute Zusammensetzen zu vermeiden. (I5b5a2)
- Die APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen für feste und minimierbare Abschnitte. (Ib8b0c, b/323403446)
API-Änderungen
- Die APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen für feste und minimierbare Abschnitte. Ein Problem wurde behoben, das dazu führte, dass einzeilige Top-App-Leisten beim Scrollen von Inhalten zu oft neu zusammengesetzt wurden. Ein Problem wurde behoben, bei dem
MediumTopAppBar
-Titel auf Geräten mit großen Schrift-/Anzeigeeinstellungen abgeschnitten wurden. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) SegmentedButton
und zugehörige APIs sind jetzt stabil (I8a158)SwipeToDismissBox
,SwipeToDismissBoxDefaults
,SwipeToDismissBoxState
undSwipeToDismissBoxValue
sind jetzt als stabil gekennzeichnet. (I5f000)- Die eingestellten Enums und APIs
DismissDirection
undDismissValue
wurden entfernt. (I89ccd) - Dem
CarouselState
-Begleitobjekt von „Carousel“ wurde ein experimentelles Tag hinzugefügt. (I94154) LocalMinimumInteractiveComponentEnforcement
wurde eingestellt und durchLocalMinimumInteractiveComponentSize
ersetzt. (I7a7ac)- Der Konstruktor für
SearchBarColors
ist jetzt öffentlich. (I769ca) - Der Parameter
gesturesEnabled
wurde zuSwipeToDismissBox
hinzugefügt. (Idc59f, b/324170119) - Die als verworfen und experimentell markierten Textfeld-APIs wurden entfernt. (I1305f)
Version 1.3.0-alpha03
20. März 2024
androidx.compose.material3:material3-*:1.3.0-alpha03
wird veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.
Visuelle Breaking Changes
- Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorScheme
unddarkColorScheme
. (I9db52)
Neue Funktionen
- Es wurden Parameter hinzugefügt, um
ExposedDropdownMenu
anzupassen. Insbesondere haben Menüs jetzt einenfocusable
-Parameter (Standardwerttrue
), der auffalse
gesetzt werden sollte, wenn Sie mit bearbeitbaren Textfeldern arbeiten. (I4184c, b/323694447, b/278609042)
API-Änderungen
- Das Flag
ScaffoldSubcomposeInMeasureFix
wurde entfernt. (Ie2a4b) NavigationRailItemColors
ist jetzt als@Immutable
markiert. (If6112, b/327660613)NavigationBarItemColors
ist jetzt als@Immutable
markiert. (I42a30, b/298064514)- Parameter in der zusammensetzbaren Funktion „Slider Track“ neu anordnen. (I9f315)
ExposedDropdownMenu
wird jetzt mitPopup
implementiert. Das Verhalten sollte dasselbe sein, mit Ausnahme von fokussierbaren Menüs mit bearbeitbaren Textfeldern, die beim Tippen auf der Tastatur geschlossen werden können.
Fehlerkorrekturen
- Die Baseline-Rollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, sodass in hellen und dunklen Designs mehr Farbton vorhanden ist. (I677a5)
- Die Farben für den Schieberegler und
ProgressIndicator
wurden aktualisiert, um den neuen Spezifikationen für den Kontrast von Nicht-Text-Elementen zu entsprechen. (I26807) - Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorScheme
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 Schieberegler werden wieder stabilisiert.
State.onValueChangeFinished
wird wieder zu einem Wert.onValueChangeFinished
in einrememberUpdatedState
einfügen (I82ab2, b/322269951) - Die Navigationskomponenten verwenden jetzt die neuen
SurfaceContainer
-Rollen.DrawerDefaults
bietet jetzt separate Attribute fürstandardContainerColor
undmodalContainerColor
.DrawerDefaults.ModalDrawerElevation
heißt jetzt0.dp
. (I7fbac) @Stable
wird aus den Status vonSlider
entfernt, dastate.onValueChangeFinished
in einvar
geändert wird. (Ied34a, b/322269951)- Die Animationsspezifikation für
ModalBottomSheet
undStandardBottomSheet
ist jetzt eineTweenSpec
und wurde von einer federnden Animation aktualisiert. Damit wird ein Problem mit einem sichtbaren Überschwingen behoben. Die verworfenenSheetState
-Konstruktoren ohne Dichte wurden entfernt. (I7babc, b/285847707)
Fehlerkorrekturen
SurfaceContainer
-Varianten werden jetzt von Komponenten verwendet. Bei Komponenten, bei denen die Farbe bisher mit „Surface“ undTonalElevation
berechnet wurde, werden jetzt standardmäßigSurfaceContainer
-Rollen verwendet, die nicht von der tonalen Erhebung beeinflusst werden. (b/304584161)- Ein Fehler wurde behoben, durch den die nicht ausgewählte, deaktivierte Containerfarbe von
ElevatedFilterChip
schwarz war. (I400e6, b/322407043) - Problem mit unbestimmter Fortschrittsanzeige behoben, wenn der Fortschritt 0 ist (Id6582)
- Ein Problem mit
Slider
undRangeSlider
im RTL-Layout (Iab0e1) wurde behoben. SliderRangeTolerance
wird für die Berechnung des Schiebereglerbereichs hinzugefügt, da das Runden von Gleitkommazahlen ungenau sein kann. (Ic918a, b/324934900)- Die Schaltflächen von
DatePickerDialog
müssen angezeigt werden, wenn einDateRangePicker
verschachtelt wird oder wenn auf kleinen Bildschirmen mit größeren Schriftarten eine beliebige Art von Datumsauswahl angezeigt wird. (Ie4758, b/325107799, b/277768544) Menu
verwendet jetzt die RolleSurfaceContainer
für die Containerfarbe.MenuDefaults.TonalElevation
heißt jetzt0.dp
. (I135b7)TextField
verwendet jetzt die RolleSurfaceContainerHighest
für die Containerfarbe. (I4dced)- Für die erhöhten Chips wird jetzt die Rolle
SurfaceContainerLow
(I7cd2f) verwendet. - Die Containerfarbe von
DatePicker
ist jetztSurfaceContainerHigh
.DatePickerDefaults.TonalElevation
heißt jetzt0.dp
. (Ida753) - Aktualisiert die Containerfarbe und die Ziehgrifffarbe von Bottom Sheets. (I72a0a)
- Die Containerfarbe von
RichTooltip
ist jetztSurfaceContainer
. (Ia8b45) - Die Containerfarbe von
SearchBar
ist jetztSurfaceContainerHighest
.SearchBarDefaults.TonalElevation
heißt jetzt0.dp
. (I88604) - Der Schalter für Updates ist deaktiviert und nicht ausgewählte Tracks/Symbole nutzen die Farbrolle
SurfaceContainerHighest
. (I7687a) - Die Containerfarbe von
AlertDialog
ist jetztSurfaceContainerHigh
. (Ie0433) - Die Containerfarbe von
BottomAppBar
ist jetztSurfaceContainer
. Die FarbeTopAppBar
onScroll
ist jetztSurfaceContainer
. (I41630) - Die Containerfarbe von
ElevatedCard
ist jetztSurfaceContainerLow
. Die Containerfarbe vonFilledCard
istSurfaceContainerHighest
. (I35141) - Die Containerfarbe von
ElevatedButton
ist jetztSurfaceContainerLow
.FilledIconButton
, die nicht ausgewählt sind, haben jetzt die ContainerfarbeSurfaceContainerHighest
. (I792c9) - Aktualisiert die Rolle für die Containerfarbe
TimePicker
und die Farbe des Zifferblatts aufSurfaceContainerHighest
. (I43b93)
Version 1.3.0-alpha01
21. Februar 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
wird veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.
Neue Funktionen
- Update für Compose M3
ModalBottomSheet
zur Unterstützung von Predictive Back unter U+ (Iccf32, b/281967264, b/304850357) - Compose M3
SearchBar
wurde aktualisiert, um die intelligente „Zurück“-Geste auf U+ zu unterstützen (I657f8) - Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I3058e)
- Die
ProgressIndicator
wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I21451) - Es wurde ein Standard-Caret für Rich-Tooltips hinzugefügt. Die neue Rich-Tooltip-API ermöglicht jetzt das Zeichnen eines benutzerdefinierten Carets für den Anker
LayoutCoordinates
. (Ifd42c)
Geändertes Verhalten
- Material-Komponenten wurden migriert, um die neuen Ripple-APIs zu verwenden. Sie fragen
RippleTheme
nicht mehr ab.
API-Änderungen
- Die Funktion
drawStopIndicator
ist jetzt öffentlich verfügbar. (I3f59f) - Markieren Sie die
formatWithSkeleton
-Funktion desDatePicker
als intern (Ic65dc). DropdownMenu
unterstützt jetzt benutzerdefinierte Farben, Formen, Erhebungen und Rahmen. (I8e981, b/289554448, b/301887035, b/283654243)- Material3-Komponenten, die in ihrer API ein
MutableInteractionSource
verfügbar machen, wurden aktualisiert und machen jetzt ein nullableMutableInteractionSource
verfügbar, das standardmäßig aufnull
gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dasMutableInteractionSource
nicht verschieben. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie einMutableInteractionSource
zugewiesen wird. Außerdem kann es sein, dass für andere Komponenten nur dann eine Instanz erstellt wird, wenn sie benötigt wird. Das verbessert die Leistung dieser Komponenten. Wenn Sie dieMutableInteractionSource
, die Sie an diese Komponenten übergeben, nicht verwenden, sollten Sie stattdessen „null“ übergeben. Es wird auch empfohlen, ähnliche Änderungen in Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146) - Fügt
RippleConfiguration
undLocalRippleConfiguration
hinzu, um die Anpassung von Ripples pro Komponente / Unterbaum mithilfe von festen Werten zu ermöglichen. Das kann beispielsweise sinnvoll sein, wenn Sie die Farbe einer Komponente ändern möchten, die Sie nicht steuern, oder wenn Sie die Wellenbewegung für eine Komponente deaktivieren möchten. In den meisten Fällen sollten die Standardwerte verwendet werden. Diese APIs sind ein Ausweg für die Anpassung einzelner Komponenten oder eingeschränkter Unterstrukturen. Bei größeren Änderungen und benutzerdefinierten Designsystemen sollten Sie stattdessen mitcreateRippleModifierNode
eine eigene Ripple-Animation erstellen. (I7b5d6, b/298048146) - Fügt eine neue Ripple-API in Material 3 hinzu, die die verworfene
rememberRipple
ersetzt. Außerdem wird ein temporäresCompositionLocal
,LocalUseFallbackRippleImplementation
hinzugefügt, um Material 3-Komponenten auf die Verwendung der verworfenen APIsrememberRipple
/RippleTheme
zurückzusetzen. Diese wird in der nächsten stabilen Version entfernt und ist nur als vorübergehende Migrationshilfe für Fälle gedacht, in denen Sie eine benutzerdefinierteRippleTheme
angeben. (I34cbc, b/298048146)
Fehlerkorrekturen
- Die Unterkomposition in
ModalBottomSheet
wurde entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei demModalBottomSheet
in bestimmten Szenarien in Kombination mitLookaheadScope
abstürzen konnte. (I2a198) - Die Unterkomposition in
BottomSheetScaffold
wurde 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 wurde angepasst, sodass es sich näher an der Mitte des Ankerinhalts in Bezug auf die obere rechte Ecke befindet. (I18a28)
- Es wurde ein Problem mit der Barrierefreiheit bei
DateRangePicker
behoben, bei dem der Texttitel „Monat–Jahr“ für Nutzer von Screenreadern, Switch Access und Voice Access als interaktiv dargestellt wurde. (I2ac55) - Der Fehler bei der Parameterreihenfolge
mediumTopAppBarColors
wurde behoben. (Ibe64a)
Version 1.2
Version 1.2.1
6. März 2024
androidx.compose.material3:material3-*:1.2.1
wird veröffentlicht. Version 1.2.1 enthält diese Commits.
Fehlerkorrekturen
- Machen Sie die Schieberegler-Zustände wieder stabil.
State.onValueChangeFinished
wird wieder zu einem Wert.onValueChangeFinished
in einrememberUpdatedState
einfügen (Ie8fd0, b/322269951) @Stable
wird aus den Status vonSlider
entfernt, dastate.onValueChangeFinished
in einvar
geändert wird. (I82ba1, b/322269951)NavigationBar
Fehler bei benutzerdefinierten Farben beheben, die aus Standardfarben kopiert werden (80a779, b/326894020)- Regression in
ExposedDropdownMenu
beheben, damit das Element wieder fokussierbar ist (3fcec1, b/323694447) - Problem mit dem Caching der Schaltflächenfarbe behoben (3e5bbcb/327371655)
Version 1.2.0
7. Februar 2024
androidx.compose.material3:material3-*:1.2.0
wird veröffentlicht. Version 1.2.0 enthält diese Commits.
Bekanntes Problem
- In
PrimaryTabRow
wurde im Rahmen einer Leistungsverbesserung ein Fehler beim Rendern der View-Compose-Interop eingeführt. Verwenden Sie als BehelfslösungTabRow
mitTabRowDefaults.PrimaryIndicator
.
Wichtige Änderungen seit Version 1.1.0
Neue Material Design 3-Komponenten
- Zum Aktualisieren nach unten ziehen
- Segmented Button
Verbesserungen an vorhandenen Material Design 3-Komponenten:
- Untere App-Leiste (RTL-Ausrichtung, automatisches Ausblenden beim Scrollen)
- Visuelle Aktualisierung von Tabs
- Logo (Ausrichtung aktualisiert)
Experimentelle APIs wurden zu stabilen APIs hochgestuft.
Leistungsverbesserungen
- Weitere Informationen finden Sie in diesem Blogpost.
Version 1.2.0-rc01
24. Januar 2024
androidx.compose.material3:material3-*:1.2.0-rc01
wird veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Der Fehler bei der Parameterreihenfolge
mediumTopAppBarColors
wurde behoben. (Ibe64a) - Ein Fehler wurde behoben, der in
1.2.0-beta02
inCardDefaults.cardColors
eingeführt wurde und bei demcontentColor
nicht auf Grundlage descontainerColor
-Parameterwerts aktualisiert wurde. (Iee041, b/319671246) - Ein Fehler in
disabledContentColor
, der in1.2.0-beta02
eingeführt wurde, wurde behoben und es wurden kleine Optimierungen vorgenommen. (I6dda1, b/318428829)
Version 1.2.0-beta02
10. Januar 2024
androidx.compose.material3:material3-*:1.2.0-beta02
wird veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.
Bekannter Fehler
- Aufgrund eines Fehlers in
IconButtonColors
wird standardmäßigdisabledContentColor
einem Alpha (0,38f) vonLocalContentColor
anstelle des vom Nutzer angegebenencontentColor
zugewiesen. Das Problem lässt sich umgehen, indem SiedisabledContentColor
explizit festlegen. Dieses Problem wird im nächsten Release behoben.
API-Änderungen
- Es wurde die Möglichkeit hinzugefügt, Tooltip-Caret-Symbole für Plain
Tooltip
APIs zu aktivieren. (Ibf767) SwipeToDismissState
,rememberSwipeToDismiss
undSwipeToDismissValue
werden alle umbenannt und enthalten_SwipeToDismissBox_
. (I68d6d)
Fehlerkorrekturen
- Der End-Padding-Wert für
ListItem
wurde korrigiert, um der Spezifikation zu entsprechen. (Ibd68b, b/305342674) - Die Umrissfarbe für Karten mit Umriss wird jetzt korrekt
OutlineVariant
zugeordnet. (I75480, b/310979715) - Die dynamische Farbe wird jetzt aus vom System definierten Farbrollen abgerufen. Dadurch wird der Kontrast für barrierefreie Inhalte verbessert und die dynamische Farbe wird besser an die Material-Spezifikation angepasst. (I1de96)
- Die Verarbeitung von
ModalBottomSheet
wurde auf Android T/13+ korrigiert, 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 der verworfenen experimentellen APIs für Tooltips. (I438cb)
- Ändern Sie neue
TabRow
-Überladungen so, dass keine untergeordneten Kompositionen verwendet werden. Das führt zu einer anderen Methode zum Erstellen derTabRow
-Indikatoren mit benutzerdefinierten Modifikatoren. (Ife741) - Die APIs
DismissDirection
undDismissValue
werden eingestellt. Diese wurden inSwipeToDismissValue
zusammengeführt. Die Werte geben sowohl die Position als auch die Richtung vonSwipeToDismissBox
an.DismissState.progress
ist jetzt alsFloatRange
zwischen0.0
und1.0
markiert. Die verworfenen Saver- und Constructor-KlassenDismissState
wurden entfernt. Die KomponenteSwipeToDismiss
, das Status- und das Standardobjekt wurden als experimentell gekennzeichnet. (Ib54f2)
Fehlerkorrekturen
- Die Standardanzeige für
PullToRefresh
ist jetzt eine offene Pfeilspitze anstelle eines ausgefüllten Dreiecks. (I67be3)
Version 1.2.0-alpha12
29. November 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
wird veröffentlicht. Version 1.2.0-alpha12 enthält diese Commits.
API-Änderungen
RangeSlider
akzeptiert jetzt einen Kotlin-Bereich (z.B.0f..1f
) anstelle einer benutzerdefiniertenFloatRange
-Wertklasse.SnapFlingBehavior.kt
verwendet jetzt auch einen Kotlin-Bereich. (I025cb)- Markieren Sie Modifier-Factory-Funktionen als
@Stable
. (Ib109f)
Version 1.2.0-alpha11
15. November 2023
androidx.compose.material3:material3-*:1.2.0-alpha11
wird veröffentlicht. Version 1.2.0-alpha11 enthält diese Commits.
Neue Funktionen
- Implementiert
PullToRefreshContainer
undPullToRefreshState
, die zusammen eine Pull-to-Refresh-Implementierung in Material3 ermöglichen. (I16456, b/261760718)
API-Änderungen
- Markieren Sie
SwipeToDismissBox
DismissDirection
undDismissValue
als experimentell. (I517b0) - Benennen Sie
SwipeToDismiss
inSwipeToDismissBox
um. Benennen Siebackground
inbackgroundContent
unddismissContent
in nachgestelltescontent
-Lambda um. (I7f4d3) - Machen Sie den Konstruktor für
ChipElevation
undSelectableChipElevation
öffentlich. (Ie0c48, b/308432421) ModalBottomSheetProperties
wird hinzugefügt.securePolicy
wird inModalBottomSheetProperties
verschoben. FügtisFocusable
undshouldDismissOnBackPress
zuModalBottomSheetProperties
hinzu. Mit diesen neuen booleschen Werten lässt sich festlegen, wie modale Bottom Sheets IME-Ereignisse verarbeiten sollen. (Iea56f, b/278216859)- Die Status
RangeSlider
undSlider
wurden aktualisiert, uminitialOnValueChange
, die ursprünglichen Präfixe und die entsprechenden K-Dokumente zu entfernen. (I57d30) - Die Klasse
ChipBorder
und die zugehörigen Funktionsaufrufe werden eingestellt. Wir empfehlen, stattdessenBorderStroke
direkt zu verwenden. (I89cc2) - Die Tooltip-APIs für Grundlagenmodelle sind jetzt
@ExperimentalFoundationApi
. (I30b0b) TabRow
undScrollableTabRow
sind nicht mehr veraltet. Die neuen primären und sekundären Varianten sind als experimentell gekennzeichnet. (I0def6)- Filter- und Eingabe-Chips verwenden jetzt direkt
BorderStroke
. (I07a8d) SegmentedButton
verwendet jetztBorderStroke
direkt. (I89b9b)- Die generische Funktion
AlertDialog
wurde inBasicAlertDialog
umbenannt und die vorherige Funktion wurde eingestellt. (Idbe52) - Benennen Sie die
SwipeToDismiss
-APIs inSwipeDismiss
um und stufen Sie die neuenSwipeDismiss
-APIs auf „Stabil“ hoch. (I14cbe) tonalElevation
undshadowElevation
werden den Tooltip-APIs hinzugefügt. Außerdem werden die APIsTooltipBox
,PlainTooltip
undRichTooltip
wieder in den experimentellen Status zurückgesetzt, da sie versehentlich als stabil veröffentlicht wurden. (If0f66, b/293939035)- Experimentelle Chip-APIs werden in stabile APIs umgewandelt. (Iea2c3)
- Die Annotation
@ExperimentalMaterial3Api
wurde aus den klickbaren Material3-Karten entfernt. (I88dbf)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem
SwipeToDismiss
in bestimmten Szenarien mit verschachtelten Lookahead- und Lazy-Layouts abstürzte. (Ica8d1, b/297226562)
Version 1.2.0-alpha10
18. Oktober 2023
androidx.compose.material3:material3-*:1.2.0-alpha10
wird veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.
API-Änderungen
Badge
undBadgedBox
werden als stabil eingestuft. (I67f16, b/261565132)securePolicy
als Parameter fürModalBottomSheet
hinzufügen, 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 verwenden. Diese sollten leistungsfähiger als die vorherigen Versionen sein. (I824e6, b/295616656) - Benennt
StandardSizeClasses
inAllSizeClasses
um. (I8cb07) - Berechnungsfunktionen von Fenstergrößenklassen kombinieren (Iad935)
Fehlerkorrekturen
- Ein
DatePicker
-Absturz wurde behoben, der auftrat, wenn schnell auf die Navigationspfeile geklickt wurde und der angezeigte Monat am Rand des zulässigen Jahresbereichs lag. (I46f36, b/290954897, b/297002119) - [Navigationsleiste] Unterstützung für transparente Farbe für Indikator. (Ie0a9b, b/267289987)
Version 1.2.0-alpha09
4. Oktober 2023
androidx.compose.material3:material3-*:1.2.0-alpha09
wird veröffentlicht. Version 1.2.0-alpha09 enthält diese Commits.
API-Änderungen
ModalNavigationDrawer
undDismissibleNavigationDrawer
wurden migriert, um die neuenAnchoredDraggable
-APIs zu verwenden.DrawerState
sanimateTo
wurde durch die Methoden „open“ und „close“ ersetzt. Der Offset wird jetzt als Gleitkommazahl und nicht als Statusobjekt bereitgestellt. Sie können direkt übercurrentOffset
auf den Offset zugreifen. (I0a72c)- Es wurden nicht zusammensetzbare Funktionen zum direkten Erstellen von
DatePickerState
undDateRangePickerState
hinzugefügt. Diese Funktionen können bei Bedarf als Alternative zu den zusammensetzbaren FunktionenrememberDatePickerState
undrememberDateRangePickerState
verwendet werden. (I70326, b/291524052) - Für die festen und scrollbaren
TabRows
gibt es jetzt primäre und sekundäre Varianten. Sie entsprechen der Farb- und Indikatorfunktion, die in Material 3 definiert ist. PrimaryScrollableTabRow
undSecondaryScrollableTabRow
geben jetzt den Scrollstatus aus. (Iec8f5, b/260572337)- Es wurde ein neuer
sheetMaxWidth
-Parameter hinzugefügt, mit dem Entwickler eine maximale Breite für das Blatt festlegen können. Dp.Unspecified kann für den Parameter übergeben werden, wenn ein Sheet gewünscht wird, das die gesamte Bildschirmbreite einnimmt. (Ifb7c9, b/266697696) - Die APIs
PlainTooltipBox
undRichTooltipBox
werden als eingestellte Methoden wieder hinzugefügt. (I246fa)
Fehlerkorrekturen
- Ein Absturz wurde behoben, der aufgetreten ist, wenn
DatePicker
mit einemDatePickerFormatter
initialisiert wurde, das bestimmte Datumsgerüste enthält, die bei der Konvertierung in Datumsmuster (z. B. YY) gleich bleiben. (I01f29)
Version 1.2.0-alpha08
20. September 2023
androidx.compose.material3:material3-*:1.2.0-alpha08
wird veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.
Funktionsgefährdende Verhaltensänderung
ColorScheme
ist jetzt unveränderlich. Das macht einzelne Farbaktualisierungen weniger effizient, aber die häufigere Verwendung von Farben effizienter. Der Grund für diese Änderung ist, dass das Aktualisieren einzelner Farben für die meisten Apps kein Hauptanwendungsfall ist. Das ist weiterhin möglich, aber es wird mehr als zuvor neu zusammengesetzt. Dadurch wird die Anzahl der Statusabos im gesamten Material-Code deutlich reduziert, was sich auf die Initialisierungs- und Laufzeitkosten von Standardanwendungsfällen auswirkt. (Ic447d, b/297212873)- Die tonale Erhebung wird in verschiedenen Interaktionsstatus nicht mehr animiert, um der Spezifikation zu entsprechen. (Icdd12)
API-Änderungen
- Es wurde ein neues
BottomAppBar
hinzugefügt, das einBottomAppBarScrollBehavior
als Parameter verwendet, um es beim Scrollen von Inhalten automatisch auszublenden. Außerdem wurdeFabPosition.EndOverlay
hinzugefügt, damit das FAB die untere App-Leiste im Scaffold überlagern kann, anstatt darüber verankert zu werden. (Iecb47) - Es wurde eine einfache Label-Komponente hinzugefügt, die auf
BasicTooltipBox
basiert und nicht geschlossen wird, wenn außerhalb der Grenzen des Labels getippt wird. (I821f9)
Fehlerkorrekturen
- Die Verwendung von
rememberSaveable
für Tooltips wurde entfernt. (Icc131, b/299500338) - Es wurde ein temporäres Flag eingeführt, mit dem gesteuert werden kann, ob untergeordnete Elemente von Scaffold während der Messung oder während der Platzierung gemessen werden sollen. Standardmäßig wird die Messung in der Maßeinheit durchgeführt. Wenn Sie Probleme mit dem neuen Verhalten haben, melden Sie bitte ein Problem. (I0b354)
- Die horizontale Edge-to-Edge-Anzeige in
BottomSheet
wurde korrigiert, indem die richtige Messung für die Bildschirmbreite des Geräts verwendet wurde. (I1df0c, b/299058752) - Ein Fehler wurde behoben, bei dem
ModalBottomSheet
nichtonDismissedRequest
aufgerufen hat, wenn das Sheet durch Wischen nach unten geschlossen wurde. (Idfdd8)
Version 1.2.0-alpha07
6. September 2023
androidx.compose.material3:material3-*:1.2.0-alpha07
wird veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.
Neue Funktionen
- In
compose material 1.6.0-alpha05
wurde Unterstützung für das automatische Spiegeln von Symbolen hinzugefügt. Weitere Informationen finden Sie in den Versionshinweisen.
API-Änderungen
SliderState
implementiertDraggableState
(I9b116)- „shape“ als erforderlichen Parameter festlegen Benennen Sie
position
in der Formular-Hilfsfunktion inindex
um. (I34941) - Aktualisiert die
DatePicker
formatWithSkeleton
, sodass sie eine Karte enthält, die als Cache zur Leistungssteigerung verwendet wird. (I3195f) BasicTooltipBox
wurde zucompose.foundation
hinzugefügt undPlainTooltipBox
undRichTooltipBox
wurden aktualisiert, umTooltipBox
mit den neuen ComposablesPlainTooltip
undRichTooltip
zu verwenden. (I79e1d)
Fehlerkorrekturen
dynamicLightColorScheme
unddynamicDarkColorScheme
geben jetzt Farben mit höherer Chroma für die Rollen „surface“ undsurfaceContainer
zurück. (I5e901)- Ein Problem wurde behoben, bei dem einige Komponenten, die die Unterkomposition (z.B.
BottomSheetScaffold
) innerhalb eines Scaffold innerhalb einesLookaheadScope
verwenden, versuchten, ihre Größe zu früh zu lesen. (I297b4, I871f1, b/295536718)
Version 1.2.0-alpha06
23. August 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
wird veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Die Berechnung von
DropdownMenu
offset
wurde korrigiert, sodass x-Offsets nur von der lokalen Layoutrichtung abhängen und y-Offsets nicht mehr umgekehrt werden, wenn sich das Menü unten auf dem Bildschirm befindet. (Iccc74, b/294103942) - Die Berechnung von
DropdownMenu
offset
wurde korrigiert, sodass x-Offsets nur von der lokalen Layoutrichtung abhängen und y-Offsets nicht mehr umgekehrt werden, wenn sich das Menü unten auf dem Bildschirm befindet. (Ib87a2, b/294103942)
Version 1.2.0-alpha05
9. August 2023
androidx.compose.material3:material3-*:1.2.0-alpha05
wird veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.
API-Änderungen
- Aktualisierungen der Farben für das Kästchen und
TriStateCheckbox
. DieCheckboxDefaults.colors()
disabledUncheckedColor
wirkt sich jetzt nur noch auf den Rahmen des Kästchens aus. In Sonderfällen, in denen Sie die interne Kästchenfarbe festlegen müssen, wenn sie deaktiviert und nicht ausgewählt ist, ist eine benutzerdefinierte Instanz 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
- Die Abhängigkeit von der Dichte wird auf die Komponentenebene verschoben. Dies gilt für die folgenden Komponenten:
SwipeToDismiss
und blattbasierte Komponenten. Verwenden Sie die neue Überladung, bei der die Dichte ein Parameter ist. (I1846e) - Zusätzliche Anmerkungen zur Angabe zulässiger Eingaben für Composables (Ief234)
- Fügen Sie einen Symbolparameter für segmentierte Schaltflächen hinzu, teilen Sie die Semantik auf, damit segmentierte Schaltflächen für die Einzelauswahl auswählbar und für die Mehrfachauswahl umschaltbar sind, mit
SelectableSegmentedButtonRow
bzw.ToggelableSegmentedButtonRow
. (I38740) - Die Trennlinie wurde in
HorizontalDivider
umbenannt.VerticalDivider
-Funktion hinzugefügt. (I5975c) - Die Verwendung von
ClosedFloatingPointRange
wurde in experimentellen Material3-APIs durch das schlankereFloatRange
ersetzt, um das automatische Boxing 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.
Geändertes Verhalten
includeFontPadding
ist jetzt standardmäßigfalse
in der Material 3-Typografie. Die Standardeinstellung für die Zeilenhöhe wurde ebenfalls inTrim.None
undAlignment.Center
geändert. Außerdem wurde denTextStyle
s vonTypography
ein expliziterlineHeight
(in sp) hinzugefügt. Wenn Sie diese Werte anpassen möchten, sehen Sie in der API-Dokumentation nach. Eine ausführliche Erläuterung dieser Änderungen finden Sie im Blogpost. (I6266f, Icabc3)
Neue Funktionen
- Es wurde eine Überladung für
RangeSlider
hinzugefügt, die eine zustandsbehaftete Version der Komponente ist.RangeSliderState
erstellt, die alle Informationen für den aktuell aktiven Track, die Messungen der Komponenten vonRangeSlider
sowie die Drag-and-Gesture-Logik enthält. (I8c270) - Die Suchleiste unterstützt jetzt Schatten über den neu hinzugefügten Parameter
shadowElevation
. (Ia5369, b/271040353) ColorScheme
unterstützt jetzt neueSurfaceContainer
-Rollen.- Das Overlay für die tonale Erhebung der Oberfläche kann jetzt mit der lokalen Komposition
LocalTonalElevationEnabled
deaktiviert werden. (Ic203c, b/277774590)
API-Änderungen
- Öffnen Sie die Konstruktoren für Komponentenfarben. (I8c4a6)
- Der Parameter „focusable“ wurde beiden Tooltip-APIs hinzugefügt, damit Entwickler festlegen können, ob der Tooltip Touch-Ereignisse verarbeiten soll oder nicht. Beachten Sie, dass dies die automatische Bewegung des Fokus für die Barrierefreiheit unterbrechen kann. (Ie32d8)
- Optimierte Barrierefreiheit für Leistung und Speicherzuweisungen. (Iede48)
DefaultSizeClasses
freigeben undStandardSizeClasses
fürWindowSizeClasses
erstellen (I91838)- Ändern Sie
WindowWidth/HeightSizeClass
in Gleitkommawertklassen (Ie686e).
Fehlerkorrekturen
- Der
contentWindowInsets
-Parameter von Scaffold berücksichtigt jetzt die Insets des verarbeiteten Fensters. Das Verhalten des Content-Paddings basierend auftopBar
undbottomBar
bleibt unverändert, wenn diese Parameter angegeben werden. (I08b73, b/264601542) - Korrigieren Sie die Ausrichtung der oberen App-Leiste in der Mitte, damit ein langer Titel nicht über den Aktionssymbolen oder dem Navigationssymbol gerendert wird. (I4369f, b/236994621)
- Für Tabpositionen wird jetzt eine Mindestbreite von 24 dp für den Inhalt erzwungen. Dadurch wird ein barrierefreies Touch-Ziel für Tab-Indikatoren bereitgestellt. (Id8861)
- Dynamische Farbpaletten aus
dynamicLightColorScheme
unddynamicDarkColorScheme
unterstützen jetzt neue Oberflächenrollen. (I1252e) - Die Ausrichtung von Benachrichtigungen mit Badges wurde aktualisiert, damit sie nicht abgeschnitten werden, wenn sie mit dem übergeordneten Element kollidieren. (Idf75a)
Version 1.2.0-alpha02
24. Mai 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
wird veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
API-Änderungen
- Fügen Sie
ModalBottomSheet
den Parameter für Fenstereinsätze hinzu.- Der Scrim für
ModalBottomSheet
kann jetzt hinter der Statusleiste gezeichnet werden, wennwindowInsets
auf null gesetzt ist. - Die Standardfunktion
ModalBottomSheet
wurde aktualisiert, um außerhalb der Systemleisten, einschließlich der Navigationsleiste, zu bleiben. - Die Verarbeitung von Insets in der Statusleiste erfolgt im Edge-to-Edge-Modus über den Ziehpunkt.
BottomSheetDefaults
enthält Fenstereinsätze fü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 Tabinhalts, währendSecondaryIndicator
die gesamte verfügbare Breite einnimmt.SecondaryIndicator
entspricht dem jetzt eingestelltenIndicator
und kann als direkter Ersatz verwendet werden. (I27604)- Es wurde eine Option hinzugefügt, mit der ein
ScrollState
beim Erstellen einesDropdownMenu
oder einesExposedDropdownMenu
übergeben werden kann, um den vertikalen Scrollstatus der angezeigten Menüelemente zu steuern. (Ia0734, b/185304441) - Es wurde eine Überladung für
Slider
hinzugefügt, die eine zustandsbehaftete Version der Komponente ist.SliderState
erstellt, die alle Informationen für den aktuell aktiven Track, die Messungen der Komponenten vonSlider
sowie die Drag-and-Gesture-Logik enthält. (I124a5) - Umbenennung des Semantics-Attributs
isContainer
inisTraversalGroup
(I121f6) - Optimierte
TextStyle.merge(...)
mit vollständiger Parameterliste hinzugefügt. (Iad234, b/246961787) TooltipState
,RichTooltipState
undPlainTooltipState
sind öffentliche Schnittstellen.RichTooltipStateImpl
undPlainTooltipStateImpl
für Standardstatus wurden hinzugefügt. Es wurdenremember*State
-Funktionen hinzugefügt, um diese implementierten Status abzurufen.TooltipSync
wurde zugunsten vonTooltipDefault.GlobalMutatorMutex
entfernt. (I7813d)- Die
DatePickerColors
wurde aktualisiert und enthält jetzt zusätzliche Anpassungsoptionen für die Farben der Trennlinie der Datumsauswahl, der Navigation und der Texteingabefelder. (I1a685, b/274626815) DatePickerState
undDateRangePickerState
sind jetzt öffentliche Schnittstellen mit Standardimplementierungen, die überrememberDatePickerState
undrememberDateRangePickerState
abgerufen werden können. (I71c52)- Die
dateValidator
wurde ausDatePicker
undDateRangePicker
entfernt und eineSelectableDates
-Schnittstelle eingeführt, die im Status festgelegt werden kann, um zu steuern, welche Datumsangaben oder Jahre in der Benutzeroberfläche ausgewählt werden können. (Ic2fc6) TimePicker
aus stabiler API entfernt, weitere Änderungen in der Status-API werden erwartet (I3f39a)ModalBottomSheet
wurde nur auf Android verschoben.ModalBottomSheet
wird für die Verwendung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv weiterentwickelt. (Ib3778)
Fehlerkorrekturen
- Die Aktion zum Schließen von
AlertDialog
wird jetzt unter der Bestätigungsaktion angezeigt, wenn die Aktionen übereinander gestapelt werden, um in die Breite des Dialogfelds zu passen. Mit dieser Korrektur wird die Implementierung an die Material Design-Spezifikation angepasst. (I029de, b/235454277) - Ein Fehler in
ListItem
wurde behoben, bei dem für dreizeilige Elemente ein falscher Innenabstand verwendet wurde. (I6e235) ModalBottomSheet
kann jetzt die IME-Tastatur anzeigen (Idc508, b/262140644, b/268380384, b/272483584)
Version 1.2.0-alpha01
10. Mai 2023
androidx.compose.material3:material3:1.2.0-alpha01
und androidx.compose.material3:material3-window-size-class:1.2.0-alpha01
werden veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
Version 1.1
Version 1.1.2
20. September 2023
androidx.compose.material3:material3:1.1.2
und androidx.compose.material3:material3-window-size-class:1.1.2
werden veröffentlicht. Version 1.1.2 enthält diese Commits.
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem der Modifier fälschlicherweise an zwei Composables übergeben wurde. (b/282761472)
- Der Fehler, dass
TimePickerState
bei der Initialisierung mit 23 Stunden falsche Stunden zurückgibt, wurde behoben. (b/278242122) - Der anfängliche Ein/Aus-Status für die Validierung von Mittag und Minute wurde korrigiert. (b/269768197, b/282790635)
- Der Fehler wurde behoben, bei dem
state.hour
für 23:00 Uhr einen falschen Wert zurückgegeben hat. (b/282761472, b/278242122)
Version 1.1.1
21. Juni 2023
androidx.compose.material3:material3:1.1.1
und androidx.compose.material3:material3-window-size-class:1.1.1
werden veröffentlicht. Version 1.1.1 enthält diese Commits.
Fehlerkorrekturen
- Ruft
ModalBottomSheet
ohne den ParameterwindowInset
für die binäre Kompatibilität auf. (Ib7959) - Fügen Sie
ModalBottomSheet
den Parameter für Fenstereinsätze hinzu.- Der Scrim für
ModalBottomSheet
kann jetzt hinter der Statusleiste gezeichnet werden, wennwindowInsets
auf null gesetzt ist. - Die Standardfunktion
ModalBottomSheet
wurde aktualisiert, um außerhalb der Systemleisten, einschließlich der Navigationsleiste, zu bleiben. - Die Verarbeitung von Insets in der Statusleiste erfolgt im Edge-to-Edge-Modus über den Ziehpunkt.
BottomSheetDefaults
enthält Fenstereinsätze fü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 veröffentlicht. Version 1.1.0 enthält diese Commits.
Wichtige Funktionen von Version 1.1.0
Neue Material Design 3-Komponenten
Verbesserungen an vorhandenen Material Design 3-Komponenten:
Experimentelle APIs wurden zu stabilen APIs hochgestuft.
Weitere Informationen finden Sie in diesem Blogpost.
Version 1.1.0-rc01
19. April 2023
androidx.compose.material3:material3:1.1.0-rc01
und androidx.compose.material3:material3-window-size-class:1.1.0-rc01
werden veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.
API-Änderungen
TimePicker
aus stabiler API entfernt, weitere Änderungen in der Status-API werden erwartet (I3f39a)ModalBottomSheet
wurde nur auf Android verschoben.ModalBottomSheet
wird für die Verwendung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv weiterentwickelt. (Ib3778)
Version 1.1.0-beta02
5. April 2023
androidx.compose.material3:material3:1.1.0-beta02
und androidx.compose.material3:material3-window-size-class:1.1.0-beta02
werden veröffentlicht. Version 1.1.0-beta02 enthält diese Commits.
API-Änderungen
SheetState
hat jetzt den optionalen ParameterskipHiddenState
rememberStandardBottomSheetState
hat jetzt den optionalen ParameterskipHiddenState
BottomSheetScaffold
hat jetzt einen definierten verborgenen Anker, der jedoch standardmäßig deaktiviert ist.- Die Dokumentation für
SheetState.requireOffset
wurde aktualisiert. BottomSheetDefaults.MinimizedShape
wurde inBottomSheetDefaults.HiddenShape
umbenannt (I839f4, b/273870234).
Fehlerkorrekturen
- Bei aktivierter Touch-Bedienung wird das Zifferblatt nicht von Stunde auf Minute umgeschaltet. (I717d0)
- Die Semantik für das Ziehen von
ModalBottomSheet
undBottomSheetScaffold
wurde zusammengeführt. (I05afb) - Der Modifikator
BottomSheetScaffold
sowie die ParametercontainerColor
undcontentColor
wirken sich jetzt nur noch auf Inhalte aus. (I992cb) - In
BottomSheetScaffold nestedScroll
für Tabellenblattinhalte werden jetzt Wischbewegungen unterstützt. (I992cb)
Version 1.1.0-beta01
22. März 2023
androidx.compose.material3:material3:1.1.0-beta01
und androidx.compose.material3:material3-window-size-class:1.1.0-beta01
werden veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.
API-Änderungen
- Füge dem
TimePicker
-Composable einen Parameter für den Layouttyp hinzu. Je nach Bildschirmkonfiguration (Ia0e16) können verschiedene Layouts verwendet werden. SearchBarDefaults
wurde als experimentell markiert. (I65561)- Schattenhöhe für
BottomSheetScaffold
hinzugefügt (I94e0f) - Unterstützung für die Anzeige der Datumsauswahl ohne Kopfzeile hinzugefügt. API-Änderungen, um beim Erstellen einer Datumsauswahl eine Null-Überschrift zu übergeben. Sie können jetzt „null“ für „headline“, „title“ und
showToggleMode = false
übergeben, um eine Headless-Auswahl zu präsentieren. (Id3f3a, b/266132421, b/267194809)
Fehlerkorrekturen
- Suchleisten verlieren jetzt automatisch den Fokus, wenn sie inaktiv werden. (I22a7c, b/261444487)
- Die
DateRangePicker
wurde aktualisiert, sodass ein Zeitraum mit demselben Start- und Enddatum ausgewählt werden kann. (I16529, b/272882497) - Textfelder positionieren ihre Textelemente jetzt richtig, wenn die Schriftgröße kleiner als erwartet ist. Je nach Schriftarteinstellungen und Skript kann sich das auf einige Pixel in Ihren Apps auswirken. (I8b8d0)
- Semantische Aktionen in der Ansicht am unteren Rand haben jetzt Labels. (I277b0)
Version 1.1.0-alpha08
8. März 2023
androidx.compose.material3:material3:1.1.0-alpha08
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha08
werden veröffentlicht. Version 1.1.0-alpha08 enthält diese Commits.
Neue Funktionen
- Unterstützung für
BottomSheetScaffold
undBottomSheetScaffoldState
hinzugefügt. (I063d4)
API-Änderungen
- Der
DatePickerState
und demDateRangePickerState
wurde die Funktion hinzugefügt, Datumsangaben nach der Erstellung des Status festzulegen und Auswahlen durch Festlegen von Null-Zeitstempeln zurückzusetzen. Das manuelle Festlegen von Datumsangaben sollte mit Vorsicht erfolgen. Die neue FunktionsetSelection
löst eine Ausnahme aus, wenn ein angegebenes Datum eine Vorbedingung nicht erfüllt (siehe Dokumentation). (Ifa645, b/268609314, b/270427389) - Benennen Sie „Collapsed
SheetValue
“ in „PartiallyExpanded
“ um, um das Verhalten in diesem Status genauer und flexibler darzustellen. (Ia1491) - Die Namen der
ListItem
-Parameter wurden von „_text“ in „_content“ geändert. Standard-Getter sind jetztReadOnlyComposables
, sofern relevant. (I69a25) - Interaktive Surface-APIs aus der experimentellen Phase herausnehmen. (I90d59, b/261561812)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem der Status von
ModalBottomSheet
HalfExpanded
falsch berechnet wurde und das Blatt schwebend angezeigt wurde. (I45e84, b/268411386) - Füge die
confirmValueChange
-Prüfung für das Tippen auf den Scrim fürModalBottomSheet
hinzu. (I2311a, b/270425759) - Semantische
BottomSheet
-Aktionen werden zum Ziehpunkt verschoben. (I158ba) ModalBottomSheet
-Befehle konzentrieren sich jetzt auf den Start und verarbeiten die Zurück-Schaltfläche. (I4d2ab)ModalBottomSheet onDismissRequest
wird jetzt auch bei verschachtelten Scroll-Flings berücksichtigt. (I655c5, b/268433166)
Version 1.1.0-alpha07
22. Februar 2023
androidx.compose.material3:material3:1.1.0-alpha07
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha07
werden veröffentlicht. Version 1.1.0-alpha07 enthält diese Commits.
Neue Funktionen
- Fügen Sie ein zusammensetzbares Element für die Zeiteingabe hinzu, das mit
rememberTimePickerState()
funktioniert und der M3-Spezifikation für die Zeiteingabe (Ia4fab) entspricht. - Es wurde eine Material 3-
DateRangePicker
-API zum Auswählen eines Zeitraums hinzugefügt. (I7a6c3, b/267194809) - Unterstützung für die Auswahl von Zeiträumen über die
DateRangePicker
API im Material 3-Eingabemodus wurde hinzugefügt. (Ifdbc4) - Die Farben von Textfeldern können jetzt angepasst werden:
- Die Farben des Eingabefelds und des Platzhaltertexts basierend auf dem Fokus und dem Fehlerstatus. Der Parameter
textColor
wurde inunfocusedTextColor
undplaceholderColor
inunfocusedPlaceholderColor
umbenannt. - Die Containerfarbe für ausgefüllte Textfelder basierend auf dem Fehlerstatus mit dem neuen Parameter
errorContainerColor
.
- Die Farben des Eingabefelds und des Platzhaltertexts basierend auf dem Fokus und dem Fehlerstatus. Der Parameter
- Die Farben der Textfelder für Drop-down-Menüs wurden mit Parametern aktualisiert, um die neue Prefix- und Suffix-API zu unterstützen. (I9c8b4, b/254284181, b/264766350)
API-Änderungen
- Einige Slider API-Versionen werden zurückgesetzt und redundante Slider-Überladungen werden entfernt, die vom neuen experimentellen Slider mit benutzerdefiniertem Thumb und Track abgedeckt werden.
RangeSlider
als stabil einstufen. (Ie8fbd) - Die Erhebungsfunktionen des Chips wurden von
defaultElevation
inelevation
umbenannt. (I0f872) - Die folgenden Material 3-Textfeld-APIs sind nicht mehr experimentell:
TextField
,OutlinedTextField
,textFieldWithLabelPadding
,textFieldWithoutLabelPadding
,outlinedTextFieldPadding
. (Ieb5c0, b/261561819) TimePickers
is24Hour
verwendet die Systemeinstellung (I18856)- Die experimentelle Annotation wurde aus den Scaffold-APIs entfernt. (Ibb51e, b/261565765, b/261436953)
Fehlerkorrekturen
- Die Standardform von
ModalBottomSheet
ist jetzt immerSheetDefaults.ExpandedShape
. (I0dfca) - Verbesserungen bei den Bedienungshilfen für Material 3
DatePicker
undDateRangePicker
. (I5087e) - Es wurde ein Fehler behoben, durch den die Beschränkung für die maximale Höhe weitergegeben wurde und es zu einem Absturz kommen konnte. (I30d8c)
- Semantische Rollen wurden aus klickbaren und auswählbaren Oberflächen entfernt. Komponenten, in denen sie verwendet wurden, wurden aktualisiert, um Rollen mit „modifier.semantics“ festzulegen. (I793d9)
Version 1.1.0-alpha06
8. Februar 2023
androidx.compose.material3:material3:1.1.0-alpha06
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha06
werden veröffentlicht. Version 1.1.0-alpha06 enthält diese Commits.
Neue Funktionen
- Textfelder unterstützen jetzt Präfix- und Suffixtext (Ia8578, b/179884561)
- Die Funktion
TimePicker
wurde hinzugefügt, um eine Zeitauswahl gemäß der Material 3-Spezifikation anzuzeigen. Sie wird in Verbindung mitTimePickerState
und der Convenience-MethoderememberTimePickerState
verwendet (I71910). - Die Datumseingabe ist jetzt ein Anzeigemodus unter
DatePicker
. Unterstützung für das Umschalten zwischen der Datumsauswahl und der Datumeingabe hinzugefügt. (Ieeff7) - API für
RichTextTooltips
hinzugefügt. (I58ef3) - Implementierung des modalen Blatts am unteren Rand für Material 3, einschließlich
ModalBottomSheet
undModalBottomSheetDefaults
. Außerdem werdenSheetState
undrememberSheetState
eingeführt, die für zukünftige Tabellenblattkomponenten verwendet werden können. (I0853a, b/244189383)
API-Änderungen
- API
showSnackbar
stabilisieren (I195c2, b/261424370) - APIs für Assist-Chip und Vorschlagschip stabilisieren (Ibb67b, b/261424370)
- Die APIs
ListItem
,ListItemDefaults
undListItemColors
werden als nicht experimentell eingestuft (I7e7fa, b/261438882). - Die APIs
SliderPositions
,SliderDefaults.Thumb
undSliderDefaults.Track
werden als stabil eingestuft und es werden nicht experimentelleSlider
- undRangeSlider
-APIs mit benutzerdefinierten Thumbnails und Tracks hinzugefügt. Die bisherigen APIsSlider
undRangeSlider
werden ebenfalls eingestellt. (Ie5ea6, b/261566890) Modifier.tooltipAnchor()
wurde öffentlich gemacht, damit Entwickler es an den Anker übergeben können, um anzugeben, dass bei langem Drücken eine Kurzinfo angezeigt werden soll. DiePlainTooltipBox
API wurde aktualisiert.TooltipState
ist jetzt nicht mehr nullable und hat einen Standardwert. (Ie2fb7)ProgressIndicatorDefaults.circularTrackColor
wurde zur besseren Übersichtlichkeit mit@Composable
markiert. (Id29cc)- Die Getter-Methode
LocalMinimuTouchTargetEnforcement
für die wiederhergestellte Property wurde wiederhergestellt, als eingestellt markiert und zur MethodeLocalMinimumInteractiveComponentEnforcement
weitergeleitet. (I60dd5)
Version 1.1.0-alpha05
26. Januar 2023
androidx.compose.material3:material3:1.1.0-alpha05
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha05
werden veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.
Neue Funktionen
DatePickerDialog
und Support für Bedienungshilfen- Benutzerdefinierte Miniatur und benutzerdefinierter Track wurden
RangeSlider
hinzugefügt.
Abhängigkeitsupdates
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 veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.
Neue Funktionen
- Erste
DatePicker
-API zum Auswählen eines einzelnen Datums über eine Kalender-Benutzeroberfläche. Diese API wird noch geändert. (I722b9) - Unterstützung für einfache Tooltips über
PlainTooltipBox
wurde hinzugefügt. (I0cdfb) - Suchleiste (Iad128)
SwipeToDismiss
(I458a8, b/242889540)
API-Änderungen
- Die Semantik-Property
IsContainer
wurde auf Plattformen hinzugefügt. Diese Eigenschaft wird bei einer späteren Änderung verwendet, bei der die Reihenfolge der Traversierung auf der Grundlage der semantischen Bedeutung von Elementen wie Oberflächen bestimmt wird. (I63379) - Markieren Sie APIs für die Navigationsleiste als stabil. (Iab01e, b/261439597)
- Für kreisförmige Fortschrittsanzeigen wurde ein Parameter für die Farbe der Spur und für kreisförmige und lineare Fortschrittsanzeigen ein Parameter für die Form der Linienenden hinzugefügt. (Ie668c, b/216325962, b/222964817)
- Weitere Informationen zur Nullable-Eigenschaft des Rückgabetyps von eingestellten, ausgeblendeten Funktionen (Ibf7b0)
- Fügen Sie
Modifier.minimumInteractiveComponentSize
hinzu. Damit können Sie mindestens 48 dp für die eindeutige Unterscheidung von Berührungsinteraktionen reservieren, wenn das Element kleiner wäre. (I33f58, b/258495559) - Es wurde eine experimentelle API für die
AlertDialog
-Composable-Funktion mit einem Inhalts-Slot hinzugefügt. (Iec4a2)
Fehlerkorrekturen
- Der Fortschritt für Fortschrittsindikatoren ist jetzt korrekt auf den erwarteten Bereich begrenzt. (I8a7eb, b/262262727)
Bekanntes Problem
- Beim Aktualisieren von
androidx.compose.foundation:1.4.0-alpha03
aufandroidx.compose.foundation:1.4.0-alpha04
kann der Fehlerjava.lang.NoSuchFieldError
auftreten. Hier wurde das Problem ursprünglich gemeldet. Ein Fix wurde eingereicht und ist im nächsten Compose-Update verfügbar. Als Behelfslösung können Sie Ihreandroidx.compose.material
- undandroidx.compose.material3
-Bibliotheken auf die neueste Version(1.1.0-alpha04) aktualisieren oder Ihreandroidx.compose.foundation
-Bibliothek auf Version 1.4.0-alpha03 downgraden.
Version 1.1.0-alpha03
7. Dezember 2022
androidx.compose.material3:material3:1.1.0-alpha03
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
werden veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.
API-Änderungen
consumedWindowInsets()
wurde inconsumeWindowInsets()
undwithConsumedWindowInsets()
inonConsumedWindowInsetsChanged()
umbenannt. Außerdem wurden die Modifikatoren öffentlich gemacht. (Ie44e1)- Es wurde ein neuer Standard-Inhaltsabstand für Textschaltflächen mit Symbol hinzugefügt. (I8f662)
- Es wurden deaktivierte Farben für die Navigationsleiste und die Navigationsspalte hinzugefügt. (Ia7892, b/258867034)
- Eine Modifier API zum Abfragen von Scrollinformationen für übergeordnete Elemente wurde hinzugefügt. (I2ba9d, b/203141462)
- Wird in
Clickable
verwendet, um Tippinteraktionen richtig zu verzögern, wenn aus Gesten Scroll-Ereignisse werden könnten. - Das Problem, dass
Clickables
Ripples nicht richtig verzögert hat, wenn es in einemScrollable ViewGroup
verwendet wurde, wurde behoben. - Die Schubladen und Sheets wurden aktualisiert, um das Drücken korrekt zu verzögern, falls Gesten zu Scroll-Ereignissen werden können.
Abhängigkeitsupdates
Compose UI
undCompose Material
sind jetzt von Lifecycle 2.5.1 abhängig. (I05ab0, b/258038814)
Version 1.1.0-alpha02
9. November 2022
androidx.compose.material3:material3:1.1.0-alpha02
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
werden veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.
API-Änderungen
awaitFirstDown
undwaitForUpOrCancellation
akzeptieren jetzt einPointerEventPass
für mehr Flexibilität. Außerdem wird das Problem behoben, dass beiExposedDropdownMenuBox
beim Scrollen ein Menü angezeigt wurde. (I7579a, b/212091796)- Der Parameter
minLines
wurde in die Material- und Material3-TextkomponentenTextField
undOutlinedTextField
eingefügt. Damit kann die Mindesthöhe der Komponente in Bezug auf die Anzahl der Zeilen festgelegt werden (I4af1d). - Die Funktion
TopAppBarDefaults smallTopAppBarColors
wird zugunsten einer neuen FunktiontopAppBarColors
eingestellt, die beim Erstellen einesTopAppBar
verwendet werden sollte. (Ie6cb9) - Der Parameter
minLines
wurde denBasicText
undBasicTextField
hinzugefügt. Damit kann die Mindesthöhe dieser Composables in Bezug auf die Anzahl der Zeilen festgelegt werden (I24294, b/122476634).
Fehlerkorrekturen
- Schneiden Sie den Inhalt eines Material3-
IconButton
undIconToggleBotton
auf die Form der Status-Ebene der Komponente zu (z.B. kreisförmig). (I9da8f) - Die mittleren und großen oberen App-Leisten von Material3 wurden aktualisiert, sodass auf der gesamten Oberfläche dieselbe Hintergrundfarbe verwendet wird. Außerdem können die Standardfarben mit transparenten Farbwerten überschrieben werden. (I67659, b/249688556, b/250838918)
Version 1.1.0-alpha01
24. Oktober 2022
androidx.compose.material3:material3:1.1.0-alpha01
und androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
werden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Es wurden Fehler in der oberen App-Leiste behoben, wenn der Titel mit einem TextStyle und einem Brush angewendet wird. (If667e)
Version 1.0
Version 1.0.1
9. November 2022
androidx.compose.material3:material3:1.0.1
und androidx.compose.material3:material3-window-size-class:1.0.1
werden veröffentlicht. Version 1.0.1 enthält diese Commits.
Fehlerkorrekturen
- Die mittleren und großen oberen App-Leisten von Material3 wurden aktualisiert, sodass auf der gesamten Oberfläche dieselbe Hintergrundfarbe verwendet wird. Außerdem können die Standardfarben mit transparenten Farbwerten überschrieben werden. (I67659, b/249688556, b/250838918)
Version 1.0.0
24. Oktober 2022
androidx.compose.material3:material3:1.0.0
und androidx.compose.material3:material3-window-size-class:1.0.0
werden veröffentlicht. Version 1.0.0 enthält diese Commits.
Wichtige Funktionen von Version 1.0.0
Dies ist die erste stabile Version von Compose Material 3.
Material Design 3-Thematisierung und dynamische Material You-Farben
Material Design 3-Komponenten
- Abzeichen
- Untere App-Leiste
- Schaltflächen
- UAS und erweitertes UAS
- Infokarten
- Kästchen
- Chips
- Dialogfelder
- Trennlinie
- Drop-down-Menü
- Liste
- Navigationsleiste
- Navigationsleiste
- Navigationsleiste
- Fortschrittsanzeige
- Optionsfeld
- Schieberegler
- Wechseln
- Tabs
- Textfelder
- Obere App-Leiste
- Symbol
- Text
- Oberfläche
- Layout
- Inhaltsfarbe
Klasse für Fenstergröße
material3-window-size-class
ist eine neue Bibliothek, die Unterstützung für Fenstergrößenklassen bietet. Das sind eine Reihe von Ansichtsfenster-Breakpoints, die Ihnen als Grundlage für das Design, die Entwicklung und das Testen von anpassbaren Anwendungslayouts dienen. MitcalculateWindowSizeClass
können Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche dargestellt werden soll. Bei größeren Fenstergrößen kann beispielsweise eine Navigationsleiste anstelle der unteren Navigation angezeigt werden. Weitere Informationen und Beispiele zur Verwendung finden Sie in der API-Referenzdokumentation fürWindowSizeClass
.Weitere Informationen finden Sie in diesem Blogpost.
Version 1.0.0-rc01
5. Oktober 2022
androidx.compose.material3:material3:1.0.0-rc01
und androidx.compose.material3:material3-window-size-class:1.0.0-rc01
werden veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
API-Änderungen
- Es wurde ein Slot-Parameter zur Unterstützung der Text-zu-Textfeld-API hinzugefügt (Iaac0d, b/227146125).
Version 1.0.0-beta03
21. September 2022
androidx.compose.material3:material3:1.0.0-beta03
und androidx.compose.material3:material3-window-size-class:1.0.0-beta03
werden veröffentlicht. Version 1.0.0-beta03 enthält diese Commits.
API-Änderungen
ExposedDropdownMenuDefaults
stellt jetzt einen Auffüllwert für Menüelemente bereit. (I34ee1)ExposedDropdownMenuBoxScope
hat jetzt einenModifier.menuAnchor()
-Modifikator, der für ein korrektes Verhalten in Bezug auf die Barrierefreiheit an das Textfeld übergeben werden sollte. (I27fa3)- Hinzufügen von zwei überladenen Methoden für die aktuelle Slider API, damit Nutzer einen Thumb oder Track übergeben können, um den Slider zu füllen. (I21c00)
Fehlerkorrekturen
- Die Farbzuordnung für das dunkle Design für „On Error Container“ wurde zu Ton 90 (Ic5612) aktualisiert.
- Es wurde ein Fehler behoben, der das Festlegen eines transparenten Hintergrunds für kleine Material 3-App-Leisten oben verhindert hat. (I645e2, b/245575782)
Version 1.0.0-beta02
7. September 2022
androidx.compose.material3:material3:1.0.0-beta02
und androidx.compose.material3:material3-window-size-class:1.0.0-beta02
werden veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.
API-Änderungen
- Die in M3-Komponenten in der Beta01-Version eingeführten Standardkomponenteneinzüge berücksichtigen keine IME-Einzüge mehr.
- Die Material3-Scaffold-Komponente hat jetzt einen
contentWindowInsets
-Parameter, mit dem Sie die Anzahl der Insets für den Inhalts-Slot angeben können. (Icf11a, b/243713323) - Die experimentelle Material 3-Funktion
SmallTopAppBar
wird eingestellt und eine entsprechende FunktionTopAppBar
wird eingeführt. Migrieren Sie Ihre Nutzung bitte auf die neue. (I74404, b/226918634) - Fügt die Steuerung des Wisch- und Einrastverhaltens der oberen App-Leiste hinzu. (I15c81)
- Entfernt „startIndent“ aus „Divider“ und verschiebt die Farbe in den letzten Parameter. (If7be2)
Fehlerkorrekturen
- Dialogfelder müssen sich TalkBack-Nutzern gegenüber identifizieren, indem sie das Wort „Dialog“ ausgeben, wenn sie angezeigt werden. (I857ef)
Version 1.0.0-beta01
24. August 2022
androidx.compose.material3:material3:1.0.0-beta01
und androidx.compose.material3:material3-window-size-class:1.0.0-beta01
werden veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
API-Referenz
Die neuesten verfügbaren Composables für das Theming, Komponenten und andere Elemente finden Sie in der Compose Material 3 API-Referenzübersicht.
API-Änderungen
- Die obere App-Leiste mit Material 3 kann jetzt vollständig minimiert oder maximiert werden. Außerdem wurde die Verhaltensfunktion
TopAppBarDefaults
aktualisiert, sodass sie Composables ist und Standardwerte für den Status der oberen App-Leiste und die Animationsspezifikation bereitstellt. (I642b3) - Aktualisierte Signaturen der FAB-Komponente, die der Surface API (I3afaa) entsprechen
- Es wurde eine integrierte Unterstützung für Insets für obere App-Leisten, Drawers, Navigationsleisten und Rails hinzugefügt. Diese Komponenten, die separat oder mit Scaffold verwendet werden, verarbeiten automatisch Insets für Entwickler. Hinweis: Durch diese Änderung wird keine automatische Verarbeitung von Statusleistensymbolen und Transparenz der Status- und Navigationsleisten hinzugefügt. Bitte machen Sie das weiterhin manuell, um die beste Darstellung zu erzielen. (I7e4e6, b/183161866)
- Die Standardeinstellungen für Komponenten wurden aktualisiert, um die API-Oberfläche für zukünftige Flexibilität und Leistungsverbesserungen zu verringern. (I31820)
- Die Parameter für Chip und Navigationsleiste wurden neu angeordnet, um die Konsistenz innerhalb der API zu wahren (I45d0b).
startIndent
wurde aus „Divider“ entfernt und die Farbe ist jetzt der letzte Parameter.(If7be2)
Version 1.0.0-alpha16
10. August 2022
androidx.compose.material3:material3:1.0.0-alpha16
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
werden veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.
Neue Funktionen
- Unterstützung für die Angabe einer benutzerdefinierten Breite für eine Navigationsleiste. (Ia7f10)
API-Änderungen
- Tab- und Leading-Icon-Tab-Parameter neu anordnen, um die Konsistenz innerhalb der API zu wahren (Ie2637)
BadgeDefaults
als experimentell gekennzeichnet (I98ef3)- Die eingestellte Navigationsleistenfunktion wurde entfernt. (I4f2db)
- Parameter für den Slider in Material 3 neu anordnen, um die Konsistenz innerhalb der API zu wahren (I0aee7)
NavigationBar
- undNavigationRail
-Parameter neu anordnen, um die Konsistenz innerhalb der API aufrechtzuerhalten (I51cda)- Parameter in Material 3 neu anordnen, um die Konsistenz in der gesamten API zu wahren. (If4ae1)
- Slider-Parameter in Material 3 neu anordnen, um die Konsistenz innerhalb der API zu wahren (I62673)
- Der Parameter „icons“ wurde in „actions“ umbenannt, um ihn an die obere App-Leiste anzupassen (Id75be).
- Markiere
Badge
undBadgedBox
als experimentell, da die Ankerausrichtung noch nicht endgültig festgelegt ist. (I1712e, b/236524516) - Ändere
@ExperimentalMaterial3Api
-Anmerkungen für Symbolschaltflächenvarianten in@OptIn
(I070b5). - Der Inhalt des Navigationsbereichs wurde in eine eigene zusammensetzbare Funktion ausgelagert, um eine benutzerdefinierte Breite festlegen zu können. (Ia7f10)
- Entfernt
Divider
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 veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.
Neue Funktionen
- Das Ziehen der oberen App-Leiste an der Leiste selbst zulassen. (I65c00, b/205873416)
API-Änderungen
- Die APIs
FilterChip
undElevatedFilterChip
wurden aktualisiert, um denselectedIcon
-Slot zu entfernen und die Wiederverwendung vonleadingIcon
zum Anzeigen eines ausgewählten Status zu fördern. (Ie5dc2) - Rollen für die Farbe von Scrim und Umrissvariante hinzufügen. (Id6d54)
- Namenskonventionen für zusammensetzbare Standardeinstellungen korrigieren (I62b27)
ListItemDefaults
undListItemColors
als experimentell markieren (I1f3ec)- Änderungen an der API für die obere App-Leiste, um die Bedeutung der Statusattribute besser widerzuspiegeln. Kennzeichnen Sie die Top-App-Leiste-API außerdem als experimentell. (Ic0ad8)
- Die Farben für die Textauswahl wurden jetzt in
TextFieldColors
hinzugefügt, um die Auffindbarkeit zu verbessern. (Iba1b8) ButtonDefault.ButtonWithIconContentPadding
für Schaltflächen mit Symbolen hinzufügen. (I2bf9c)- Textfelder wurden als experimentell markiert, um mehr Flexibilität bei zukünftigen API-Änderungen zu ermöglichen. (I127b5)
- Die Annotation
@ExperimentalMaterial3Api
wurde aus der FunktionCheckbox
entfernt. (I5eefc) - Die Annotation
@ExperimentalMaterial3Api
wurde aus der FunktionRadioButton
entfernt. (I17e2a) - Die Annotation
@ExperimentalMaterial3Api
wurde aus den nicht interaktiven Karten entfernt. (I9bd49) - Aktualisiert verschiedene Standardobjekte für Komponenten, um Farben, Formen usw. einzuschließen (I96e11)
Fehlerkorrekturen
- Nicht funktionierende nachgestellte Symbole wurden aus den Beispielen für Eingabe-Chips entfernt, um Verwirrung bei Nutzern der Katalog-App zu vermeiden. (I9846a)
Version 1.0.0-alpha14
29. Juni 2022
androidx.compose.material3:material3:1.0.0-alpha14
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
werden veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.
Neue Funktionen
- M3-Listenimplementierung hinzugefügt. Informationen zur Verwendung finden Sie in der Dokumentation (Id7a20).
API-Änderungen
- Parametername von „values“ in „value“ in
RangeSlider
ändern (I3b79a) - API-Änderungen an der
InputChip
-Implementierung zur Unterstützung eines auswählbaren Status gemäß der Material Design-Spezifikation. Zusätzliche Unterstützung für dieFilterChip
-Farben für den ausgewählten deaktivierten Status. (I55244, b/235792432) - Standard-FAB für
BottomAppBar
hinzufügen (Ida4c8) ColorScheme.surfaceColorAtElevation
wurde hinzugefügt (Id41af)- Schnittstellen in Compose-Bibliotheken werden jetzt mit JDK8-Standardschnittstellenmethoden erstellt (I5bcf1).
WindowWidthSizeClass
undWindowHeightSizeClass
implementieren jetzt Comparable, sodass sie mit Operatoren (<, <=, >=, >) und anderen APIs verglichen werden können. (I747d0)
Fehlerkorrekturen
- Aktualisieren Sie das Beispiel für das Logo, um eine aussagekräftigere Inhaltsbeschreibung zu liefern. (I10b9d)
- Es wurde eine Option hinzugefügt, mit der die Systemschriftgröße in der Designauswahl des Material 3-Katalogs verwendet werden kann. (I10605)
- Fügt Beispielcode für Badge- und unbestimmte Fortschrittsanzeigen hinzu. (I8fbe0)
Version 1.0.0-alpha13
1. Juni 2022
androidx.compose.material3:material3:1.0.0-alpha13
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
werden veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.
API-Änderungen
- Unterstützt das Beibehalten der Position der oberen App-Leiste bei einer Konfigurationsänderung. (I10459, b/216160958)
Version 1.0.0-alpha12
18. Mai 2022
androidx.compose.material3:material3:1.0.0-alpha12
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
werden veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.
Fehlerkorrekturen
- Das übergeordnete Element des Sliders kann jetzt eine Breite von 0 haben. (b/231707291)
Version 1.0.0-alpha11
11. Mai 2022
androidx.compose.material3:material3:1.0.0-alpha11
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
werden veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.
Neue Funktionen
RangeSlider
wurde zu Material 3 (I18e38) hinzugefügt.- Unterstützung für Material3-
AssistChip
undInputChip
hinzugefügt (I0d25a) - Unterstützung für Material3-
FilterChip
undSuggestionChip
hinzugefügt (I9fdf3)
API-Änderungen
- Die zusammensetzbare Funktion
TextFieldDefaults.BorderStroke
, mit der ein Rahmenstrich inOutlinedTextField
gezeichnet wird, wurde inTextFieldDefaults.BorderBox
umbenannt. (I5f295) - Visuelle Änderungen bei M3 (Iab30e)
- Allow passing colors to the standard icon buttons. (Ia2445)
Fehlerkorrekturen
- Lint-Prüfung für material3/Scaffold hinzufügen, um sicherzustellen, dass das innere Padding verwendet wird (I72293, b/226951418)
Version 1.0.0-alpha10
20. April 2022
androidx.compose.material3:material3:1.0.0-alpha10
und androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
werden veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.
Neue Funktionen
material3-window-size-class
ist eine neue Bibliothek, die Unterstützung für Fenstergrößenklassen bietet. Das sind eine Reihe von Ansichtsfenster-Breakpoints, die Ihnen als Grundlage für das Design, die Entwicklung und das Testen von anpassbaren Anwendungslayouts dienen. MitcalculateWindowSizeClass
können Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche dargestellt werden soll. Bei größeren Fenstergrößen kann beispielsweise eine Navigationsleiste anstelle der unteren Navigation angezeigt werden. Weitere Informationen und Beispiele finden Sie in der API-Referenzdokumentation zuWindowSizeClass
. Weitere Informationen zu den Definitionen der Fenstergrößenklassen finden Sie in der öffentlichen Anleitung zur Unterstützung verschiedener Bildschirmgrößen.
API-Änderungen
- Fügt die Standard-UAS-Erhebung für
BottomAppBar
hinzu und entfernt das nachgestellte Lambda ausBottomAppBar
mit UAS. (I92c47) - Fügt Material3-
FilledIconButton
,FilledTonalIconButton
undOutlinedIconButton
hinzu. (Ib2bda) - Die Material 3-Snackbar-API wurde aktualisiert, sodass Farbwerte für die optionale Aktion und die Schließen-Aktion akzeptiert werden. (Ibe4b4)
- Die teilweise Nutzung (Down- oder Position) wurde in
PointerInputChange
eingestellt. Mitconsume()
können Sie die Änderung vollständig übernehmen. MitisConsumed
können Sie feststellen, ob die Änderung bereits von jemand anderem übernommen wurde. PointerInputChange::copy()
erstellt jetzt immer eine oberflächliche Kopie. Das bedeutet, dass Kopien vonPointerInputChange
verbraucht werden, sobald eine der Kopien verbraucht wird. Wenn Sie ein ungebundenesPointerInputChange
erstellen möchten, verwenden Sie stattdessen den Konstruktor. (Ie6be4, b/225669674)- Änderungen an der Cards API, um die Container- und Inhaltsfarben über eine
CardColors
-Schnittstelle zu empfangen und einen deaktivierten Status für anklickbare Karten zu unterstützen. (I927df) - Der Parameter
backgroundColor
wurde in Material 3-Textfeldern incontainerColor
umbenannt, um die Konsistenz mit anderen Komponenten zu verbessern. (I6fbd9)
Fehlerkorrekturen
- Aktualisierungen des Standard-
IconButton
, um es an die Material3-Spezifikation anzupassen. (I09eab) - Die Höhe der oberen Leiste von Material3 Scaffold wird in das Padding verschoben, das an „content“ übergeben wird. So kann der Inhalt unter der oberen App-Leiste gerendert werden. Wenn die
PaddingValues
ignoriert werden, kann der Inhalt durch die obere Leiste verdeckt werden. (I83cbc, b/217776202)
Version 1.0.0-alpha09
6. April 2022
androidx.compose.material3:material3:1.0.0-alpha09
wird veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
Neue Funktionen
- Material 3-Schalter-API (I2c3ad) hinzugefügt
API-Änderungen
- Unterstützung für Drop-down-Menüs mit Textfeldern (auch als „offengelegte Drop-down-Menüs“ oder „Kombinationsfelder“ bezeichnet) hinzugefügt. (I1b832)
- Dem MaterialTheme- und Shape-Subsystem wurde ein Formparameter hinzugefügt. (I37426)
ExtendedFloatingActionButton
wurde ein erweiterter Parameter hinzugefügt, um zu steuern, ob das FAB maximiert oder minimiert wird. Zwischen den einzelnen Status werden Animationen angezeigt. Für erweiterte UASs ohne Symbol wurde eine Überladung für erweiterte UASs mit nachfolgendem Text hinzugefügt. (Iba7f1)
Version 1.0.0-alpha08
23. März 2022
androidx.compose.material3:material3:1.0.0-alpha08
wird veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
- Unterstützung für Material 3-Textfelder 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
- Der Standardwert für den Textstil der Material3-Schaltfläche wird jetzt aus dem MaterialTheme gelesen. (Ie62fc)
Version 1.0.0-alpha07
9. März 2022
androidx.compose.material3:material3:1.0.0-alpha07
wird veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
- Aktualisierungen der Material 3 Surface API, durch die die überladenen Funktionen für klickbare Surfaces zurückkehren. Außerdem wurde eine Funktion zur Unterstützung von auswählbaren und umschaltbaren Surfaces hinzugefügt. (I4bf18)
LazyVerticalGrid
undLazyHorizontalGrid
sind jetzt stabil. (I307c0)LazyVerticalGrid/LazyHorizontalGrid
und alle zugehörigen APIs wurden in das Unterpaket „.grid“ verschoben. Aktualisieren Sie Ihre Importe von „androidx.compose.foundation.lazy“ zu „androidx.compose.foundation.lazy.grid“. (I2d446)- Die vorherige Änderung, bei der nur eine Ansicht für
WindowInsetsControllerCompat
verwendet wurde, wurde rückgängig gemacht. Es ist wieder ein Fenster erforderlich, das für die Verwaltung einiger Fenster-Flags benötigt wird.ViewCompat.getWindowInsetsController
wurde zugunsten vonWindowCompat.getInsetsController
eingestellt, um sicherzustellen, dass das richtige Fenster verwendet wird (z. B. wenn sich die Ansicht in einem Dialogfeld befindet). (I660ae, b/219572936) - Eine neue
LazyVerticalGrid
API zum Definieren von Größen für die Querachse wurde hinzugefügt (I17723).
Fehlerkorrekturen
- Aktualisierungen der Card API aufgrund von Änderungen an der Surface API (I3c8b9)
Version 1.0.0-alpha06
23. Februar 2022
androidx.compose.material3:material3:1.0.0-alpha06
wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
NavigationDrawerItem
wird hinzugefügt und steht für ein einzelnes Ziel in den Drawern (Ic396f, b/218286829).PermanentNavigationDrawer
undDismissibleNavigationDrawer
wurden als experimentelle APIs hinzugefügt. Das sind die Schubladen, die sich gut für Geräte mit großen Bildschirmen eignen. (I5f8ab, b/218286829)- Unterstützung für die untere App-Leiste von Material 3 hinzugefügt (Ic432a)
NavigationDrawer
wurde inModalNavigationDrawer
umbenannt (I1807d, b/218286829)- Material 3-Slider-Klasse und ‑Tokens hinzugefügt (I1ccee)
- Die Tab-Implementierung wurde hinzugefügt. Informationen zur Beispielverwendung finden Sie in der Dokumentation (Ie0146).
Fehlerkorrekturen
- Ein Problem wurde behoben, durch das bei der linearen Navigation mit dem
TalkBack
-Screenreader ein leerer Titel der oberen App-Leiste ausgewählt wurde. (Id4690) IconSize
wurde zuFloatingActionButtonDefaults
hinzugefügt. (Ia71cf)- Fehlerbehebung für ausgeblendete
AlertDialog
-Schaltflächen, wenn mit einemLazyColumn
langer Text hinzugefügt wird. (Ib2cc9, b/216663029)
Version 1.0.0-alpha05
9. Februar 2022
androidx.compose.material3:material3:1.0.0-alpha05
wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
Material Design 3-Komponenten hinzugefügt
- Drop-down-Menü
- Infokarten
API-Änderungen
- Die eingestellte Funktion
Surface
, die einen onClick-Callback verwendet. Klickbare Oberflächen sollten mit einemInteractionSource
und einemModifier.clickable()
erstellt werden. (I211c6) - Unterstützung für die Erhebung von „Gedrückt“ und „Fokus“ für den schwebenden Aktionsbutton hinzugefügt. (Ibb584)
- Die
Surface
API wurde so geändert, dass sie eine InteractionSource empfängt, mit der ihr Erscheinungsbild in verschiedenen Status gesteuert werden kann. (Iafbc8)
Fehlerkorrekturen
- Fehlende tertiäre Farben in dynamischen Farbschemas wurden hinzugefügt (I456c4, b/214588434).
Version 1.0.0-alpha04
26. Januar 2022
androidx.compose.material3:material3:1.0.0-alpha04
wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
NonRestartableComposable
wurde Methoden hinzugefügt, die Überladungen vorhandener Methoden ohne komplexe Logik sind. Dadurch werden die vom Compiler generierten Memoization-Prüfungen (equals) für alle Parameter reduziert, die in der aufgerufenen inneren Funktion wiederholt werden. (I90490)- Material 3-Trennlinie hinzugefügt. (Ica5fc)
- Markieren Sie das Checkbox- und das RadioButton-Element mit einer experimentellen API-Annotation. (Ie44bb)
- Unterstützung für Material 3-Statusanzeigen hinzugefügt. (Iff232, b/205023841)
Fehlerkorrekturen
- Die Farbe eines deaktivierten
TextButton's
-Containers wird auf „transparent“ aktualisiert (I6b248, b/213339737).
Version 1.0.0-alpha03
12. Januar 2022
androidx.compose.material3:material3:1.0.0-alpha03
wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Fügen Sie
LocalIndication
zuMaterialTheme
von Material 3 hinzu. (I7ce4e) - Eckradius für Kästchen korrigieren (I38b03, b/175198975, b/202309440)
Abhängigkeitsupdates
- Jetzt von Kotlin
1.6.10
abhängig.
Version 1.0.0-alpha02
1. Dezember 2021
androidx.compose.material3:material3:1.0.0-alpha02
wird veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- Unterstützung für Checkboxen und Optionsfelder hinzugefügt.
- Aktualisiert, um mit Kotlin
1.6.0
kompatibel zu sein
API-Änderungen
- Entfernen Sie die Schublade aus dem Scaffold von Material 3. (I04f51)
- Unterstützung für Material 3
Checkbox
wird hinzugefügt. (Id5542) - Unterstützung für Material 3
RadioButton
wird hinzugefügt. (I20334)
Fehlerkorrekturen
- Reduziere den Welleneffekt-Radius von
IconButton
von 40 dp auf 20 dp. (I68bbe, b/206674345) - Der Fast Path für den Port-String für
Text
ändert sich voncompose.material
(I30b03) - Es wurde behoben, dass die hartcodierte Schaltfläche immer aktiviert war. (Iea832, b/205335456)
Version 1.0.0-alpha01
27. Oktober 2021
androidx.compose.material3:material3:1.0.0-alpha01
wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Material Design 3-Thematisierung und dynamische Material You-Farben
Material Design 3-Komponenten
- Schaltflächen
- UAS und erweitertes UAS
- Dialogfelder
- Navigationsleiste
- Navigationsleiste
- Navigationsleiste
- Obere App-Leiste
- Logo
- Symbol
- Text
- Oberfläche
- Layout
- Inhaltsfarbe
Weitere Informationen finden Sie im Abschnitt Material Design 3 und Material You im Leitfaden „Material-Theming in Compose“.