Diese Seite wurde von der Cloud Translation API übersetzt.

Material 3 zusammenstellen

API-Referenz
androidx.compose.material3
(API-Referenzdokumentation für alle Compose-Pakete ansehen)

Erstellen Sie Jetpack Compose-UIs mit Material Design 3-Komponenten, der nächsten Weiterentwicklung von Material Design. Material 3 umfasst aktualisierte Themen und Komponenten sowie Personalisierungsfunktionen von Material You wie dynamische Farben. Es wurde so konzipiert, dass es zum neuen visuellen Stil und zur System-UI von Android 12 passt.

Letzte Aktualisierung	Stabile Version	Release Candidate	Beta-Ausgabe	Alphaversion
12. Dezember 2024	1.3.1	-	-	1.4.0-alpha05

Struktur

Compose ist eine Kombination aus sieben Maven-Gruppen-IDs in androidx. Jede Gruppe enthält eine gezielte Teilmenge von Funktionen, für die jeweils eigene Release-Notes gelten.

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

Gruppe	Beschreibung
compose.animation	Sie können Animationen in ihren Jetpack Compose-Anwendungen erstellen, um die Nutzerfreundlichkeit zu verbessern.
compose.compiler	@Composable-Funktionen transformieren und Optimierungen mit einem Kotlin-Compiler-Plug-in aktivieren
compose.foundation	Erstellen Sie Jetpack Compose-Anwendungen mit vorgefertigten Bausteinen und erweitern Sie das Fundament, um eigene Designsystemelemente zu erstellen.
compose.material	Erstellen Sie Jetpack Compose-UIs mit vorgefertigten Material Design-Komponenten. Dies ist der übergeordnete Einstiegspunkt von Compose. Er wurde entwickelt, um Komponenten bereitzustellen, die denen auf www.material.io entsprechen.
compose.material3	Erstellen Sie Jetpack Compose-UIs mit Material Design 3-Komponenten, der nächsten Weiterentwicklung von Material Design. Material 3 umfasst aktualisierte Themen und Komponenten sowie Personalisierungsfunktionen von Material You wie dynamische Farben. Es wurde so konzipiert, dass es zum neuen visuellen Stil und zur System-UI von Android 12 passt.
compose.runtime	Grundlegende Bausteine des Programmiermodells und der Statusverwaltung von Compose sowie die Kernlaufzeit, auf die das Compose-Compiler-Plug-in ausgerichtet ist.
compose.ui	Grundlegende Komponenten der Compose-Benutzeroberfläche, die für die Interaktion mit dem Gerät erforderlich sind, einschließlich Layout, Zeichnen und Eingabe.

Abhängigkeiten deklarieren

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

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die erforderlichen Artefakte hinzu:

Groovy

dependencies {
    implementation "androidx.compose.material3:material3:1.3.1"
    implementation "androidx.compose.material3:material3-window-size-class:1.3.1"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha04"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    implementation("androidx.compose.material3:material3:1.3.1")
    implementation("androidx.compose.material3:material3-window-size-class:1.3.1")
    implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha04")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Compose Material3 Common Version 1.0

Version 1.0.0-alpha01

17. April 2024

androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01 und androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 werden losgelassen. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

Themenlose Komponenten, die zum Erstellen von Material Design-Komponenten verwendet werden können:

Tonale Palette
- TonalPalette
Symbol
- Icon
Größe des Berührungszielbereichs
- LocalMinimumInteractiveComponentSize

Compose Material3 Adaptive Navigation Suite Version 1.0

Version 1.0.0-alpha07

1. Mai 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 werden losgelassen. Version 1.0.0-alpha07 enthält diese Commits.

API-Änderungen

Navigation Suite APIs nicht mehr als experimentell kennzeichnen (If62af)

Fehlerkorrekturen

Standardmäßig Einblendungen für Inhalte verwenden (50266df)

17. April 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 werden losgelassen. Version 1.0.0-alpha06 enthält diese Commits.

API-Änderungen

Fügen Sie containerColor und contentColor zu NavigationSuiteScaffoldDefaults hinzu. (I64e3a, b/331993720)
itemColors-Funktion zu NavigationSuiteDefaults hinzufügen (Idf719, b/328480012)
Machen Sie NavigationSuiteScope versiegelt. (Iefa57)

6. März 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 werden losgelassen. Version 1.0.0-alpha05 enthält diese Commits.

API-Änderungen

Machen Sie den Konstruktor von NavigationSuiteItemColors öffentlich. (Ica83a, b/324886877)

21. Februar 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 werden losgelassen. Version 1.0.0-alpha04 enthält diese Commits.

Abhängigkeitsupdates

Aktualisieren Sie die adaptiven Abhängigkeiten von Material 3 auf die neuen Modulpfade. (Ibc421)
Verwenden Sie die Fenstermanagerversion der Fenstergrößenklassen. (I3794d)

7. Februar 2024

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 werden losgelassen. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

Paketnamen von „navigation-suite“ in „navigationsuite“ ändern (I7eff7)
Material3-Komponenten, die eine MutableInteractionSource in ihrer API bereitstellen, wurden aktualisiert. Sie stellen jetzt eine nullable MutableInteractionSource bereit, die standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie die MutableInteractionSource nicht hochladen. Sie wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie zu „null“ wechseln, wird für einige Komponenten nie eine MutableInteractionSource zugewiesen. Bei anderen Komponenten wird eine Instanz nur bei Bedarf erstellt, was die Leistung dieser Komponenten insgesamt verbessert. Wenn du den MutableInteractionSource, den du an diese Komponenten weitergibst, nicht verwendest, solltest du stattdessen „null“ übergeben. Wir empfehlen Ihnen außerdem, ähnliche Änderungen an Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146)

13. Dezember 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 und androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 werden losgelassen. Version 1.0.0-alpha02 enthält diese Commits.

Neue Funktionen

Fügen Sie ein NavigationSuiteType für „Kein“ hinzu (If8cb1, b/313688598).

Fehlerkorrekturen

Navigationskomponente füllt den gesamten Bildschirm aus, wenn die Stammoberfläche modifier.fillMaxSize enthält (c9cf250, b/312664933)

15. November 2023

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

NavigationSuiteScaffold
- NavigationSuiteScaffoldLayout
- NavigationSuite

Material3 Adaptive Version 1.0 erstellen

Version 1.0.0-alpha06

7. Februar 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 werden losgelassen. Version 1.0.0-alpha06 enthält diese Commits.

Neue Funktionen

Es wurden zusätzliche Verhaltensoptionen für die ThreePaneScaffoldNavigator-Rückwärtsnavigation hinzugefügt. (I858aa)
Dem Navigationsverlauf wurden optionale Zielinhalte hinzugefügt. (Ibd7e6)

Version 1.0.0-alpha05

24. Januar 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 werden losgelassen. Version 1.0.0-alpha05 enthält diese Commits.

Neue Funktionen

Unterstützung der Historie bei der Navigation im Navigations-Scaffold und bei der Wertberechnung (I71d46)

Version 1.0.0-alpha04

10. Januar 2024

androidx.compose.material3:material3-adaptive:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 werden losgelassen. Version 1.0.0-alpha04 enthält diese Commits.

Neue Funktionen

Unterstützung für die volle Breite in Bereichs-Scaffolds hinzugefügt (I1b462)

API-Änderungen

Die Eigenschaften für Scharniergrenzen wurden in „Körperhaltung“ in eine Liste mit Scharnierinformationen verschoben (I24f90)

Fehlerkorrekturen

Fehler beheben: AnimatedPane wird nicht neu zusammengesetzt (c3f573d)

Version 1.0.0-alpha03

13. Dezember 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 werden losgelassen. Version 1.0.0-alpha03 enthält diese Commits.

API-Änderungen

Ändern Sie die Scaffold-Rollen in Aliasse von ThreePaneScaffoldRole. (I65bd1)
Basisklasse für Scaffold-Rollen erstellen (I4784d)
Unnötigen Parameter aus dem Inhalt von AnimatedPane entfernen (Ibc73b)
Benennt collectWindowSizeAsState um und gibt stattdessen Rohwerte zurück (I480f4)

Version 1.0.0-alpha02

29. November 2023

androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 und androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 werden losgelassen. Version 1.0.0-alpha02 enthält diese Commits.

API-Änderungen

Navigations-APIs von APIs für adaptives Scaffolding trennen. (Ic4045)
Entfernen Sie die Klasse GutterSize. (I785b3)

Fehlerkorrekturen

Es wird nicht mehr zwischen den Ansichten gewechselt, wenn AnimatedPane nicht verwendet wird (d88f181)

Version 1.0.0-alpha01

15. November 2023

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

Neue Funktionen

APIs für adaptive Material3-Bedingungen:

Körperhaltung

APIs für Material3-Anweisungen für adaptive Steuerfeldbereiche:

PaneScaffoldDirective

APIs für Material3-Adaptive-Steuerfeld-Scaffolding:

Grundlegende APIs für Steuerfeld-Scaffolding

Material3 Version 1.4

Version 1.4.0-alpha05

12. Dezember 2024

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

API-Änderungen

Ersetzen Sie den Typ im WideNavigationRailState.current/target-Wert durch ein Enum, um die Lesbarkeit zu verbessern (I2d6ab)
SplitButton Shape API von Datenklasse zu Klasse für binäre Kompatibilität ändern. (I53812)
Es wurde eine Tooltip-API mit dem Parameter onDismissRequest hinzugefügt, mit dem Creator 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)
Ändern Sie den Namen von opticalCentering in horizontalCenterOptically. Modifikator intern machen Ersetzen Sie den Parameter „padding“ durch „max_start_offset“ und „max_end_offset“. (I0b904)
Ändern Sie WideNavigationRailState in den aktuellen/Zielwert und entfernen Sie die Enumerationen zugunsten von booleschen Werten. (Idfa29, b/356039090)
Fügen Sie NavigationBarItemComponentOverride hinzu. (I3a06a)

Fehlerkorrekturen

Das Verhalten der oberen und unteren App-Leiste wurde so angepasst, dass die Farbe zuverlässig geändert wird, wenn der Inhalt ganz nach unten gescrollt wird. (Idc4e8, b/293665988)
Funktionen für das Scrollen in oberen und unteren App-Leisten geben jetzt ein gespeichertes Verhalten zurück, um bei Neuzusammensetzungen eine bessere Leistung zu erzielen. (I0fdbe, b/207957336)
Der Parameter „Modifier“ wird jetzt nach internen Modifikatoren wie dem Verhalten beim Ziehen und der Semantik angewendet, anstatt davor. Dies wirkt sich auf die Reihenfolge aus, in der die Modifikatoren angewendet werden. (I8d83f)
Maximierte untere Leiste bleibt bei Größenänderung maximiert. (I2870b, b/324934884)
Status und Flags der Navigationsleiste für Fenstereigenschaften wurden korrigiert. (Ie674d, b/362539765)
Verschieben Sie den Modifikatorparameter wie dokumentiert in das Stammverzeichnis des Scaffolds. Dadurch wird die Implementierung an M2 angepasst. (I0235e, b/372311595)

Externer Beitrag

Gemeinsam genutzte DatePickerDialog-Funktion. (I7dced)

Version 1.4.0-alpha04

13. November 2024

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

Verhaltensänderungen

Die in aosp/3212478 eingeführten Farbänderungen für iconButtonColors, iconToggleButtonColors, outlinedIconButtonColors, outlinedIconToggleButtonColors und outlinedIconToggleButtonBorder rückgängig machen Das jetzt rückgängig gemachte Verhalten wurde in eine neue Gruppe von Funktionen namens iconButtonVibrantColors usw. verschoben, um die zurückgegebenen Farben mit hohem Kontrast hervorzuheben. (Iffd8d)

Neue Funktionen

Einführung der VerticalDragHandle-Komponente (I6c770)

API-Änderungen

Benennen Sie DismissibleModalWideNavigationRailDefaults in ModalWideNavigationRailDefaults um. (I8e877)
Fügen Sie NavigationBarComponentOverrides hinzu. (I8a3f3)
Fügen Sie NavigationRailComponentOverride hinzu. (I83e13)
Fügen Sie WideNavigationRailState hinzu, um das Minimieren/Maximieren der Leiste zu steuern, lassen Sie ModalWideNavigationRail schließen und löschen Sie DismissibleModalWideNavigationRail. (I88568)
Fügen Sie den Standardgrößen „xSmall“, „Medium“, „Large“ und „xLarge“ Standardwerte für die Ein-/Aus-Schaltfläche hinzu. (Ie95d1)
Fügen Sie den Standardgrößen „xSmall“, „Medium“, „Large“ und „xLarge“ zu den Standardgrößen der Schaltfläche hinzu. (If8b6d)

Fehlerkorrekturen

Die Farbe des nachgestellten Symbols für Filterchips wurde gemäß den Spezifikationen von „Primär“ zu „OnSurfaceContainer“ geändert. Alle Chip-Umrissfarben wurden gemäß den Spezifikationen von „Umriss“ zu „Umrissvariante“ geändert. (I68bd4)

Version 1.4.0-alpha03

30. Oktober 2024

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

API-Änderungen

Der SheetState-Konstruktor mit Dichte wurde zugunsten von Grenzwerten für Position und Geschwindigkeit eingestellt. (Ifd16e)
rememberTooltipPositionProvider hinzugefügt, das eine aktualisierte Positionierungslogik enthält. rememberPlainTooltipPositionProvider und rememberRichTooltipPositionProvider wurden eingestellt. (Ie66e2)
Mit zusätzlichen ModalBottomSheetProperties können Sie die Farben der Status- und Navigationsleiste anpassen. Standardmäßig werden sie anhand der Inhaltsfarbe und nicht anhand des Status des dunklen Systemdesigns aktualisiert. (Ib874e, b/362539765)
Die Eingabe für Datumsauswahlen wurde verbessert: Im Eingabemodus wird das Textfeld für das Datum aktiviert, damit sofort Text eingegeben werden kann. Durch die Änderung wird dem DatePicker und dem DateRangePicker ein requestFocus-Parameter hinzugefügt. Sie können den Fokus verhindern, indem Sie false übergeben. (I12d09, b/286399710, b/340102743)
Die Standardeinstellungen für die Form im Shape-Objekt im Cache speichern Die Standardform für die Ein-/Aus-Schaltfläche ist @Composable. Die Formen werden zu einer Standardform minimiert, da die Varianten auf dieselbe Tokendatei verweisen. (Iaa014)

Fehlerkorrekturen

Optimieren Sie das Verhalten von contentPadding im Scaffold, damit der Textkörper nicht immer neu formatiert werden muss, wenn sich contentPadding ändert. (I8c8e2, b/373904168)
TextFieldLabelScope progress in labelMinimizedProgress umbenannt
TextFieldLabelPosition Default wurde in Attached umbenannt. Benutzeroberflächenelemente wurden entfernt. (If75c6)
Ein Problem mit dem DatePicker im Eingabemodus wurde behoben, bei dem Validierungsfehler dazu führen konnten, dass sich die Höhe der Komponente änderte. (I2e229, b/280462363)
Der Material-Schieberegler soll seinen Wert ändern, wenn Steuertasten gedrückt werden. (I1c442)

