Compose Material 3
| Letzte Aktualisierung | Stabile Version | Releasekandidat | Betarelease | Alpha-Release |
|---|---|---|---|---|
| 22. Oktober 2025 | 1.4.0 | - | - | 1.5.0-alpha07 |
Struktur
Compose ist eine Kombination aus sieben Maven-Gruppen-IDs in androidx. Jede Gruppe enthält eine bestimmte Teilmenge von Funktionen mit jeweils eigenen Versionshinweisen.
In dieser Tabelle werden die Gruppen erläutert und es sind Links zu den einzelnen Versionshinweisen enthalten.
| Gruppe | Beschreibung |
|---|---|
| compose.animation | Animationen in Jetpack Compose-Anwendungen erstellen, um die Nutzerfreundlichkeit zu verbessern |
| compose.compiler | @Zusammensetzbare Funktionen transformieren und Optimierungen mit einem Kotlin-Compiler-Plug-in ermöglichen |
| compose.foundation | Mit den einsatzbereiten Bausteinen können Sie Jetpack Compose-Anwendungen schreiben und die 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.4.0" implementation "androidx.compose.material3:material3-window-size-class:1.4.0" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha07" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.4.0") implementation("androidx.compose.material3:material3-window-size-class:1.4.0") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.5.0-alpha07") } 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 stimmen, indem Sie auf die Schaltfläche mit dem Stern klicken.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Compose Material3 Common Version 1.0
Version 1.0.0-alpha01
17. April 2024
androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01 und androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 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
containerColorundcontentColorzuNavigationSuiteScaffoldDefaultshinzu. (I64e3a, b/331993720) - Die Funktion
itemColorswirdNavigationSuiteDefaultshinzugefügt. (Idf719, b/328480012) NavigationSuiteScopeversiegeln (Iefa57)
Version 1.0.0-alpha05
6. März 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 sind veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
API-Änderungen
- Machen Sie den
NavigationSuiteItemColors-Konstruktor öffentlich. (Ica83a, b/324886877)
Version 1.0.0-alpha04
21. Februar 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 sind veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Abhängigkeitsupdates
- Aktualisieren Sie die adaptiven Material3-Abhängigkeiten auf die neuen Modulpfade. (Ibc421)
- Auf die Window Manager-Version 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
MutableInteractionSourceverfügbar machen, wurden aktualisiert und machen jetzt ein nullableMutableInteractionSourceverfügbar, das standardmäßig auf null gesetzt ist. Es gibt hier keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dasMutableInteractionSourcenicht hochziehen. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie einMutableInteractionSourcezugewiesen wird. Außerdem kann es sein, dass für andere Komponenten 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.fillMaxSizehat, wurde behoben. (c9cf250, b/312664933)
Version 1.0.0-alpha01
15. November 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Compose Material3 Adaptive Version 1.0
Version 1.0.0-alpha06
7. Februar 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 sind veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
Neue Funktionen
- Es wurden zusätzliche Verhaltensoptionen für die
ThreePaneScaffoldNavigator-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) collectWindowSizeAsStatewird umbenannt und es werden stattdessen Rohwerte zurückgegeben (I480f4).
Version 1.0.0-alpha02
29. November 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 sind veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
API-Änderungen
- Navigations-APIs von APIs für adaptive Gerüste trennen (Ic4045)
- Entfernen Sie den Kurs
GutterSize. (I785b3)
Fehlerkorrekturen
- Fix: Bereiche werden nicht gewechselt, wenn
AnimatedPanenicht verwendet wird (d88f181)
Version 1.0.0-alpha01
15. November 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Adaptive Bedingungs-APIs für Material 3:
Material3-Direktiven-APIs für adaptive Pane-Scaffolds:
Material3-APIs für adaptive Pane-Scaffolding:
- Grundlegende APIs für die Gerüststruktur von Bereichen
Compose Material3 Version 1.5
Version 1.5.0-alpha07
22. Oktober 2025
androidx.compose.material3:material3-*:1.5.0-alpha07 ist veröffentlicht. Version 1.5.0-alpha07 enthält diese Commits.
API-Änderungen
- Erweiterte
SearchBar.InputFieldmit einemkeyboardOptions-Parameter, der eine optimierte Texteingabe durch Angabe von Tastaturoptionen ermöglicht, und einemlineLimits-Parameter, mit dem das Scrollen des Textumbruchs angegeben werden kann (Id08a4, b/416991049)
Fehlerkorrekturen
- Ein Fehler im Slider wurde behoben, durch den bei Berührungen keine Press-Interaktionen ausgegeben wurden. Diese Änderung sorgt dafür, dass auf
awaitFirstDownsofort einPressInteraction.Pressausgegeben wird, sodass sofort visuelles Feedback erfolgt. (If9e25, b/308501482) - Ein Problem wurde behoben, durch das sich die Richtung des
Tooltip-Caret beim Scrollen nicht geändert hat. Die FunktionTooltipBoxlöst jetzt eine Neuzusammensetzung aus, wenn die Seite des Tooltip-Pop-ups gewechselt wird. So wird sichergestellt, dass die Richtung des Cursors richtig aktualisiert wird. (I5ad1e, b/438875827)
Version 1.5.0-alpha06
8. Oktober 2025
androidx.compose.material3:material3-*:1.5.0-alpha06 ist veröffentlicht. Version 1.5.0-alpha06 enthält diese Commits.
API-Änderungen
- Scrollfarben für
AppBarWithSearchhinzugefügt. Außerdem ist die Containerfarbe eines Suchleisten-Eingabefelds jetzt standardmäßig transparent. Die Standard-Containerfarbe der Suchleiste selbst bleibt unverändert. (I4fe32) FloatingToolbarwurde ein standardmäßiges Composable für die Überlaufanzeige hinzugefügt. (I6a6f8, b/415833723)- Aktualisieren Sie
isExpandedaufisShowingfür Menü-APIs in der Schaltflächengruppe. (I86309, b/412419514) initialIsExpandedwurde zuinitialIsShowingaktualisiert und inButtonGroupDefaultswurde eine standardmäßige Composable für den Überlaufindikator hinzugefügt. (I6e67c, b/412419514)- Die Funktion zum Ziehen zum Anpassen der Größe wird aus der öffentlichen API entfernt (Ic85ba, b/437953743, b/442636084).
Fehlerkorrekturen
- Die Fokusreihenfolge der Tasten für die Tastaturnavigation wurde korrigiert, auch für RTL. (Ibba27, b/422220597)
- Die Tastaturnavigation im Raster für die Jahresauswahl der Datumsauswahl wurde korrigiert. (I02363, b/422425720, b/446814683)
- Die Tastaturnavigation für das Raster zur Datumsauswahl in Datumsauswahlen wurde korrigiert. (I594ef, b/422220597, b/422223115)
- Es wurde ein Fehler behoben, durch den die Tastaturfokus auf eine Symbolleiste außerhalb des Bildschirms verschoben wurde. (I01a73, b/422786812)
- Die Tastaturnavigation für
RangeSliderund Schieberegler wurde korrigiert. (Ib6bcf, b/424845268, b/422942624)
Version 1.5.0-alpha04
10. September 2025
androidx.compose.material3:material3-*:1.5.0-alpha04 ist veröffentlicht. Version 1.5.0-alpha04 enthält diese Commits.
Neue Funktionen
- Es wurden
Text-Composable-Überladungen hinzugefügt, die eineColorProducer-Lambda-Funktion akzeptieren, mit der effiziente Farbänderungen möglich sind, ohne dass eine vollständige Neuzusammenstellung ausgelöst wird. (I9ff25, b/407055128)
API-Änderungen
- Benennen Sie
Scrim()inLevitatedPaneScrim()um und blenden Sie Attribute der Klassen „Levitated“ und „Reflowed“ aus. (I090e1, b/427953101) calculatePosture()API als intern ausblenden (Ie7227, b/424442112)PaneScaffoldHorizontalOrderals versiegelte öffentliche API (Ia4ebe) verfügbar machen- APIs für Fenstergröße und Haltung als experimentell kennzeichnen (I4ee96)
Fehlerkorrekturen
- Die Reihenfolge der Tastaturnavigation wurde korrigiert, sodass der Fokus von der Schaltfläche „+“ zum ersten Element oben wechselt. (Icaaa1, b/422762939)
- Verbesserte Tastatur-Barrierefreiheit für die Navigationsleiste: Die Leiste ist nicht mehr fokussierbar, wenn sie geschlossen ist. Sie kann über die Esc-Taste geschlossen werden und ihr Inhalt wird fokussiert, wenn sie geöffnet wird. (Idb995, b/422793544, b/422793651, b/422797424)
- Das Zifferblatt der Zeitauswahl reagiert jetzt auf die Tastaturnavigation und -eingabe. (I9d5d9, b/425710631)
- Neuen anfänglichen Anker verwenden, wenn sich die Ankerliste für die Bereichserweiterung ändert (I91cd1, b/438829477)
Version 1.5.0-alpha03
27. August 2025
androidx.compose.material3:material3-*:1.5.0-alpha03 ist veröffentlicht. Version 1.5.0-alpha03 enthält diese Commits.
Verhaltensänderung
- Die Größe des Kästchens und die Farben der Markierungen wurden an die Spezifikation angepasst. Um Störungen der Benutzeroberfläche zu minimieren, wurde das Flag
isCheckboxStylingFixEnabledhinzugefügt, um die Migration zu erleichtern. Bitte aktivieren Sie sie manuell in Ihren Apps. Dieses Flag wird in einer zukünftigen Version entfernt. (I5bcd3, b/304300693)
API-Änderungen
- Parameter
contentPaddingfürTopAppBarhinzugefügt (Ia5fea) - Komponentenüberschreibung für Navigationssuite-Gerüst hinzufügen (I85312)
Fehlerkorrekturen
- Der Parameter
containerColorinTimePickerDialogwird jetzt korrekt angewendet, sodass die Hintergrundfarbe des Dialogfelds angepasst werden kann. (I47f89, b/403183883) - Der Fokus geht nicht mehr verloren, wenn die modale Navigationsleiste minimiert wird. Sie wird jetzt durch Drücken der Esc-Taste geschlossen. (4255257)
Snackbarhat jetzt die richtige Reihenfolge für den Tastaturfokus für Aktions- und Schließen-Schaltflächen. Die Schließen-Schaltfläche unterstützt auch die Anzeige einer Kurzinfo. (11fa13d)
Version 1.5.0-alpha02
13. August 2025
androidx.compose.material3:material3-*:1.5.0-alpha02 ist veröffentlicht. Version 1.5.0-alpha02 enthält diese Commits.
API-Änderungen
- In
PullToRefreshDefaultswurdeshapeinindicatorShapeundcontainerColorinindicatorContainerColorumbenannt undindicatorMaxDistancefür die Verwendung von Indikatoren hinzugefügt. (Ib6cbe) - Entferne das Deprecation-Tag aus
PullToRefreshDefaults.indicatorColor(Iaaee2) AppBarWithSearchwurde hinzugefügt und ersetztTopSearchBar. Außerdem werden Navigations- und Aktionssymbole unterstützt. (I213a5)
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem der Drawer-Offset durch das Zurückdrücken fälschlicherweise aktualisiert wurde. (I85624, b/427778135)
SwipeToDismissBoxgreift jetzt auf einen abgerechnetentargetValuezurück, wenn keine anderen Anker vorhanden sind.BottomSheetScaffoldgreift jetzt auf ein erweitertestargetValuezurück, wenn keine anderen Anker vorhanden sind. (I73d5e, b/428856426)- Die Schaltflächenauffüllung in
AlertDialogwurde korrigiert, wenn die Schaltflächen vertikal gestapelt sind. (Ia2118) - [FAB] Fehler behoben, durch den das FAB nach dem Ausblenden durch
Modifier.animateFloatingActionButtonweiterhin angeklickt werden konnte (I8ea6c, b/430336834) - [Schieberegler] Die Tastaturnavigation für den Schieberegler wurde korrigiert (I3a405).
Version 1.5.0-alpha01
30. Juli 2025
androidx.compose.material3:material3-*:1.5.0-alpha01 ist veröffentlicht. Version 1.5.0-alpha01 enthält diese Commits.
Neue Funktionen
- Es wurde ein weiterer Positionsanbieter für Tooltips hinzugefügt. Entwickler können jetzt festlegen, ob der Tooltip über, unter, links oder rechts vom Anker platziert wird. Fügen Sie eine API hinzu, die eine Form für Carets akzeptiert, damit mehr benutzerdefinierte Formen bereitgestellt werden können. (Ie513c)
API-Änderungen
TextFieldColors-Methoden zum Berechnen von Komponentenfarben basierend auf dem Status sind jetzt öffentlich. (I03165)- Die Anmerkung „Suspend“ wurde aus dem
onDismiss-Callback entfernt. (Ie3166) DatePickerState.getDisplayedMonth(): YearMonth?undDateRangePickerState.getDisplayedMonth(): YearMonth?wurden aktualisiert, um einen nicht leeren Wert zurückzugeben. (Ice09c, b/427952972)- Entfernen Sie
ModalWideNavigationRailDefaults, verschieben Sie die Inhalte nachWideNavigationRailDefaultsund benennen Sie die zugehörigen Formnamen um. (Ic5e61) - Die Farben und der Text von
WideNavigationRailItem, die auf eingestellten Funktionen basieren, sollten auf der Ebene „Ausgeblendet“ sein. (Id7e82) - Ändern Sie die Ebene der eingestellten
WideNavigationRail-APIs in „Warnung“ und machen Sie sie experimentell. (I89085)
Fehlerkorrekturen
- Sorgt dafür, dass
DatePickerbei der Formatierung von Zahlen die eigene Spracheinstellung berücksichtigt. Bisher wurden bei der Konfiguration vonDatePickerfür ein arabisches Gebietsschema möglicherweise fälschlicherweise lateinische Ziffern gerendert, wenn im Systemgebietsschema des Geräts ein anderes Zahlensystem verwendet wurde. (Iccf76, b/432616196) - Ein
LinearProgressIndicator-Problem wurde behoben, durch das in RTL-Layouts keine korrekte Haltestellenanzeige gerendert wurde. (I0734c) - Die Trennlinie zwischen
PrimaryScrollableTabRowundSecondaryScrollableTabRowerstreckt sich jetzt über die gesamte Bildschirmgröße, auch wenn der Tabinhalt nicht bis zum Ende des Bildschirms reicht. (Ic1e9c, b/261741384)
Compose Material3 Version 1.4
Version 1.4.0
24. September 2025
androidx.compose.material3:material3-*:1.4.0 ist veröffentlicht. Version 1.4.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.3.0:
Ankündigungen zu Änderungen an der Mediathek
Die androidx.compose.material.icons-Bibliothek wird nicht mehr empfohlen, um Material Icons in Compose darzustellen, da Material Symbols die neue Methode sind. Wir veröffentlichen keine Updates mehr für diese Bibliothek. Sie wurde aus dem neuesten Release der Material 3-Bibliothek entfernt. Sie können weiterhin manuell darauf verweisen, wenn Sie noch nicht migrieren können.
Stattdessen empfehlen wir, eine Vector Drawable-XML-Datei vom Tab „Android“ unter https://fonts.google.com/icons herunterzuladen, um auf die neuesten stilisierten Symbole zuzugreifen: Material Symbols.
Warum empfehlen wir die Bibliothek nicht mehr? Die Symbolbibliothek („Material Icons“) wurde durch das neuere Design von Material Symbols ersetzt. Wir haben festgestellt, dass die Bibliothek die Build-Zeit Ihrer Apps erheblich verlängern kann, da sie alle verschiedenen Symbole enthält, die möglicherweise nicht benötigt werden.
Weitere Informationen: https://developer.android.com/develop/ui/compose/graphics/images/material
Geändertes Verhalten
Diese Bibliothek fügt keine Abhängigkeit zu
material-icons-coremehr hinzu. Wenn Ihr Projekt darauf angewiesen war, müssen Sie diese Abhängigkeit explizit in Ihren build.gradle[.kts]-Dateien hinzufügen. (I735ff, b/349894318)Die aktive Label-Farbe von
NavigationBarItemundNavigationRailItemwird vononSurfacein „Sekundär“ geändert, um die Nutzerfreundlichkeit und den Farbkontrast zu verbessern und die Kohärenz im System zu erhöhen (Ibc297). Wenn Sie zum vorherigen Verhalten zurückkehren möchten, kopieren Sie die Standardfarben und ändern SieselectedTextColorinMaterialTheme.colorScheme.onSurface.Material 3-Komponenten verwenden jetzt die neue
MotionScheme, um ihre Bewegung zu definieren. (Ie0f93)Bewegungsänderungen bei unbestimmter kreisförmiger Fortschrittsanzeige (I3c07e)
Neue Material 3-Komponenten
HorizontalCenteredHeroCarouselVerticalDragHandle- Sichere Textfelder für Passworteingabefelder
Verbesserungen an vorhandenen Material Design 3-Komponenten
- Text unterstützt jetzt
autoSize- Text mit String
- Text mit annotatedString
- Material 3-Dekoratoren für
BasicTextField2hinzugefügt - Es wurde eine
TimePickerDialogAPI hinzugefügt, die fürTimePicker,TimeInputoder für eine umschaltbare Version verwendet werden kann. - Neue APIs für die Suchleiste:
- Minimierte Suchleisten und maximierte Suchansichten sind jetzt separate Composables:
SearchBarsteht für eine Suchleiste im minimierten Zustand.ExpandedFullScreenSearchBarundExpandedDockedSearchBarstellen die Suchleiste im maximierten Zustand dar. Diese werden in einem neuen Fenster geöffnet.SearchBarStatezum Steuern des Status der Suchleiste
- Experimentelle APIs wurden in stabile APIs umgewandelt.
- Leistungsverbesserungen
Version 1.4.0-rc01
10. September 2025
androidx.compose.material3:material3-*:1.4.0-rc01 ist veröffentlicht. Version 1.4.0-rc01 enthält diese Commits.
Version 1.4.0-beta03
27. August 2025
androidx.compose.material3:material3-*:1.4.0-beta03 ist veröffentlicht. Version 1.4.0-beta03 enthält diese Commits.
Version 1.4.0-beta02
13. August 2025
androidx.compose.material3:material3-*:1.4.0-beta02 ist veröffentlicht. Version 1.4.0-beta02 enthält diese Commits.
Änderungen an Abhängigkeiten
graphics-shapes-Abhängigkeit entfernen (I219e0, b/436230765)
API-Änderungen
- In
PullToRefreshDefaultswurdeshapeinindicatorShapeundcontainerColorinindicatorContainerColorumbenannt undindicatorMaxDistancefür die Verwendung von Indikatoren hinzugefügt. (Ib6cbe) - Entferne das Deprecation-Tag aus
PullToRefreshDefaults.indicatorColor(Iaaee2) BasicAlertDialogOverrideScopewurde versehentlich als stabil eingestuft und die experimentelle Anmerkung wurde in aosp/3701846 entfernt. Als intern markieren. In Version 1.5.0-alpha (I9182a) bleibt die Funktion als öffentliche experimentelle Funktion verfügbar.
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem der Drawer-Offset durch das Zurückdrücken fälschlicherweise aktualisiert wurde. (I85624, b/427778135)
Version 1.4.0-beta01
30. Juli 2025
androidx.compose.material3:material3-*:1.4.0-beta01 ist veröffentlicht. Version 1.4.0-beta01 enthält diese Commits.
Nicht abwärtskompatible Änderungen
- Alle öffentlichen APIs, die mit
ExperimentalMaterial3ExpressiveApioderExperimentalMaterial3ComponentOverrideApigekennzeichnet waren, wurden entfernt. Bitte wechseln Sie zu1.5.0-alpha, um diese Funktionen weiterhin nutzen zu können. (Ie4ae0) - Die folgenden stabilisierten
pullToRefresh-APIs werden in der nächsten Version umbenannt. (Ib6cbe)
Neue Funktionen
Tooltipunterstützt jetzt benutzerdefinierte Caret-Formen und ‑Positionen (über, unter, links oder rechts vom Anker). (Ie513c)
API-Änderungen
- Die Anmerkung „Suspend“ wurde aus dem
onDismiss-Callback entfernt. (Ie3166) DatePickerState.getDisplayedMonth(): YearMonth?undDateRangePickerState.getDisplayedMonth(): YearMonth?wurden aktualisiert, um einen nicht leeren Wert zurückzugeben. (Ice09c, b/427952972)- Entfernen Sie
ModalWideNavigationRailDefaults, verschieben Sie die Inhalte nachWideNavigationRailDefaultsund benennen Sie die zugehörigen Formnamen um. (Ic5e61)
Fehlerkorrekturen
- Sorgt dafür, dass
DatePickerbei der Formatierung von Zahlen die eigene Spracheinstellung berücksichtigt. Bisher wurden bei der Konfiguration vonDatePickerfür ein arabisches Gebietsschema möglicherweise fälschlicherweise lateinische Ziffern gerendert, wenn im Systemgebietsschema des Geräts ein anderes Zahlensystem verwendet wurde. (Iccf76, b/432616196) - Ein
LinearProgressIndicator-Problem wurde behoben, durch das in RTL-Layouts keine korrekte Haltestellenanzeige gerendert wurde. (I0734c) - Die Trennlinie zwischen
PrimaryScrollableTabRowundSecondaryScrollableTabRowerstreckt sich jetzt über die gesamte Bildschirmgröße, auch wenn der Tabinhalt nicht bis zum Ende des Bildschirms reicht. (Ic1e9c, b/261741384)
Version 1.4.0-alpha18
16. Juli 2025
androidx.compose.material3:material3-*:1.4.0-alpha18 ist veröffentlicht. Version 1.4.0-alpha18 enthält diese Commits.
Neue Funktionen
ModalBottomSheetPropertiesbietet jetzt die Möglichkeit, „dismissRequest“ bei einem Scrim-Klick zu deaktivieren. (I8e715)- Fügen Sie dem Track von
RangeSliderUnterstützung fürtrackCornerSizehinzu. (Iec529)
API-Änderungen
railExpandedist jetzt ein erforderlicher Parameter fürWideNavigationRailItem.modalContentColorwurde fürWideNavigationRailColorshinzugefügt undWideNavigationRailDefaults.modalContainerShapewurde zuModalWideNavigationRailDefaults.containerShapeverschoben. (Id60c5)- Verschieben Sie den neuen Farbparameter von
WideNavigationRailan die letzte Stelle und stellen Sie die alte Funktion ein. (Iac7f7) PullToRefreshist jetzt eine stabile API (I18537)- Aktualisierungen der
DatePickersAPI Wir haben das Standardenddatum „null“ fürDateRangePickerentfernt und es ist jetzt obligatorisch, es zu übergeben. Außerdem haben wir die Verwendung der Datumsdarstellung in der API-Dokumentation um Mitternacht UTC klargestellt und die neuesten Getter und Setter, die die java.time-APIs verwenden, vorerst als experimentell gekennzeichnet. (I121b3, b/427952972) - Die API für das Symbol mit dem Parameter
tint: ColorProducerist nicht mehr experimentell. (Ia0133) - Die experimentellen Anmerkungen wurden aus
DatePicker,DateRangePickerund den zugehörigen Status, Klassen und Typen entfernt. (I0e4e0, b/391848485) - Der Standardwert für „focusable“ wurde in „false“ geändert, um das A11Y-Fokusproblem zu beheben. Außerdem wurde der Parameter
hasActionzuTooltipBoxhinzugefügt. (I62998) - Die experimentellen APIs
WideNavigationRail,ShortNavigationBarundNavigationItemsind jetzt allgemein verfügbar. (I3ca3c) - Entfernen Sie die
@ExperimentalMaterial3Api-Annotationen aus einigen der Funktionen, unterstützenden Klassen und Objekte der oberen App-Leiste. (I0a9b7)
Version 1.4.0-alpha17
2. Juli 2025
androidx.compose.material3:material3-*:1.4.0-alpha17 ist veröffentlicht. Version 1.4.0-alpha17 enthält diese Commits.
Neue Funktionen
- Die Animation der Schaltflächengruppe wird jetzt zu 75% animiert, wenn darauf geklickt wird, anstatt wenn sie gedrückt wird. (593942a, b/423596967)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem ein Karussellelement in einigen Fällen die Größe des großen Elements bei der Layoutberechnung überschreiten konnte, wodurch das gesamte Widget abgeschnitten wurde. (I1c3d7, b/397489534)
- Das Überspringen von
beforeContentPaddingbeim Scrollen von Karussells mit sich überschneidenden Start- und Endverschiebungen wurde behoben. (c3d5f3a, b/420618979) - Das aktivierte Verhalten von
SwipeToDismisswurde 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
ExposedDropdownMenukann jetzt über die Tastatur geöffnet werden. Außerdem ist das Menü für die bearbeitbare Variante jetzt über die Tastatur erreichbar. (46ead03)
Version 1.4.0-alpha16
18. Juni 2025
androidx.compose.material3:material3-*:1.4.0-alpha16 ist veröffentlicht. Version 1.4.0-alpha16 enthält diese Commits.
Neue Funktionen
- Eine zentriert ausgerichtete Hero-Karussellkomponente (I6f6d3) wurde hinzugefügt.
API-Änderungen
- Implementierung von XR-Überschreibungen für die vertikale Symbolleiste (Ia1604)
- Programmatische Scrollfunktionen wurden
CarouselStatehinzugefügt (I12f8e) ComponentOverridefürModalWideNavigationRailhinzufügen (I4f440)ComponentOverridefürWideNavigationRailhinzufügen (I6354f)ComponentOverridefürHorizontalFloatingToolbarerstellen (I51116)ComponentOverridefürShortNavigationBarerstellen (I30e24)SwipeToDismissBoxState-Verweise aufconfirmValueChangewurden als veraltet markiert. Nutzer sollten stattdessen denSwipeToDismissBoxAPI-CallbackonDismissedverwenden. (Iee780)- Der Parameter „userScrollEnabled“ wurde den Carousel-Composables hinzugefügt. (I1d4d2)
- Das Karussell
currentItemkann jetzt überCarouselStatebeobachtet werden. (Ie87e9)
Fehlerkorrekturen
- Ein Problem wurde behoben, durch das der Schatten einer beliebigen Form auf einem FAB, das an ein
FloatingToolbarübergeben wurde, nicht richtig angewendet wurde. (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
LaunchedEffectaktualisiert wurde (Id9f31, b/302774166)
Version 1.4.0-alpha15
20. Mai 2025
androidx.compose.material3:material3-*:1.4.0-alpha15 ist veröffentlicht. Version 1.4.0-alpha15 enthält diese Commits.
API-Änderungen
MotionTheme.LocalMotionSchemehinzugefügt, Komposition lokal. Dadurch kann überCompositionLocalConsumerModifierNodesmitcurrentValueOf(MotionTheme.LocalMotionScheme)auf das Bewegungsdesign 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
SnackbarundFloatingActionButtonbei 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 dasBottomSheetwird jetzt der schnelle Effekt vonMotionSchemebeim Ausblenden oder Minimieren und der räumliche Standardeffekt beim Maximieren verwendet. (Ifa46f, b/416063171) - Der
ColorScheme-Konstruktor ohne Rollen für Oberflächencontainer wurde als ausgeblendet markiert und wird nicht mehr empfohlen. (Ia7237) - Die Anforderung
CircularWavyProgressIndicatorSize.minDimension > 0wurde entfernt, um mehr Flexibilität zu ermöglichen. Zuvor wurde dadurch eine Ausnahme ausgelöst. (Ic9418, b/377531195) - Hyperlinks in
Text(AnnotatedString)haben jetzt standardmäßig Material-Stile. (I78288, b/339843816) - Es wurde ein Problem behoben, bei dem die Funktion
toShape()inRoundedPolygoneinen 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 ist veröffentlicht. Version 1.4.0-alpha14 enthält diese Commits.
API-Änderungen
- Es wurde eine neue zusammensetzbare Funktion
AppBarColumnhinzugefügt, die genauso funktioniert wieAppBarRow, aber für Inhalte, die in einer Spalte angeordnet sind. (Iaf6bd) - Die maximale Anzahl von Elementen wurde
AppBarRowhinzugefügt. Dies ist erforderlich, um die Material-Spezifikation für obere App-Leisten korrekt zu implementieren. (I92ce4) - In
TooltipScopewurde eine Methode zum Abrufen derlayoutCoordinatesdes Ankers hinzugefügt. Die MethodedrawCaretwird eingestellt, da Entwickler mit dieser neuen Methode die AnkergrenzenlayoutCoordinatesabrufen und eine geeignete Form mit einem Caretzeichen erstellen können. (Ia2e12, b/329470609) java.time-Unterstützung für Datumsauswahlen hinzugefügt: Es wurdenrememberDatePickerState/rememberDateRangePickerState-Überladungen eingeführt, die java.time-Objekte (z.B. initialLocalDate,YearMonth) akzeptieren. Außerdem wurden Erweiterungsfunktionen für die Statusobjekte hinzugefügt, um Werte mit Typen wieLocalDateundYearMonthabzurufen/festzulegen. Erfordert API 26 oder höher oder Desugaring. (I70f29, b/266202516, b/281859606)- Fügen Sie die zusammensetzbare Funktion
CenteredTrackhinzu, damit ein Schieberegler mit einem Track verwendet werden kann, der in der Mitte beginnt. (I5b1d6)
Fehlerkorrekturen
- Die Leistung von wellenförmigen Fortschrittsanzeigen wurde verbessert: Lineare Typen werden jetzt etwa 8, 5% schneller geladen und es sind etwa 11% weniger Zuweisungen erforderlich.Bei kreisförmigen Typen ist die Geschwindigkeit um etwa 47% gestiegen und die Anzahl der Zuweisungen um etwa 39% gesunken. (I595d8)
Version 1.4.0-alpha13
23. April 2025
androidx.compose.material3:material3-*:1.4.0-alpha13 ist veröffentlicht. Version 1.4.0-alpha13 enthält diese Commits.
API-Änderungen
isAppearanceLightStatusBarsundisAppearanceLightNavigationBarswurden inModalBottomSheetPropertiesals reine Android-Parameter wieder eingeführt. (Id4bc0)- Fügen Sie eine
AppBarRow-Composable hinzu, die den Überlauf von Elementen verarbeitet, die außerhalb ihrer Grenzen liegen. (I742bd) - Aktualisieren Sie die APIs
DatePickerundDateRangePicker, um den Fokus beim Wechsel in den Datumseingabemodus anzufordern. Wir haben den booleschen ParameterrequestFocusdurch einen optionalen ParameterfocusRequesterersetzt, der einenFocusRequesterakzeptiert. (I14b69) - Entfernen Sie den Modifikator und die Interaktionsquelle aus den standardmäßigen anklickbaren und umschaltbaren Elementen. Verwenden Sie es stattdessen als Implementierungsdetail. (I95ed6)
- Die Schaltfläche
ButtonGroupwird 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.windowInsetsenthält jetztWindowInsets.safeDrawing.Top. (I0ab67, b/321877275, b/336962418, b/342093067) - Ein- und Ausblendeanimationen (Ein- und Ausblenden/Ein- und Ausschieben) für führende Chip-Symbole/Avatare und nachfolgende Symbole beim Hinzufügen oder Entfernen aktiviert. Das ist vor allem für auswählbare Chips (Filter, Eingabe) von Vorteil, gilt aber allgemein. (I9af21)
- Das fehlerhafte Verhalten des RTL-Schiebereglers, das durch
LookaheadScopeverursacht wurde, wurde behoben. (Ieb152, b/408118041) - Behebung des Absturzes von
AppBarunten 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 ist veröffentlicht. Version 1.4.0-alpha12 enthält diese Commits.
API-Änderungen
- Android-spezifische Parameter aus
ModalBottomSheetPropertiesentfernt (Iab97f, b/362539765) - Überladen von Funktionen für Standardwerte für die Größe des Ziehpunkts (I0ed0d)
- Neue
NavigationSuiteScaffold- undNavigationSuiteScaffoldLayout-Funktionen zur Unterstützung neuer Layouttypen und zum Hinzufügen von Unterstützung für optionalen primären Aktionsinhalt. (Ib262a, b/353144478) Modifier.weightmit dem Parameter „fill“ inButtonGroupwird eingestellt. Eine Version ohne Füllung hinzufügen (Id32bb)- Benennen Sie
xSmall-undxLarge-um. Standardmäßig wird für die IconButton-Komponenteextraausgeschrieben. (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.contentColorForwird jetztsurfaceDimzuonSurfacezugeordnet. (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 ist 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
ToggleButtonDefaultsundButtonDefaultsMethoden für das empfohlene Padding, die Formen, die Symbolgröße, den Symbolabstand und den Textstil für empfohlene Inhalte in Abhängigkeit von der Containerhöhe hinzu. (Iea69e) - Veraltete experimentelle Funktionen und Konstanten wurden aus der
FloatingToolbarentfernt. (I8f339) - Höhenkomponenten haben jetzt eine gemeinsame Schnittstelle und öffentliche Konstruktoren und Eigenschaften. (Ibb172)
- Hinzufügen des Modifikators
animateWidthinButtonGroupScope, der mit den untergeordneten Elementen der Schaltflächengruppe verwendet werden muss, um die untergeordneten Elemente richtig zu animieren. (Ia3bb6)
Fehlerkorrekturen
- Das Padding der schwebenden Symbolleiste wurde korrigiert, um für ein visuelles Gleichgewicht 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 ist veröffentlicht. Version 1.4.0-alpha10 enthält diese Commits.
API-Änderungen
TabRowDefaults.tabIndicatorOffsetwurde zugunsten vonTabIndicatorScope.tabIndicatorOffseteingestellt. (Ib36b3)- Tippfehler für kleines Content-Padding in Schaltflächen-Standardeinstellungen behoben. (I19bfe)
TabRowundScrollableTabRowwerden zugunsten von primären und sekundären Varianten der einzelnen Elemente eingestellt. Die Zeilen auf den Tabs „Primär“ und „Sekundär“ sind leistungsfähiger und entsprechen genauer den Spezifikationen. (I918e2)rememberSliderStateundrememberRangeSliderStatewurden hinzugefügt. (I8e384)shouldAutoSnapwurde zuSliderStatehinzugefügt, um den automatischen Einrastmechanismus zu steuern. Das Deaktivieren kann für benutzerdefinierte Animationen nützlich sein. (I07745)- Die Mindestbreite von Tabs in scrollbaren Tabzeilen ist jetzt ein Parameter. Die Varianten für die primäre und sekundäre Tabellenzeile sind nicht mehr experimentell. (If6f15, b/226665301)
- Die Klasse
ExitAlwaysFloatingToolbarScrollBehaviorwurde öffentlich gemacht, sodass sie ohne Komposition erstellt werden kann. (Ibf31c)
Version 1.4.0-alpha09
26. Februar 2025
androidx.compose.material3:material3-*:1.4.0-alpha09 ist veröffentlicht. Version 1.4.0-alpha09 enthält diese Commits.
API-Änderungen
- Die Einstellungsfelder von
DragHandleim Standardzustand umbenennen, gedrückte und gezogene Zustände trennen und die Standardgrößen öffentlich machen. (I787b9) - Aktualisierungen der
TowRowsTopAppBarAPI Der Lambda-Parameterexpandedwurde entfernt und es wurden separate Parameter für die 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 ist veröffentlicht. Version 1.4.0-alpha08 enthält diese Commits.
Neue Funktionen
Es wurde eine
TimePickerDialogAPI hinzugefügt, die fürTimePicker,TimeInputoder für eine umschaltbare Version verwendet werden kann. (Id2d83)Neue APIs für die Suchleiste:
- Minimierte Suchleisten und maximierte Suchansichten sind jetzt separate Composables.
SearchBarsteht für eine Suchleiste im minimierten Zustand.ExpandedFullScreenSearchBarundExpandedDockedSearchBarstellen die Suchleiste im maximierten Zustand dar. Diese werden in einem neuen Fenster geöffnet.SearchBarStatezum Steuern des Status der SuchleisteTopSearchBar, um die Verarbeitung von Insets und das Scrollverhalten hinzuzufügen- Neue Überladung von
InputField, dieSearchBarStateverwendet (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)
API-Änderungen
- Unterstützung für das Morphing der Eckenform von Symbolschaltflächen beim Drücken. (I21843)
- Die APIs für Textfeld-Decorators/Decorations sind nicht mehr experimentell. (I31d95)
- Es wurden Beispiele und Standardwerte für die verbundene Variante für
ButtonGrouphinzugefügt. (I5c8ce) - Machen Sie den Statusparameter zum letzten in
NavigationSuiteScaffoldundNavigationSuiteScaffoldLayout. (I9cc7b)
Fehlerkorrekturen
- Benutzerdefinierte Bedienungshilfen für
FloatingToolbarshinzugefügt, damit Bedienungshilfen jetzt alleFloatingToolbar-Variationen 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
FloatingToolbarsbeobachten 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 Ladeanzeigen wurde behoben, wenn
Float.NaNals Fortschritt übergeben wurde. (I4fa96, b/352364576)
Version 1.4.0-alpha07
29. Januar 2025
androidx.compose.material3:material3-*:1.4.0-alpha07 ist veröffentlicht. Version 1.4.0-alpha07 enthält diese Commits.
Neue Funktionen
- Mit einer neuen API lässt sich das Erscheinungsbild von Checkboxen jetzt noch flexibler anpassen. Diese API bietet Strichparameter, mit denen Sie besser steuern können, wie das Häkchen und der Rahmen des Kästchens gerendert werden. (I65a88)
- Die
TwoRowsTopAppBarAPI wurde hinzugefügt. Sie ist eine anpassungsfähigere Alternative zu 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 inFlexibleBottomAppBarumbenannt. 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
CapitalCasegeä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
FloatingToolbarmit einem schwebenden Aktionsschaltfläche auf das Scrollen reagiert, indem Sie einFloatingToolbarScrollBehaviorangeben. Für Toolbars, die an einer mittleren Kante (z. B. oben oder unten in der Mitte) positioniert sind, empfehlen wir, ein Scrollverhalten zu verwenden, um die gesamte Komponente beim Scrollen auszublenden und so ein übersichtlicheres Design zu erzielen. Außerdem wird so verhindert, dass der FAB nicht mehr zentriert ist, was beim Verwenden des Flagsexpandedzum Minimieren passieren könnte. (I33f67) - Die experimentellen
TopAppBar-APIs wurden aktualisiert, sodass beim Festlegen der Ausrichtung von Titel und UntertitelAlignment.Horizontalanstelle eines benutzerdefiniertenTopAppBarTitleAlignmentverwendet wird. (I70ca2) SliderState#onValueChangeist jetzt öffentlich, um dem Nutzer mehr Kontrolle zu geben (I104eb)- Führen Sie
NavigationSuiteScaffoldStateein, um die Animation der Navigationskomponente zu ermöglichen. Außerdem werden Überladungen vonNavigationSuiteScaffoldundNavigationSuiteScaffoldLayoutmit einem Statusparameter eingeführt. (I6a8c9, b/328674235)
Fehlerkorrekturen
- Verschieben Sie die Klassen
IconButtonColorsundIconToggleButtonColorsvonIconButtonDefaults.ktzurück zuIconButton.kt. (I3c233)
Externe Beiträge
SliderState#isDraggingist jetzt öffentlich. (I8458a)
Version 1.4.0-alpha06
15. Januar 2025
androidx.compose.material3:material3-*:1.4.0-alpha06 ist veröffentlicht. Version 1.4.0-alpha06 enthält diese Commits.
Verhaltensänderung
displayCutoutwurde der Gruppe von Insets hinzugefügt, die Material-Komponenten standardmäßig berücksichtigen, um zu verhindern, dass Inhalte mit dem Displayausschnitt überlappen. Dies ist eine Verhaltensänderung, die sich darauf auswirkt, wie Komponenten, die Insets berücksichtigen, um einen Displayausschnitt herum funktionieren. Dazu gehören der Standardwert des ParametersWindowInsetsfü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 ParameterWindowInsetsmanuell für jede Komponente an. (I43ee9, b/362508045)
API-Änderungen
- Aktualisierungen der
TopAppBarAPI Benennen Sie die mittleren und großen oberen App-Leisten mit einer Untertitel in*FlexibleTopAppBarum. Die Farbvariationen wurden in einer einzigenTopAppBarDefault.topAppBarColors()-Funktion zusammengefasst und einsubtitle-Farbparameter wurde hinzugefügt, der für eine bereitgestellte zusammensetzbare Untertitel-Funktion (I41b65) angewendet werden soll. WideNavigationRailArrangementAPI zugunsten vonArrangement.Verticalentfernen (Id0341)- Fügen Sie eine neue
VerticalSlider @Composablehinzu. (I2bfba) - Es wurde ein neuer Track
@Composablehinzugefügt, mit dem benutzerdefinierte externe Track-Ecken und ‑Symbole angegeben werden können. (I436a4) - Aktualisieren Sie die APIs für die schwebende Symbolleiste, damit das
FloatingToolbarColors-Objekt anstelle einer einzelnen Containerfarbe verwendet wird. (I9a054) - Neue experimentelle Annotation
ExperimentalMaterial3ComponentOverrideApi(Ia1eaf) hinzufügen und verwenden Modifier.indicatorLineakzeptiert jetzt eine Form für das Textfeld, um das Abschneiden zu verarbeiten. (I8c5f3, b/380704151)- Benennen Sie die experimentellen
FloatingAppBar-Funktionen inFloatingToolbarum (I1dbf8). - Es wurde ein neues
floatingToolbarVerticalNestedScrollhinzugefügt, das an einen scrollbaren Container angehängt werden kann, um den Erweiterungsstatus der unverankerten Symbolleiste basierend auf einer Scrollbewegung zu aktualisieren, die einen Schwellenwert überschreitet. (I6d65f) - Wir stellen eine neue API zum Erstellen einer schwebenden Symbolleiste mit einer angehängten Floating Action Button (FAB) vor. Die API bietet flexible Anpassungsoptionen, mit denen Sie die Symbolleiste horizontal oder vertikal anordnen und die 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
TalkBackaktiviert war. (/I9db53)
Externe Beiträge
BasicTooltipwurde in Foundation undBasicTooltip/Tooltipin Material 3 vereinheitlicht. (Ifc2e6)
Version 1.4.0-alpha05
12. Dezember 2024
androidx.compose.material3:material3-*:1.4.0-alpha05 ist veröffentlicht. Version 1.4.0-alpha05 enthält diese Commits.
API-Änderungen
- Ersetzen Sie den Typ im
WideNavigationRailState.current/target-Wert durch ein Enum, um die Lesbarkeit zu verbessern (I2d6ab). SplitButton– Shape API von Datenklasse in Klasse für binäre Kompatibilität ändern. (I53812)- Es wurde eine Tooltip-API mit dem Parameter
onDismissRequesthinzugefügt, damit Ersteller festlegen können, was passiert, wenn ein Nutzer außerhalb des Tooltips klickt. Die alte API, die diesen neuen Parameter nicht enthält, wurde eingestellt. (I99aef) - Die Benennung von
opticalCenteringinhorizontalCenterOpticallyändern. Den Modifikator intern machen Ersetzen Sie den Padding-Parameter durch den maximalen Start- und End-Offset. (I0b904) - Ändern Sie
WideNavigationRailStateso, dass es den aktuellen/Zielwert enthält, und entfernen Sie Enums zugunsten von booleschen Werten. (Idfa29, b/356039090) - Fügen Sie
NavigationBarItemComponentOverridehinzu. (I3a06a)
Fehlerkorrekturen
- Das Verhalten der oberen und unteren App-Leiste wurde korrigiert, sodass die Farbe zuverlässig geändert wird, wenn der Inhalt vollständig gescrollt wird. (Idc4e8, b/293665988)
- Scrollverhalten-Funktionen für obere und untere App-Leisten geben jetzt ein gespeichertes Verhalten zurück, um bei Neuzusammenstellungen eine bessere Leistung zu erzielen. (I0fdbe, b/207957336)
- Der Modifiziererparameter wird jetzt nach internen Modifizierern wie Drag-and-drop-Verhalten und Semantik angewendet, nicht mehr davor. Dies wirkt sich auf die Reihenfolge aus, in der die Modifikatoren angewendet werden. (I8d83f)
- Die maximierte Ansicht am unteren Rand bleibt auch bei einer Größenänderung maximiert. (I2870b, b/324934884)
- Status- und Navigationsleisten-Flags für Fenstereigenschaften werden korrekt weitergeleitet. (Ie674d, b/362539765)
- Verschieben Sie den Parameter für den Modifikator in das Stammverzeichnis der Gerüste, wie dokumentiert. Dadurch wird die Implementierung an M2 angepasst. (I0235e, b/372311595)
Externe Beiträge
- Die
DatePickerDialog-Funktion wurde vereinheitlicht. (I7dced)
Version 1.4.0-alpha04
13. November 2024
androidx.compose.material3:material3-*:1.4.0-alpha04 ist veröffentlicht. Version 1.4.0-alpha04 enthält diese Commits.
Geändertes Verhalten
- Die in aosp/3212478 eingeführten Farbänderungen für
iconButtonColors,iconToggleButtonColors,outlinedIconButtonColors,outlinedIconToggleButtonColorsundoutlinedIconToggleButtonBorderwerden rückgängig gemacht. Das jetzt zurückgesetzte Verhalten wurde in eine neue Reihe von Funktionen namensiconButtonVibrantColorsusw. verschoben, um die zurückgegebenen Farben mit hohem Kontrast hervorzuheben. (Iffd8d)
Neue Funktionen
VerticalDragHandle-Komponente einführen (I6c770)
API-Änderungen
- Benennen Sie
DismissibleModalWideNavigationRailDefaultsinModalWideNavigationRailDefaultsum. (I8e877) - Fügen Sie
NavigationBarComponentOverrideshinzu. (I8a3f3) - Fügen Sie
NavigationRailComponentOverridehinzu. (I83e13) - Wir führen
WideNavigationRailStateein, um das Ein- und Ausblenden des Rails zu ermöglichen,ModalWideNavigationRailkann geschlossen werden undDismissibleModalWideNavigationRailwird gelöscht. (I88568) - Den Standardwerten für Ein/Aus-Schaltflächen werden die Standardgrößen „xSmall“, „medium“, „large“ und „xLarge“ hinzugefügt. (Ie95d1)
- Den Schaltflächen-Standardeinstellungen werden die Standardgrößen „xSmall“, „medium“, „large“ und „xLarge“ hinzugefügt. (If8b6d)
Fehlerkorrekturen
- Die Farbe des nachgestellten Symbols des Filterchips wurde gemäß Spezifikation von „Primär“ zu
OnSurfaceContaineraktualisiert. 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 ist veröffentlicht. Version 1.4.0-alpha03 enthält diese Commits.
API-Änderungen
- Der
SheetState-Konstruktor mit Dichte wurde zugunsten von Positions- und Geschwindigkeitsschwellenwerten eingestellt. (Ifd16e) rememberTooltipPositionProviderwurde hinzugefügt und enthält eine aktualisierte Logik für die Positionierung.rememberPlainTooltipPositionProviderundrememberRichTooltipPositionProviderwurden eingestellt. (Ie66e2)- Mit zusätzlichen
ModalBottomSheetPropertieskönnen die Farben der Status- und Navigationsleiste angepasst werden. Standardmäßig werden sie 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
DatePickerundDateRangePickereinrequestFocus-Parameter hinzugefügt. Sie können verhindern, dass der Fokus gesetzt wird, indem Siefalseübergeben. (I12d09, b/286399710, b/340102743) - Die Standardeinstellungen für Formen werden im Shape-Objekt im Cache gespeichert. Die Form wird standardmäßig auf
@Composablefür die Ein/Aus-Schaltfläche festgelegt. Die Formen werden standardmäßig in einer Form zusammengefasst, da die Varianten auf dieselbe Tokendatei 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) TextFieldLabelScopeprogresswurde inlabelMinimizedProgressumbenanntTextFieldLabelPositionDefaultwurde inAttachedumbenannt. Schnittstellenmitglieder wurden entfernt. (If75c6)- Ein Problem mit
DatePickerim Eingabemodus wurde behoben. Validierungsfehler konnten dazu führen, dass sich die Höhe der Komponente geändert hat. (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 ist veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.
API-Änderungen
- Die Datumsauswahlen wurden aktualisiert, um eine einheitliche Verwendung von Gebietsschemas in der gesamten
DatePickerundDateRangePickerzu gewährleisten, wenn ein Gebietsschema direkt über einDatePickerStateoder einDateRangePickerStatefestgelegt wird. Wenn Sie Gebietsschemas direkt auf den Status festlegen, müssen Sie dafür sorgen, dass die Titel- und Überschriftentexte entsprechend lokalisiert werden, da der Standardtext weiterhin gemäß dem Standardgebietsschema der Plattform angewendet wird. (I37073, b/326490763, b/321657276) SheetState.isAnimationRunningist jetzt verfügbar. (I9a3d7)DatePickerColorshaben jetzt Vorrang vor allen in den Textstilen der Typografie des Designs definierten Farben, die in Konflikt stehen. Außerdem wird mit diesem Update die Position des Parameterscolorin den Funktionen für die Datumsauswahl angepasst und ein ParametercontentColorzum Anpassen der Farben für Header- und Titeltext eingeführt. (I30d03, b/347031394)- Benennen Sie
SplitButtoninSplitButtonLayoutum und entfernen Sie die APIs für Farbvarianten vonSplitButton. Varianten werden durch die Wiederverwendung von Schaltflächenvarianten vonSplitButtonDefaultserreicht. (I44c36) ModalBottomSheethat jetzt den ParametersheetGestureEnabled(I856cb, b/288211587)- Die
standardMotionSchemeund dieexpressiveMotionSchemewurden in „Standard“ und „Expressiv“ umbenannt. Beide Funktionen sind jetzt über dasMotionScheme-Begleitobjekt durch Aufrufen vonMotionScheme.standard()undMotionScheme.expressive()verfügbar. (Iceccf) - Der Parameter
maxWidthwird einfachen und Rich-Tooltips hinzugefügt. Die Standardeinstellung ist die Designspezifikation von 200 dp für einfache Tooltips und 320 dp für Rich-Tooltips. (I30ce9)
Fehlerkorrekturen
- Die
DatePickerundDateRangePickeraktualisieren den angezeigten Monat jetzt korrekt, wenn er über diedisplayedMonthMillisdes Status festgelegt wird. (If9e47, b/333414302) ModalBottomSheet– Inhalte werden 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_DEFAULTgeändert, damit die IME-Tastatur zuerst geschlossen werden kann. (I447fb) - Abstürze in
DatePickerundDateRangePickerbehoben, wenn das minimal auswählbare Jahr auf ein zukünftiges Jahr festgelegt ist. (I78656, b/319395747) - 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 ist veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.
Geändertes Verhalten
- Die Bibliothek fügt keine Abhängigkeit von
material-icons-coremehr hinzu. Wenn Ihr Projekt also darauf angewiesen war, müssen Sie diese Abhängigkeit explizit in Ihrenbuild.gradle[.kts]-Dateien hinzufügen. (I735ff, b/349894318) - Die aktive Label-Farbe von
NavigationBarItemundNavigationRailItemändert sich vononSurfacezusecondary, um die Nutzerfreundlichkeit und den Farbkontrast zu verbessern und die Kohärenz im System zu optimieren (Ibc297). Wenn Sie zum vorherigen Verhalten zurückkehren möchten, kopieren Sie die Standardfarben und ändern SieselectedTextColorinMaterialTheme.colorScheme.onSurface. - Material 3-Komponenten verwenden jetzt die neue
MotionScheme, um ihre Bewegung zu definieren. (Ie0f93) - Bewegungsänderungen bei unbestimmter kreisförmiger Fortschrittsanzeige (I3c07e)
- Aktualisieren Sie
OutlinedIconButtonColorsundOutlinedIconToggleButtonColors, um den Farbkontrast zu verbessern. (I2743d) - Die Container- und Inhaltsfarbe für
FilledIconToggleButtonColorsundFilledTonalIconToggleButtonColorswurde aktualisiert. (Ic5d0f) - Die Rahmenfarbe von
OutlinedButtonwurde vonoutlinezuoutlineVariantgeändert. (057f00)
API-Änderungen
- Der Funktion
enterAlwaysScrollBehaviordesTopAppBarwurde ein optionalerreverseLayout-Parameter hinzugefügt, um Inhalte, die mit einemreverseLayoutfestgelegt wurden, besser zu unterstützen. (I4e0e5) SegmentedButtonunterstützt jetzt das ArgumentcontentPadding. (I5ad91, b/358414376)PullToRefreshStatehat keine Standardimplementierung mehr fürisAnimating(I6a593)- Es wurden neue Überladungen von Material
TextFieldundOutlinedTextFieldhinzugefügt, dieTextFieldStateverwenden. Es wurden APIs für Dekorationsboxen hinzugefügt, die mitTextFieldDecoratorkompatibel sind. (If13a1) - Es wurde ein Parameter hinzugefügt, um die
labelPositiondes Textfelds zu steuern. MitalwaysMinimizekann das UI-Muster verwendet werden, bei dem ein Label und ein Platzhalter gleichzeitig in einem Textfeld angezeigt werden, auch wenn das Feld nicht fokussiert ist. (I1ef2c) - Material
SecureTextFieldundOutlinedSecureTextFieldfü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_PRESSin Kurzinfos hinzugefügt. (I62e6a) TimePickerStatesisAfternoonist jetzt ein Erweiterungswert anstelle einer Variablen in der Schnittstelle und wurde inisPmumbenannt (I89a97).- Die Typografieklasse wurde aktualisiert, um betonte Typografie-Skalen zu unterstützen. (Ifa13c)
- Die
ModalWideNavigationRailAPI wurde hinzugefügt und dieModalExpandedNavigationRailAPIs wurden inDismissibleModalWideNavigationRailumbenannt. (Ic9118) - Die
FloatingAppBarScrollBehaviorwurde aktualisiert, sodass diescreenOffsetautomatisch berechnet wird und keine@Composableerforderlich ist. (Idf349) - Aktualisierungen der
LoadingIndicatorAPI zur Korrektur der Benennung im Standardobjekt. DerPullToRefreshwurde eineLoadingIndicatorElevation-Konstante hinzugefügt. (I1d72b) - Aktualisierungen der
LoadingIndicatorAPI zur Korrektur der Benennung im Standardobjekt. DerPullToRefreshwurde eineLoadingIndicatorElevation-Konstante hinzugefügt. (I1d72b) - Den unbestimmten Varianten von
LinearWavyProgressIndicatorundCircularWavyProgressIndicatorwurden die ParameteramplitudeundwaveSpeedhinzugefügt. (I2a0c5) - Unterstützung für das Ändern der Form einer Symbol-Schaltflä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. DieAnimatedTrailingButtonAPI wurde entfernt, da dieTrailingButtonAPI 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 Formen und Abständen für verbundene Schaltflächengruppen zu
ButtonGroupDefaultszur 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
MotionSchemeein, mit dem Sie ein Schema für die Bewegung der Komponente festlegen können. Das Schema wird überMaterialThemefestgelegt. (Id50c2)
Fehlerkorrekturen
- Wenden Sie den richtigen Fokus-Traversal-Index auf untergeordnete
Scaffold-Composables an. Die Reihenfolge isttopBar,bottomBar, fab, content, snackbar. (I5936b) - Ein Problem wurde bei
DatePickerundDateRangePickerbehoben, bei dem in bestimmten Gebietsschemas und Format-Skeletten einige der Datumsbestandteile (z.B. Monatsnamen) nicht mit einem Großbuchstaben begannen. (I1430f) - Tokens für die FAB- und FAB-Menükomponenten integrieren (geringfügige visuelle Änderungen an Abständen und Text) (Ib57f3)
ModalBottomSheetist jetzt das erste Element in der semantischen Reihenfolge, gefolgt vom Scrim. (I436f9, b/358594665)- 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 ist veröffentlicht. Version 1.3.2 enthält diese Commits.
Fehlerkorrekturen
ListItemkorrigiert die Berechnung der intrinsischen Höhe und reserviert jetzt die entsprechende Menge an Speicherplatz im Layout.- Entfernen Sie überflüssiges Padding für das Label
NavigationBarItem, um die Spezifikation korrekt einzuhalten. - Korrigiert das
TabRow-Layout im RTL-Modus.
Version 1.3.1
30. Oktober 2024
androidx.compose.material3:material3-*:1.3.1 ist veröffentlicht. Version 1.3.1 enthält diese Commits.
Fehlerkorrekturen
- Die
DatePickerundDateRangePickeraktualisieren den angezeigten Monat jetzt korrekt, wenn er über diedisplayedMonthMillisdes Status festgelegt wird. (If9e47, b/333414302) - Abstürze in
DatePickerundDateRangePickerbehoben, 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_DEFAULTgeändert, damit die IME-Tastatur zuerst geschlossen werden kann. (I447fb)
Version 1.3.0
4. September 2024
androidx.compose.material3:material3-*:1.3.0 ist veröffentlicht. Version 1.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.2.0
Wichtige Funktionen von Version 1.3.0
Neue Material Design 3-Komponenten
- Karussell
HorizontalMultiBrowseCarouselundHorizontalUncontainedCarouselVerbesserungen an vorhandenen Material Design 3-Komponenten.
- [
ModalBottomSheet] unterstützt jetzt die 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 (
ModalDrawerSheetundDismissibleDrawerSheet) unterstützt jetzt die Funktion „Vorhersagende Zurück-Geste“ auf U+ als Opt-in (Ie5b0b). DropdownMenuunterstützt jetzt benutzerdefinierte Farben, Formen, Erhebungen und Rahmen. (I8e981,b/289554448, b/301887035, b/283654243)- Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I3058e)
- Die
ProgressIndicatorwurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I21451) - Für Rich-Tooltips wurde ein Standard-Caret hinzugefügt. Es wird jetzt unterstützt, dass ein benutzerdefiniertes Caret für den Anker
LayoutCoordinatesgezeichnet wird. (Ifd42c) Funktionsgefährdende Änderungen - Neue Pull-to-Refresh-APIs:
- Vereinfachtes
PullToRefreshStatezur Verwendung von Bruchwerten anstelle von Dp-Einheiten. - Der
isRefreshing-Status wird vom Nutzer und nicht vonPullToRefreshStategesteuert. - Die verschachtelte Scrollverbindung wurde von
PullToRefreshStategetrennt. Dies wird vom neuenPullToRefreshBoxoderModifier.pullToRefreshübernommen. - Dieses Update ist eine grundlegende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Visuelle Änderungen
- Vereinfachtes
- Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorSchemeunddarkColorScheme. (I9db52) - Die Farben für den Schieberegler und
ProgressIndicatorwurden 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 mitSurfaceundTonalElevationberechnet wurde, werden jetzt standardmäßigSurfaceContainer-Rollen verwendet, die nicht von der tonalen Erhebung betroffen sind. (b/304584161)- Die Baseline-Rollen für Surface und Surface-Container wurden leicht angepasst, sodass in hellen und dunklen Designs mehr Farbton zu sehen ist. (I677a5)
- Experimentelle APIs wurden in stabile APIs umgewandelt.
- Leistungsverbesserungen
Version 1.3.0-rc01
21. August 2024
androidx.compose.material3:material3-*:1.3.0-rc01 ist veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.
Fehlerkorrekturen
ModalBottomSheetist jetzt das erste Element in der semantischen Reihenfolge, gefolgt vom Scrim. (I436f9, b/358594665)
Version 1.3.0-beta05
24. Juli 2024
androidx.compose.material3:material3-*:1.3.0-beta05 ist veröffentlicht. Version 1.3.0-beta05 enthält diese Commits.
- Ein Problem wurde behoben, bei dem
BottomSheet-Inhalte unter Android N und O fehlten oder abgeschnitten wurden (a10a2d). - Die semantischen Grenzen des Schiebereglers wurden erhöht, damit
TalkBackdie Fokusindikatoren um die Thumbnails herum richtig anzeigen kann. (0b5a1d)
Version 1.3.0-beta04
26. Juni 2024
androidx.compose.material3:material3-*:1.3.0-beta04 ist veröffentlicht. Version 1.3.0-beta04 enthält diese Commits.
Version 1.3.0-beta03
12. Juni 2024
androidx.compose.material3:material3-*:1.3.0-beta03 ist veröffentlicht. Version 1.3.0-beta03 enthält diese Commits.
Externe Beiträge
androidx.compose.material3.DropdownMenuaus dem gemeinsamen Quellenset verfügbar machen (If62c0)
Version 1.3.0-beta02
29. Mai 2024
androidx.compose.material3:material3-*:1.3.0-beta02 ist veröffentlicht. Version 1.3.0-beta02 enthält diese Commits.
API-Änderungen
Modifier.pullToRefreshIndicatorunterstützt die Erhöhung. Die Pull-to-Refresh-APIs wurden so aktualisiert, dass „enabled“ ein boolescher Wert anstelle einer Lambda-Funktion ist. Unterstützung der Ausrichtung von Inhalten inPullToRefreshBox(I75679)TooltipScopeals versiegeltes Interface festlegen und eine interne Implementierung für die Verwendung inTooltipBoxund Label erstellen. (I3833e)CarouselItemScope: Zwei neue Modifizierer hinzugefügt –maskClipundmaskBorder–, um jedem Karussellelement ganz einfach eine Form und einen Rahmen hinzuzufügen (Id67a1)TimePickerStateist jetzt eine Schnittstelle und ermöglicht das Einstellen der Uhrzeit (I88546).- Die API zum Formatieren der Links wurde aktualisiert:
TextLinkStyleswurde zuTextStyleverschoben undTextDefaultswurde aus dem Material entfernt. (I5477b)
Fehlerkorrekturen
- Die Symbole für die Status- und Navigationsleiste von
ModalBottomSheetpassen sich jetzt an den Status des dunklen Designs an. (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.AlertDialogaus dem gemeinsamen Quellset verfügbar machen (Ia33f5)ModalBottomSheetaus dem gemeinsamen Quellenset (Id7cc7) verfügbar machen
Version 1.3.0-beta01
14. Mai 2024
androidx.compose.material3:material3-*:1.3.0-beta01 ist veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.
API-Änderungen
DpSizeanstelle vonCaretPropertiesverwendenCaretPropertieswird entfernt. Benennen SieCaretScopeinTooltipScopeum. (Id9a76)- Die API zum Abrufen von Links mit Material-Design im Text wurde aktualisiert. Konkret wurden die Methoden aus
TextDefaultszum Erstellen thematischerLinkAnnotationsund zum Parsen von HTML mit thematischen Links entfernt. Stattdessen wurde eineTextLinkStyles-Klasse hinzugefügt, mit der die Links als Parameter für die zusammensetzbare Text-Funktion formatiert werden können. (I31b93)
Version 1.3.0-alpha06
1. Mai 2024
androidx.compose.material3:material3-*:1.3.0-alpha06 ist veröffentlicht. Version 1.3.0-alpha06 enthält diese Commits.
Aktuelle Änderungen
Neue APIs zum Aktualisieren durch Ziehen:
- Vereinfachtes
PullToRefreshStatezur Verwendung von Bruchwerten anstelle von Dp-Einheiten. - Der
isRefreshing-Status wird vom Nutzer und nicht vonPullToRefreshStategesteuert. - Die verschachtelte Scrollverbindung wurde von
PullToRefreshStategetrennt. Dies wird vom neuenPullToRefreshBoxoderModifier.pullToRefreshübernommen. - Dieses Update ist eine grundlegende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)
- Vereinfachtes
API-Änderungen
RippleConfiguration#isEnabledwurde entfernt undLocalRippleConfigurationwurde auf „nullable“ gesetzt. Wenn Sie einen Ripple deaktivieren möchten, geben Sie statt einesRippleConfigurationmitisEnabled = falsedie WertenullbisLocalRippleConfigurationan. (I22725)ModalBottomSheetDie Statusleiste wird jetzt genauer mit einem Scrim überzogen, wenn der Edge-to-Edge-Modus aktiviert ist. Inhalte von modalen Bottom Sheets können jetzt Fenster-Insets nutzen, sodass Inhalte über der Navigationsleiste sichtbar sind. Der ParameterModalBottomSheetwindowInsetswurde incontentWindowInsetsumbenannt, um anzugeben, wo die Insets angewendet werden. Sie sind nicht mehr an die Fensterlogik gebunden. Der TypcontentWindowInsetswurde in eine Funktion geändert, dieWindowInsetszurückgibt, damit er im neuen Fenster aufgelöst werden kann. (I39630, b/274872542, b/300280229, b/290893168)PrimaryScrollableTabRowundSecondaryScrollableTabRowverwenden jetzt ein benutzerdefiniertes Layout anstelle 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
OutlinedTextField-Padding oben für das Label berücksichtigt jetzt die Schriftgröße des Systems. (Idc781) - Korrigierter Paketstandort:
CalendarLocale. (Ifa235) - [Intelligente „Zurück“-Geste] Aktualisieren der Animationen für die intelligente „Zurück“-Geste, sodass die Interpolationskurve (0.1, 0.1, 0, 1) verwendet wird (I2591a)
Version 1.3.0-alpha05
17. April 2024
androidx.compose.material3:material3-*:1.3.0-alpha05 ist veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.
Neue Funktionen
SearchBarundDockedSearchBarhaben neue Überladungen, die einen Textfeldparameter akzeptieren. So lässt sich das Textfeld unabhängig vom Rest der Suchleiste gestalten und es können benutzerdefinierte Textfelder übergeben werden. Das Textfeld der aktuellen Implementierung ist alsSearchBarDefaults.InputFieldverfügbar. (I50c73, b/275074248, b/278773336, b/326627700)- Die Lambda-Funktion
drawTickwurde der öffentlichen API hinzugefügt, um die Ticks bei Bedarf anzupassen (I0c048).
API-Änderungen
- Für Textlinks gibt es jetzt zusätzlich zum normalen Stil, dem Hover- und dem Fokusstil auch eine Stiloption für den gedrückten Zustand (I5f864, b/139312671).
CarouselItemInfowurde aktualisiert, um ein Maskenrechteck zu präsentieren, durch das das Element beschnitten wird (I785d8).BasicTooltipStatewurde aus der öffentlichen Material 3-API entfernt. Die Funktionalität wird mitTooltipStatekombiniert, bis dieBasicTooltipvon 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, dieMaterialThemeauf die Links anwenden (I98532, b/139312671). ExposedDropdownMenuBoxScopelässt keine Unterklassen mehr zu. Für Drop-down-Menüs, die angezeigt werden, gibt es jetzt einMenuAnchorType, das anmenuAnchorübergeben werden sollte, um die Barrierefreiheit zu verbessern. Diese Methode sollte anstelle der Übergabe vonfocusableanExposedDropdownMenuverwendet werden, da Letzteres jetzt veraltet ist.menuAnchorhat einen neuen Parameter zum Steuern desenabled-Status. (I55ee6, b/257209915, b/308840226)- Die Rahmenfarbe von
OutlinedButtonwurde korrigiert, wenn die Funktion deaktiviert ist. Die ÜberladungButtonDefaults.outlinedButtonBorder("enabled")wurde hinzugefügt, die den aktivierten Status übernimmt. (Ie650b, b/318461363) - Es wurde eine neue
CarouselItemInfo-Klasse hinzugefügt, damit Clients Informationen zu den Artikelgrößen abrufen können. (I9070c) - Der
ColorScheme-Konstruktor ohne Surface-Container ist jetzt veraltet. Migrieren Sie bitte zum Konstruktor, der Oberflächencontainer enthält. (I35c11) - [Outlined]
TextFieldDefaultsContainerBoxwurde inContainerumbenannt. (Ie8d3b)
Fehlerkorrekturen
BottomSheetScaffoldwird nicht mehr durch verschachteltes Scrollen gescrollt, wennsheetSwipeEnabledauf „false“ gesetzt ist. (I5e1c1, b/306464779)- Die OptIn-Annotation
ExperimentalMaterial3Apiwurde inIconButtonSamples.ktentfernt. (I111d1)
Version 1.3.0-alpha04
3. April 2024
androidx.compose.material3:material3-*:1.3.0-alpha04 ist veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.
Neue Funktionen
- Es wurden zwei experimentelle Versionen des Material3-Karussells hinzugefügt:
HorizontalMultiBrowseCarouselundHorizontalUncontainedCarousel(I88d64). - Die Compose M3-Navigationsleiste (
ModalDrawerSheetundDismissibleDrawerSheet) wurde aktualisiert, um die 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
MediumTopAppBarTitel auf Geräten mit großen Schrift-/Anzeigeeinstellungen gekürzt hat. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676) SegmentedButtonund zugehörige APIs sind jetzt stabil (I8a158)SwipeToDismissBox,SwipeToDismissBoxDefaults,SwipeToDismissBoxStateundSwipeToDismissBoxValuesind jetzt als stabil gekennzeichnet. (I5f000)- Die verworfenen Enums und APIs
DismissDirectionundDismissValuewurden entfernt. (I89ccd) - Dem
CarouselState-Begleitobjekt von „Carousel“ wurde ein experimentelles Tag hinzugefügt. (I94154) LocalMinimumInteractiveComponentEnforcementwurde eingestellt und durchLocalMinimumInteractiveComponentSizeersetzt. (I7a7ac)- Der Konstruktor für
SearchBarColorsist jetzt öffentlich. (I769ca) - Der Parameter
gesturesEnabledwurde zuSwipeToDismissBoxhinzugefügt. (Idc59f, b/324170119) - Die als verworfen und experimentell gekennzeichneten APIs für Textfelder wurden entfernt. (I1305f)
Version 1.3.0-alpha03
20. März 2024
androidx.compose.material3:material3-*:1.3.0-alpha03 ist veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.
Visuelle Breaking Changes
- Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorSchemeunddarkColorScheme. (I9db52)
Neue Funktionen
- Es wurden Parameter hinzugefügt, um
ExposedDropdownMenuanzupassen. Insbesondere haben Menüs jetzt einenfocusable-Parameter (Standardwerttrue), der auffalsegesetzt werden sollte, wenn Sie mit bearbeitbaren Textfeldern arbeiten. (I4184c, b/323694447, b/278609042)
API-Änderungen
- Das Flag
ScaffoldSubcomposeInMeasureFixwurde entfernt. (Ie2a4b) NavigationRailItemColorsist jetzt als@Immutablegekennzeichnet. (If6112, b/327660613)NavigationBarItemColorsist jetzt als@Immutablegekennzeichnet. (I42a30, b/298064514)- Parameter im zusammensetzbaren Element „Slider Track“ neu anordnen. (I9f315)
ExposedDropdownMenuwird jetzt mitPopupimplementiert. 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 Surface und Surface-Container wurden leicht angepasst, sodass in hellen und dunklen Designs mehr Farbton zu sehen ist. (I677a5)
- Die Farben für den Schieberegler und
ProgressIndicatorwurden aktualisiert, um den neuen Spezifikationen für den Kontrast von Nicht-Text-Elementen zu entsprechen. (I26807) - Das Overlay für den Fokusstatus wurde auf 0,1 f aktualisiert, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
- Kleine Anpassungen der Standardeinstellungen für Oberflächen- und Hintergrundfarben in
lightColorSchemeunddarkColorScheme. (I9db52)
Version 1.3.0-alpha02
6. März 2024
androidx.compose.material3:material3-*:1.3.0-alpha02 ist veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.
API-Änderungen
- Die Schieberegler werden wieder stabilisiert.
State.onValueChangeFinishedwird wieder zu einem Wert.onValueChangeFinishedin einrememberUpdatedStateeinfügen (I82ab2, b/322269951) - Die Navigationskomponenten verwenden jetzt die neuen
SurfaceContainer-Rollen.DrawerDefaultsbietet jetzt separate Attribute fürstandardContainerColorundmodalContainerColor.DrawerDefaults.ModalDrawerElevationheißt jetzt0.dp. (I7fbac) @Stablewird aus den Status vonSliderentfernt, dastate.onValueChangeFinishedin einvargeändert wird. (Ied34a, b/322269951)- Die Animationsspezifikation für
ModalBottomSheetundStandardBottomSheetist jetzt eineTweenSpecund 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“ undTonalElevationberechnet wurde, werden jetzt standardmäßigSurfaceContainer-Rollen verwendet, die nicht von der tonalen Erhebung betroffen sind. (b/304584161)- Ein Fehler wurde behoben, durch den die nicht ausgewählte, deaktivierte Containerfarbe von
ElevatedFilterChipschwarz war. (I400e6, b/322407043) - Problem mit unbestimmter Fortschrittsanzeige behoben, wenn der Fortschritt 0 ist (Id6582)
- Ein Problem mit
SliderundRangeSliderim RTL-Layout (Iab0e1) wurde behoben. SliderRangeTolerancewird für die Berechnung des Bereichs des Schiebereglers hinzugefügt, da das Runden von Gleitkommazahlen ungenau sein kann. (Ic918a, b/324934900)- Die Schaltflächen von
DatePickerDialogmüssen angezeigt werden, wenn einDateRangePickerverschachtelt wird oder wenn auf kleinen Bildschirmen mit größeren Schriftarten eine beliebige Art von Datumsauswahl angezeigt wird. (Ie4758, b/325107799, b/277768544) Menuverwendet jetzt die RolleSurfaceContainerfür die Containerfarbe.MenuDefaults.TonalElevationheißt jetzt0.dp. (I135b7)TextFieldverwendet jetzt die RolleSurfaceContainerHighestfür die Containerfarbe. (I4dced)- Für die erhöhten Chips wird jetzt die Rolle
SurfaceContainerLow(I7cd2f) verwendet. - Die Containerfarbe von
DatePickerist jetztSurfaceContainerHigh.DatePickerDefaults.TonalElevationheißt jetzt0.dp. (Ida753) - Aktualisiert die Containerfarbe und die Ziehgrifffarbe von Bottom Sheets. (I72a0a)
- Die Containerfarbe von
RichTooltipist jetztSurfaceContainer. (Ia8b45) - Die Containerfarbe von
SearchBarist jetztSurfaceContainerHighest.SearchBarDefaults.TonalElevationheiß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
AlertDialogist jetztSurfaceContainerHigh. (Ie0433) - Die Containerfarbe von
BottomAppBarist jetztSurfaceContainer. Die FarbeTopAppBaronScrollist jetztSurfaceContainer. (I41630) - Die Containerfarbe von
ElevatedCardist jetztSurfaceContainerLow.FilledCardDie Containerfarbe vonSurfaceContainerHighest. (I35141) - Die Containerfarbe von
ElevatedButtonist jetztSurfaceContainerLow.FilledIconButton, die nicht ausgewählt sind, haben jetzt die ContainerfarbeSurfaceContainerHighest. (I792c9) - Aktualisiert die Rolle für die Containerfarbe
TimePickerund die Farbe des Zifferblatts aufSurfaceContainerHighest. (I43b93)
Version 1.3.0-alpha01
21. Februar 2024
androidx.compose.material3:material3-*:1.3.0-alpha01 ist veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.
Neue Funktionen
- Update für Compose M3
ModalBottomSheetzur Unterstützung von Predictive Back unter U+ (Iccf32, b/281967264, b/304850357) - Compose M3
SearchBarwurde aktualisiert, um die intelligente „Zurück“-Geste auf U+ zu unterstützen (I657f8) - Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I3058e)
- Die
ProgressIndicatorwurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurden eine Lücke und eine Stoppanzeige hinzugefügt. (I21451) - 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
RippleThemenicht mehr ab.
API-Änderungen
- Die Funktion
drawStopIndicatorist jetzt öffentlich verfügbar. (I3f59f) - Markieren Sie die
formatWithSkeleton-Funktion vonDatePickerals intern (Ic65dc). DropdownMenuunterstützt jetzt benutzerdefinierte Farben, Formen, Erhebungen und Rahmen. (I8e981, b/289554448, b/301887035, b/283654243)- Material3-Komponenten, die in ihrer API ein
MutableInteractionSourceverfügbar machen, wurden aktualisiert und machen jetzt ein nullableMutableInteractionSourceverfügbar, das standardmäßig aufnullgesetzt ist. Es gibt hier keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dasMutableInteractionSourcenicht hochziehen. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie einMutableInteractionSourcezugewiesen wird. Außerdem kann es sein, dass für andere Komponenten 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
RippleConfigurationundLocalRippleConfigurationhinzu, um die Anpassung von Ripples pro Komponente / Unterbaum mithilfe von festen Werten zu ermöglichen. Das kann beispielsweise sinnvoll sein, wenn Sie die Farbe einer Komponente ändern möchten, die Sie nicht steuern, oder wenn Sie die Wellenbewegung für eine Komponente deaktivieren möchten. In den meisten Fällen sollten die Standardwerte verwendet werden. Diese APIs sind eine Möglichkeit, einzelne Komponenten oder begrenzte Unterstrukturen anzupassen. Bei größeren Änderungen und benutzerdefinierten Designsystemen sollten Sie stattdessen mitcreateRippleModifierNodeeine eigene Ripple-Animation erstellen. (I7b5d6, b/298048146) - Fügt in Material 3 eine neue Ripple-API hinzu, die die eingestellte
rememberRippleersetzt. Außerdem wird ein temporäresCompositionLocal,LocalUseFallbackRippleImplementationhinzugefügt, um Material 3-Komponenten auf die Verwendung der verworfenenrememberRipple- undRippleTheme-APIs 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 benutzerdefinierteRippleThemeangeben. (I34cbc, b/298048146)
Fehlerkorrekturen
- Die Unterkomposition in
ModalBottomSheetwurde entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei demModalBottomSheetin bestimmten Szenarien in Kombination mitLookaheadScopeabstürzen konnte. (I2a198) - Die Unterkomposition in
BottomSheetScaffoldwurde entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei demBottomSheetScaffoldin bestimmten Szenarien in Kombination mitLookaheadScopeabstürzte. (Ie6401) - Die Ausrichtung des Logos wurde angepasst, sodass es sich näher an der Mitte des Ankerinhalts in Bezug auf die obere rechte Ecke befindet. (I18a28)
- Es wurde ein Problem mit der Barrierefreiheit bei
DateRangePickerbehoben, bei dem der Texttitel „Monat–Jahr“ für Nutzer von Screenreadern, Switch Access und Voice Access als interaktiv dargestellt wurde. (I2ac55) - Der Fehler bei der Parameterreihenfolge für
mediumTopAppBarColorswurde behoben. (Ibe64a)
Version 1.2
Version 1.2.1
6. März 2024
androidx.compose.material3:material3-*:1.2.1 ist veröffentlicht. Version 1.2.1 enthält diese Commits.
Fehlerkorrekturen
- Sorgen Sie dafür, dass die Schieberegler-Zustände wieder stabil sind.
State.onValueChangeFinishedwird wieder zu einem Wert.onValueChangeFinishedin einrememberUpdatedStateeinfügen (Ie8fd0, b/322269951) @Stablewird aus den Status vonSliderentfernt, dastate.onValueChangeFinishedin einvargeändert wird. (I82ba1, b/322269951)NavigationBarBenutzerdefinierte Farben aus Standardfarben kopieren (80a779, b/326894020)- Regression in
ExposedDropdownMenubehoben, damit das Element wieder fokussierbar ist (3fcec1, b/323694447) - Problem mit dem Caching der Schaltflächenfarbe behoben (3e5bbcb/327371655)
Version 1.2.0
7. Februar 2024
androidx.compose.material3:material3-*:1.2.0 ist veröffentlicht. Version 1.2.0 enthält diese Commits.
Bekanntes Problem
- In
PrimaryTabRowwurde im Rahmen einer Leistungsverbesserung ein Fehler beim Rendern der View-Compose-Interop eingeführt. Verwenden Sie als BehelfslösungTabRowmitTabRowDefaults.PrimaryIndicator.
Wichtige Änderungen seit Version 1.1.0
Neue Material 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 ist veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Der Fehler bei der Parameterreihenfolge für
mediumTopAppBarColorswurde behoben. (Ibe64a) - Ein Fehler wurde behoben, der in
1.2.0-beta02inCardDefaults.cardColorseingeführt wurde und bei demcontentColornicht auf Grundlage descontainerColor-Parameterwerts aktualisiert wurde. (Iee041, b/319671246) - Ein Fehler in
disabledContentColor, der in1.2.0-beta02eingefü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 ist veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.
Bekannter Fehler
- Aufgrund eines Fehlers in
IconButtonColorswird standardmäßigdisabledContentColoreinem Alpha (0,38f) vonLocalContentColoranstelle des vom Nutzer angegebenencontentColorzugewiesen. Das Problem lässt sich umgehen, indem SiedisabledContentColorexplizit festlegen. Dieses Problem wird im nächsten Release behoben.
API-Änderungen
- Es wurde die Möglichkeit hinzugefügt, Tooltip-Caret-Symbole für Plain
TooltipAPIs zu aktivieren. (Ibf767) SwipeToDismissState,rememberSwipeToDismissundSwipeToDismissValuewerden alle umbenannt und enthalten_SwipeToDismissBox_. (I68d6d)
Fehlerkorrekturen
- Der End-Padding-Wert für
ListItemwurde korrigiert, um der Spezifikation zu entsprechen. (Ibd68b, b/305342674) - Die Umrissfarbe für Karten mit Umriss wird jetzt korrekt
OutlineVariantzugeordnet. (I75480, b/310979715) - Die dynamische Farbe wird jetzt aus den 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
ModalBottomSheetwurde auf Android T/13+ behoben, wennandroid:enableOnBackInvokedCallback="true". (I728dc, b/306196110)
Version 1.2.0-beta01
13. Dezember 2023
androidx.compose.material3:material3-*:1.2.0-beta01 ist veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.
API-Änderungen
TabIndicatorScopeals experimentell markieren (I45c88)- Die verworfenen experimentellen APIs für Tooltips werden entfernt. (I438cb)
- Ändern Sie neue
TabRow-Überladungen so, dass keine untergeordneten Kompositionen verwendet werden. Das führt zu einer anderen Methode zum Erstellen derTabRow-Indikatoren mit benutzerdefinierten Modifikatoren. (Ife741) - Die APIs
DismissDirectionundDismissValuewerden eingestellt. Sie wurden inSwipeToDismissValuezusammengeführt. Die Werte geben sowohl die Position als auch die Richtung vonSwipeToDismissBoxan.DismissState.progressist jetzt alsFloatRangezwischen0.0und1.0markiert. Die eingestellten Saver- und Constructor-KlassenDismissStatewurden entfernt. Die KomponenteSwipeToDismiss, das Status- und das Standardobjekt wurden als experimentell gekennzeichnet. (Ib54f2)
Fehlerkorrekturen
- Die Standardanzeige für
PullToRefreshist jetzt eine offene Pfeilspitze anstelle eines ausgefüllten Dreiecks. (I67be3)
Version 1.2.0-alpha12
29. November 2023
androidx.compose.material3:material3-*:1.2.0-alpha12 ist veröffentlicht. Version 1.2.0-alpha12 enthält diese Commits.
API-Änderungen
RangeSliderakzeptiert jetzt einen Kotlin-Bereich (z.B.0f..1f) anstelle einer benutzerdefiniertenFloatRange-Wertklasse.SnapFlingBehavior.ktverwendet jetzt auch einen Kotlin-Bereich. (I025cb)- Markieren Sie die Factory-Funktionen für Modifikatoren als
@Stable. (Ib109f)
Version 1.2.0-alpha11
15. November 2023
androidx.compose.material3:material3-*:1.2.0-alpha11 ist veröffentlicht. Version 1.2.0-alpha11 enthält diese Commits.
Neue Funktionen
- Implementiert
PullToRefreshContainerundPullToRefreshState, die zusammen eine Implementierung von „Zum Aktualisieren ziehen“ in Material 3 ermöglichen. (I16456, b/261760718)
API-Änderungen
- Markieren Sie
SwipeToDismissBox,DismissDirectionundDismissValueals experimentell. (I517b0) - Benennen Sie
SwipeToDismissinSwipeToDismissBoxum. Benennen SiebackgroundinbackgroundContentunddismissContentin nachgestelltescontent-Lambda um. (I7f4d3) - Machen Sie den Konstruktor für
ChipElevationundSelectableChipElevationöffentlich. (Ie0c48, b/308432421) ModalBottomSheetPropertieswird hinzugefügt.securePolicywird inModalBottomSheetPropertiesverschoben.isFocusableundshouldDismissOnBackPresswerden zuModalBottomSheetPropertieshinzugefügt. Mit diesen neuen booleschen Werten lässt sich festlegen, wie modale Bottom Sheets IME-Ereignisse verarbeiten sollen. (Iea56f, b/278216859)- Die Status
RangeSliderundSliderwurden aktualisiert, uminitialOnValueChange, die ursprünglichen Präfixe und die entsprechenden K-Dokumente zu entfernen. (I57d30) - Die Klasse
ChipBorderund die zugehörigen Funktionsaufrufe werden eingestellt. Wir empfehlen, stattdessenBorderStrokedirekt zu verwenden. (I89cc2) - Die Tooltip-APIs für Grundlagenmodelle sind jetzt
@ExperimentalFoundationApi. (I30b0b) TabRowundScrollableTabRowsind nicht mehr veraltet. Die neuen primären und sekundären Varianten sind als experimentell gekennzeichnet. (I0def6)- Filter- und Eingabe-Chips verwenden jetzt direkt
BorderStroke. (I07a8d) SegmentedButtonverwendet jetztBorderStrokedirekt. (I89b9b)- Die generische Funktion
AlertDialogwurde inBasicAlertDialogumbenannt und die vorherige Funktion wurde eingestellt. (Idbe52) - Benennen Sie die
SwipeToDismiss-APIs inSwipeDismissum und stufen Sie die neuenSwipeDismiss-APIs auf „Stabil“ hoch. (I14cbe) tonalElevationundshadowElevationwerden den Tooltip-APIs hinzugefügt. Außerdem werden die APIsTooltipBox,PlainTooltipundRichTooltipwieder 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
@ExperimentalMaterial3Apiwurde aus den klickbaren Material3-Karten entfernt. (I88dbf)
Fehlerkorrekturen
- Ein Problem wurde behoben, durch das
SwipeToDismissin bestimmten Szenarien mit verschachtelten Lookahead- und Lazy-Layouts abstürzte. (Ica8d1, b/297226562)
Version 1.2.0-alpha10
18. Oktober 2023
androidx.compose.material3:material3-*:1.2.0-alpha10 ist veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.
API-Änderungen
BadgeundBadgedBoxwerden als stabil eingestuft. (I67f16, b/261565132)securePolicyals Parameter fürModalBottomSheethinzufügen, damit Nutzer das Verhalten fürWindowManager.LayoutParams.FLAG_SECUREdefinieren können. (Icdac8, b/296250262)- Es wurden neue Überladungen von
LinearProgressIndicatorundCircularProgressIndicatorhinzugefügt, dieprogressals Lambda verwenden. Diese sollten leistungsfähiger als die vorherigen Versionen sein. (I824e6, b/295616656) - Benennt
StandardSizeClassesinAllSizeClassesum. (I8cb07) - Berechnungsfunktionen von Fenstergrößenklassen kombinieren (Iad935)
Fehlerkorrekturen
- Ein
DatePicker-Absturz wurde behoben, der auftrat, wenn schnell auf die Navigationspfeile geklickt wurde und der angezeigte Monat am Rand des zulässigen Jahresbereichs lag. (I46f36, b/290954897, b/297002119) - [Navigationsleiste] Unterstützung für transparente Farbe für Indikator. (Ie0a9b, b/267289987)
Version 1.2.0-alpha09
4. Oktober 2023
androidx.compose.material3:material3-*:1.2.0-alpha09 ist veröffentlicht. Version 1.2.0-alpha09 enthält diese Commits.
API-Änderungen
ModalNavigationDrawerundDismissibleNavigationDrawerwurden migriert, um die neuenAnchoredDraggable-APIs zu verwenden.DrawerStatesanimateTowurde durch die Methoden „open“ und „close“ ersetzt. Der Offset wird jetzt als Gleitkommazahl und nicht als Statusobjekt bereitgestellt. Sie können direkt übercurrentOffsetauf den Offset zugreifen. (I0a72c)- Es wurden nicht zusammensetzbare Funktionen zum direkten Erstellen von
DatePickerStateundDateRangePickerStatehinzugefügt. Diese Funktionen können bei Bedarf als Alternative zu den zusammensetzbaren FunktionenrememberDatePickerStateundrememberDateRangePickerStateverwendet werden. (I70326, b/291524052) - Für die festen und scrollbaren
TabRowsgibt es jetzt primäre und sekundäre Varianten. Sie entsprechen dem Farb- und Indikatorverhalten, das in Material3 definiert ist. PrimaryScrollableTabRowundSecondaryScrollableTabRowgeben jetzt den Scrollstatus aus. (Iec8f5, b/260572337)- Es wurde ein neuer
sheetMaxWidth-Parameter hinzugefügt, mit dem Entwickler eine maximale Breite für das Blatt festlegen können. Dp.Unspecified kann für den Parameter übergeben werden, wenn ein Sheet gewünscht wird, das die gesamte Bildschirmbreite einnimmt. (Ifb7c9, b/266697696) - Die APIs
PlainTooltipBoxundRichTooltipBoxwerden als eingestellte Methoden wieder hinzugefügt. (I246fa)
Fehlerkorrekturen
- Ein Absturz wurde behoben, der auftrat, wenn
DatePickermit einemDatePickerFormatterinitialisiert 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 ist veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.
Funktionsgefährdende Verhaltensänderung
ColorSchemeist jetzt unveränderlich. Das macht einzelne Farbaktualisierungen weniger effizient, die häufigere Verwendung von Farben jedoch 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
BottomAppBarhinzugefügt, das einBottomAppBarScrollBehaviorals Parameter verwendet, um es beim Scrollen von Inhalten automatisch auszublenden. Außerdem wurdeFabPosition.EndOverlayhinzugefügt, damit das FAB die untere App-Leiste im Scaffold überlagern kann, anstatt darüber verankert zu werden. (Iecb47) - Es wurde eine einfache Label-Komponente hinzugefügt, die auf
BasicTooltipBoxbasiert und nicht geschlossen wird, wenn außerhalb der Grenzen des Labels getippt wird. (I821f9)
Fehlerkorrekturen
- Die Verwendung von
rememberSaveablefür 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 Einheit „measurement“ verwendet. Wenn Sie Probleme mit dem neuen Verhalten haben, melden Sie bitte ein Problem. (I0b354)
- Das Problem mit dem horizontalen Edge-to-Edge-Layout in
BottomSheetwurde behoben, indem die richtige Messung für die Bildschirmbreite des Geräts verwendet wurde. (I1df0c, b/299058752) - Ein Fehler wurde behoben, bei dem
ModalBottomSheetnichtonDismissedRequestaufgerufen hat, wenn es durch Wischen nach unten auf dem Sheet geschlossen wurde. (Idfdd8)
Version 1.2.0-alpha07
6. September 2023
androidx.compose.material3:material3-*:1.2.0-alpha07 ist veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.
Neue Funktionen
- In
compose material 1.6.0-alpha05wurde Unterstützung für das automatische Spiegeln von Symbolen hinzugefügt. Weitere Informationen finden Sie in den Versionshinweisen.
API-Änderungen
SliderStateimplementiertDraggableState(I9b116)- „shape“ als erforderlichen Parameter festlegen Benennen Sie
positionin der Formularhilfsfunktion inindexum. (I34941) - Aktualisiert die
DatePickerformatWithSkeleton, sodass sie eine Karte enthält, die als Cache zur Leistungssteigerung verwendet wird. (I3195f) BasicTooltipBoxwurde zucompose.foundationhinzugefügt undPlainTooltipBoxundRichTooltipBoxwurden aktualisiert, umTooltipBoxmit den neuenPlainTooltip- undRichTooltip-Composables zu verwenden. (I79e1d)
Fehlerkorrekturen
dynamicLightColorSchemeunddynamicDarkColorSchemegeben jetzt Farben mit höherer Chroma für die Rollen „surface“ undsurfaceContainerzurück. (I5e901)- Ein Problem wurde behoben, bei dem einige Komponenten, die die Unterkomposition (z.B.
BottomSheetScaffold) innerhalb eines Scaffold innerhalb einesLookaheadScopeverwenden, versuchten, ihre Größe zu früh zu lesen. (I297b4, I871f1, b/295536718)
Version 1.2.0-alpha06
23. August 2023
androidx.compose.material3:material3-*:1.2.0-alpha06 ist veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Die Berechnung von
DropdownMenuoffsetwurde korrigiert, sodass x-Offsets nur von der lokalen Layoutrichtung abhängen und y-Offsets nicht mehr umgekehrt werden, wenn sich das Menü in der Nähe des unteren Bildschirmrands befindet. (Iccc74, b/294103942) - Die Berechnung von
DropdownMenuoffsetwurde korrigiert, sodass x-Offsets nur von der lokalen Layoutrichtung abhängen und y-Offsets nicht mehr umgekehrt werden, wenn sich das Menü in der Nähe des unteren Bildschirmrands befindet. (Ib87a2, b/294103942)
Version 1.2.0-alpha05
9. August 2023
androidx.compose.material3:material3-*:1.2.0-alpha05 ist veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.
API-Änderungen
- Aktualisierungen der Farben für das Kästchen und
TriStateCheckbox. DieCheckboxDefaults.colors()disabledUncheckedColorwirkt sich jetzt nur noch auf den Rahmen des Kästchens aus. In Sonderfällen, in denen Sie die interne Kästchenfarbe festlegen müssen, wenn sie deaktiviert und nicht ausgewählt ist, ist eine benutzerdefinierte Instanz vonCheckboxColorsmit den gewünschten Farbwerten erforderlich. (I77d17, b/291943198)
Version 1.2.0-alpha04
26. Juli 2023
androidx.compose.material3:material3-*:1.2.0-alpha04 ist veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.
Neue Funktionen
- Experimentelle Segmented Button API (Ifc8fb)
- Trennlinien haben jetzt einen Parameter, mit dem die Ausrichtung gesteuert werden kann, um vertikale Trennlinien zu unterstützen. (I4c899, b/288438593)
API-Änderungen
- Die Dichteabhängigkeit wird auf die Komponentenebene verschoben. Dies gilt für die folgenden Komponenten:
SwipeToDismissund blattbasierte Komponenten. Verwenden Sie bitte 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 der segmentierten Schaltfläche einen Symbolparameter hinzu, teilen Sie die Semantik auf, damit segmentierte Schaltflächen für die Einzelauswahl auswählbar und für die Mehrfachauswahl umschaltbar sind, mit
SelectableSegmentedButtonRowbzw.ToggelableSegmentedButtonRow. (I38740) - Die Trennlinie wurde in
HorizontalDividerumbenannt.VerticalDivider-Funktion hinzugefügt. (I5975c) - Die Verwendung von
ClosedFloatingPointRangewurde in experimentellen Material3-APIs durch das schlankereFloatRangeersetzt, um das automatische Boxing zu minimieren. (I4aab5) - Neue Startausrichtung für
FabPositionhinzugefügt (Ib7aea, b/170592777)
Fehlerkorrekturen
ModalBottomSheetberücksichtigt die lokale Layoutrichtung. (Ib4f44, b/285628622)
Version 1.2.0-alpha03
21. Juni 2023
androidx.compose.material3:material3-*:1.2.0-alpha03 ist veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.
Geändertes Verhalten
includeFontPaddingist jetzt standardmäßigfalsein der Material 3-Typografie. Die Standardeinstellung für die Zeilenhöhe wurde ebenfalls inTrim.NoneundAlignment.Centergeändert. Außerdem wurde denTextStyles vonTypographyein 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
RangeSliderhinzugefügt, die eine zustandsbehaftete Version der Komponente ist.RangeSliderStateerstellt, die alle Informationen für den aktuell aktiven Track, die Messungen der Komponenten vonRangeSlidersowie die Drag-and-Gesture-Logik enthält. (I8c270) - Die Suchleiste unterstützt jetzt Schatten über den neu hinzugefügten Parameter
shadowElevation. (Ia5369, b/271040353) ColorSchemeunterstützt jetzt neueSurfaceContainer-Rollen.- Das Overlay für die tonale Erhebung der Oberfläche kann jetzt mit der lokalen Komposition
LocalTonalElevationEnableddeaktiviert werden. (Ic203c, b/277774590)
API-Änderungen
- Öffnen Sie die Konstruktoren für Komponentenfarben. (I8c4a6)
- Der Parameter „fokussierbar“ 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 Navigation des Fokus für die Barrierefreiheit unterbrechen kann. (Ie32d8)
- Optimierter Zugriff für Leistung und Arbeitsspeicherzuweisungen. (Iede48)
DefaultSizeClassesfreigeben undStandardSizeClassesfürWindowSizeClasseserstellen (I91838)- Ändern Sie
WindowWidth/HeightSizeClassin Gleitkommawertklassen (Ie686e).
Fehlerkorrekturen
- Der
contentWindowInsets-Parameter von Scaffold berücksichtigt jetzt verbrauchte Fenstereinsätze. Das Verhalten des Content-Paddings basierend auftopBarundbottomBarbleibt unverändert, wenn diese Parameter angegeben werden. (I08b73, b/264601542) - 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
dynamicLightColorSchemeunddynamicDarkColorSchemeunterstützen jetzt neue Oberflächenrollen. (I1252e) - Die Ausrichtung der Benachrichtigung mit dem Badge wurde so aktualisiert, dass sie nicht abgeschnitten wird, wenn sie mit dem Urgroßelternteil kollidiert. (Idf75a)
Version 1.2.0-alpha02
24. Mai 2023
androidx.compose.material3:material3-*:1.2.0-alpha02 ist veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
API-Änderungen
- Fügen Sie den Parameter für Fenstereinsätze zu
ModalBottomSheethinzu.- Der Scrim für
ModalBottomSheetkann jetzt hinter der Statusleiste gezeichnet werden, wennwindowInsetsauf null gesetzt ist. - Die Standardfunktionalität von
ModalBottomSheetwurde aktualisiert, um außerhalb der Systemleisten, einschließlich der Navigationsleiste, zu bleiben. - Die Verarbeitung von Insets der Statusleiste erfolgt im Edge-to-Edge-Modus über den Ziehpunkt.
BottomSheetDefaultsenthält Fenstereinsetzungen fürBottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- Der Scrim für
Indicatorwird eingestellt undPrimary/SecondaryIndicatorwird hinzugefügt, um den M3-Spezifikationen zu entsprechen.PrimaryIndicatorentspricht der Breite des Tabinhalts, währendSecondaryIndicatordie gesamte verfügbare Breite einnimmt.SecondaryIndicatorentspricht dem jetzt eingestelltenIndicatorund kann als direkter Ersatz verwendet werden. (I27604)- Es wurde eine Option hinzugefügt, mit der beim Erstellen eines
DropdownMenuoder einesExposedDropdownMenueinScrollStateübergeben werden kann, um den vertikalen Scrollstatus der angezeigten Menüelemente zu steuern. (Ia0734, b/185304441) - Es wurde eine Überladung für
Sliderhinzugefügt, die eine zustandsbehaftete Version der Komponente ist.SliderStateerstellt, die alle Informationen für den aktuell aktiven Track, die Messungen der Komponenten vonSlidersowie die Drag-and-Gesture-Logik enthält. (I124a5) - Umbenennung des Attributs „Semantik“
isContainerinisTraversalGroup(I121f6) - Optimierte
TextStyle.merge(...)mit vollständiger Parameterliste hinzugefügt. (Iad234, b/246961787) TooltipState,RichTooltipStateundPlainTooltipStatesind öffentliche Schnittstellen.RichTooltipStateImplundPlainTooltipStateImplfür Standardstatus wurden hinzugefügt. Es wurdenremember*State-Funktionen hinzugefügt, um diese implementierten Status abzurufen.TooltipSyncwurde zugunsten vonTooltipDefault.GlobalMutatorMutexentfernt. (I7813d)- Die
DatePickerColorswurde aktualisiert und enthält jetzt zusätzliche Anpassungsoptionen für die Farben der Trennlinie, der Navigation und der Texteingabefelder der Datumsauswahl. (I1a685, b/274626815) DatePickerStateundDateRangePickerStatesind jetzt öffentliche Schnittstellen mit Standardimplementierungen, die überrememberDatePickerStateundrememberDateRangePickerStateabgerufen werden können. (I71c52)- Die
dateValidatorwurde ausDatePickerundDateRangePickerentfernt und eineSelectableDates-Schnittstelle eingeführt, die im Status festgelegt werden kann, um zu steuern, welche Datumsangaben oder Jahre in der Benutzeroberfläche ausgewählt werden können. (Ic2fc6) TimePickeraus stabiler API entfernt, weitere Änderungen in der Status-API werden erwartet (I3f39a)ModalBottomSheetwurde nur auf Android verschoben.ModalBottomSheetwird für die Verwendung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv weiterentwickelt. (Ib3778)
Fehlerkorrekturen
- Die Aktion zum Schließen von
AlertDialogwird 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
ListItemwurde behoben, bei dem für dreizeilige Elemente ein falscher Innenabstand verwendet wurde. (I6e235) ModalBottomSheetkann jetzt die IME-Tastatur anzeigen (Idc508, b/262140644, b/268380384, b/272483584)
Version 1.2.0-alpha01
10. Mai 2023
androidx.compose.material3:material3:1.2.0-alpha01 und androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 sind veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
Version 1.1
Version 1.1.2
20. September 2023
androidx.compose.material3:material3:1.1.2 und androidx.compose.material3:material3-window-size-class:1.1.2 sind veröffentlicht. Version 1.1.2 enthält diese Commits.
Fehlerkorrekturen
- Ein Fehler wurde behoben, bei dem der Modifier fälschlicherweise an zwei Composables übergeben wurde. (b/282761472)
- Der Fehler, dass
TimePickerStatebei 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, dass
state.hourfü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 sind veröffentlicht. Version 1.1.1 enthält diese Commits.
Fehlerkorrekturen
- Ruft
ModalBottomSheetohne den ParameterwindowInsetfür die binäre Kompatibilität auf. (Ib7959) - Fügen Sie den Parameter für Fenstereinsätze zu
ModalBottomSheethinzu.- Der Scrim für
ModalBottomSheetkann jetzt hinter der Statusleiste gezeichnet werden, wennwindowInsetsauf null gesetzt ist. - Die Standardfunktionalität von
ModalBottomSheetwurde aktualisiert, um außerhalb der Systemleisten, einschließlich der Navigationsleiste, zu bleiben. - Die Verarbeitung von Insets der Statusleiste erfolgt im Edge-to-Edge-Modus über den Ziehpunkt.
BottomSheetDefaultsenthält Fenstereinsetzungen fürBottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
- Der Scrim für
Version 1.1.0
10. Mai 2023
androidx.compose.material3:material3:1.1.0 und androidx.compose.material3:material3-window-size-class:1.1.0 sind veröffentlicht. Version 1.1.0 enthält diese Commits.
Wichtige Funktionen von Version 1.1.0
Neue Material Design 3-Komponenten
Verbesserungen an vorhandenen Material Design 3-Komponenten:
Experimentelle APIs wurden zu stabilen APIs hochgestuft.
Weitere Informationen finden Sie in diesem Blogpost.
Version 1.1.0-rc01
19. April 2023
androidx.compose.material3:material3:1.1.0-rc01 und androidx.compose.material3:material3-window-size-class:1.1.0-rc01 sind veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.
API-Änderungen
TimePickeraus stabiler API entfernt, weitere Änderungen in der Status-API werden erwartet (I3f39a)ModalBottomSheetwurde nur auf Android verschoben.ModalBottomSheetwird für die Verwendung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv weiterentwickelt. (Ib3778)
Version 1.1.0-beta02
5. April 2023
androidx.compose.material3:material3:1.1.0-beta02 und androidx.compose.material3:material3-window-size-class:1.1.0-beta02 sind veröffentlicht. Version 1.1.0-beta02 enthält diese Commits.
API-Änderungen
SheetStatehat jetzt einen optionalen ParameterskipHiddenStaterememberStandardBottomSheetStatehat jetzt einen optionalen ParameterskipHiddenStateBottomSheetScaffoldhat jetzt einen definierten verborgenen Anker, der jedoch standardmäßig deaktiviert ist.- Die Dokumentation zu
SheetState.requireOffsetwurde aktualisiert BottomSheetDefaults.MinimizedShapewurde inBottomSheetDefaults.HiddenShapeumbenannt (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
ModalBottomSheetundBottomSheetScaffoldwurde zusammengeführt. (I05afb) - Der Modifikator
BottomSheetScaffoldsowie die ParametercontainerColorundcontentColorwirken sich jetzt nur noch auf Inhalte aus. (I992cb) BottomSheetScaffold nestedScrollfür Tabellenblattinhalte unterstützt jetzt Wischbewegungen. (I992cb)
Version 1.1.0-beta01
22. März 2023
androidx.compose.material3:material3:1.1.0-beta01 und androidx.compose.material3:material3-window-size-class:1.1.0-beta01 sind veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.
API-Änderungen
- Füge dem zusammensetzbaren Element
TimePickerden Layouttyp-Parameter hinzu. Je nach Bildschirmkonfiguration (Ia0e16) können verschiedene Layouts verwendet werden. SearchBarDefaultswurde als experimentell markiert. (I65561)- Schattenhöhe zu
BottomSheetScaffoldhinzugefügt (I94e0f) - Unterstützung für die Anzeige der Datumsauswahl ohne Kopfzeile hinzugefügt. API-Änderungen, um beim Erstellen einer Datumsauswahl eine Null-Überschrift zu übergeben. Sie können jetzt „null“ für „headline“, „title“ und
showToggleMode = falseübergeben, um eine Headless-Auswahl zu präsentieren. (Id3f3a, b/266132421, b/267194809)
Fehlerkorrekturen
- Suchleisten verlieren jetzt automatisch den Fokus, wenn sie inaktiv werden. (I22a7c, b/261444487)
- Die
DateRangePickerwurde aktualisiert, sodass ein Zeitraum mit demselben Start- und Enddatum ausgewählt werden kann. (I16529, b/272882497) - Textfelder positionieren ihre Textelemente jetzt richtig, wenn die Schriftgröße kleiner als erwartet ist. Je nach Schriftarteinstellungen und Skript kann sich 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 sind veröffentlicht. Version 1.1.0-alpha08 enthält diese Commits.
Neue Funktionen
- Unterstützung für
BottomSheetScaffoldundBottomSheetScaffoldStatehinzugefügt. (I063d4)
API-Änderungen
DatePickerStateundDateRangePickerStatewurden um Funktionen erweitert, mit denen sich Datumsangaben nach der Erstellung des Status festlegen und Auswahlen durch Festlegen von Null-Zeitstempeln zurücksetzen lassen. Das manuelle Festlegen von Datumsangaben sollte mit Vorsicht erfolgen. Die neue FunktionsetSelectionlöst eine Ausnahme aus, wenn ein angegebenes Datum eine Vorbedingung nicht erfüllt (siehe Dokumentation). (Ifa645, b/268609314, b/270427389)- Die Bezeichnung „Zusammengefasst“
SheetValuewurde in „PartiallyExpanded“ umbenannt, um das Verhalten in diesem Status genauer und flexibler darzustellen. (Ia1491) - Die Namen der
ListItem-Parameter wurden von „_text“ in „_content“ geändert. Standard-Getter sind jetztReadOnlyComposables, sofern relevant. (I69a25) - Interaktive Surface-APIs aus der experimentellen Phase herausnehmen. (I90d59, b/261561812)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem der Status von
ModalBottomSheetHalfExpandedfalsch berechnet wurde und das Blatt schwebend angezeigt wurde. (I45e84, b/268411386) - Füge die
confirmValueChange-Prüfung für das Tippen auf den Scrim fürModalBottomSheethinzu. (I2311a, b/270425759) - Semantische
BottomSheet-Aktionen werden zum Ziehpunkt verschoben. (I158ba) ModalBottomSheet-Befehle konzentrieren sich jetzt auf den Start und verarbeiten die Zurück-Schaltfläche. (I4d2ab)ModalBottomSheet onDismissRequestwird jetzt auch bei verschachtelten Scrollvorgängen berücksichtigt. (I655c5, b/268433166)
Version 1.1.0-alpha07
22. Februar 2023
androidx.compose.material3:material3:1.1.0-alpha07 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 sind veröffentlicht. Version 1.1.0-alpha07 enthält diese Commits.
Neue Funktionen
- Fügen Sie ein zusammensetzbares Element für die Zeiteingabe hinzu, das mit
rememberTimePickerState()funktioniert. Es entspricht der M3-Spezifikation für die Zeiteingabe (Ia4fab). - Es wurde eine Material 3-
DateRangePicker-API zum Auswählen eines Zeitraums hinzugefügt. (I7a6c3, b/267194809) - Unterstützung für die Auswahl von Zeiträumen über die
DateRangePickerAPI im Material 3-Eingabemodus wurde hinzugefügt. (Ifdbc4) - Die Farben von Textfeldern können jetzt angepasst werden:
- Die Farben des Eingabefelds und des Platzhaltertexts basierend auf dem Fokus und dem Fehlerstatus. Der Parameter
textColorwurde inunfocusedTextColorundplaceholderColorinunfocusedPlaceholderColorumbenannt. - 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.
RangeSliderals stabil kennzeichnen. (Ie8fbd) - Die Erhebungsfunktionen des Chips wurden von
defaultElevationinelevationumbenannt. (I0f872) - Die folgenden Material 3-APIs für Textfelder sind nicht mehr experimentell:
TextField,OutlinedTextField,textFieldWithLabelPadding,textFieldWithoutLabelPadding,outlinedTextFieldPadding. (Ieb5c0, b/261561819) TimePickersis24Hourverwendet die Systemeinstellung (I18856)- Die experimentelle Anmerkung wurde aus den Scaffold-APIs entfernt. (Ibb51e, b/261565765, b/261436953)
Fehlerkorrekturen
- Die Standardform von
ModalBottomSheetist jetzt immerSheetDefaults.ExpandedShape. (I0dfca) - Verbesserungen bei den Bedienungshilfen für Material 3
DatePickerundDateRangePicker. (I5087e) - Es wurde ein Fehler behoben, durch den die Einschrä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 sind veröffentlicht. Version 1.1.0-alpha06 enthält diese Commits.
Neue Funktionen
- Textfelder unterstützen jetzt Präfix- und Suffixtext (Ia8578, b/179884561)
- Die Funktion
TimePickerwurde hinzugefügt, um eine Zeitauswahl gemäß der Material 3-Spezifikation anzuzeigen. Sie wird in Verbindung mitTimePickerStateund der Convenience-MethoderememberTimePickerStateverwendet. (I71910) - Die Datumseingabe ist jetzt ein Anzeigemodus unter
DatePicker. Unterstützung für das Umschalten zwischen der Datumsauswahl und der Datumseingabe hinzugefügt. (Ieeff7) - API für
RichTextTooltipshinzugefügt. (I58ef3) - Implementierung des modalen Blatts am unteren Rand für Material 3, einschließlich
ModalBottomSheetundModalBottomSheetDefaults. Außerdem werdenSheetStateundrememberSheetStateeingeführt, die für zukünftige Tabellenblattkomponenten verwendet werden können. (I0853a, b/244189383)
API-Änderungen
- API
showSnackbarstabilisieren (I195c2, b/261424370) - APIs für Assist-Chip und Vorschlagschip stabilisieren (Ibb67b, b/261424370)
- Die APIs
ListItem,ListItemDefaultsundListItemColorswerden als nicht experimentell eingestuft (I7e7fa, b/261438882). - Die APIs
SliderPositions,SliderDefaults.ThumbundSliderDefaults.Trackwerden als stabil eingestuft und es werden nicht experimentelleSlider- undRangeSlider-APIs mit benutzerdefinierten Thumbnails und Tracks hinzugefügt. Die bisherigen APIsSliderundRangeSliderwerden ebenfalls eingestellt. (Ie5ea6, b/261566890) Modifier.tooltipAnchor()wurde öffentlich gemacht, damit Entwickler es an den Anker übergeben können, um anzugeben, dass bei langem Drücken eine Kurzinfo angezeigt werden soll. DiePlainTooltipBoxAPI wurde aktualisiert.TooltipStateist jetzt nicht mehr nullable und hat einen Standardwert. (Ie2fb7)ProgressIndicatorDefaults.circularTrackColorwurde zur besseren Übersichtlichkeit mit@Composablemarkiert. (Id29cc)- Die Getter-Methode
LocalMinimuTouchTargetEnforcementfür die wiederhergestellte Property wurde wiederhergestellt, als eingestellt markiert und zur MethodeLocalMinimumInteractiveComponentEnforcementweitergeleitet. (I60dd5)
Version 1.1.0-alpha05
26. Januar 2023
androidx.compose.material3:material3:1.1.0-alpha05 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 sind veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.
Neue Funktionen
DatePickerDialogund Support für Bedienungshilfen- Benutzerdefinierte Miniatur und benutzerdefinierter Track zu
RangeSliderhinzugefügt.
Abhängigkeitsupdates
Compose UIundCompose Materialsind jetzt von Lifecycle 2.6.0 abhängig.
Version 1.1.0-alpha04
11. Januar 2023
androidx.compose.material3:material3:1.1.0-alpha04 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 sind veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.
Neue Funktionen
- Erste
DatePickerAPI zum Auswählen eines einzelnen Datums über eine Kalender-UI. Diese API wird noch geändert. (I722b9) - Unterstützung für einfache Tooltips über
PlainTooltipBoxwurde hinzugefügt. (I0cdfb) - Suchleiste (Iad128)
SwipeToDismiss(I458a8, b/242889540)
API-Änderungen
- Die Semantik-Property
IsContainerwurde auf Oberflächen hinzugefügt. Diese Eigenschaft wird in einer späteren Änderung verwendet, mit der die Reihenfolge der Traversierung basierend auf der semantischen Bedeutung von Elementen wie Oberflächen bestimmt wird. (I63379) - Markieren Sie APIs für die Navigationsleiste als stabil. (Iab01e, b/261439597)
- Für kreisförmige Fortschrittsanzeigen wurde ein Parameter für die Track-Farbe und für kreisförmige und lineare Fortschrittsanzeigen ein Parameter für die Strichkappen hinzugefügt. (Ie668c, b/216325962, b/222964817)
- Weitere Informationen zur Nullable-Eigenschaft des Rückgabetyps von eingestellten, ausgeblendeten Funktionen (Ibf7b0)
- Fügen Sie
Modifier.minimumInteractiveComponentSizehinzu. Damit können Sie mindestens 48 dp für die Berührungsinteraktion reservieren, wenn das Element kleiner ist. (I33f58, b/258495559) - Es wurde eine experimentelle API für die
AlertDialog-Composable-Funktion mit einem Inhaltsslot 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-alpha03aufandroidx.compose.foundation:1.4.0-alpha04kann der Fehlerjava.lang.NoSuchFieldErrorauftreten. Hier wurde das Problem ursprünglich gemeldet. Ein Fix wurde eingereicht und ist im nächsten Compose-Update verfügbar. Als Behelfslösung können Sie Ihreandroidx.compose.material- undandroidx.compose.material3-Bibliotheken auf die neueste Version(1.1.0-alpha04) aktualisieren oder 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 sind 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 eine neue Standard-Inhaltsauffüllung 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
Clickableverwendet, um Tippinteraktionen richtig zu verzögern, wenn aus Gesten Scroll-Ereignisse werden könnten. - Das Problem, dass
ClickablesWellen nicht richtig verzögert hat, wenn es in einemScrollable ViewGroupverwendet wurde, wurde behoben. - Die Schubladen und Sheets wurden aktualisiert, um das Drücken im Fall von Gesten, die zu Scroll-Ereignissen werden können, korrekt zu verzögern.
Abhängigkeitsupdates
Compose UIundCompose Materialsind jetzt von Lifecycle 2.5.1 abhängig. (I05ab0, b/258038814)
Version 1.1.0-alpha02
9. November 2022
androidx.compose.material3:material3:1.1.0-alpha02 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 sind veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.
API-Änderungen
awaitFirstDownundwaitForUpOrCancellationakzeptieren jetzt einPointerEventPassfür mehr Flexibilität. Außerdem wird das Problem behoben, dass beiExposedDropdownMenuBoxbeim Scrollen ein Menü angezeigt wurde. (I7579a, b/212091796)- Der Parameter
minLineswurde in die Textkomponenten „material“ und „material3“ sowie inTextFieldundOutlinedTextFieldeingefügt. Damit kann die Mindesthöhe der Komponente in Zeilen angegeben werden (I4af1d). - Die Funktion
TopAppBarDefaults smallTopAppBarColorswird zugunsten einer neuen FunktiontopAppBarColorseingestellt, die beim Erstellen einesTopAppBarverwendet werden sollte. (Ie6cb9) - Der Parameter
minLineswurdeBasicTextundBasicTextFieldhinzugefü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-
IconButtonundIconToggleBottonauf die Form der Status-Ebene der Komponente zu (z.B. kreisförmig). (I9da8f) - Aktualisiert die mittleren und großen Top-App-Leisten von Material 3, sodass auf der gesamten Oberfläche dieselbe Hintergrundfarbe verwendet wird. Außerdem können die Standardfarben mit transparenten Farbwerten überschrieben werden. (I67659, b/249688556, b/250838918)
Version 1.1.0-alpha01
24. Oktober 2022
androidx.compose.material3:material3:1.1.0-alpha01 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 sind veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Es wurden Fehler in der oberen App-Leiste behoben, wenn der Titel mit einem TextStyle und einem Brush angewendet wird. (If667e)
Version 1.0
Version 1.0.1
9. November 2022
androidx.compose.material3:material3:1.0.1 und androidx.compose.material3:material3-window-size-class:1.0.1 sind veröffentlicht. Version 1.0.1 enthält diese Commits.
Fehlerkorrekturen
- Aktualisiert die mittleren und großen Top-App-Leisten von Material 3, sodass auf der gesamten Oberfläche dieselbe Hintergrundfarbe verwendet wird. Außerdem können die Standardfarben mit transparenten Farbwerten überschrieben werden. (I67659, b/249688556, b/250838918)
Version 1.0.0
24. Oktober 2022
androidx.compose.material3:material3:1.0.0 und androidx.compose.material3:material3-window-size-class:1.0.0 sind veröffentlicht. Version 1.0.0 enthält diese Commits.
Wichtige Funktionen von Version 1.0.0
Dies ist die erste stabile Version von Compose Material 3.
Material Design 3-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-classist eine neue Bibliothek, die Unterstützung für Fenstergrößenklassen bietet. Das sind eine Reihe von Ansichtsbereich-Breakpoints, die Ihnen beim Entwerfen, Entwickeln und Testen von anpassbaren Anwendungslayouts helfen. MitcalculateWindowSizeClasskönnen Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche dargestellt werden soll. Bei größeren Fenstergrößen kann beispielsweise eine Navigationsleiste anstelle der unteren Navigation angezeigt werden. Weitere Informationen und Beispiele finden Sie in der API-Referenzdokumentation fürWindowSizeClass.Weitere Informationen finden Sie in diesem Blogpost.
Version 1.0.0-rc01
5. Oktober 2022
androidx.compose.material3:material3:1.0.0-rc01 und androidx.compose.material3:material3-window-size-class:1.0.0-rc01 sind veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
API-Änderungen
- Slot-Parameter zur Unterstützung der Text-zu-Textfeld-API hinzugefügt (Iaac0d, b/227146125)
Version 1.0.0-beta03
21. September 2022
androidx.compose.material3:material3:1.0.0-beta03 und androidx.compose.material3:material3-window-size-class:1.0.0-beta03 sind veröffentlicht. Version 1.0.0-beta03 enthält diese Commits.
API-Änderungen
ExposedDropdownMenuDefaultsstellt jetzt einen Auffüllwert für Menüelemente bereit. (I34ee1)ExposedDropdownMenuBoxScopehat jetzt einenModifier.menuAnchor()-Modifikator, der für ein korrektes Verhalten in Bezug auf die Barrierefreiheit an das Textfeld übergeben werden sollte. (I27fa3)- Es werden zwei überladene Methoden für die aktuelle Slider API hinzugefügt, 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 sind 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
SmallTopAppBarwird eingestellt und eine entsprechendeTopAppBar-Funktion wird eingeführt. Migrieren Sie Ihre Nutzung bitte zur neuen API. (I74404, b/226918634) - Fügt die Steuerung des Wisch- und Andockverhaltens 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 durch Ansage des Wortes „Dialog“ zu erkennen geben, wenn sie angezeigt werden. (I857ef)
Version 1.0.0-beta01
24. August 2022
androidx.compose.material3:material3:1.0.0-beta01 und androidx.compose.material3:material3-window-size-class:1.0.0-beta01 sind veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
API-Referenz
Die neuesten verfügbaren Composables für das Theming, Komponenten und andere Composables finden Sie in der Compose Material 3 API-Referenzübersicht.
API-Änderungen
- Die obere App-Leiste von Material 3 kann jetzt vollständig minimiert oder maximiert werden. Außerdem wurde die Verhaltensfunktion
TopAppBarDefaultsso aktualisiert, dass sie Composables 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. Wenn diese Komponenten separat oder mit Scaffold verwendet werden, werden Insets automatisch für Entwickler berücksichtigt. Hinweis: Durch diese Änderung wird keine automatische Verarbeitung von Statusleistensymbolen und Transparenz der Status- und Navigationsleisten hinzugefügt. Bitte fahren Sie manuell fort, um die beste Darstellung zu erzielen. (I7e4e6, b/183161866)
- Die Standardeinstellungen für Komponenten wurden aktualisiert, um die API-Oberfläche für zukünftige Flexibilität und Leistungsverbesserungen zu reduzieren. (I31820)
- Die Parameter für Chip und Navigationsleiste wurden neu angeordnet, um die Konsistenz innerhalb der API zu wahren (I45d0b).
startIndentwurde aus „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 sind veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.
Neue Funktionen
- Unterstützung für die Angabe einer benutzerdefinierten Breite für eine Navigationsleiste. (Ia7f10)
API-Änderungen
- Tab- und Leading-Icon-Tab-Parameter neu anordnen, um die Konsistenz innerhalb der API zu wahren (Ie2637)
BadgeDefaultsals experimentell 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 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 mit der oberen App-Leiste übereinzustimmen (Id75be).
- Markiere
BadgeundBadgedBoxals experimentell, da die Ankerausrichtung noch nicht endgültig 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 die Angabe einer benutzerdefinierten Breite zu ermöglichen. (Ia7f10)
- Entfernt
DividerausMenuDefaultsundTabDefaults(I4e33c)
Version 1.0.0-alpha15
27. Juli 2022
androidx.compose.material3:material3:1.0.0-alpha15 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 sind veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.
Neue Funktionen
- Das Ziehen der oberen App-Leiste an der Leiste selbst zulassen. (I65c00, b/205873416)
API-Änderungen
- Die APIs
FilterChipundElevatedFilterChipwurden aktualisiert, um denselectedIcon-Slot zu entfernen und die Wiederverwendung vonleadingIconzum 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)
ListItemDefaultsundListItemColorsals 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-Leisten-API außerdem als experimentell. (Ic0ad8)
- Die Farben für die Textauswahl wurden jetzt in
TextFieldColorsaufgenommen, um die Auffindbarkeit zu verbessern. (Iba1b8) ButtonDefault.ButtonWithIconContentPaddingfü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
@ExperimentalMaterial3Apiwurde aus der FunktionCheckboxentfernt. (I5eefc) - Die Annotation
@ExperimentalMaterial3Apiwurde aus der FunktionRadioButtonentfernt. (I17e2a) - Die Annotation
@ExperimentalMaterial3Apiwurde aus den nicht interaktiven Karten entfernt. (I9bd49) - Aktualisiert verschiedene Standardobjekte für Komponenten, um Farben, Formen usw. einzuschließen (I96e11)
Fehlerkorrekturen
- Nicht funktionierende nachgestellte Symbole wurden aus den Beispielen für Eingabe-Chips entfernt, um Verwirrung bei Nutzern der Katalog-App zu vermeiden. (I9846a)
Version 1.0.0-alpha14
29. Juni 2022
androidx.compose.material3:material3:1.0.0-alpha14 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 sind veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.
Neue Funktionen
- M3-Listenimplementierung hinzugefügt. Informationen zur Beispielnutzung finden Sie in der Dokumentation (Id7a20).
API-Änderungen
- Parametername von „values“ in „value“ in
RangeSliderändern (I3b79a) - API-Änderungen an der
InputChip-Implementierung zur Unterstützung eines auswählbaren Status gemäß der Material Design-Spezifikation. Zusätzliche Unterstützung für dieFilterChip-Farben für den ausgewählten deaktivierten Status. (I55244, b/235792432) - Standard-FAB für
BottomAppBarhinzufügen (Ida4c8) ColorScheme.surfaceColorAtElevationwurde hinzugefügt (Id41af)- Schnittstellen in Compose-Bibliotheken werden jetzt mit JDK8-Standard-Schnittstellenmethoden erstellt (I5bcf1).
WindowWidthSizeClassundWindowHeightSizeClassimplementieren jetzt „Comparable“, sodass sie mit Operatoren (<, <=, >=, >) und anderen APIs verglichen werden können. (I747d0)
Fehlerkorrekturen
- Das Beispiel für das Badge wurde aktualisiert, um eine aussagekräftigere Inhaltsbeschreibung zu liefern. (I10b9d)
- Fügt dem Theme-Picker des Material 3-Katalogs die Option hinzu, die Schriftgröße des Systems zu verwenden. (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 sind veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.
API-Änderungen
- Unterstützt das Beibehalten der Position der oberen App-Leiste bei einer Konfigurationsänderung. (I10459, b/216160958)
Version 1.0.0-alpha12
18. Mai 2022
androidx.compose.material3:material3:1.0.0-alpha12 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 sind veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.
Fehlerkorrekturen
- 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 sind veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.
Neue Funktionen
RangeSliderwurde zu Material 3 hinzugefügt (I18e38)- Unterstützung für Material3-
AssistChipundInputChiphinzugefügt (I0d25a) - Unterstützung für Material3-
FilterChipundSuggestionChiphinzugefügt (I9fdf3)
API-Änderungen
- Die zusammensetzbare Funktion
TextFieldDefaults.BorderStroke, mit der ein Rahmenstrich inOutlinedTextFieldgezeichnet wird, wurde inTextFieldDefaults.BorderBoxumbenannt. (I5f295) - Visuelle Änderungen bei M3 (Iab30e)
- Allow passing colors to the standard icon buttons. (Ia2445)
Fehlerkorrekturen
- Lint-Prüfung für material3/Scaffold hinzugefügt, um sicherzustellen, dass das innere Padding verwendet wird (I72293, b/226951418)
Version 1.0.0-alpha10
20. April 2022
androidx.compose.material3:material3:1.0.0-alpha10 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 sind veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.
Neue Funktionen
material3-window-size-classist eine neue Bibliothek, die Unterstützung für Fenstergrößenklassen bietet. Das sind eine Reihe von Ansichtsbereich-Breakpoints, die Ihnen beim Entwerfen, Entwickeln und Testen von anpassbaren Anwendungslayouts helfen. MitcalculateWindowSizeClasskönnen Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche dargestellt werden soll. Bei größeren Fenstergrößen kann beispielsweise eine Navigationsleiste anstelle der unteren Navigation angezeigt werden. Weitere Informationen und Beispiele finden Sie in der API-Referenzdokumentation zuWindowSizeClass. Weitere Informationen zu den Definitionen der Fenstergrößenklassen finden Sie in der öffentlichen Anleitung zur Unterstützung verschiedener Bildschirmgrößen.
API-Änderungen
- Fügt die Standard-UAS-Erhebung für
BottomAppBarhinzu und entfernt das nachgestellte Lambda ausBottomAppBarmit UAS. (I92c47) - Fügt Material3-
FilledIconButton,FilledTonalIconButtonundOutlinedIconButtonhinzu. (Ib2bda) - Die Material 3-Snackbar-API wurde aktualisiert, sodass Farbwerte für die optionale Aktion und die Schließen-Aktion akzeptiert werden. (Ibe4b4)
- Die teilweise Nutzung (Down- oder Position-Attribut) wurde in
PointerInputChangeeingestellt. Mitconsume()können Sie die Änderung vollständig übernehmen. MitisConsumedkönnen Sie feststellen, ob die Änderung bereits von jemand anderem übernommen wurde. PointerInputChange::copy()erstellt jetzt immer eine oberflächliche Kopie. Das bedeutet, dass Kopien vonPointerInputChangeverbraucht werden, sobald eine der Kopien verbraucht wird. Wenn Sie ein ungebundenesPointerInputChangeerstellen möchten, verwenden Sie stattdessen den Konstruktor. (Ie6be4, b/225669674)- Änderungen an der Cards API, um die Container- und Inhaltsfarben über eine
CardColors-Schnittstelle zu empfangen und einen deaktivierten Status für klickbare Karten zu unterstützen. (I927df) - Der Parameter
backgroundColorwurde in Material 3-Textfeldern incontainerColorumbenannt, um die Konsistenz mit anderen Komponenten zu verbessern. (I6fbd9)
Fehlerkorrekturen
- Aktualisierungen des Standard-
IconButton, um es an die Material3-Spezifikation anzupassen. (I09eab) - Die Höhe der oberen Leiste des Material3-Scaffold wird in das Padding verschoben, das an den Inhalt übergeben wird. So kann der Inhalt unter der oberen App-Leiste gerendert werden. Wenn die
PaddingValuesignoriert 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 ist veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
Neue Funktionen
- Material 3-Switch-API hinzugefügt (I2c3ad)
API-Änderungen
- Unterstützung für Drop-down-Menüs mit Textfeldern (auch als „offengelegte Drop-down-Menüs“ oder „Kombinationsfelder“ bezeichnet) wurde hinzugefügt. (I1b832)
- Dem MaterialTheme- und Shape-Subsystem wurde ein Formparameter hinzugefügt. (I37426)
ExtendedFloatingActionButtonwurde 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 ist veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
- Unterstützung für Material 3-Textfelder hinzugefügt. (I795cc, b/199377790)
API-Änderungen
- Standardtrennlinie für das Menü hinzufügen (I01374)
- Der Klasse
ColorSchemewurde der FarbparametersurfaceTinthinzugefü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 ist veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
API-Änderungen
- Aktualisierungen der Material 3 Surface API, durch die die überladenen Funktionen für klickbare Surfaces zurückkehren. Außerdem wurde eine Funktion zur Unterstützung von auswählbaren und umschaltbaren Surfaces hinzugefügt. (I4bf18)
LazyVerticalGridundLazyHorizontalGridsind jetzt stabil. (I307c0)LazyVerticalGrid/LazyHorizontalGridund alle zugehörigen APIs wurden in das Unterpaket „.grid“ verschoben. Aktualisieren Sie Ihre Importe von androidx.compose.foundation.lazy zu androidx.compose.foundation.lazy.grid. (I2d446)- Die vorherige Änderung, bei der nur eine Ansicht für
WindowInsetsControllerCompatverwendet wurde, wurde rückgängig gemacht. Es ist wieder ein Fenster erforderlich, das zum Verwalten einiger Fenster-Flags benötigt wird.ViewCompat.getWindowInsetsControllerwurde zugunsten vonWindowCompat.getInsetsControllereingestellt, um sicherzustellen, dass das richtige Fenster verwendet wird (z. B. wenn sich die Ansicht in einem Dialogfeld befindet). (I660ae, b/219572936) - Eine neue
LazyVerticalGridAPI zum Definieren von Größen für die Querachse wurde hinzugefügt (I17723).
Fehlerkorrekturen
- 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 ist veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
API-Änderungen
NavigationDrawerItemwurde hinzugefügt und steht für ein einzelnes Ziel in den Drawern (Ic396f, b/218286829).PermanentNavigationDrawerundDismissibleNavigationDrawerwurden als experimentelle APIs hinzugefügt. Das sind die Schubladen, die sich gut für Geräte mit großen Bildschirmen eignen. (I5f8ab, b/218286829)- Unterstützung für die untere App-Leiste von Material 3 hinzugefügt (Ic432a)
NavigationDrawerwurde inModalNavigationDrawerumbenannt (I1807d, b/218286829).- Material 3-Slider-Klasse und ‑Tokens hinzugefügt (I1ccee)
- Die Tab-Implementierung wurde hinzugefügt. Informationen zur 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) IconSizewurde zuFloatingActionButtonDefaultshinzugefügt. (Ia71cf)- Fehlerbehebung für ausgeblendete
AlertDialog-Schaltflächen, wenn mit einemLazyColumnlanger Text hinzugefügt wird. (Ib2cc9, b/216663029)
Version 1.0.0-alpha05
9. Februar 2022
androidx.compose.material3:material3:1.0.0-alpha05 ist veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
Material Design 3-Komponenten hinzugefügt
- Drop-down-Menü
- Infokarten
API-Änderungen
- Die eingestellte Funktion
Surface, die einen onClick-Callback verwendet. Klickbare Oberflächen sollten mit einemInteractionSourceund 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
SurfaceAPI wurde so geändert, dass sie eine InteractionSource empfängt, mit der das Erscheinungsbild in verschiedenen Status gesteuert werden kann. (Iafbc8)
Fehlerkorrekturen
- Es wurden fehlende tertiäre Farben in dynamischen Farbschemas hinzugefügt (I456c4, b/214588434).
Version 1.0.0-alpha04
26. Januar 2022
androidx.compose.material3:material3:1.0.0-alpha04 ist veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
API-Änderungen
NonRestartableComposablewurde Methoden hinzugefügt, die Überladungen vorhandener Methoden ohne komplexe Logik sind. Dadurch werden die vom Compiler generierten Memoization-Prüfungen (equals) für alle Parameter reduziert, die in der aufgerufenen inneren Funktion wiederholt werden. (I90490)- Material 3-Trennlinie hinzugefügt. (Ica5fc)
- Markieren Sie das Checkbox- und das RadioButton-Element mit einer experimentellen API-Anmerkung. (Ie44bb)
- Unterstützung für Material 3-Statusanzeigen hinzugefügt. (Iff232, b/205023841)
Fehlerkorrekturen
- Die Farbe eines deaktivierten
TextButton's-Containers wird in „Transparent“ geändert (I6b248, b/213339737)
Version 1.0.0-alpha03
12. Januar 2022
androidx.compose.material3:material3:1.0.0-alpha03 ist veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Fügen Sie
LocalIndicationzuMaterialThemevon Material 3 hinzu. (I7ce4e) - Eckradius für Kästchen korrigieren (I38b03, b/175198975, b/202309440)
Abhängigkeitsupdates
- Hängt jetzt von Kotlin
1.6.10ab.
Version 1.0.0-alpha02
1. Dezember 2021
androidx.compose.material3:material3:1.0.0-alpha02 ist veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- Unterstützung für Kästchen und Optionsfelder hinzugefügt.
- Aktualisiert, um mit Kotlin
1.6.0kompatibel zu sein
API-Änderungen
- Entfernen Sie die Schublade aus dem Scaffold von Material 3. (I04f51)
- Unterstützung für Material 3
Checkboxwird hinzugefügt. (Id5542) - Unterstützung für Material 3
RadioButtonwird hinzugefügt. (I20334)
Fehlerkorrekturen
- Reduziere den Welleneffekt-Radius von
IconButtonvon 40 dp auf 20 dp. (I68bbe, b/206674345) - Schnellzugriff auf Port-String für
Textändert sich voncompose.material(I30b03) - Es wurde ein Fehler behoben, durch den die Schaltfläche immer aktiviert war. (Iea832, b/205335456)
Version 1.0.0-alpha01
27. Oktober 2021
androidx.compose.material3:material3:1.0.0-alpha01 ist veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Material Design 3-Thematisierung und dynamische Material You-Farben
Material Design 3-Komponenten
- Schaltflächen
- UAS und erweitertes UAS
- Dialogfelder
- Navigationsleiste
- Navigationsleiste
- Navigationsleiste
- Obere App-Leiste
- Badge
- Symbol
- Text
- Oberfläche
- Layout
- Inhaltsfarbe
Weitere Informationen finden Sie im Abschnitt Material Design 3 und Material You im Leitfaden „Material-Theming in Compose“.