Version 1.4.0-alpha02

16. Oktober 2024

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

API-Änderungen

Aktualisierungen an den Datumsauswahlen, um eine einheitliche Spracheneinstellung in DatePicker und DateRangePicker zu gewährleisten, wenn eine Sprache direkt über eine DatePickerState oder eine DateRangePickerState festgelegt wird. Wenn Sie die Sprachen direkt auf den Bundesstaat festlegen, müssen Sie dafür sorgen, dass der Titel und die Überschriften entsprechend lokalisiert sind, da der Standardtext weiterhin gemäß der Standardsprache der Plattform angewendet wird. (I37073, b/326490763, b/321657276)
SheetState.isAnimationRunning ist jetzt sichtbar. (I9a3d7)
DatePickerColors hat jetzt Vorrang vor eventuell abweichenden Farben, die in den Textstilen „Typografie“ des Designs definiert sind. Außerdem wird durch dieses Update die Position des Parameters color in den Funktionen der Datumsauswahl angepasst und der Parameter contentColor eingeführt, mit dem die Textfarben für Kopfzeile und Titel angepasst werden können. (I30d03, b/347031394)
Benennen Sie SplitButton in SplitButtonLayout um und entfernen Sie die APIs für SplitButton-Farbvarianten. Varianten werden durch Wiederverwendung der von SplitButtonDefaults bereitgestellten Schaltflächenvarianten erstellt. (I44c36)
ModalBottomSheet hat jetzt den Parameter sheetGestureEnabled (I856cb, b/288211587)
standardMotionScheme und expressiveMotionScheme wurden in „Standard“ und „Ausdrucksstark“ umbenannt. Beide Funktionen sind jetzt über das MotionScheme-Begleiterobjekt verfügbar. Rufen Sie dazu MotionScheme.standard() und MotionScheme.expressive() auf. (Iceccf)
Der Parameter maxWidth wurde einfachen und erweiterten Kurzinfos hinzugefügt. Standardmäßig wird die Designangabe von 200 dp für einfache Kurzinfos und 320 dp für umfangreiche Kurzinfos verwendet. (I30ce9)

Fehlerkorrekturen

Der angezeigte Monat wird jetzt von DatePicker und DateRangePicker korrekt aktualisiert, wenn er über die displayedMonthMillis des jeweiligen Status festgelegt wird. (If9e47, b/333414302)
ModalBottomSheet-Inhalte werden jetzt nicht mehr in der Statusleiste angezeigt. (I5114c, b/321877275, b/336962418, b/342093067)
[Untere Leiste] Die Rückrufpriorität wird wieder auf PRIORITY_DEFAULT zurückgesetzt, damit die IME-Tastatur zuerst geschlossen wird. (I447fb)
Behebung von Abstürzen in der DatePicker und DateRangePicker, wenn das Jahr, das als Mindestwert für die Auswahl festgelegt ist, in der Zukunft liegt. (I78656, b/319395747)
Behebung eines Problems mit der Datumsauswahl, durch das die Benutzeroberfläche nicht aktualisiert wurde, wenn eine aktualisierte SelectableDates-Instanz angewendet wurde. (Iad59a, b/290135807, b/339898760)

Version 1.4.0-alpha01

2. Oktober 2024

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

Verhaltensänderungen

Die Bibliothek fügt material-icons-core keine Abhängigkeit mehr hinzu. Wenn Ihr Projekt darauf angewiesen ist, müssen Sie diese Abhängigkeit in Ihren build.gradle[.kts]-Dateien explizit hinzufügen. (I735ff, b/349894318)
Die Farbe des aktiven Labels von NavigationBarItem und NavigationRailItem ändert sich von onSurface zu secondary, um die Nutzerfreundlichkeit, den Farbkontrast und die Einheitlichkeit im System zu verbessern (Ibc297). Wenn Sie zum vorherigen Verhalten zurückkehren möchten, kopieren Sie die Standardfarben und ändern Sie selectedTextColor in MaterialTheme.colorScheme.onSurface.
Für die Bewegung von Material 3-Komponenten wird jetzt die neue MotionScheme verwendet. (Ie0f93)
Änderungen der Bewegung der unbestimmten kreisförmigen Fortschrittsanzeige (I3c07e)
Aktualisieren Sie OutlinedIconButtonColors und OutlinedIconToggleButtonColors für einen besseren Farbkontrast. (I2743d)
Farbe von Container und Inhalt für FilledIconToggleButtonColors und FilledTonalIconToggleButtonColors aktualisiert. (Ic5d0f)
Die Rahmenfarbe von OutlinedButton wurde von outline zu outlineVariant geändert. (057f00)

API-Änderungen

Der Funktion enterAlwaysScrollBehavior von TopAppBar wurde ein optionaler Parameter reverseLayout hinzugefügt, um Inhalte zu unterstützen, die mit einem reverseLayout festgelegt wurden. (I4e0e5)
SegmentedButton unterstützt jetzt das Argument contentPadding. (I5ad91, b/358414376)
PullToRefreshState hat keine Standardimplementierung mehr für isAnimating (I6a593)
Es wurden neue Überladungen von Material TextField und OutlinedTextField hinzugefügt, die TextFieldState verwenden. APIs für Dekorationsboxen hinzugefügt, die mit TextFieldDecorator kompatibel sind. (If13a1)
Dem Textfeld wurde der Parameter labelPosition hinzugefügt. Mit alwaysMinimize kann das UI-Muster so gestaltet werden, dass ein Label und ein Platzhalter in einem Textfeld gleichzeitig angezeigt werden, auch wenn das Feld nicht fokussiert ist. (I1ef2c)
Die Materialien SecureTextField und OutlinedSecureTextField für Passwort-Eingabefelder wurden hinzugefügt. (I7e22d)
Textfeldlabels haben jetzt einen Bereich, um den Fortschritt der Animation abzufragen. (If5ec8)
In den Kurzinfos wird die Unterstützung für MotionEvent.CLASSIFICATION_DEEP_PRESS hinzugefügt. (I62e6a)
isAfternoon von TimePickerState ist jetzt ein Erweiterungswert statt einer Variablen in der Benutzeroberfläche und wurde in isPm umbenannt (I89a97)
Die Typografieklasse wird aktualisiert, um hervorgehobene Schriftskalierungen zu unterstützen. (Ifa13c)
Die ModalWideNavigationRail API wurde hinzugefügt und die ModalExpandedNavigationRail APIs in DismissibleModalWideNavigationRail umbenannt. (Ic9118)
FloatingAppBarScrollBehavior wurde aktualisiert, damit die screenOffset automatisch berechnet wird und keine @Composable erforderlich ist. (Idf349)
Aktualisierungen der LoadingIndicator API zur Korrektur der Benennung im Standardobjekt. An der PullToRefresh wurde eine LoadingIndicatorElevation-Konstante hinzugefügt. (I1d72b)
Aktualisierungen der LoadingIndicator API zur Korrektur der Benennung im Standardobjekt. An der PullToRefresh wurde eine LoadingIndicatorElevation-Konstante hinzugefügt. (I1d72b)
Den unbestimmten Varianten von LinearWavyProgressIndicator und CircularWavyProgressIndicator wurden die Parameter amplitude und waveSpeed hinzugefügt. (I2a0c5)
Die Form einer Symbolschaltfläche muss sich je nach gedrücktem oder angeklicktem Zustand ändern lassen. (Ibc781)
Die Typografieklasse wird aktualisiert, um hervorgehobene Schriftskalierungen zu unterstützen. (Ifa13c)
SplitButton Formen werden je nach Standard-/gedrücktem Status verändert. Die AnimatedTrailingButton API wurde entfernt, da die TrailingButton API dieselben Anpassungen bietet (I95066)
Fügen Sie einen Modifier hinzu, um das Ein- und Ausblenden des Floating Action Button zu animieren, z.B. beim Scrollen von Inhalten. (I8338d)
ButtonGroupDefaults wird mit verbundenen Schaltflächengruppenformen und Abständen versehen, die in einem Beispiel verwendet werden sollen. (I68e30)
Für die geteilte Schaltfläche wird ein horizontaler Abstand für die hintere Schaltfläche hinzugefügt und die optische Zentrierung wird anhand der Unterschiede zwischen Start- und Endecke berechnet (I122e2)
Einführung eines neuen Material-MotionScheme-Attributs, mit dem ein Schema für die Bewegung der Komponente festgelegt werden kann. Das Schema wird über die MaterialTheme festgelegt. (Id50c2)

Fehlerkorrekturen

Wenden Sie den richtigen Index für die Fokusüberprüfung auf Scaffold untergeordnete Composables an. Die Reihenfolge ist topBar, bottomBar, FAB, Inhalt, Snackbar. (I5936b)
Ein Problem bei DatePicker und DateRangePicker wurde behoben, bei dem in bestimmten Sprachen und Format-Skeletten einige Datumselemente (z.B. Monatsnamen) nicht mit einem Großbuchstaben begannen. (I1430f)
FAB- und FAB-Menü-Komponenten-Tokens einbinden (kleine visuelle Änderungen an Rändern und Text) (Ib57f3)
ModalBottomSheet steht jetzt in der semantischen Durchlaufreihenfolge an erster Stelle, gefolgt vom Scrim. (I436f9, b/358594665)
Die untere App-Leiste verschwindet nicht vollständig, wenn im Vollbildmodus unter der Navigationsschaltfläche gescrollt wird (I3ee21)

Compose Material3 Version 1.3

Version 1.3.1

30. Oktober 2024

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

Fehlerkorrekturen

Der angezeigte Monat wird jetzt von DatePicker und DateRangePicker korrekt aktualisiert, wenn er über die displayedMonthMillis des jeweiligen Status festgelegt wird. (If9e47, b/333414302)
Behebung von Abstürzen in der DatePicker und DateRangePicker, wenn das Jahr, das als Mindestwert für die Auswahl festgelegt ist, in der Zukunft liegt. (I78656, b/319395747)
Behebung eines Problems mit der Datumsauswahl, durch das die Benutzeroberfläche nicht aktualisiert wurde, wenn eine aktualisierte SelectableDates-Instanz angewendet wurde. (Iad59a, b/290135807, b/339898760)
Ändern Sie die Rückrufpriorität, die von unteren Infofeldern verwendet wird, in PRIORITY_DEFAULT, damit die IME-Tastatur zuerst geschlossen wird. (I447fb)

Version 1.3.0

4. September 2024

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

Wichtige Änderungen seit Version 1.2.0

Wichtige Funktionen von Version 1.3.0

Neue Material Design 3-Komponenten

Karussell
- HorizontalMultiBrowseCarousel und HorizontalUncontainedCarousel: Verbesserungen an vorhandenen Material Design 3-Komponenten.
[ModalBottomSheet] Unterstützung der Vorhersagefunktion für Zurück bei U+ (Iccf32, b/281967264, b/304850357)
[SearchBar] Unterstützt jetzt die intelligente „Zurück“-Geste auf Android U und höher (I657f8)
Die Navigationsleiste (ModalDrawerSheet und DismissibleDrawerSheet) unterstützt jetzt die vorausschauende Navigation auf U+ als Option (Ie5b0b)
DropdownMenu unterstützt jetzt benutzerdefinierte Farbe, Form, Höhe und Rahmen. (I8e981,b/289554448, b/301887035, b/283654243)
Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Haltestellenanzeige hinzugefügt. (I3058e)
ProgressIndicator wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Haltestellenanzeige hinzugefügt. (I21451)
Es wurde ein Standard-Cursor für Rich-Tooltips hinzugefügt. Außerdem wird unterstützt, dass ein benutzerdefinierter Cursor für einen bestimmten Anker LayoutCoordinates gezeichnet wird. (Ifd42c) Wichtige Änderungen
Neue APIs für das Ziehen zum Aktualisieren:
- PullToRefreshState wurde vereinfacht, sodass anstelle von Dp-Einheiten Bruchteile verwendet werden.
- Der Status von isRefreshing wird vom Nutzer und nicht von PullToRefreshState gesteuert.
- Die verschachtelte Scrollverbindung von PullToRefreshState getrennt. Die Verarbeitung erfolgt über die neue PullToRefreshBox oder Modifier.pullToRefresh.
- Dieses Update ist eine inkompatibilitätsbedingte Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Visuelle Unterbrechungen
Aktualisieren Sie das Overlay für den Fokusstatus auf 0,1f, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
Kleine Anpassungen an den Standardfarben für Oberfläche und Hintergrund in lightColorScheme und darkColorScheme. (I9db52)
Die Farben des Schiebereglers und von ProgressIndicator wurden an die neuen Spezifikationen für den Kontrast von Nichttextelementen angepasst. (I26807)
SurfaceContainer Varianten werden jetzt von Komponenten verwendet. Für Komponenten, bei denen die Farbe bisher mit Surface und TonalElevation berechnet wurde, werden jetzt standardmäßig SurfaceContainer-Rollen verwendet, die nicht von der Tonhöhenänderung betroffen sind. (b/304584161)
Die Standardrollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, um in hellen und dunklen Designs mehr Färbung zu ermöglichen. (I677a5)
Die experimentellen APIs wurden in stabile APIs umgewandelt.
Leistungsverbesserungen

Version 1.3.0-rc01

21. August 2024

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

Fehlerkorrekturen

ModalBottomSheet steht jetzt in der semantischen Durchlaufreihenfolge an erster Stelle, gefolgt vom Scrim. (I436f9, b/358594665)

Version 1.3.0-beta05

24. Juli 2024

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

Problem behoben, bei dem BottomSheet-Inhalte unter Android N und O fehlen oder abgeschnitten werden (a10a2d)
Die semantischen Grenzen des Schiebereglers wurden erhöht, damit TalkBack die Fokusindikatoren um die Schieberegler richtig anzeigen kann. (0b5a1d)

Version 1.3.0-beta04

26. Juni 2024

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

Version 1.3.0-beta03

12. Juni 2024

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

Externer Beitrag

Machen Sie androidx.compose.material3.DropdownMenu aus dem gemeinsamen Quellsatz verfügbar. (If62c0)

Version 1.3.0-beta02

29. Mai 2024

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

API-Änderungen

Modifier.pullToRefreshIndicator unterstützt die Höhe. Aktualisieren Sie die APIs für das Ziehen zum Aktualisieren, damit „aktiviert“ ein boolescher Wert statt eines Lambdas ist. Unterstützung der Inhaltsausrichtung in PullToRefreshBox (I75679)
TooltipScope zu einer versiegelten Schnittstelle machen und eine interne Implementierung für TooltipBox und Label erstellen (I3833e)
CarouselItemScope wurde zwei neue Modifikatoren hinzugefügt: maskClip und maskBorder. Damit können Sie jedem Karussellelement ganz einfach eine Form und einen Rahmen hinzufügen (Id67a1)
TimePickerState ist jetzt eine Benutzeroberfläche und ermöglicht das Einstellen der Uhrzeit (I88546)
API für das Stilisieren der Links aktualisiert: TextLinkStyles wurde an die Stelle von TextStyle verschoben und TextDefaults aus dem Material entfernt. (I5477b)

Fehlerkorrekturen

Der Status von ModalBottomSheet und die Symbole in der Navigationsleiste reagieren jetzt auf den Status des dunklen Designs. (Ie1fe7, b/338342149)
Dem ModalBottomSheet-Skim wurde die Semantik „Tabellenblatt schließen“ hinzugefügt. (0e61cb,b/328801864)

Externer Beitrag

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

Version 1.3.0-beta01

14. Mai 2024

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

API-Änderungen

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

Version 1.3.0-alpha06

1. Mai 2024

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

Wichtige Änderungen

Neue APIs für das Ziehen zum Aktualisieren:
- PullToRefreshState wurde vereinfacht, sodass anstelle von Dp-Einheiten Bruchteile verwendet werden.
- Der Status von isRefreshing wird vom Nutzer und nicht von PullToRefreshState gesteuert.
- Die verschachtelte Scrollverbindung von PullToRefreshState getrennt. Die Verarbeitung erfolgt über die neue PullToRefreshBox oder Modifier.pullToRefresh.
- Dieses Update ist eine inkompatibilitätsverursachende Änderung gegenüber früheren experimentellen APIs. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)

API-Änderungen

RippleConfiguration#isEnabled wurde entfernt und LocalRippleConfiguration ist jetzt nullable. Wenn Sie eine Wellenbewegung deaktivieren möchten, geben Sie anstelle von RippleConfiguration mit isEnabled = false null bis LocalRippleConfiguration an. (I22725)
ModalBottomSheet Der Scrim wird jetzt genauer über der Statusleiste dargestellt, wenn „Edge to Edge“ aktiviert ist. Der Inhalt modaler Unterbrechungen kann jetzt Fenster-Einsätze verwenden, sodass Inhalte über der Navigationsleiste sichtbar sind. Der Parameter ModalBottomSheet wurde in contentWindowInsets umbenannt, um anzugeben, wo die Einzüge angewendet werden. Sie sind nicht mehr an die Fensterlogik gebunden.windowInsets Der Typ contentWindowInsets wurde in eine Funktion geändert, die WindowInsets zurückgibt, damit er im neuen Fenster aufgelöst werden kann. (I39630, b/274872542, b/300280229, b/290893168)
Für PrimaryScrollableTabRow und SecondaryScrollableTabRow wird jetzt ein benutzerdefiniertes Layout anstelle einer untergeordneten Komposition verwendet, was die Leistung verbessern sollte. (I991e0)
Für Textlinks gibt es jetzt neben den Optionen für den normalen Stil, den Mauszeiger- und den Fokusstil auch eine Option für den gedrückten Zustand. Die TextDefaults-Methoden haben jeweils ein pressedStyle-Argument, das dies unterstützt. (Ic473f, b/139312671)

Fehlerkorrekturen

Die Ankerpunkte für die Navigationsleiste entsprechen jetzt der Breite der drawerContent. (Ibc72f, b/245355396)
OutlinedTextField Der obere Abstand für das Label berücksichtigt jetzt die Systemschriftgröße. (Idc781)
Korrigierter Paketstandort: CalendarLocale (Ifa235)
[Intelligente „Zurück“-Geste] Animationen für intelligente „Zurück“-Touch-Geste werden jetzt mit der Interpolationskurve (0,1, 0,1, 0,1) aktualisiert (I2591a)

Version 1.3.0-alpha05

17. April 2024

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

Neue Funktionen

Für SearchBar und DockedSearchBar gibt es neue Überladungen, die einen Textfeldparameter annehmen. So können Sie das Textfeld unabhängig vom Rest der Suchleiste formatieren und benutzerdefinierte Textfelder übergeben. Das Textfeld der aktuellen Implementierung wurde als SearchBarDefaults.InputField verfügbar gemacht. (I50c73, b/275074248, b/278773336, b/326627700)
Der Lambda-Wert drawTick wurde der öffentlichen API hinzugefügt, um die Markierungen bei Bedarf anzupassen (I0c048)

API-Änderungen

Für Textlinks gibt es jetzt neben dem normalen Stil auch einen Stil für den gedrückten Zustand, den Hover-Zustand und den Fokus-Zustand (I5f864, b/139312671)
CarouselItemInfo wurde aktualisiert, um einen Masken-Rechteck zu zeigen, durch den das Element zugeschnitten wird (I785d8)
BasicTooltipState wurde aus der öffentlichen Material 3 API entfernt. Die Funktionalität wird mit TooltipState kombiniert, bis BasicTooltip von Foundation stabilisiert ist. (Icda29)
Es wurde ein TextDefaults-Objekt hinzugefügt, das Methoden zum Erstellen einer LinkAnnotation und zum Parsen von HTML-getaggten Strings enthält, die MaterialTheme auf die Links anwenden (I98532, b/139312671)
ExposedDropdownMenuBoxScope erlaubt keine Unterklassen mehr. Ausgeblendete Drop-down-Menüs haben jetzt ein MenuAnchorType, das an menuAnchor übergeben werden sollte, um die Barrierefreiheit zu verbessern. Diese Methode sollte anstelle der Weitergabe von focusable an ExposedDropdownMenu verwendet werden, was jetzt nicht mehr unterstützt wird. menuAnchor hat einen neuen Parameter zum Steuern des Status enabled. (I55ee6, b/257209915, b/308840226)
Die Rahmenfarbe von OutlinedButton wurde korrigiert, wenn die Funktion deaktiviert ist. Überladung von ButtonDefaults.outlinedButtonBorder("enabled") hinzugefügt, die den aktivierten Status berücksichtigt. (Ie650b, b/318461363)
Es wurde eine neue CarouselItemInfo-Klasse hinzugefügt, damit Kunden Informationen zu den Artikelgrößen erhalten. (I9070c)
Der ColorScheme-Konstruktor ohne Oberflächencontainer ist jetzt eingestellt. Bitte migrieren Sie zum Konstruktor, der Oberflächencontainer enthält. (I35c11)
[Umrandet]TextFieldDefaults ContainerBox wurde in Container umbenannt. (Ie8d3b)

Fehlerkorrekturen

BottomSheetScaffold wird nicht mehr durch verschachtelte Scroll-Aktionen gescrollt, wenn sheetSwipeEnabled auf „falsch“ gesetzt ist. (I5e1c1, b/306464779)
Einige ExperimentalMaterial3Api-Opt-in-Hinweise in IconButtonSamples.kt wurden entfernt. (I111d1)

Version 1.3.0-alpha04

3. April 2024

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

Neue Funktionen

Es wurden zwei experimentelle Versionen des Material3-Karussells hinzugefügt: HorizontalMultiBrowseCarousel und HorizontalUncontainedCarousel (I88d64).
Der Navigationsbereich von Compose M3 (ModalDrawerSheet und DismissibleDrawerSheet) wurde aktualisiert, um die vorausschauende Suche bei U+ als Option zu unterstützen (Ie5b0b)
In „Symbol“ wurde eine neue API hinzugefügt, mit der die Farbtonung als Lambda übergeben werden kann, um ein Neuzusammensetzen zu vermeiden. (I5b5a2)
APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen sowohl für feste als auch für minimierbare Bereiche. (Ib8b0c, b/323403446)

API-Änderungen

APIs für die obere App-Leiste unterstützen jetzt benutzerdefinierte Höhen sowohl für feste als auch für minimierbare Bereiche. Ein Problem wurde behoben, durch das sich App-Steuerfeldern mit einer Zeile beim Scrollen zu oft neu zusammensetzen. Ein Problem wurde behoben, bei dem Titel auf Geräten mit großen Schrift-/Displayeinstellungen von MediumTopAppBar abgeschnitten wurden. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676)
SegmentedButton und die zugehörigen APIs sind jetzt stabil (I8a158)
SwipeToDismissBox, SwipeToDismissBoxDefaults, SwipeToDismissBoxState und SwipeToDismissBoxValue sind jetzt als stabil gekennzeichnet. (I5f000)
Die eingestellten DismissDirection- und DismissValue-Enumerierungen und ‑APIs wurden entfernt. (I89ccd)
Dem CarouselState-Begleiterobjekt des Karussells wurde ein experimentelles Tag hinzugefügt. (I94154)
LocalMinimumInteractiveComponentEnforcement wurde eingestellt und durch LocalMinimumInteractiveComponentSize ersetzt. (I7a7ac)
Der Konstruktor von SearchBarColors ist jetzt öffentlich. (I769ca)
SwipeToDismissBox hat einen gesturesEnabled-Parameter erhalten. (Idc59f, b/324170119)
Textfeld-APIs, die als veraltet und experimentell gekennzeichnet waren, wurden entfernt. (I1305f)

Version 1.3.0-alpha03

20. März 2024

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

Visuelle Unterbrechungen

Aktualisieren Sie das Overlay für den Fokusstatus auf 0,1f, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
Kleine Anpassungen an den Standardfarben für Oberfläche und Hintergrund in lightColorScheme und darkColorScheme. (I9db52)

Neue Funktionen

Es wurden Parameter hinzugefügt, um ExposedDropdownMenu anzupassen. Insbesondere haben Menüs jetzt einen focusable-Parameter (Standardwert true), der bei der Arbeit mit bearbeitbaren Textfeldern auf false gesetzt werden sollte. (I4184c, b/323694447, b/278609042)

API-Änderungen

Das Flag ScaffoldSubcomposeInMeasureFix wurde entfernt. (Ie2a4b)
NavigationRailItemColors ist jetzt als @Immutable gekennzeichnet. (If6112, b/327660613)
NavigationBarItemColors ist jetzt als @Immutable gekennzeichnet. (I42a30, b/298064514)
Parameter im Slider Track-Composit neu anordnen (I9f315)
ExposedDropdownMenu wird jetzt mit Popup implementiert. Das Verhalten sollte gleich sein, mit der Ausnahme, dass Menüs, die fokussiert werden können und bearbeitbare Textfelder enthalten, geschlossen werden können, wenn auf der Tastatur getippt wird.

Fehlerkorrekturen

Die Standardrollen für Oberflächen und Oberflächencontainer wurden leicht angepasst, um in hellen und dunklen Designs mehr Färbung zu ermöglichen. (I677a5)
Die Farben des Schiebereglers und von ProgressIndicator wurden an die neuen Spezifikationen für den Kontrast von Nichttextelementen angepasst. (I26807)
Aktualisieren Sie das Overlay für den Fokusstatus auf 0,1f, um einen ausreichenden Farbkontrast zu gewährleisten. (I7ea77)
Kleine Anpassungen an den Standardfarben für Oberfläche und Hintergrund in lightColorScheme und darkColorScheme. (I9db52)

Version 1.3.0-alpha02

6. März 2024

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

API-Änderungen

Die Schiebereglerpositionen sind wieder stabil. State.onValueChangeFinished wird wieder zu einem Wert. onValueChangeFinished in einen rememberUpdatedState einschließen (I82ab2, b/322269951)
Für die Navigationskomponenten werden jetzt die neuen SurfaceContainer-Rollen verwendet. DrawerDefaults bietet jetzt separate standardContainerColor- und modalContainerColor-Attribute. DrawerDefaults.ModalDrawerElevation heißt jetzt 0.dp. (I7fbac)
@Stable wird aus den Status von Slider entfernt, da wir state.onValueChangeFinished in var ändern. (Ied34a, b/322269951)
Die ModalBottomSheet- und StandardBottomSheet-Animationsspezifikation ist jetzt eine TweenSpec, die aus einer federnden Animation aktualisiert wurde. Dadurch wird ein Problem mit einem sichtbaren Überlauf behoben. Die veralteten SheetState-Konstruktoren ohne Dichte wurden entfernt. (I7babc, b/285847707)

Fehlerkorrekturen

SurfaceContainer Varianten werden jetzt von Komponenten verwendet. Für Komponenten, bei denen die Farbe bisher mit „Surface“ und TonalElevation berechnet wurde, werden jetzt standardmäßig SurfaceContainer-Rollen verwendet, die nicht von der Tonhöhenänderung betroffen sind. (b/304584161)
Ein Fehler wurde behoben, durch den die nicht ausgewählte, deaktivierte Containerfarbe von ElevatedFilterChip schwarz war. (I400e6, b/322407043)
Fehler bei der unbestimmten Fortschrittsanzeige bei 0 % behoben (Id6582)
Ein Problem mit Slider und RangeSlider im linksläufigen Layout wurde behoben (Iab0e1)
SliderRangeTolerance für die Berechnung des Schiebereglerbereichs hinzufügen, da die Rundung von Gleitkommazahlen ungenau sein kann. (Ic918a, b/324934900)
Achten Sie darauf, dass die Schaltflächen von DatePickerDialog angezeigt werden, wenn Sie ein DateRangePicker verschachteln oder eine beliebige Art von Datumsauswahl auf kleinen Bildschirmen mit größeren Schriftarten anzeigen. (Ie4758, b/325107799, b/277768544)
Menu nutzt jetzt die Rolle SurfaceContainer für die Containerfarbe. MenuDefaults.TonalElevation heißt jetzt 0.dp. (I135b7)
TextField nutzt jetzt die Rolle SurfaceContainerHighest für die Containerfarbe. (I4dced)
Für erhöhte Chips wird jetzt die Rolle SurfaceContainerLow (I7cd2f) verwendet.
Die Containerfarbe von DatePicker ist jetzt SurfaceContainerHigh. DatePickerDefaults.TonalElevation heißt jetzt 0.dp. (Ida753)
Die Farbe des Containers und des Ziehpunkts für Unterbrechungen wurde aktualisiert. (I72a0a)
Die Containerfarbe von RichTooltip ist jetzt SurfaceContainer. (Ia8b45)
Die Containerfarbe von SearchBar ist jetzt SurfaceContainerHighest. SearchBarDefaults.TonalElevation heißt jetzt 0.dp. (I88604)
Deaktivierte und nicht ausgewählte Tracks/Symbole werden aktualisiert, um die Farbrolle SurfaceContainerHighest zu nutzen. (I7687a)
Die Containerfarbe von AlertDialog ist jetzt SurfaceContainerHigh. (Ie0433)
Die Containerfarbe von BottomAppBar ist jetzt SurfaceContainer. Die Farbe von TopAppBar onScroll ist jetzt SurfaceContainer. (I41630)
Die Containerfarbe von ElevatedCard ist jetzt SurfaceContainerLow. FilledCard hat die Containerfarbe SurfaceContainerHighest. (I35141)
Die Containerfarbe von ElevatedButton ist jetzt SurfaceContainerLow. Nicht ausgewählte FilledIconButton haben jetzt die Containerfarbe SurfaceContainerHighest. (I792c9)
Die Rolle der TimePicker-Farbe des Containers und der Zifferblattfarbe der Uhr wird auf SurfaceContainerHighest aktualisiert. (I43b93)

Version 1.3.0-alpha01

21. Februar 2024

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

Neue Funktionen

Aktualisierung von Compose M3 ModalBottomSheet zur Unterstützung der Vorhersagefunktion für Rückwärtssuche bei U+ (Iccf32, b/281967264, b/304850357)
Compose M3 SearchBar wurde aktualisiert, um die intelligente „Zurück“-Geste auf U+ zu unterstützen (I657f8)
Der Schieberegler wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Haltestellenanzeige hinzugefügt. (I3058e)
ProgressIndicator wurde aktualisiert, um die Barrierefreiheit zu verbessern. Dazu wurde eine Lücke und eine Haltestellenanzeige hinzugefügt. (I21451)
Durch das Hinzufügen eines Standard-Cursors für die erweiterte Kurzinfo kann mit der neuen API für erweiterte Kurzinfos jetzt ein benutzerdefinierter Cursor für den Anker LayoutCoordinates gezeichnet werden. (Ifd42c)

Verhaltensänderungen

Materialkomponenten wurden auf die neuen Ripple APIs umgestellt und RippleTheme wird nicht mehr abgefragt.

API-Änderungen

drawStopIndicator ist jetzt öffentlich. (I3f59f)
Markieren Sie die formatWithSkeleton-Funktion der DatePicker als intern (Ic65dc).
DropdownMenu unterstützt jetzt benutzerdefinierte Farbe, Form, Höhe und Rahmen. (I8e981, b/289554448, b/301887035, b/283654243)
Material 3-Komponenten, die in ihrer API ein MutableInteractionSource bereitstellen, wurden aktualisiert. Sie stellen jetzt ein nullables MutableInteractionSource bereit, das standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie die MutableInteractionSource nicht hochladen. Sie wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie zu „null“ wechseln, wird für einige Komponenten nie eine MutableInteractionSource zugewiesen. Andere Komponenten können dann nur bei Bedarf eine Instanz erstellen, was die Leistung dieser Komponenten insgesamt verbessert. Wenn du den MutableInteractionSource, den du an diese Komponenten weitergibst, nicht verwendest, solltest du stattdessen „null“ übergeben. Wir empfehlen Ihnen außerdem, ähnliche Änderungen an Ihren eigenen Komponenten vorzunehmen. (I41abb, b/298048146)
Hiermit werden RippleConfiguration und LocalRippleConfiguration hinzugefügt, um Wellenmuster pro Komponente / untergeordnetem Baum mithilfe fester Werte anzupassen. So können Sie beispielsweise die Farbe einer Komponente ändern, die Sie nicht steuern, oder eine Wellenbewegung für eine Komponente deaktivieren. In den meisten Fällen sollten die Standardwerte verwendet werden. Diese APIs sind eine Notlösung für die Anpassung einzelner Komponenten oder begrenzter untergeordneter Bäume. Bei größeren Änderungen und benutzerdefinierten Designsystemen sollten Sie stattdessen mit createRippleModifierNode eine eigene Welle erstellen. (I7b5d6, b/298048146)
Es wird eine neue Ripple API in material3 hinzugefügt, die die verworfene rememberRipple ersetzt. Außerdem wird eine temporäre CompositionLocal, LocalUseFallbackRippleImplementation hinzugefügt, um Material 3-Komponenten wieder auf die veralteten rememberRipple-/RippleTheme-APIs umzustellen. Diese Funktion wird in der nächsten stabilen Version entfernt. Sie dient nur als vorübergehende Migrationshilfe für Fälle, in denen Sie eine benutzerdefinierte RippleTheme bereitstellen. (I34cbc, b/298048146)

Fehlerkorrekturen

Unterkomposition in ModalBottomSheet entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei dem ModalBottomSheet in bestimmten Szenarien in Kombination mit LookaheadScope abstürzen konnte. (I2a198)
Unterkomposition in BottomSheetScaffold entfernt, um die Leistung zu verbessern. Ein Problem wurde behoben, bei dem BottomSheetScaffold in bestimmten Szenarien in Kombination mit LookaheadScope abstürzte. (Ie6401)
Die Ausrichtung des Logos wird so angepasst, dass es im Vergleich zur rechten oberen Ecke näher an der Mitte des Ankerinhalts liegt. (I18a28)
Behebung eines A11Y-Problems mit der DateRangePicker, bei dem der Texttitel „Monat-Jahr“ für Screenreader, Switch Access und Voice Access-Nutzer als ausführbar übermittelt wurde. (I2ac55)
Fehler bei der Reihenfolge der Parameter mediumTopAppBarColors behoben. (Ibe64a)

Version 1.2

Version 1.2.1

6. März 2024

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

Fehlerkorrekturen

Die Schiebereglerstatus wieder stabil machen State.onValueChangeFinished wird wieder zu einem Wert. onValueChangeFinished in einen rememberUpdatedState einschließen (Ie8fd0, b/322269951)
@Stable wird aus den Status von Slider entfernt, da wir state.onValueChangeFinished in var ändern. (I82ba1, b/322269951)
NavigationBar Benutzerdefinierte Farben, die aus den Standardfarben kopiert werden sollen, korrigieren (80a779, b/326894020)
Regression in ExposedDropdownMenu behoben, damit es wieder fokussiert werden kann (3fcec1, b/323694447)
Problem mit dem Caching der Schaltflächenfarbe behoben (3e5bbc b/327371655)

Version 1.2.0

7. Februar 2024

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

Bekanntes Problem

In PrimaryTabRow wurde im Rahmen einer Leistungsverbesserung ein Fehler beim Interop-Rendering von View-Compose eingeführt. Verwenden Sie als Problemumgehung TabRow mit TabRowDefaults.PrimaryIndicator.

Wichtige Änderungen seit Version 1.1.0

Neue Material Design 3-Komponenten

Zum Aktualisieren nach unten ziehen
- PullToRefreshContainer
- PullToRefreshState
Segmentierte Schaltfläche

Verbesserungen an vorhandenen Material Design 3-Komponenten

Untere App-Leiste (linksläufige Ausrichtung, automatisches Ausblenden beim Scrollen)
- BottomAppBarScrollBehavior
Visuelle Aktualisierung von Tabs
- PrimaryIndicator
- SecondaryIndicator
Logo (Ausrichtung aktualisiert)

Experimentelle APIs wurden zu stabilen APIs aufgewertet.

Leistungsverbesserungen

Weitere Informationen findest du in diesem Blogpost.

Version 1.2.0-rc01

24. Januar 2024

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

Fehlerkorrekturen

Fehler bei der Reihenfolge der Parameter mediumTopAppBarColors behoben. (Ibe64a)
Ein Fehler wurde behoben, der in 1.2.0-beta02 in CardDefaults.cardColors aufgetreten ist und durch den contentColor nicht anhand des containerColor-Param-Werts aktualisiert wurde. (Iee041, b/319671246)
Ein in 1.2.0-beta02 eingeführter Fehler in disabledContentColor wurde behoben und eine kleine Optimierung wurde hinzugefügt. (I6dda1, b/318428829)

Version 1.2.0-beta02

10. Januar 2024

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

Bekannter Fehler

Aufgrund eines Fehlers in IconButtonColors wird disabledContentColor standardmäßig einem Alphawert (0,38f) von LocalContentColor zugewiesen, anstatt dem vom Nutzer angegebenen contentColor. Das Problem lässt sich dadurch umgehen, dass Sie disabledContentColor explizit festlegen. Dieses Problem wird in der nächsten Version behoben.

API-Änderungen

Es ist jetzt möglich, Kursivschrift für Tooltip-APIs zu aktivieren. (Ibf767)
SwipeToDismissState, rememberSwipeToDismiss und SwipeToDismissValue werden in _SwipeToDismissBox_ umbenannt. (I68d6d)

Fehlerkorrekturen

Der Wert für das Ende des ListItem-Abstands wurde an die Spezifikation angepasst. (Ibd68b, b/305342674)
Die Umrissfarbe für Karten mit Umriss wird jetzt korrekt OutlineVariant zugeordnet. (I75480, b/310979715)
Die dynamische Farbe wird jetzt aus systemdefinierten Farbrollen abgerufen. Dadurch wird der Kontrast für barrierefreie Inhalte verbessert und die dynamische Farbe wird besser an die Material-Spezifikation angepasst. (I1de96)
Die ModalBottomSheet-Rückgabe wurde unter Android T/13 und höher korrigiert, wenn android:enableOnBackInvokedCallback="true". (I728dc, b/306196110)

Version 1.2.0-beta01

13. Dezember 2023

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

API-Änderungen

TabIndicatorScope als experimentell markieren (I45c88)
Entfernen von veralteten experimentellen APIs aus der Kurzinfo (I438cb)
Ändern Sie neue TabRow-Überladungen so, dass keine Unterkompositionen verwendet werden. Dadurch können die TabRow-Indikatoren mithilfe von benutzerdefinierten Modifikatoren erstellt werden. (Ife741)
Einstellung der DismissDirection- und DismissValue-APIs Diese wurden zu SwipeToDismissValue zusammengeführt, dessen Werte sowohl die Position als auch die Richtung von SwipeToDismissBox angeben. DismissState.progress ist jetzt als FloatRange zwischen 0.0 und 1.0 markiert. Der verworfene DismissState-Energiesparmodus und ‑Konstruktor wurden entfernt. Die Komponente „SwipeToDismiss“, das Statusobjekt und das Standardobjekt wurden als experimentell gekennzeichnet. (Ib54f2)

Fehlerkorrekturen

Der Standardindikator für PullToRefresh ist jetzt ein offener Pfeil statt eines durchgezogenen Dreiecks. (I67be3)

Version 1.2.0-alpha12

29. November 2023

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

API-Änderungen

Für RangeSlider kann jetzt ein Kotlin-Bereich verwendet werden (z.B. 0f..1f) anstelle einer benutzerdefinierten FloatRange-Wertklasse. Für SnapFlingBehavior.kt wird jetzt auch ein Kotlin-Bereich verwendet. (I025cb)
Markieren Sie die werkseitigen Funktionen für Modifikatoren als @Stable. (Ib109f)

Version 1.2.0-alpha11

15. November 2023

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

Neue Funktionen

Implementiert PullToRefreshContainer und PullToRefreshState, die zusammen eine Pull-to-Refresh-Implementierung in Material3 bieten. (I16456, b/261760718)

API-Änderungen

Markieren Sie SwipeToDismissBox, DismissDirection und DismissValue als experimentell. (I517b0)
Benennen Sie SwipeToDismiss in SwipeToDismissBox um. Benennen Sie background in backgroundContent und dismissContent in content lambda um. (I7f4d3)
Machen Sie den Konstruktor für ChipElevation und SelectableChipElevation öffentlich. (Ie0c48, b/308432421)
ModalBottomSheetProperties wird hinzugefügt. securePolicy wird in ModalBottomSheetProperties verschoben. isFocusable und shouldDismissOnBackPress werden zu ModalBottomSheetProperties hinzugefügt. Mit diesen neuen Booleschen Werten lässt sich festlegen, wie modale Unterbrechungen IME-Ereignisse verarbeiten sollen. (Iea56f, b/278216859)
Die Status RangeSlider und Slider wurden aktualisiert, um initialOnValueChange, die ursprünglichen Präfixe und die entsprechenden KDocs zu entfernen. (I57d30)
Die Klasse ChipBorder und die zugehörigen Funktionsaufrufe werden eingestellt. Wir empfehlen stattdessen, BorderStroke direkt zu verwenden. (I89cc2)
Die Foundation Tooltip APIs sind jetzt @ExperimentalFoundationApi. (I30b0b)
TabRow und ScrollableTabRow sind nicht mehr eingestellt. Die neuen primären und sekundären Varianten sind als experimentell gekennzeichnet. (I0def6)
Filter- und Eingabe-Chips verwenden jetzt direkt BorderStroke. (I07a8d)
SegmentedButton verwendet jetzt BorderStroke direkt. (I89b9b)
Die generische Funktion AlertDialog wurde in BasicAlertDialog umbenannt und die vorherige Funktion eingestellt. (Idbe52)
Benenne die SwipeToDismiss-APIs in SwipeDismiss um und setze die neuen SwipeDismiss-APIs auf „stabil“. (I14cbe)
tonalElevation und shadowElevation wurden den API-Tooltips hinzugefügt. Außerdem wurden die APIs TooltipBox, PlainTooltip und RichTooltip wieder in den experimentellen Status versetzt, da sie versehentlich als stabil veröffentlicht wurden. (If0f66, b/293939035)
Die experimentellen Chip-APIs werden zu stabilen APIs. (Iea2c3)
Die Anmerkung @ExperimentalMaterial3Api wurde aus den anklickbaren Karten in Material 3 entfernt. (I88dbf)

Fehlerkorrekturen

Ein Problem wurde behoben, durch das SwipeToDismiss in bestimmten Szenarien mit verschachtelten Lookahead- und Lazy-Layouts abstürzte. (Ica8d1, b/297226562)

Version 1.2.0-alpha10

18. Oktober 2023

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

API-Änderungen

Badge und BadgedBox werden zur stabilen Version hochgestuft. (I67f16, b/261565132)
securePolicy wird als Parameter zu ModalBottomSheet hinzugefügt, damit Nutzer das Verhalten für WindowManager.LayoutParams.FLAG_SECURE definieren können. (Icdac8, b/296250262)
Es wurden neue Überladungen von LinearProgressIndicator und CircularProgressIndicator hinzugefügt, die progress als Lambda-Funktion annehmen. Diese sollten eine bessere Leistung als die vorherigen Versionen bieten. (I824e6, b/295616656)
StandardSizeClasses wird in AllSizeClasses umbenannt. (I8cb07)
Berechnungsfunktionen von Klassen für Fenstergrößen kombinieren (Iad935)

Fehlerkorrekturen

Behebung eines Absturzes von DatePicker, wenn schnell auf die Navigationspfeile geklickt wird, während der angezeigte Monat am Rand des zulässigen Jahresbereichs liegt. (I46f36, b/290954897, b/297002119)
[Navigationsleiste] Unterstützung für transparente Farbe für den Indikator. (Ie0a9b, b/267289987)

Version 1.2.0-alpha09

4. Oktober 2023

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

API-Änderungen

ModalNavigationDrawer und DismissibleNavigationDrawer wurden auf die neuen AnchoredDraggable APIs umgestellt. Das animateTo von DrawerState wurde durch die Methoden „open“ und „close“ ersetzt und der Offset wird jetzt als Float statt als Statusobjekt angezeigt. Sie können direkt über currentOffset auf den Versatz zugreifen. (I0a72c)
Es wurden nicht zusammensetzbare Funktionen hinzugefügt, mit denen DatePickerState und DateRangePickerState direkt erstellt werden können. Diese Funktionen können bei Bedarf als Alternative zu den zusammensetzbaren Funktionen rememberDatePickerState und rememberDateRangePickerState verwendet werden. (I70326, b/291524052)
Für feste und scrollbare TabRows gibt es jetzt primäre und sekundäre Varianten. Sie entsprechen dem in Material3 definierten Farb- und Indikatorverhalten.
PrimaryScrollableTabRow und SecondaryScrollableTabRow geben jetzt den Scrollstatus an. (Iec8f5, b/260572337)
Es wurde ein neuer Parameter sheetMaxWidth hinzugefügt, mit dem Entwickler die maximale Breite des Tabellenblatts festlegen können. Wenn Sie ein Tabellenblatt benötigen, das die gesamte Bildschirmbreite einnimmt, können Sie „Dp.Unspecified“ für den Parameter übergeben. (Ifb7c9, b/266697696)
Die APIs PlainTooltipBox und RichTooltipBox werden als verworfene Methoden wieder hinzugefügt. (I246fa)

Fehlerkorrekturen

Ein Absturz wurde behoben, der beim Initialisieren von DatePicker mit einer DatePickerFormatter aufgetreten ist, die bestimmte Datums-Grundmuster enthält, die bei der Umwandlung in Datumsmuster (z. B. JJ) unverändert bleiben. (I01f29)

Version 1.2.0-alpha08

20. September 2023

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

Funktionsgefährdende Änderung

ColorScheme ist jetzt unveränderlich. Das macht einzelne Farbaktualisierungen weniger effizient, aber die gängige Verwendung von Farben effizienter. Der Grund für diese Änderung ist, dass das Aktualisieren einzelner Farben in der Mehrzahl der Apps nicht der Hauptanwendungsfall ist. Das ist weiterhin möglich, aber es wird häufiger neu zusammengesetzt als zuvor. Dadurch reduzieren wir die Anzahl der Statusabonnements im gesamten Material-Code erheblich und wirken sich auf die Initialisierungs- und Laufzeitkosten bei Standardanwendungsfällen aus. (Ic447d, b/297212873)
Die Tonhöhenänderung wird nicht mehr in verschiedenen Interaktionsstatus animiert, um der Spezifikation zu entsprechen. (Icdd12)

API-Änderungen

Es wurde eine neue BottomAppBar hinzugefügt, die als Parameter eine BottomAppBarScrollBehavior annimmt, um sie automatisch auszublenden, wenn Inhalte gescrollt werden. Außerdem wurde FabPosition.EndOverlay hinzugefügt, damit das FAB die untere App-Leiste im Scaffold überlagern kann, anstatt darüber verankert zu sein. (Iecb47)
Es wurde eine einfache Labelkomponente hinzugefügt, die auf BasicTooltipBox basiert und nicht geschlossen wird, wenn außerhalb des Labels getippt wird. (I821f9)

Fehlerkorrekturen

Die Verwendung von rememberSaveable für Kurzinfos wurde entfernt. (Icc131, b/299500338)
Einführung eines temporären Flags, mit dem festgelegt werden kann, ob die untergeordneten Elemente von Scaffold während der Messung oder während der Platzierung gemessen werden sollen. Standardmäßig wird dies in „Messung“ gemessen. Wenn Sie Probleme mit dem neuen Verhalten haben, reichen Sie bitte ein Problem ein. (I0b354)
In BottomSheet wurde das horizontale Vollbild durch die Verwendung der richtigen Maße für die Gerätebildschirmbreite korrigiert. (I1df0c, b/299058752)
Ein Fehler wurde behoben, durch den ModalBottomSheet nicht aufgerufen wurde, wenn onDismissedRequest durch Wischen nach unten auf dem Tabellenblatt geschlossen wurde. (Idfdd8)

Version 1.2.0-alpha07

6. September 2023

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

Neue Funktionen

In compose material 1.6.0-alpha05 wurde die Unterstützung für automatisch gespiegelte Symbole hinzugefügt. Weitere Informationen finden Sie in den Release-Notes.

API-Änderungen

SliderState implementiert DraggableState (I9b116)
Ändern Sie „shape“ in einen erforderlichen Parameter. Benennen Sie position in der Hilfsfunktion für Formen in index um. (I34941)
Die DatePicker formatWithSkeleton wird um eine Karte aktualisiert, die als Cache für Leistungsverbesserungen verwendet wird. (I3195f)
BasicTooltipBox wurde zu compose.foundation hinzugefügt und PlainTooltipBox und RichTooltipBox wurden aktualisiert, damit TooltipBox mit den neuen PlainTooltip- und RichTooltip-Kompositen verwendet werden kann. (I79e1d)

Fehlerkorrekturen

dynamicLightColorScheme und dynamicDarkColorScheme geben jetzt für Oberflächen- und surfaceContainer-Rollen Farben mit höherer Chroma zurück. (I5e901)
Ein Problem wurde behoben, bei dem einige Komponenten mit einer untergeordneten Komposition (z.B. BottomSheetScaffold) in einem Scaffold in einem LookaheadScope versuchten, ihre Größe zu früh zu lesen. (I297b4, I871f1, b/295536718)

Version 1.2.0-alpha06

23. August 2023

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

Fehlerkorrekturen

Die Berechnung von DropdownMenu wurde korrigiert, sodass die X-Achsenverschiebungen nur noch von der lokalen Layoutrichtung abhängen. Die Y-Achsenverschiebungen werden nicht mehr umgekehrt, wenn sich das Menü unten auf dem Bildschirm befindet.offset (Iccc74, b/294103942)
Die Berechnung von DropdownMenu wurde korrigiert, sodass die X-Achsenverschiebungen nur von der lokalen Layoutrichtung abhängen. Die Y-Achsenverschiebungen werden nicht mehr umgekehrt, wenn sich das Menü unten auf dem Bildschirm befindet.offset (Ib87a2, b/294103942)

Version 1.2.0-alpha05

9. August 2023

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

API-Änderungen

Aktualisierte Farben für Kästchen und TriStateCheckbox Die CheckboxDefaults.colors() disabledUncheckedColor wirkt sich jetzt nur noch auf den Rahmen des Kästchens aus. In Sonderfällen, in denen die Farbe des inneren Felds festgelegt werden muss, wenn es deaktiviert und nicht angeklickt ist, ist eine benutzerdefinierte Instanz von CheckboxColors mit den gewünschten Farbwerten erforderlich. (I77d17, b/291943198)

Version 1.2.0-alpha04

26. Juli 2023

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

Neue Funktionen

Experimentelle Segmented Button API (Ifc8fb)
Trennlinien haben jetzt einen Parameter, mit dem die Ausrichtung gesteuert werden kann, um vertikale Trennlinien zu unterstützen. (I4c899, b/288438593)

API-Änderungen

Wir verlagern die Abhängigkeit von der Dichte auf Komponentenebene. Dies gilt für die folgenden Komponenten: SwipeToDismiss und tabellenbasierte Komponenten. Verwenden Sie die neue Überladung, bei der die Dichte ein Parameter ist. (I1846e)
Zusätzliche Anmerkungen, um zulässige Eingaben für Composeables anzugeben (Ief234)
Fügen Sie der segmentierten Schaltfläche einen Symbolparameter hinzu und teilen Sie die Semantik auf, damit segmentierte Schaltflächen mit SelectableSegmentedButtonRow bzw. ToggelableSegmentedButtonRow ausgewählt werden können, um eine Einzelauswahl bzw. eine Mehrfachauswahl zu implementieren. (I38740)
Die Trennlinie wurde in HorizontalDivider umbenannt. VerticalDivider-Funktionen hinzugefügt (I5975c)
Ersetzen Sie in den experimentellen Material3 APIs ClosedFloatingPointRange durch das leichtere FloatRange, um das automatische Boxen zu minimieren. (I4aab5)
Neue Startausrichtung für FabPosition hinzugefügt (Ib7aea, b/170592777)

Fehlerkorrekturen

ModalBottomSheet berücksichtigt die lokale Layoutrichtung. (Ib4f44, b/285628622)

Version 1.2.0-alpha03

21. Juni 2023

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

Verhaltensänderungen

includeFontPadding ist in der Material 3-Typografie jetzt standardmäßig false. Der Standardstil für die Zeilenhöhe wurde ebenfalls in Trim.None und Alignment.Center geändert. Den TextStyles von Typography wurden explizite lineHeight (in sp) hinzugefügt. Wenn du diese Werte anpassen möchtest, findest du in der API-Dokumentation entsprechende Informationen. Im Blogpost werden diese Änderungen ausführlich erläutert. (I6266f, Icabc3)

Neue Funktionen

Es wurde eine Überladung für RangeSlider hinzugefügt, die eine zustandsabhängige Version der Komponente ist. RangeSliderState erstellt, die alle Informationen für den aktuellen aktiven Titel, die Messungen der Komponenten der RangeSlider und die Logik für Ziehen und Gesten enthält (I8c270)
Die Suchleiste unterstützt jetzt Schatten über den neu hinzugefügten Parameter shadowElevation. (Ia5369, b/271040353)
ColorScheme unterstützt jetzt neue SurfaceContainer-Rollen.
Das Overlay für die Oberflächenhöhe kann jetzt lokal in der Komposition LocalTonalElevationEnabled deaktiviert werden. (Ic203c, b/277774590)

API-Änderungen

Öffnen Sie die Konstruktoren für Komponentenfarben. (I8c4a6)
Den beiden Tooltip-APIs wurde der Parameter „focusable“ hinzugefügt, damit Entwickler festlegen können, ob Touch-Ereignisse vom Tooltip verarbeitet werden sollen oder nicht. Beachten Sie, dass dies die automatische Fokusübergabe für Barrierefreiheit beeinträchtigen kann. (Ie32d8)
Optimierte Zugänglichkeit für Leistung und Speicherzuweisungen. (Iede48)
DefaultSizeClasses freigeben und StandardSizeClasses für WindowSizeClasses erstellen (I91838)
WindowWidth/HeightSizeClass in Gleitkommawertklassen ändern (Ie686e)

Fehlerkorrekturen

Der Parameter contentWindowInsets von Scaffold berücksichtigt jetzt die genutzten Fensterausschnitte. Das Verhalten des Inhaltsabstands, der auf topBar und bottomBar basiert, bleibt unverändert, wenn diese Parameter angegeben werden. (I08b73, b/264601542)
Richten Sie die obere App-Leiste in der Mitte aus, damit ein langer Titel nicht über den Aktionssymbolen oder dem Navigationssymbol dargestellt wird. (I4369f, b/236994621)
Für Tab-Positionen gilt jetzt eine Mindestinhaltsbreite von 24 dp. Dadurch wird ein barrierefreies Touch-Ziel für Tab-Indikatoren bereitgestellt. (Id8861)
Dynamische Farbpaletten von dynamicLightColorScheme und dynamicDarkColorScheme unterstützen jetzt neue Oberflächenrollen. (I1252e)
Die Ausrichtung der Benachrichtigungssymbole wurde aktualisiert, damit sie nicht abgeschnitten werden, wenn sie mit dem übergeordneten Element kollidieren. (Idf75a)

Version 1.2.0-alpha02

24. Mai 2023

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

API-Änderungen

Fügen Sie ModalBottomSheet den Parameter „Fenster-Einzüge“ hinzu.
- Der Scrim für ModalBottomSheet kann jetzt hinter der Statusleiste gezeichnet werden, wenn windowInsets auf null gesetzt ist.
- Die Standardfunktion von ModalBottomSheet wurde aktualisiert, damit sie außerhalb der Systemleisten bleibt, einschließlich der Navigation.
- Die Statusleiste kann im Vollbildmodus über einen Ziehpunkt minimiert werden.
- BottomSheetDefaults enthält Fenstereinzüge für BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
Indicator wird eingestellt und Primary/SecondaryIndicator wird hinzugefügt, um den M3-Spezifikationen zu entsprechen. PrimaryIndicator entspricht der Breite des Inhalts des Tabs, während SecondaryIndicator die gesamte verfügbare Breite einnimmt. SecondaryIndicator entspricht der jetzt eingestellten Indicator und kann ein direkter Ersatz sein. (I27604)
Es wurde eine Option hinzugefügt, mit der beim Erstellen einer DropdownMenu oder ExposedDropdownMenu eine ScrollState übergeben werden kann, um den vertikalen Scrollstatus der angezeigten Menüpunkte zu steuern. (Ia0734, b/185304441)
Es wurde eine Überladung für Slider hinzugefügt, die eine zustandsabhängige Version der Komponente ist. SliderState erstellt, die alle Informationen für den aktuellen aktiven Titel, die Messungen der Komponenten der Slider und die Logik für Ziehen und Gesten enthält (I124a5)
Die Eigenschaft „Semantik“ isContainer in isTraversalGroup umbenannt (I121f6)
Optimierte TextStyle.merge(...) mit vollständiger Parameterliste hinzugefügt. (Iad234, b/246961787)
TooltipState, RichTooltipState und PlainTooltipState wurden zu öffentlichen Schnittstellen. RichTooltipStateImpl und PlainTooltipStateImpl wurden als Standardstatus hinzugefügt. Es wurden remember*State-Funktionen hinzugefügt, um diese implementierten Status abzurufen. TooltipSync wurde durch TooltipDefault.GlobalMutatorMutex ersetzt. (I7813d)
Die DatePickerColors wurde um zusätzliche Anpassungsoptionen für die Farben der Trennlinie, Navigation und Textfelder der Datumsauswahl erweitert. (I1a685, b/274626815)
DatePickerState und DateRangePickerState sind jetzt öffentliche Schnittstellen mit Standardimplementierungen, die über rememberDatePickerState und rememberDateRangePickerState abgerufen werden können. (I71c52)
Die dateValidator wurde aus DatePicker und DateRangePicker entfernt und durch eine SelectableDates-Benutzeroberfläche ersetzt, die für den Status festgelegt werden kann, um festzulegen, welche Datumsangaben oder Jahre in der Benutzeroberfläche ausgewählt werden können. (Ic2fc6)
TimePicker wurde aus der stabilen API entfernt. Weitere Änderungen an der Status-API sind zu erwarten (I3f39a)
ModalBottomSheet wurde auf Android umgestellt. ModalBottomSheet wird für die Nutzung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv gepflegt. (Ib3778)

Fehlerkorrekturen

Die AlertDialog-Schaltfläche zum Schließen wird jetzt unter der Bestätigungsschaltfläche angezeigt, wenn die Aktionen übereinander gestapelt werden, um in die Breite des Dialogfelds zu passen. Durch diese Korrektur wird die Implementierung an die Material Design-Spezifikation angepasst. (I029de, b/235454277)
Fehler in ListItem behoben, bei dem für Elemente mit drei Zeilen ein falsches Abstandselement verwendet wurde. (I6e235)
ModalBottomSheet kann jetzt die IME-Tastatur anzeigen (Idc508, b/262140644, b/268380384, b/272483584)

Version 1.2.0-alpha01

10. Mai 2023

androidx.compose.material3:material3:1.2.0-alpha01 und androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 werden freigegeben. Version 1.2.0-alpha01 enthält diese Commits.

Version 1.1

Version 1.1.2

20. September 2023

androidx.compose.material3:material3:1.1.2 und androidx.compose.material3:material3-window-size-class:1.1.2 werden freigegeben. Version 1.1.2 enthält diese Commits.

Fehlerkorrekturen

Der Fehler wurde behoben, dass ein Modifikator fälschlicherweise an zwei Elemente übergeben wurde. (b/282761472)
Bei der Initialisierung mit 23 Stunden gibt die feste TimePickerState falsche Stunden zurück. (b/278242122)
Der anfängliche Ein-/Aus-Status für die Validierung von Mittag und Minute wurde korrigiert. (b/269768197, b/282790635)
Fehler behoben, durch den state.hour für 23:00 Uhr einen falschen Wert zurückgab. (b/282761472, b/278242122)

Version 1.1.1

21. Juni 2023

androidx.compose.material3:material3:1.1.1 und androidx.compose.material3:material3-window-size-class:1.1.1 werden freigegeben. Version 1.1.1 enthält diese Commits.

Fehlerkorrekturen

Ruft ModalBottomSheet ohne windowInset-Parameter für die Binärkompatibilität auf. (Ib7959)
Fügen Sie ModalBottomSheet den Parameter „Fenster-Einzüge“ hinzu.
- Der Scrim für ModalBottomSheet kann jetzt hinter der Statusleiste gezeichnet werden, wenn windowInsets auf null gesetzt ist.
- Die Standardfunktion von ModalBottomSheet wurde aktualisiert, damit sie außerhalb der Systemleisten bleibt, einschließlich der Navigation.
- Die Statusleiste kann im Vollbildmodus über einen Ziehpunkt minimiert werden.
- BottomSheetDefaults enthält Fenstereinzüge für BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)

Version 1.1.0

10. Mai 2023

androidx.compose.material3:material3:1.1.0 und androidx.compose.material3:material3-window-size-class:1.1.0 werden freigegeben. Version 1.1.0 enthält diese Commits.

Wichtige Funktionen von 1.1.0

Neue Material Design 3-Komponenten

Verbesserungen an vorhandenen Material Design 3-Komponenten

Die experimentellen APIs wurden zu stabilen APIs aufgewertet.

Weitere Informationen findest du in diesem Blogpost.

Version 1.1.0-rc01

19. April 2023

androidx.compose.material3:material3:1.1.0-rc01 und androidx.compose.material3:material3-window-size-class:1.1.0-rc01 werden freigegeben. Version 1.1.0-rc01 enthält diese Commits.

API-Änderungen

TimePicker wurde aus der stabilen API entfernt. Weitere Änderungen an der Status-API sind zu erwarten (I3f39a)
ModalBottomSheet wurde auf Android umgestellt. ModalBottomSheet wird für die Nutzung auf dem Computer nicht empfohlen und die Funktion wird nicht aktiv gepflegt. (Ib3778)

Version 1.1.0-beta02

5. April 2023

androidx.compose.material3:material3:1.1.0-beta02 und androidx.compose.material3:material3-window-size-class:1.1.0-beta02 werden freigegeben. Version 1.1.0-beta02 enthält diese Commits.

API-Änderungen

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

Fehlerkorrekturen

Wechseln Sie das Zifferblatt nicht von den Stunden zu den Minuten, wenn die Funktion „Tippen & Entdecken“ aktiviert ist. (I717d0)
Die Drag-Handle-Semantik von ModalBottomSheet und BottomSheetScaffold wurde zusammengeführt. (I05afb)
Die Parameter BottomSheetScaffold-Modifikator, containerColor und contentColor wirken sich jetzt nur noch auf Inhalte aus. (I992cb)
Für BottomSheetScaffold nestedScroll für Tabelleninhalte werden jetzt Wischaktionen implementiert. (I992cb)

Version 1.1.0-beta01

22. März 2023

androidx.compose.material3:material3:1.1.0-beta01 und androidx.compose.material3:material3-window-size-class:1.1.0-beta01 werden freigegeben. Version 1.1.0-beta01 enthält diese Commits.

API-Änderungen

Dem TimePicker-Kompositelement den Parameter „Layouttyp“ hinzufügen Es ermöglicht die Verwendung verschiedener Layouts je nach Bildschirmkonfiguration (Ia0e16)
SearchBarDefaults wurde als experimentell gekennzeichnet. (I65561)
Schattenhöhe für BottomSheetScaffold (I94e0f) hinzugefügt
Unterstützung für die Anzeige der Datumsauswahl ohne Kopfzeile hinzugefügt API-Änderungen, durch die beim Erstellen einer Datumsauswahl eine leere Überschrift übergeben werden kann. Sie können jetzt „null“ für Anzeigentitel, Titel und showToggleMode = false übergeben, um eine headless-Auswahl anzuzeigen. (Id3f3a, b/266132421, b/267194809)

Fehlerkorrekturen

Der Fokus wird bei Suchleisten jetzt automatisch aufgehoben, wenn sie inaktiv sind. (I22a7c, b/261444487)
Die DateRangePicker wurde aktualisiert, sodass ein Zeitraum mit demselben Datum für Start und Ende ausgewählt werden kann. (I16529, b/272882497)
In Textfeldern werden Textelemente jetzt richtig positioniert, wenn die Schriftgröße kleiner als erwartet ist. Je nach Schriftart und Schriftschnitt kann dies zu einer Änderung von einigen Pixeln in Ihren Apps führen. (I8b8d0)
Semantische Aktionen im Infobereich haben jetzt Labels. (I277b0)

Version 1.1.0-alpha08

8. März 2023

androidx.compose.material3:material3:1.1.0-alpha08 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 werden freigegeben. Version 1.1.0-alpha08 enthält diese Commits.

Neue Funktionen

Unterstützung für BottomSheetScaffold und BottomSheetScaffoldState hinzugefügt. (I063d4)

API-Änderungen

Die Funktionen von DatePickerState und DateRangePickerState wurden erweitert, damit Datumsangaben auch nach dem Erstellen des Status festgelegt werden können. Außerdem können Auswahlen durch Festlegen von Nullzeitstempeln zurückgesetzt werden. Das manuelle Festlegen von Datumsangaben sollte mit Vorsicht erfolgen. Die neue Funktion setSelection wirft eine Ausnahme aus, wenn ein angegebenes Datum nicht die Vorbedingungen erfüllt (siehe Dokumentation). (Ifa645, b/268609314, b/270427389)
Benennen Sie „Zusammengefaltet“ SheetValue in PartiallyExpanded um, um das Verhalten in diesem Status genauer und flexibler darzustellen. (Ia1491)
Die Parameternamen von ListItem wurden in _content statt _text geändert. Standard-Getter sind jetzt ReadOnlyComposables, sofern zutreffend. (I69a25)
Interaktive Surface APIs werden nicht mehr als experimentell eingestuft. (I90d59, b/261561812)

Fehlerkorrekturen

Ein Problem wurde behoben, bei dem der Status HalfExpanded von ModalBottomSheet falsch berechnet wurde und das Tabellenblatt so erschien, als würde es schweben. (I45e84, b/268411386)
Füge ein Häkchen für confirmValueChange zum Tippen auf den Scribble für ModalBottomSheet hinzu. (I2311a, b/270425759)
Verschieben Sie semantische BottomSheet-Aktionen zum Ziehpunkt. (I158ba)
ModalBottomSheet-Befehle konzentrieren sich jetzt auf die Ausführung und verarbeiten die Zurück-Schaltfläche. (I4d2ab)
ModalBottomSheet onDismissRequest wird jetzt auch bei verschachtelten Scroll-Wischaktionen verarbeitet. (I655c5, b/268433166)

Version 1.1.0-alpha07

22. Februar 2023

androidx.compose.material3:material3:1.1.0-alpha07 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 werden freigegeben. Version 1.1.0-alpha07 enthält diese Commits.

Neue Funktionen

Fügen Sie ein Zeiteingabe-Composeable hinzu, das mit rememberTimePickerState() funktioniert und der M3-Spezifikation für die Zeiteingabe (Ia4fab) entspricht.
Die Material 3 DateRangePicker API wurde hinzugefügt, um einen Zeitraum auszuwählen. (I7a6c3, b/267194809)
Unterstützung für den Material 3-Eingabemodus zur Auswahl von Zeitraum über die DateRangePicker API hinzugefügt. (Ifdbc4)
Die Farben von Textfeldern können jetzt angepasst werden:
- Die Farben des Eingabefelds und des Platzhaltertexts richten sich nach dem Fokus und dem Fehlerstatus. Der Parameter textColor wurde in unfocusedTextColor umbenannt und placeholderColor in unfocusedPlaceholderColor.
- Die Containerfarbe für ausgefüllte Textfelder basierend auf dem Fehlerstatus mit dem neuen Parameter errorContainerColor.
Die Textfeldfarben der angezeigten Drop-down-Menüs wurden um Parameter zur Unterstützung der neuen Prefix- und Suffix-API aktualisiert. (I9c8b4, b/254284181, b/264766350)

API-Änderungen

Einige Slider API-Versionen wurden rückgängig gemacht und redundante Slider-Überladungen entfernt, die vom neuen experimentellen Slider mit benutzerdefiniertem Schieberegler und Track abgedeckt werden. RangeSlider wird als stabil eingestuft. (Ie8fbd)
defaultElevation wurde in den Höhenfunktionen des Chips in elevation umbenannt. (I0f872)
Die folgenden APIs für Material 3-Textfelder sind nicht mehr experimentell: TextField, OutlinedTextField, textFieldWithLabelPadding, textFieldWithoutLabelPadding und outlinedTextFieldPadding. (Ieb5c0, b/261561819)
TimePickers is24Hour verwendet die Systemeinstellung (I18856)
Die experimentelle Anmerkung wurde aus den Scaffold-APIs entfernt. (Ibb51e, b/261565765, b/261436953)

Fehlerkorrekturen

Die Standardform von ModalBottomSheet ist jetzt immer SheetDefaults.ExpandedShape. (I0dfca)
Verbesserungen bei der Barrierefreiheit für Material 3 DatePicker und DateRangePicker (I5087e)
Fehler behoben, durch den die Einschränkung der maximalen Höhe weitergegeben wurde und es zu Abstürzen kommen konnte. (I30d8c)
Semantische Rollen wurden von anklickbaren und auswählbaren Oberflächen entfernt. Komponenten, in denen sie verwendet wurden, um Rollen mit „modifier.semantics“ festzulegen, wurden aktualisiert (I793d9)

Version 1.1.0-alpha06

8. Februar 2023

androidx.compose.material3:material3:1.1.0-alpha06 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 werden freigegeben. Version 1.1.0-alpha06 enthält diese Commits.

Neue Funktionen

Textfelder unterstützen jetzt Präfix- und Suffixtext (Ia8578, b/179884561)
Die Funktion TimePicker wurde hinzugefügt, um eine Zeitauswahl gemäß der Material 3-Spezifikation anzuzeigen. Sie wird in Verbindung mit TimePickerState und der Convenience-Methode rememberTimePickerState verwendet (I71910)
Die Datumseingabe ist jetzt ein Anzeigemodus in DatePicker. Es wurde die Möglichkeit hinzugefügt, zwischen Datumsauswahl und Datumseingabe zu wechseln. (Ieeff7)
API für RichTextTooltips hinzugefügt. (I58ef3)
Implementierung eines modalen Blatts am unteren Rand für Material 3, einschließlich ModalBottomSheet und ModalBottomSheetDefaults. Außerdem werden SheetState und rememberSheetState eingeführt, die für zukünftige Tabellenkomponenten verwendet werden können. (I0853a, b/244189383)

API-Änderungen

Stabilisierung der API showSnackbar (I195c2, b/261424370)
APIs für Assistenz- und Vorschlagschip stabilisieren (Ibb67b, b/261424370)
Die ListItem-, ListItemDefaults- und ListItemColors-API werden nicht mehr als experimentell eingestuft (I7e7fa, b/261438882)
SliderPositions, SliderDefaults.Thumb und SliderDefaults.Track wurden zur stabilen Version hochgestuft und es wurden nicht experimentelle Slider- und RangeSlider-APIs hinzugefügt, die benutzerdefinierte Vorschaubilder und Tracks enthalten. Außerdem werden die bisherigen APIs Slider und RangeSlider eingestellt. (Ie5ea6, b/261566890)
Modifier.tooltipAnchor() wurde öffentlich gemacht, damit Entwickler es an den Anker übergeben können, um anzugeben, dass eine Kurzinfo bei langem Drücken angezeigt werden soll. Die PlainTooltipBox API wurde aktualisiert, sodass TooltipState nicht mehr null sein kann und jetzt einen Standardwert hat. (Ie2fb7)
ProgressIndicatorDefaults.circularTrackColor wurde aus Gründen der Einheitlichkeit als @Composable markiert. (Id29cc)
Property-Getter LocalMinimuTouchTargetEnforcement wiederhergestellt, als eingestellt markiert und auf LocalMinimumInteractiveComponentEnforcement umgeleitet (I60dd5)

Version 1.1.0-alpha05

26. Januar 2023

androidx.compose.material3:material3:1.1.0-alpha05 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 werden freigegeben. Version 1.1.0-alpha05 enthält diese Commits.

Neue Funktionen

DatePickerDialog und Support für Bedienungshilfen
Benutzerdefiniertes Vorschaubild und Track zu RangeSlider hinzugefügt.

Abhängigkeitsupdates

Compose UI und Compose Material sind jetzt von Lifecycle 2.6.0 abhängig.

Version 1.1.0-alpha04

11. Januar 2023

androidx.compose.material3:material3:1.1.0-alpha04 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 werden freigegeben. Version 1.1.0-alpha04 enthält diese Commits.

Neue Funktionen

Erste DatePicker API zur Auswahl eines einzelnen Datums über eine Kalender-Benutzeroberfläche. Diese API wird derzeit noch geändert. (I722b9)
Unterstützung für einfache Kurzinfos über PlainTooltipBox hinzugefügt. (I0cdfb)
Suchleiste (Iad128)
SwipeToDismiss (I458a8, b/242889540)

API-Änderungen

Die IsContainer-Semantik-Property wurde auf Oberflächen hinzugefügt. Diese Property wird bei einer späteren Änderung verwendet, bei der die Durchlaufreihenfolge basierend auf der semantischen Bedeutung von Elementen wie Oberflächen bestimmt wird. (I63379)
Markieren Sie APIs für die Navigationsleiste als stabil. (Iab01e, b/261439597)
Es wurde ein Parameter für die Farbe des Tracks für kreisförmige Fortschrittsanzeigen und ein Parameter für den Endpunkt des Strichs für kreisförmige und lineare Fortschrittsanzeigen hinzugefügt. (Ie668c, b/216325962, b/222964817)
Mehr Informationen zur Nullbarkeit des Rückgabetyps von eingestellten und ausgeblendeten Funktionen (Ibf7b0)
Fügen Sie Modifier.minimumInteractiveComponentSize hinzu. Damit kann eine Größe von mindestens 48 dp reserviert werden, um Touch-Interaktionen zu unterscheiden, wenn das Element kleiner wäre. (I33f58, b/258495559)
Es wurde eine experimentelle API für AlertDialog-Kompositionen mit einem Inhalts-Slot hinzugefügt. (Iec4a2)

Fehlerkorrekturen

Der Fortschritt der Fortschrittsanzeige ist jetzt korrekt auf den erwarteten Bereich begrenzt. (I8a7eb, b/262262727)

Bekanntes Problem

Beim Aktualisieren von androidx.compose.foundation:1.4.0-alpha03 auf androidx.compose.foundation:1.4.0-alpha04 kann der Fehler java.lang.NoSuchFieldError auftreten. Hier wurde das Problem ursprünglich gemeldet. Eine Lösung wurde eingereicht und ist im nächsten Update für Compose verfügbar. Als Behelfslösung können Sie Ihre androidx.compose.material- und androidx.compose.material3-Bibliotheken auf die neueste Version(1.1.0-alpha04) aktualisieren oder Ihre androidx.compose.foundation auf 1.4.0-alpha03 downgraden.

Version 1.1.0-alpha03

7. Dezember 2022

androidx.compose.material3:material3:1.1.0-alpha03 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 werden freigegeben. Version 1.1.0-alpha03 enthält diese Commits.

API-Änderungen

consumedWindowInsets() wurde in consumeWindowInsets() und withConsumedWindowInsets() in onConsumedWindowInsetsChanged() umbenannt und die Modifikatoren wurden veröffentlicht. (Ie44e1)
Fügen Sie Textschaltflächen mit Symbolen ein neues Standardabstand für den Inhalt hinzu. (I8f662)
Es wurden deaktivierte Farben für die Navigationsleiste und den Navigationspfad hinzugefügt. (Ia7892, b/258867034)
Eine Modifier API zum Abfragen von Informationen zum Scrollen von Vorfahren hinzugefügt. (I2ba9d, b/203141462)
Wird in Clickable verwendet, um die Interaktionen mit dem Drücken richtig zu verzögern, wenn Touch-Gesten zu Scrollereignissen werden könnten.
Bei Verwendung in einem Scrollable ViewGroup wurden bei Clickables keine korrekten Verzögerungen für Wellen erzeugt. Dieses Problem wurde behoben.
In Ausklappern und Ansichten werden Tastendrücke jetzt korrekt verzögert, falls Touch-Gesten zu Scrollereignissen führen können.

Abhängigkeitsupdates

Compose UI und Compose Material sind jetzt vom Lebenszyklus 2.5.1 abhängig. (I05ab0, b/258038814)

Version 1.1.0-alpha02

9. November 2022

androidx.compose.material3:material3:1.1.0-alpha02 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 werden freigegeben. Version 1.1.0-alpha02 enthält diese Commits.

API-Änderungen

Für awaitFirstDown und waitForUpOrCancellation kann jetzt auch PointerEventPass verwendet werden, um mehr Flexibilität zu ermöglichen. Außerdem wird dadurch behoben, dass bei ExposedDropdownMenuBox beim Scrollen ein Menü angezeigt wird. (I7579a, b/212091796)
Dem Material- und Material3-Text wurden die Parameter minLines, TextField und OutlinedTextField hinzugefügt, mit denen die minimale Höhe der Komponente in Bezug auf die Anzahl der Zeilen festgelegt werden kann (I4af1d)
Die Funktion TopAppBarDefaults smallTopAppBarColors wird zugunsten einer neuen Funktion topAppBarColors eingestellt, die beim Erstellen einer TopAppBar verwendet werden sollte. (Ie6cb9)
Den Parametern BasicText und BasicTextField wurde der Parameter minLines hinzugefügt. Damit lässt sich die Mindesthöhe dieser Composeables in Bezug auf die Anzahl der Zeilen festlegen (I24294, b/122476634)

Fehlerkorrekturen

Schneiden Sie den Inhalt von Material3 IconButton und IconToggleBotton an die Form der Statusebene der Komponente zu (z.B. kreisförmig). (I9da8f)
Die oberen App-Leisten von Material3 Medium und Large wurden aktualisiert, damit sie dieselbe Hintergrundfarbe auf der gesamten Oberfläche haben und die Standardfarben durch transparente Farbwerte überschrieben werden können. (I67659, b/249688556, b/250838918)

Version 1.1.0-alpha01

24. Oktober 2022

androidx.compose.material3:material3:1.1.0-alpha01 und androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 werden freigegeben. Version 1.1.0-alpha01 enthält diese Commits.

Fehlerkorrekturen

Der Titel wird an der oberen App-Leiste fixiert, wenn er mit einem Textstil und einem Pinsel angewendet wird. (If667e)

Version 1.0

Version 1.0.1

9. November 2022

androidx.compose.material3:material3:1.0.1 und androidx.compose.material3:material3-window-size-class:1.0.1 werden freigegeben. Version 1.0.1 enthält diese Commits.

Fehlerkorrekturen

Die oberen App-Leisten von Material3 Medium und Large wurden aktualisiert, damit sie dieselbe Hintergrundfarbe auf der gesamten Oberfläche haben und die Standardfarben durch transparente Farbwerte überschrieben werden können. (I67659, b/249688556, b/250838918)

Version 1.0.0

24. Oktober 2022

androidx.compose.material3:material3:1.0.0 und androidx.compose.material3:material3-window-size-class:1.0.0 werden freigegeben. Version 1.0.0 enthält diese Commits.

Wichtige Funktionen von 1.0.0

Dies ist die erste stabile Version von Compose Material 3.

Material Design 3-Designthemen und dynamische Material You-Farben

Material Design 3-Komponenten

Abzeichen
- Badge, BadgedBox
Untere App-Leiste
- BottomAppBar
Schaltflächen
- Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
Floating Action Button und erweiterter Floating Action Button
- SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
Infokarten
- Card, OutlinedCard, ElevatedCard
Kästchen
- Kästchen
Chips
- AssistChip, ElevatedAssistChip, FilterChip, ElevatedFilterChip, InputChip, SuggestionChip, ElevatedSuggestionChip
Dialoge
- AlertDialog
Trennlinie
- Trennlinie
Drop-down-Menü
- DropdownMenu, DropdownMenuItem, ExposedDropdownMenuBox
Liste
- ListItem
Navigationsleiste
- NavigationBar
Navigationsleiste
- ModalNavigationDrawer, ModalDrawerSheet, DismissibleNavigationDrawer, DismissibleDrawerSheet, PermanentNavigationDrawer, PermanentDrawerSheet
Navigationsleiste
- Navigationsleiste
Fortschrittsanzeige
- CircularProgressIndicator, LinearProgressIndicator
Optionsfeld
- RadioButton
Schieberegler
- Schieberegler, RangeSlider
Wechsel
- Wechseln
Tabs
- Tab, LeadingIconTab, TabRow, ScrollableTabRow
Textfelder
- TextField, OutlinedTextField
Obere App-Leiste
- TopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
Symbol
- Icon, IconButton
Text
- Text
Oberfläche
- Oberfläche
Layout
- Scaffold
Inhaltsfarbe
- LocalContentColor

Fenstergrößenklasse

material3-window-size-class ist eine neue Bibliothek, die Fenstergrößenklassen unterstützt: eine Reihe von Ansichtsbereichen, anhand derer Sie anpassbare Anwendungslayouts entwerfen, entwickeln und testen können. Mit calculateWindowSizeClass können Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche angezeigt werden soll, z. B. eine Navigationsleiste anstelle der Navigationsleiste unten bei größeren Fenstergrößen. Weitere Informationen und Anwendungsbeispiele finden Sie in der API-Referenzdokumentation für WindowSizeClass.
Weitere Informationen findest du in diesem Blogpost.

Version 1.0.0-rc01

5. Oktober 2022

androidx.compose.material3:material3:1.0.0-rc01 und androidx.compose.material3:material3-window-size-class:1.0.0-rc01 werden freigegeben. Version 1.0.0-rc01 enthält diese Commits.

API-Änderungen

Slotparameter für die Unterstützung der Text-zu-Textfeld-API hinzugefügt (Iaac0d, b/227146125)

Version 1.0.0-beta03

21. September 2022

androidx.compose.material3:material3:1.0.0-beta03 und androidx.compose.material3:material3-window-size-class:1.0.0-beta03 werden freigegeben. Version 1.0.0-beta03 enthält diese Commits.

API-Änderungen

ExposedDropdownMenuDefaults gibt jetzt einen Abstandswert für Menüpunkte an. (I34ee1)
ExposedDropdownMenuBoxScope hat jetzt einen Modifier.menuAnchor()-Modifikator, der für die korrekte Barrierefreiheit an das Textfeld übergeben werden sollte. (I27fa3)
Es wurden zwei überladene Methoden für die aktuelle Slider API hinzugefügt, mit denen Nutzer einen Schieberegler oder einen Track übergeben können, um den Schieberegler zu füllen. (I21c00)

Fehlerkorrekturen

Die Farbzuordnung für den On Error-Container im dunklen Design wurde auf Ton 90 (Ic5612) aktualisiert.
Es kann jetzt ein transparenter Hintergrund für kleine Material 3-App-Leisten oben festgelegt werden. (I645e2, b/245575782)

Version 1.0.0-beta02

7. September 2022

androidx.compose.material3:material3:1.0.0-beta02 und androidx.compose.material3:material3-window-size-class:1.0.0-beta02 werden freigegeben. Version 1.0.0-beta02 enthält diese Commits.

API-Änderungen

Die in der Betaversion 01 in m3-Komponenten eingeführten Standardkomponenteneinzüge berücksichtigen keine IME-Einzüge mehr.
Die Material3-Scaffold-Komponente hat jetzt einen Parameter contentWindowInsets, mit dem die Anzahl der Einzüge für den Inhalts-Slot angegeben werden kann. (Icf11a, b/243713323)
Die experimentelle Material 3-Funktion SmallTopAppBar wird eingestellt und durch eine entsprechende TopAppBar-Funktion ersetzt. Bitte migrieren Sie Ihre Nutzung auf das neue Konto. (I74404, b/226918634)
Es gibt jetzt mehr Möglichkeiten, das Verhalten der oberen App-Leiste beim Wischen und Anpinnen zu steuern. (I15c81)
Entfernt „startIndent“ aus „Divider“ und verschiebt die Farbe zum letzten Parameter. (If7be2)

Fehlerkorrekturen

Sie können Dialogfelder für TalkBack-Nutzer identifizieren, indem Sie das Wort „Dialogfeld“ ansagen, wenn sie angezeigt werden. (I857ef)

Version 1.0.0-beta01

24. August 2022

androidx.compose.material3:material3:1.0.0-beta01 und androidx.compose.material3:material3-window-size-class:1.0.0-beta01 werden freigegeben. Version 1.0.0-beta01 enthält diese Commits.

API-Referenz

Die neuesten verfügbaren Designs, Komponenten und anderen Composeable-Elemente finden Sie in der Übersicht der Compose Material 3 API-Referenz.

API-Änderungen

Die obere App-Leiste in Material 3 wurde aktualisiert, damit sie sich vollständig minimieren und maximieren lässt. Außerdem wurde die TopAppBarDefaults-Verhaltensfunktion zu Composables aktualisiert und es wurden Standardwerte für den Status der oberen App-Leiste und die Animationsspezifikation festgelegt. (I642b3)
Die Signaturen der FAB-Komponenten wurden an die Surface API angepasst (I3afaa).
Integrierte Unterstützung für Einblendungen in oberen App-Leisten, Navigationsleisten, Navigationsbereichen und Navigationsleisten. Wenn diese Komponenten separat oder mit Scaffold verwendet werden, werden Einzüge für Entwickler automatisch verarbeitet. Hinweis: Durch diese Änderung werden die Symbole in der Statusleiste nicht automatisch verarbeitet und die Status- und Navigationsleisten bleiben nicht transparent. Bitte machen Sie das weiterhin manuell, um die beste Bildqualität zu erhalten. (I7e4e6, b/183161866)
Die Standardeinstellungen für Komponenten wurden aktualisiert, um die API-Oberfläche zu reduzieren und so für mehr Flexibilität und Leistungsverbesserungen in Zukunft zu sorgen. (I31820)
Die Parameter für die Chip- und Navigationsleiste wurden neu angeordnet, um für Einheitlichkeit in der API zu sorgen (I45d0b)
startIndent wurde aus „Divider“ entfernt und „color“ wurde zum letzten Parameter gemacht.(If7be2)

Version 1.0.0-alpha16

10. August 2022

androidx.compose.material3:material3:1.0.0-alpha16 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 werden freigegeben. Version 1.0.0-alpha16 enthält diese Commits.

Neue Funktionen

Unterstützung für die Angabe einer benutzerdefinierten Breite für eine Navigationsleiste. (Ia7f10)

API-Änderungen

Tab- und Symbolparameter für den Tab „Tab“ neu anordnen, um für Einheitlichkeit in der API zu sorgen (Ie2637)
BadgeDefaults als experimentell gekennzeichnet (I98ef3)
Die eingestellte Navigationsleiste wurde entfernt. (I4f2db)
Schiebereglerparameter in Material 3 neu anordnen, um für Einheitlichkeit in der API zu sorgen (I0aee7)
Die Parameter NavigationBar und NavigationRail neu anordnen, um für Konsistenz innerhalb der API zu sorgen (I51cda)
Ordnen Sie die Parameter in Material 3 neu an, um für Einheitlichkeit in der API zu sorgen. (If4ae1)
Schiebereglerparameter in Material 3 neu anordnen, um für Einheitlichkeit in der API zu sorgen (I62673)
Der Parameter „icons“ wurde in „actions“ umbenannt, um mit der oberen App-Leiste übereinzustimmen (Id75be)
Markieren Sie Badge und BadgedBox als experimentell, da die Ausrichtung der Anker noch nicht endgültig festgelegt ist. (I1712e, b/236524516)
@ExperimentalMaterial3Api-Hinweise für Symbolschaltflächenvarianten in @OptIn ändern (I070b5)
Der Inhalt der Navigationsleiste wurde in ein eigenes Composeable-Element verschoben, damit eine benutzerdefinierte Breite angegeben werden kann. (Ia7f10)
Entfernt Divider aus MenuDefaults und TabDefaults (I4e33c)

Version 1.0.0-alpha15

27. Juli 2022

androidx.compose.material3:material3:1.0.0-alpha15 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 werden freigegeben. Version 1.0.0-alpha15 enthält diese Commits.

Neue Funktionen

Es soll möglich sein, die obere App-Leiste an der Leiste selbst zu ziehen. (I65c00, b/205873416)

API-Änderungen

Die FilterChip- und ElevatedFilterChip-APIs wurden aktualisiert, um den selectedIcon-Slot zu entfernen und die Wiederverwendung von leadingIcon für die Anzeige eines ausgewählten Status zu fördern. (Ie5dc2)
Rollen für die Farben von skurillen Elementen und Umrissen hinzufügen (Id6d54)
Namenskonventionen für zusammensetzbare Standardeinstellungen korrigieren (I62b27)
Markieren Sie ListItemDefaults und ListItemColors als experimentell. (I1f3ec)
Änderungen an der API für die obere App-Leiste, um die Bedeutung ihrer Statuseigenschaften besser widerzuspiegeln. Markieren Sie außerdem die API für die obere App-Leiste als experimentell. (Ic0ad8)
Für eine bessere Auffindbarkeit wurden TextFieldColors jetzt Farben für die Textauswahl hinzugefügt. (Iba1b8)
ButtonDefault.ButtonWithIconContentPadding für Schaltflächen mit Symbol hinzufügen (I2bf9c)
Textfelder wurden als experimentell gekennzeichnet, um bei zukünftigen API-Änderungen mehr Flexibilität zu ermöglichen. (I127b5)
Die Anmerkung @ExperimentalMaterial3Api wurde aus der Funktion Checkbox entfernt. (I5eefc)
Die Anmerkung @ExperimentalMaterial3Api wurde aus der Funktion RadioButton entfernt. (I17e2a)
Die Anmerkung @ExperimentalMaterial3Api wurde aus den nicht interaktiven Karten entfernt. (I9bd49)
Verschiedene Standardobjekte für Komponenten wurden um Farben, Formen usw. ergänzt (I96e11)

Fehlerkorrekturen

Nicht funktionierende nachgestellte Symbole wurden aus Eingabechip-Beispielen entfernt, um Verwirrung bei Nutzern in der Katalog-App zu vermeiden. (I9846a)

Version 1.0.0-alpha14

29. Juni 2022

androidx.compose.material3:material3:1.0.0-alpha14 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 werden freigegeben. Version 1.0.0-alpha14 enthält diese Commits.

Neue Funktionen

M3-Listenimplementierung hinzugefügt, siehe Dokumentation für Beispielnutzung (Id7a20)

API-Änderungen

Ändern Sie den Parameternamen von „values“ in „value“ in RangeSlider (I3b79a).
API-Änderungen an der InputChip-Implementierung zur Unterstützung eines auswählbaren Status gemäß der Material Design-Spezifikation. Zusätzliche Unterstützung bei den FilterChip-Farben für den ausgewählten deaktivierten Status. (I55244, b/235792432)
Standard-FAB für BottomAppBar hinzufügen (Ida4c8)
ColorScheme.surfaceColorAtElevation wurde hinzugefügt (Id41af)
Schnittstellen in Compose-Bibliotheken werden jetzt mit den Standardschnittstellenmethoden von JDK 8 erstellt (I5bcf1)
WindowWidthSizeClass und WindowHeightSizeClass implementieren jetzt „Vergleichbar“, sodass sie mithilfe von Operatoren (<, <=, >=, >) und anderen APIs verglichen werden können. (I747d0)

Fehlerkorrekturen

Beispiel für das Gütesiegel aktualisieren, um eine aussagekräftigere Inhaltsbeschreibung zu liefern (I10b9d)
In der Material 3-Katalog-Designauswahl wurde die Option hinzugefügt, die Systemschriftgröße zu verwenden. (I10605)
Beispielcode für Logos und unbestimmte Fortschrittsanzeigen hinzugefügt (I8fbe0)

Version 1.0.0-alpha13

1. Juni 2022

androidx.compose.material3:material3:1.0.0-alpha13 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 werden freigegeben. Version 1.0.0-alpha13 enthält diese Commits.

API-Änderungen

Die Position der App-Leiste oben wird bei Konfigurationsänderungen beibehalten. (I10459, b/216160958)

Version 1.0.0-alpha12

18. Mai 2022

androidx.compose.material3:material3:1.0.0-alpha12 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 werden freigegeben. Version 1.0.0-alpha12 enthält diese Commits.

Fehlerkorrekturen

Das übergeordnete Element des Schiebereglers kann jetzt eine Breite von 0 px haben. (b/231707291)

Version 1.0.0-alpha11

11. Mai 2022

androidx.compose.material3:material3:1.0.0-alpha11 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 werden freigegeben. Version 1.0.0-alpha11 enthält diese Commits.

Neue Funktionen

RangeSlider zu Material 3 (I18e38) hinzugefügt
Unterstützung für Material3-AssistChip und InputChip hinzugefügt (I0d25a)
Unterstützung für Material3-FilterChip und SuggestionChip hinzugefügt (I9fdf3)

API-Änderungen

Das TextFieldDefaults.BorderStroke-Element, das in OutlinedTextField einen Rahmenstrich zeichnet, wurde in TextFieldDefaults.BorderBox umbenannt. (I5f295)
Visuelle Änderungen bei m3-Switch (Iab30e)
Es ist möglich, Farben an die Standardsymbolschaltflächen zu übergeben. (Ia2445)

Fehlerkorrekturen

Fügen Sie material3/Scaffold eine Lint-Prüfung hinzu, um sicherzustellen, dass das innere Padding verwendet wird (I72293, b/226951418)

Version 1.0.0-alpha10

20. April 2022

androidx.compose.material3:material3:1.0.0-alpha10 und androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 werden freigegeben. Version 1.0.0-alpha10 enthält diese Commits.

Neue Funktionen

material3-window-size-class ist eine neue Bibliothek, die Fenstergrößenklassen unterstützt: eine Reihe von Ansichtsbereichen, anhand derer Sie anpassbare Anwendungslayouts entwerfen, entwickeln und testen können. Mit calculateWindowSizeClass können Sie eine Instanz der Fenstergrößenklasse abrufen, mit der Sie festlegen können, wie Ihre Benutzeroberfläche angezeigt werden soll, z. B. eine Navigationsleiste anstelle der Navigationsleiste unten bei größeren Fenstergrößen. Weitere Informationen und Anwendungsbeispiele finden Sie in der API-Referenzdokumentation zu WindowSizeClass. Weitere Informationen zu Definitionen von Fenstergrößenklassen finden Sie in der öffentlichen Anleitung zur Unterstützung verschiedener Bildschirmgrößen.

API-Änderungen

Fügen Sie die Standard-UAS-Ebene für BottomAppBar hinzu und entfernen Sie das abschließende Lambda von BottomAppBar mit UAS. (I92c47)
Fügen Sie „Material3“ FilledIconButton, FilledTonalIconButton und OutlinedIconButton hinzu. (Ib2bda)
Die Material 3-Snackbar-API wurde aktualisiert, sodass Farbwerte für die optionale Aktion und die Schließaktion akzeptiert werden. (Ibe4b4)
Der teilweise Verbrauch (nach unten ODER Position) wurde in PointerInputChange eingestellt. Mit consume() können Sie die Änderung vollständig übernehmen. Mit isConsumed kannst du feststellen, ob jemand anderes die Änderung bereits verwendet hat.
PointerInputChange::copy() erstellt jetzt immer eine flache Kopie. Das bedeutet, dass Kopien von PointerInputChange verbraucht werden, sobald eine der Kopien verbraucht wurde. Wenn Sie eine nicht gebundene PointerInputChange erstellen möchten, verwenden Sie stattdessen den Konstruktor. (Ie6be4, b/225669674)
Änderungen an der Cards API, um die Container- und Inhaltsfarben über eine CardColors-Oberfläche zu empfangen und einen deaktivierten Status für anklickbare Karten zu unterstützen. (I927df)
Der Parameter backgroundColor wurde in den Textfeldern von Material 3 in containerColor umbenannt, um für mehr Einheitlichkeit mit anderen Komponenten zu sorgen. (I6fbd9)

Fehlerkorrekturen

Aktualisierungen am Standard IconButton, um ihn an die Material3-Spezifikation anzupassen (I09eab)
Verschieben Sie die Höhe der oberen Leiste des Material 3-Scaffolds in den Abstand, der an den Inhalt übergeben wird, damit die Inhalte unter der oberen App-Leiste gerendert werden. Wenn die PaddingValues ignoriert werden, werden die Inhalte möglicherweise von der oberen Leiste verdeckt. (I83cbc, b/217776202)

Version 1.0.0-alpha09

6. April 2022

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

Neue Funktionen

Material 3 Switch API (I2c3ad) hinzugefügt

API-Änderungen

Unterstützung für Drop-down-Menüs mit Textfeldern (auch „offene Drop-down-Menüs“ oder „Kombinationsfelder“ genannt) hinzugefügt. (I1b832)
Dem MaterialTheme- und Shape-Subsystem wurde der Parameter „shape“ hinzugefügt. (I37426)
ExtendedFloatingActionButton wurde ein Parameter hinzugefügt, mit dem festgelegt werden kann, ob die FAB maximiert oder minimiert ist, und mit Animationen zwischen den einzelnen Status. Es wurde eine zusätzliche Option für erweiterte UAs hinzugefügt, die einen nachgestellten Text für erweiterte UAs ohne Symbol enthält. (Iba7f1)

Version 1.0.0-alpha08

23. März 2022

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

Neue Funktionen

Unterstützung für Textfelder in Material 3 hinzugefügt. (I795cc, b/199377790)

API-Änderungen

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

Fehlerkorrekturen

Fixieren Sie die Material3-Schaltfläche, um den Standardwert für den Textstil aus dem MaterialTheme zu lesen. (Ie62fc)

Version 1.0.0-alpha07

9. März 2022

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

API-Änderungen

Die Material 3 Surface API wurde aktualisiert. Die überladenen Funktionen für anklickbare Oberflächen wurden wieder eingeführt und es wurde eine Funktion hinzugefügt, die die Auswahl und das Umschalten von Oberflächen unterstützt. (I4bf18)
LazyVerticalGrid und LazyHorizontalGrid sind jetzt stabil. (I307c0)
LazyVerticalGrid/LazyHorizontalGrid und alle zugehörigen APIs wurden in das Unterpaket „.grid“ verschoben. Bitte aktualisieren Sie Ihre Importe von androidx.compose.foundation.lazy auf androidx.compose.foundation.lazy.grid. (I2d446)
Die vorherige Änderung, bei der nur eine Ansicht für WindowInsetsControllerCompat verwendet wurde, wurde rückgängig gemacht. Es ist wieder ein Fenster erforderlich, das zum Verwalten einiger Fensterflaggen benötigt wird. ViewCompat.getWindowInsetsController wurde zugunsten von WindowCompat.getInsetsController eingestellt, damit das richtige Fenster verwendet wird, z. B. wenn sich die Ansicht in einem Dialogfeld befindet. (I660ae, b/219572936)
Neue LazyVerticalGrid API zum Definieren von Größen für Achsenkreuze hinzugefügt (I17723)

Fehlerkorrekturen

Updates an der Card API, um Änderungen an der Surface API (I3c8b9) zu berücksichtigen

Version 1.0.0-alpha06

23. Februar 2022

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

API-Änderungen

NavigationDrawerItem wird hinzugefügt, das ein einzelnes Ziel innerhalb der Schubladen darstellt (Ic396f, b/218286829)
PermanentNavigationDrawer und DismissibleNavigationDrawer wurden als experimentelle APIs hinzugefügt. Diese Schubladen eignen sich gut für Geräte mit großem Bildschirm. (I5f8ab, b/218286829)
Unterstützung für die untere App-Leiste in Material 3 hinzugefügt (Ic432a)
NavigationDrawer wurde in ModalNavigationDrawer umbenannt (I1807d, b/218286829)
Material 3-Schiebereglerklasse und -Tokens hinzugefügt (I1ccee)
Tab-Implementierung hinzugefügt, siehe Dokumentation für Beispielnutzung (Ie0146)

Fehlerkorrekturen

Ein Problem wurde behoben, durch das bei der linearen Navigation des Screenreaders TalkBack ein leerer Titel in der oberen App-Leiste ausgewählt wurde. (Id4690)
IconSize wurde zu FloatingActionButtonDefaults hinzugefügt. (Ia71cf)
Fehlerbehebung für ausgeblendete AlertDialog-Schaltflächen, wenn ein langer Text mit einer LazyColumn hinzugefügt wird. (Ib2cc9, b/216663029)

Version 1.0.0-alpha05

9. Februar 2022

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

Neue Funktionen

Material Design 3-Komponenten hinzugefügt

Drop-down-Menü
- DropdownMenu, DropdownMenuItem
Infokarten
- Card, OutlinedCard, ElevatedCard

API-Änderungen

Die eingestellte Surface-Funktion, die einen onClick-Callback annimmt. Klickbare Oberflächen sollten mit einem InteractionSource und einem Modifier.clickable() erstellt werden. (I211c6)
Unterstützung für die Erhöhung von FABs bei Drücken und Fokussieren hinzugefügt (Ibb584)
Die Surface API wurde so geändert, dass sie eine Interaktionsquelle empfängt, mit der sich die Darstellung in verschiedenen Status steuern lässt. (Iafbc8)

Fehlerkorrekturen

Es wurden fehlende tertiäre Farben in dynamischen Farbschemata hinzugefügt (I456c4, b/214588434)

Version 1.0.0-alpha04

26. Januar 2022

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

API-Änderungen

NonRestartableComposable wurde Methoden hinzugefügt, die Überladungen vorhandener Methoden ohne komplexe Logik sind. Dadurch werden vom Compiler generierte Memoisierungsüberprüfungen (Gleichungen) für alle Parameter reduziert, die in der aufgerufenen inneren Funktion wiederholt werden. (I90490)
Material 3-Trennlinie hinzugefügt. (Ica5fc)
Markieren Sie das Kästchen und das Optionsfeld mit einer Anmerkung zur experimentellen API. (Ie44bb)
Unterstützung für Material 3-Fortschrittsanzeigen hinzugefügt (Iff232, b/205023841)

Fehlerkorrekturen

Farbe eines deaktivierten TextButton's-Containers in „Transparent“ ändern (I6b248, b/213339737)

Version 1.0.0-alpha03

12. Januar 2022

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

Fehlerkorrekturen

Fügen Sie LocalIndication zu MaterialTheme von Material 3 hinzu. (I7ce4e)
Korrektur des Eckradius für Kästchen (I38b03, b/175198975, b/202309440)

Abhängigkeitsupdates

Jetzt hängt es von Kotlin 1.6.10 ab.

Version 1.0.0-alpha02

1. Dezember 2021

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

Neue Funktionen

Unterstützung für Kästchen und Optionsschaltflächen hinzufügen
Aktualisiert für die Kompatibilität mit Kotlin 1.6.0

API-Änderungen

Entfernen Sie den Auszug aus dem Scaffolding von Material 3. (I04f51)
Unterstützung für Material 3 Checkbox (Id5542)
Unterstützung für Material 3 RadioButton (I20334)

Fehlerkorrekturen

Reduzieren Sie den Radius der IconButton-Welle von 40 dp auf 20 dp. (I68bbe, b/206674345)
Schnellpfad für Portstrings für Text ändert sich von compose.material (I30b03)
Behoben, aber die hartcodierte Schaltfläche ist immer aktiviert. (Iea832, b/205335456)

Version 1.0.0-alpha01

27. Oktober 2021

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

Neue Funktionen

Material Design 3-Designthemen und dynamische Material You-Farben

Material Design 3-Komponenten

Schaltflächen
- Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
Floating Action Button und erweiterter Floating Action Button
- SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
Dialoge
- AlertDialog
Navigationsleiste
- NavigationBar
Navigationsleiste
- NavigationDrawer
Navigationsleiste
- NavigationRail
Obere App-Leiste
- SmallTopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
Abzeichen
- Badge, BadgedBox
Symbol
- Icon, IconButton
Text
- Text
Oberfläche
- Surface
Layout
- Scaffold
Inhaltsfarbe
- LocalContentColor

Weitere Informationen finden Sie im Abschnitt Material Design 3 und Material You im Leitfaden „Material-Design-Designthemen in Compose“.