Ta strona została przetłumaczona przez Cloud Translation API.

Compose Material 3

Dokumentacja interfejsu API
androidx.compose.material3
(aby uzyskać dostęp do interfejsu API wszystkich pakietów compose, zapoznaj się z dokumentacją interfejsu API)

Twórz interfejsy Jetpack Compose za pomocą komponentów Material Design 3, czyli kolejnej generacji Material Design. Material 3 obejmuje zaktualizowane motywy i elementy oraz funkcje personalizacji Material You, takie jak dynamiczne kolory. Jest on zgodny z nowym stylem wizualnym Androida 12 i interfejsem systemu.

Ostatnia aktualizacja	Wersja stabilna	Wersja kandydująca do publikacji	Wersja Beta	Wersja alfa
18 czerwca 2025 r.	1.3.2	-	-	1.4.0-alpha16

Struktura

Compose to kombinacja 7 identyfikatorów grupy Maven w pakiecie androidx. Każda grupa zawiera określony podzbiór funkcji, z którym wiąże się własny zestaw informacji o wydańach.

Ta tabela zawiera informacje o grupach i linki do poszczególnych zestawów informacji o wersji.

Grupa	Opis
compose.animation	Tworzyć animacje w aplikacji Jetpack Compose, aby wzbogacać wrażenia użytkowników.
compose.compiler	Przekształcaj funkcje @Composable i włącz optymalizacje za pomocą wtyczki kompilatora Kotlin.
compose.foundation	Pisać aplikacje Jetpack Compose za pomocą gotowych elementów składowych i rozwijać podstawy, aby tworzyć własne elementy systemu projektowania.
compose.material	Tworzenie interfejsów Jetpack Compose za pomocą gotowych komponentów Material Design. Jest to punkt wejścia na wyższym poziomie w Compose, który ma na celu udostępnianie komponentów odpowiadających komponentom opisanym na stronie www.material.io.
compose.material3	Twórz interfejsy Jetpack Compose za pomocą komponentów Material Design 3, czyli kolejnej generacji Material Design. Material 3 obejmuje zaktualizowane motywy i elementy oraz funkcje personalizacji Material You, takie jak dynamiczne kolory. Jest on zgodny z nowym stylem wizualnym Androida 12 i interfejsem systemu.
compose.runtime	Podstawowe elementy modelu programowania i zarządzania stanem w Compose oraz środowisko uruchomieniowe główne dla wtyczki kompilatora Compose, na które ma ona działać.
compose.ui	podstawowe elementy interfejsu tworzenia wiadomości, które są potrzebne do interakcji z urządzeniem, w tym układ, rysowanie i wprowadzanie danych;

Deklarowanie zależności

Aby dodać zależność od Compose, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Maven firmy Google.

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

Groovy

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli zauważysz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Przed utworzeniem nowego problemu zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz zagłosować na istniejący problem, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Compose Material3 Common Version 1.0

Wersja 1.0.0-alpha01

17 kwietnia 2024 r.

Funkcje androidx.compose.material3:material3-common:1.0.0-alpha01, androidx.compose.material3:material3-common-android:1.0.0-alpha01 i androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 są dostępne. Wersja 1.0.0-alpha01 zawiera te komity.

Nowe funkcje

Komponenty bez motywu, które można wykorzystać do tworzenia komponentów Material Design:

Paleta tonalna
- TonalPalette
Ikona
- Icon
Rozmiar docelowego elementu dotykowego
- LocalMinimumInteractiveComponentSize

Compose Material3 Adaptive Navigation Suite w wersji 1.0

Wersja 1.0.0-alpha07

1 maja 2024 r.

Funkcje androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07 i androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 są dostępne. Wersja 1.0.0-alpha07 zawiera te komity.

Zmiany w interfejsie API

Usunięcie oznaczenia eksperymentalnej interfejsów API pakietu nawigacyjnego (If62af)

Poprawki błędów

Domyślne używanie wstawek dla treści (50266df)

17 kwietnia 2024 r.

Funkcje androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06 i androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 są dostępne. Wersja 1.0.0-alpha06 zawiera te komisy.

Zmiany w interfejsie API

Dodaj containerColor i contentColor do NavigationSuiteScaffoldDefaults. (I64e3a, b/331993720)
Dodawanie funkcji itemColors do NavigationSuiteDefaults. (Idf719, b/328480012)
Upewnij się, że NavigationSuiteScope jest zamknięty. (Iefa57)

6 marca 2024 roku

Funkcje androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05 i androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 są dostępne. Wersja 1.0.0-alpha05 zawiera te komity.

Zmiany w interfejsie API

Ustaw konstruktor NavigationSuiteItemColors jako publiczny. (Ica83a, b/324886877)

21 lutego 2024 r.

Funkcje androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04 i androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 są dostępne. Wersja 1.0.0-alpha04 zawiera te commity.

Aktualizacje zależności

Zaktualizuj zależności dotyczące adaptacji Material3 do nowych ścieżek modułów. (Ibc421)
Przejdź na wersję klas rozmiarów okien w Menedżerze okien. (I3794d)

7 lutego 2024 r.

Funkcje androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03 i androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 są dostępne. Wersja 1.0.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

Zmień nazwę pakietu na „navigationsuite” zamiast „navigation-suite” (I7eff7).
Komponenty Material 3, które w swoim interfejsie API udostępniają wartość MutableInteractionSource, zostały zaktualizowane, aby udostępniać wartość MutableInteractionSource, która może być pusta. Domyślnie jest ona ustawiana na null. Nie ma tu żadnych zmian semantycznych: przekazanie wartości null oznacza, że nie chcesz podnosić MutableInteractionSource, i w razie potrzeby zostanie on utworzony wewnątrz komponentu. Ustawienie wartości null pozwala niektórym komponentom nigdy nie przydzielać MutableInteractionSource, a innym pozwala tworzyć instancję tylko wtedy, gdy jest to konieczne, co zwiększa wydajność tych komponentów. Jeśli nie używasz wartości MutableInteractionSource przekazywanej do tych komponentów, zalecamy przekazanie zamiast niej wartości null. Zalecamy też wprowadzenie podobnych zmian w własnych komponentach. (I41abb, b/298048146)

13 grudnia 2023 r.

Funkcje androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02 i androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 są dostępne. Wersja 1.0.0-alpha02 zawiera te commity.

Nowe funkcje

Dodaj opcję „Brak” NavigationSuiteType (If8cb1, b/313688598)

Poprawki błędów

Naprawiono problem z komponentem nawigacji wypełniającym cały ekran, gdy element główny ma modifier.fillMaxSize. (c9cf250, b/312664933)

15 listopada 2023 r.

Element androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 został zwolniony. Wersja 1.0.0-alpha01 zawiera te commity.

Nowe funkcje

NavigationSuiteScaffold
- NavigationSuiteScaffoldLayout
- NavigationSuite

Compose Material3 Adaptive Version 1.0

Wersja 1.0.0-alpha06

7 lutego 2024 r.

Funkcje androidx.compose.material3:material3-adaptive:1.0.0-alpha06, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06 i androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 są dostępne. Wersja 1.0.0-alpha06 zawiera te commity.

Nowe funkcje

Dodano dodatkowe opcje zachowania ThreePaneScaffoldNavigator nawigacji wstecz. (I858aa)
Do historii nawigacji dodano opcjonalne treści dotyczące miejsca docelowego. (Ibd7e6)

Wersja 1.0.0-alpha05

24 stycznia 2024 r.

Funkcje androidx.compose.material3:material3-adaptive:1.0.0-alpha05, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05 i androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 są dostępne. Wersja 1.0.0-alpha05 zawiera te commity.

Nowe funkcje

Obsługa uwzględniania historii w nawigacji i obliczaniu wartości (I71d46)

Wersja 1.0.0-alpha04

10 stycznia 2024 r.

Funkcje androidx.compose.material3:material3-adaptive:1.0.0-alpha04, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04 i androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 są dostępne. Wersja 1.0.0-alpha04 zawiera te commity.

Nowe funkcje

Dodano obsługę sekcji od krawędzi do krawędzi w ramach szkieletów paneli (I1b462).

Zmiany w interfejsie API

Przeniesienie właściwości zakresów zawiasów w funkcji Posture na listę informacji o zawiasie (I24f90)

Poprawki błędów

Naprawić AnimatedPane, który nie jest ponownie tworzony (c3f573d)

Wersja 1.0.0-alpha03

13 grudnia 2023 r.

Funkcje androidx.compose.material3:material3-adaptive:1.0.0-alpha03, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03 i androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 są dostępne. Wersja 1.0.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

Zmień role szablonu na aliasy ThreePaneScaffoldRole. (I65bd1)
Tworzenie klasy bazowej dla ról szablonu (I4784d)
Usuń niepotrzebny parametr z treści AnimatedPane (Ibc73b)
Zmienia nazwę funkcji collectWindowSizeAsState i zamiast niej zwraca wartości nieprzetworzone (I480f4).

Wersja 1.0.0-alpha02

29 listopada 2023 r.

Funkcje androidx.compose.material3:material3-adaptive:1.0.0-alpha02, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 i androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 są dostępne. Wersja 1.0.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

Oddziel interfejsy API nawigacji od interfejsów API adaptacyjnych szablonów. (Ic4045)
Usuń zajęcia GutterSize. (I785b3)

Poprawki błędów

Poprawka: panele nie są przełączane, gdy nie jest używany parametr AnimatedPane (d88f181)

Wersja 1.0.0-alpha01

15 listopada 2023 r.

Element androidx.compose.material3:material3-adaptive:1.0.0-alpha01 został zwolniony. Wersja 1.0.0-alpha01 zawiera te commity.

Nowe funkcje

Interfejsy API warunków dostosowywania Material3:

Postawa

Interfejsy API dyrektywy szkieletu panelu adaptacyjnego Material3:

PaneScaffoldDirective

Interfejsy API szkieletu panelu adaptacyjnego Material3:

Podstawowe interfejsy API w ramach szablonu panelu

Tworzenie Material3 w wersji 1.4

Wersja 1.4.0-alpha16

18 czerwca 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha16 został zwolniony. Wersja 1.4.0-alpha16 zawiera te komisy.

Nowe funkcje

Dodano wyśrodkowany komponent karuzeli głównej (I6f6d3)

Zmiany w interfejsie API

Wdrożenie XR zastępuje pionowy pasek narzędzi (Ia1604)
Dodano funkcje programowego przewijania do CarouselState (I12f8e)
Dodaj ComponentOverride do ModalWideNavigationRail (I4f440)
Dodaj ComponentOverride do WideNavigationRail (I6354f)
Tworzenie klucza ComponentOverride dla chmury HorizontalFloatingToolbar (I51116)
Tworzę klucz ComponentOverride dla chmury ShortNavigationBar (I30e24)
Odwołania SwipeToDismissBoxState do confirmValueChange zostały oznaczone jako przestarzałe. Użytkownicy powinni zamiast tego skorzystać z interfejsu SwipeToDismissBox API onDismissed callback. (Iee780)
Dodano parametr userScrollEnabled do komponentów typu karuzela. (I1d4d2)
Karuzelę currentItem można teraz obserwować z poziomu CarouselState. (Ie87e9)

Poprawki błędów

Rozwiązaliśmy problem polegający na tym, że dowolny kształt w przycisku FAB przekazywany do FloatingToolbar nie stosował prawidłowo cienia. (Icdcc9, b/423336922)
Wszystkie karuzele używają teraz domyślnie roli semantycznej karuzela. (I7af12)
Poprawiono nieprawidłowy ruch suwaka podczas aktualizowania jego stanu za pomocą LaunchedEffect (Id9f31, b/302774166)

Wersja 1.4.0-alpha15

20 maja 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha15 został zwolniony. Wersja 1.4.0-alpha15 zawiera te komisy.

Zmiany w interfejsie API

Dodano MotionTheme.LocalMotionScheme, kompozycja lokalna. Daje to dostęp do schematu animacji motywu z poziomu CompositionLocalConsumerModifierNodes za pomocą currentValueOf(MotionTheme.LocalMotionScheme). (I014b1)
Konstruktor ColorScheme bez stałych ról kolorów jest teraz wycofany. Przejdź na konstruktor, który zawiera stałe role. (Iad0ee)
Komponent tekstowy M3 obsługuje teraz TextAutoSize. (I7f524)
Dodaj interfejs API do tworzenia wariantów rozmiarów przycisku podzielonego i dodaj przykłady. (Ice30b)

Poprawki błędów

Rozwiązaliśmy problem polegający na tym, że przy włączonej opcji wypełniania od krawędzi do krawędzi elementy Snackbar i FloatingActionButton były nieprawidłowo umieszczone. Szkielet teraz prawidłowo stosuje poziome wcięcia do tych komponentów. (Ib7c30, b/244400727)
Zmień animację BottomSheet z pełnego na częściowe rozwinięcie. Element BottomSheet korzysta teraz z efektu szybkiego działania elementu MotionScheme podczas ukrywania lub zwijania oraz z efektu przestrzennego domyślnego podczas rozwijania. (Ifa46f, b/416063171)
Konstruktor ColorScheme bez ról związanych z kontenerem powierzchni został oznaczony jako ukryty i nie jest już zalecany do użycia. (Ia7237)
Usunięto wymóg CircularWavyProgressIndicator Size.minDimension > 0, który powodował wyjątek, aby zapewnić większą elastyczność. (Ic9418, b/377531195)
Hiperlinki w Text(AnnotatedString) mają teraz domyślnie styl Material. (I78288, b/339843816)
Rozwiązanie problemu polegającego na tym, że funkcja toShape() w funkcji RoundedPolygon przechowuje ścieżkę i powoduje problemy, gdy wykonywane są liczne wywołania funkcji createOutline o różnych rozmiarach. (I4026d)

Wersja 1.4.0-alpha14

7 maja 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha14 został zwolniony. Wersja 1.4.0-alpha14 zawiera te komity.

Zmiany w interfejsie API

Dodaliśmy nowy komponent AppBarColumn, który działa tak samo jak komponent AppBarRow, ale służy do tworzenia treści w kolumnie. (Iaf6bd)
Do elementu AppBarRow dodano maksymalną liczbę elementów. Jest to konieczne do prawidłowego wdrożenia specyfikacji materiału w przypadku górnych pasków aplikacji. (I92ce4)
Dodano metodę TooltipScope, aby uzyskać layoutCoordinates kotwicy. wycofujemy metodę drawCaret, ponieważ deweloperzy mogą używać nowej metody do uzyskiwania granic elementów kotwiczenia layoutCoordinates i tworzenia odpowiedniego kształtu zawierającego kursor. (Ia2e12, b/329470609)
Dodano obsługę java.time dla selektora daty: wprowadzono przeciążenia rememberDatePickerState/rememberDateRangePickerState, które obsługują obiekty java.time (np. początkowy LocalDate, YearMonth). Dodano też funkcje rozszerzeń dla obiektów stanu, aby pobierać/ustawiać wartości za pomocą typów takich jak LocalDate i YearMonth. Wymaga interfejsu API w wersji 26 lub nowszej albo desugaringu. (I70f29, b/266202516, b/281859606)
Dodaj komponent CenteredTrack, który umożliwia korzystanie z suwaka z ścieżką zaczynającą się od środka. (I5b1d6)

Poprawki błędów

Zwiększyliśmy wydajność falujących wskaźników postępu: typy liniowe wczytują się teraz o ok. 8,5% szybciej i wymagają o 11% mniejszej alokacji, a typy kołowe wczytują się o ok. 47% szybciej i wymagają o 39% mniejszej alokacji. (I595d8)

Wersja 1.4.0-alpha13

23 kwietnia 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha13 został zwolniony. Wersja 1.4.0-alpha13 zawiera te komity.

Zmiany w interfejsie API

Parametry isAppearanceLightStatusBars i isAppearanceLightNavigationBars zostały ponownie wprowadzone do ModalBottomSheetProperties jako parametry dostępne tylko na urządzeniach z Androidem. (Id4bc0)
Dodaj kompozyt AppBarRow, który obsługuje przepełnienie elementów, które mieszczą się poza jego granicami. (I742bd)
Zaktualizuj interfejsy API DatePicker i DateRangePicker, aby wysyłać żądanie focus podczas przełączania się w tryb wprowadzania daty. Parametr logiczny requestFocus został zastąpiony opcjonalnym parametrem focusRequester, który przyjmuje wartość FocusRequester. (I14b69)
Usuń modyfikator i źródło interakcji z domyślnych elementów, które można kliknąć i przełączyć. Zamiast tego podaj je w szczegółach implementacji. (I95ed6)
Zaktualizowano ButtonGroup, aby wyświetlać menu rozwijane, gdy na ekranie jest zbyt dużo przycisków. (I7b88b)

Poprawki błędów

Dolna karta wykorzystuje teraz górne wstawki, gdy jest mniejsza niż bieżący offset. Dzięki temu użytkownicy mogą udostępniać w ramach rozszerzonego widoku wstawki górne. BottomSheetDefaults.windowInsets obejmuje teraz WindowInsets.safeDrawing.Top. (I0ab67, b/321877275, b/336962418, b/342093067)
Włączono animacje wchodzenia i wychodzenia (rozjaśniania i przesuwania) ikon i awatarów na początku oraz ikon na końcu, gdy są one dodawane lub usuwane. Jest to przydatne przede wszystkim w przypadku elementów do wyboru (filtrów i elementów wejściowych), ale dotyczy też innych elementów. (I9af21)
Napraw błędne działanie suwaka RTL spowodowane przez LookaheadScope. (Ieb152, b/408118041)
Rozwiązanie problemu z awarią AppBar na dole ekranu związanym z przewijaniem przy ukrytym interfejsie systemu. (Ic6140, b/405996228)

Wersja 1.4.0-alpha12

9 kwietnia 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha12 został zwolniony. Wersja 1.4.0-alpha12 zawiera te komity.

Zmiany w interfejsie API

Usunięto parametry specyficzne dla Androida z ModalBottomSheetProperties (Iab97f, b/362539765).
Wprowadzić funkcje przeciążenia domyślnych rozmiarów uchwytu przeciągania (I0ed0d)
Dodaj nowe funkcje NavigationSuiteScaffold i NavigationSuiteScaffoldLayout, aby obsługiwać nowe typy układów oraz dodać obsługę opcjonalnego głównego działania. (Ib262a, b/353144478)
Wycofaj parametr Modifier.weight w pliku ButtonGroup. Dodawanie wersji bez wypełnienia. (Id32bb)
Nazwy komponentów xSmall- i xLarge- (przycisk ikony) domyślnie są zastępowane przez extra. (Ib6e0f)
Dodaj nowe funkcje NavigationSuite, NavigationSuiteItem i NavigationSuiteColors, aby obsługiwać nowe typy układów. (I203d6)
Dodaj nową funkcję NavigationSuiteTypes i funkcję navigationSuiteType, które obejmują te opcje układu (If68f9).

Poprawki błędów

Adres ColorScheme.contentColorFor jest teraz zmapowany na adres surfaceDim.onSurface (I8891a)
Zaktualizowano implementację DateInputTextField, aby rozwiązać problem polegający na tym, że pole wejściowe nie odzwierciedlało daty ustawionej programowo. (I6c8d1, b/401143451)
Naprawiono kolejność fokusowania w pasku nawigacji i szerokim pasku nawigacji (I6cf6f, b/407048224).

Wersja 1.4.0-alpha11

26 marca 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha11 został zwolniony. Wersja 1.4.0-alpha11 zawiera te komisy.

Zmiany w interfejsie API

Zaktualizowano wielkość liter w właściwościach komponentów w obiektach domyślnych dla przycisku i przycisku przełącznika. Dodaj metody w elementach ToggleButtonDefaults i ButtonDefaults, aby uzyskać zalecaną odległość od krawędzi treści, kształty, rozmiar ikon, odstępy między ikonami i styl tekstu w zależności od wysokości kontenera. (Iea69e)
Z funkcji FloatingToolbar usunięto wycofane eksperymentalne funkcje i stałe. (I8f339)
Komponenty Elevation mają teraz wspólny interfejs oraz publiczne konstruktory i właściwości. (Ibb172)
Dodanie modyfikatora animateWidth w elementach ButtonGroupScope, które należy użyć z elementami podrzędnymi grupy przycisków, aby prawidłowo je animować. (Ia3bb6)

Poprawki błędów

Poprawiliśmy wyrównanie pływającej listwy narzędzi, aby zapewnić równowagę wizualną podczas zwijania, oraz zwiększyliśmy elastyczność w przypadku większych treści. (I06c00)

Wersja 1.4.0-alpha10

12 marca 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha10 został zwolniony. Wersja 1.4.0-alpha10 zawiera te komity.

Zmiany w interfejsie API

Środowisko wykonawcze TabRowDefaults.tabIndicatorOffset zostało wycofane na rzecz środowiska wykonawczego TabIndicatorScope.tabIndicatorOffset. (Ib36b3)
Poprawiono literówkę w przypadku małego wypełniacza treści w domyślnych ustawieniach przycisków. (I19bfe)
Metody TabRow i ScrollableTabRow zostały wycofane na rzecz ich wersji podstawowej i dodatkowej. Wiersze kart Główna i Dodatkowa są wydajniejsze i bardziej zgodne ze specyfikacją (I918e2).
Dodano rememberSliderState i rememberRangeSliderState. (I8e384)
Dodano shouldAutoSnap do SliderState, aby kontrolować mechanizm automatycznego wyrównywania. Wyłączenie tej opcji może być przydatne w przypadku animacji niestandardowych. (I07745)
Minimalna szerokość przewijanej karty jest teraz parametrem. Wersje wierszy karty Główna i Dodatkowa nie są już eksperymentalne. (If6f15, b/226665301)
Zajęcia ExitAlwaysFloatingToolbarScrollBehavior zostały udostępnione publicznie, co umożliwia tworzenie bez kompozycji. (Ibf31c)

Wersja 1.4.0-alpha09

26 lutego 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha09 został zwolniony. Wersja 1.4.0-alpha09 zawiera te komity.

Zmiany w interfejsie API

Zmień nazwy pól ustawień DragHandle w stanie domyślnym; oddziel stany wciśnięcia i przeciągnięcia; ustaw publiczne rozmiary domyślne. (I787b9)
Aktualizacje interfejsu API TowRowsTopAppBar. Usunęliśmy parametr expanded lambda i dodaliśmy osobne parametry dla wysokości po rozwinięciu i po złożeniu. (Idd677, b/306697446, b/229134133, b/268068946)

Poprawki błędów

Dolne paski aplikacji są teraz obsługiwane przez usługę eksploracji dotykowej (np. TalkBack) i aby były widoczne, gdy usługa jest włączona. (I4b34d)

Wersja 1.4.0-alpha08

12 lutego 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha08 został zwolniony. Wersja 1.4.0-alpha08 zawiera te komisy.

Nowe funkcje

Dodano interfejs API TimePickerDialog, który może być używany do TimePicker lub TimeInput albo do przełączania wersji. (Id2d83)
Nowe interfejsy API paska wyszukiwania:
- Zwinięte paski wyszukiwania i rozwinięte „widoki” wyszukiwania są teraz oddzielnymi komponentami.
- SearchBar to pasek wyszukiwania w zwiniętym stanie.
- ExpandedFullScreenSearchBar i ExpandedDockedSearchBar to pasek wyszukiwania w stanie rozwiniętym. Otwiera się w nowym oknie.
- SearchBarState – do kontrolowania stanu paska wyszukiwania.
- TopSearchBar dodanie obsługi wstawek i zachowania przewijania
- Nowa wersja funkcji InputField, która korzysta z funkcji SearchBarState (Ie0723, b/261496232, b/283311462, b/350916229, b/352872248)

Zmiany w interfejsie API

Obsługa przekształcania kształtu rogu przycisków ikon po naciśnięciu. (I21843)
Interfejsy API dekoratora pola tekstowego i opakowania nie są już eksperymentalne. (I31d95)
Dodano próbki i wartości domyślne dla połączonego wariantu w przypadku ButtonGroup. (I5c8ce)
Zmień parametr state na ostatni w elementach NavigationSuiteScaffold i NavigationSuiteScaffoldLayout. (I9cc7b)

Poprawki błędów

Dodano niestandardowe działania ułatwień dostępu do FloatingToolbars, aby usługi ułatwień dostępu mogły teraz rozwijać i zwijać wszystkie FloatingToolbar warianty. W wersji z przyciskiem FAB dotyczy on tego przycisku, a w wersji bez przycisku FAB dotyczy on głównej treści. (I26420)
Usługa FloatingToolbars teraz obserwuje usługę eksploracji dotykowej (np. TalkBack) i aby pasek narzędzi był rozłożony i widoczny, gdy usługa jest włączona. (I02172)
Usunięto awarię wskaźników postępu i wczytywania, gdy jako wartość postępu przekazywana jest wartość Float.NaN. (I4fa96, b/352364576)

Wersja 1.4.0-alpha07

29 stycznia 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha07 został zwolniony. Wersja 1.4.0-alpha07 zawiera te komity.

Nowe funkcje

Dodano nowy interfejs API, który umożliwia większą elastyczność w dostosowywaniu wyglądu pól wyboru. Ten interfejs API udostępnia parametry obrysu, które umożliwiają większą kontrolę nad sposobem renderowania znacznika wyboru i obrysu pola wyboru. (I65a88)
Dodano interfejs API TwoRowsTopAppBar, który jest bardziej konfigurowalną alternatywą dla pasków aplikacji o rozmiarze średnim i dużym, przeznaczonych do tworzenia pasków aplikacji u góry ekranu z 2 wierszami. Deweloperzy mogą teraz kontrolować zawartość tytułów i napisów zarówno w zwiniętym, jak i rozwiniętym stanie, z możliwością dostosowania wysokości dla każdego stanu. (I0be3c, b/306697446, b/229134133, b/268068946)

Zmiany w interfejsie API

Zmieniliśmy nazwę eksperymentalnej wersji BottomAppBar na FlexibleBottomAppBar, aby zapewnić większą kontrolę nad układem i wysokością treści. (Iaa448)
Zmień nazwy właściwości w obiekcie domyślnym grupy przycisków na CapitalCase. Zaktualizuj nazwę animateFraction, aby dokładniej odzwierciedlała działanie, które reprezentuje. (I545cd)
Dodawanie przeciążeń dla typowych przycisków, które umożliwiają animowane kształty po naciśnięciu. Dodano kształty przycisków w pamięci podręcznej. (I5ec20)
Możesz teraz kontrolować sposób, w jaki FloatingToolbar z przyciskiem FAB reaguje na przewijanie, podając FloatingToolbarScrollBehavior. W przypadku pasków narzędzi umieszczonych na środku krawędzi (np. u góry lub u dołu) zalecamy użycie zachowania przewijania, aby ukryć cały element podczas przewijania, co zapewni czystszy wygląd. Zapobiega to też przesunięciu się przycisku FAB, co może się zdarzyć, gdy używasz flagi expanded do zwijania. (I33f67)
Zaktualizowano eksperymentalne interfejsy API TopAppBar, aby podczas ustawiania wyrównania tytułu i podtytułu używać wartości Alignment.Horizontal zamiast niestandardowej wartości TopAppBarTitleAlignment. (I70ca2)
SliderState#onValueChange jest teraz publiczny, aby zapewnić użytkownikom większą kontrolę (I104eb)
Wprowadź NavigationSuiteScaffoldState, aby umożliwić animację elementu nawigacji. Wprowadza też przeciążenia funkcji NavigationSuiteScaffold i NavigationSuiteScaffoldLayout, które mają parametr state. (I6a8c9, b/328674235)

Poprawki błędów

Przenieś zajęcia IconButtonColors i IconToggleButtonColors z poziomu IconButtonDefaults.kt z powrotem do poziomu IconButton.kt. (I3c233)

Darowizna zewnętrzna

Usługa SliderState#isDragging jest teraz publiczna. (I8458a)

Wersja 1.4.0-alpha06

15 stycznia 2025 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha06 został zwolniony. Wersja 1.4.0-alpha06 zawiera te komisy.

Zmiany w zachowaniu

Dodaliśmy displayCutout do grupy wstawek, które komponenty Material Design uwzględniają domyślnie, aby uniknąć nakładania się treści na wycięcie w ekranie. Ta zmiana zachowania wpłynie na działanie komponentów uwzględniających wcięcie w okolicach wycięcia w ekranie. Obejmuje to domyślną wartość parametru WindowInsets w przypadku komponentów Material 3 obsługujących wstawienie oraz wartości WindowInsets podane w obiektach domyślnych komponentów zarówno w przypadku Material 2, jak i Material 3. Jeśli ta zmiana powoduje niepożądane działanie, ręcznie określ parametr WindowInsets dla poszczególnych komponentów. (I43ee9, b/362508045)

Zmiany w interfejsie API

Aktualizacje interfejsu API TopAppBar. Zmień nazwę pasków aplikacji o średniej i dużej wielkości z podtytułem na *FlexibleTopAppBar. Ujednolicenie wariantów kolorów w jednej funkcji TopAppBarDefault.topAppBarColors() i dodanie parametru koloru subtitle, który ma być stosowany w przypadku podkomponentu napisów (I41b65)
Usuń interfejs API WideNavigationRailArrangement i użyj interfejsu Arrangement.Vertical (Id0341)
Dodaj nowy VerticalSlider @Composable. (I2bfba)
Dodaj nowy element ścieżki @Composable, który umożliwia określenie niestandardowych zewnętrznych rogów ścieżki i ikon ścieżki. (I436a4)
Zaktualizuj interfejsy API pływającej listy narzędzi, aby używały obiektu FloatingToolbarColors zamiast jednego koloru kontenera. (I9a054)
Dodawanie i używanie nowej eksperymentalnej adnotacji ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)
Modifier.indicatorLine ma teraz kształt pola tekstowego, aby umożliwić przycinanie. (I8c5f3, b/380704151)
Zmień nazwy eksperymentalnych funkcji FloatingAppBar na FloatingToolbar (I1dbf8)
Dodano nowy element floatingToolbarVerticalNestedScroll, który można dołączyć do przewijanego kontenera, aby zaktualizować stan rozszerzenia pływającej paska narzędzi na podstawie ruchu przewijania, który przekracza określony próg. (I6d65f)
Przedstawiamy nowy interfejs API do tworzenia pływającego paska narzędzi z dołączonym przyciskiem Floating Action Button (FAB). Interfejs API zapewnia elastyczne opcje dostosowywania, dzięki którym możesz ustawić pasek narzędzi poziomo lub pionowo oraz umieścić przycisk szybkiego działania na początku lub na końcu paska. (I9e350)

Poprawki błędów

Naprawiliśmy problem z dostępnością paska informacji, który powodował, że pasek był ogłaszany po zamknięciu, gdy włączona była opcja TalkBack. (/I9db53)

Darowizna zewnętrzna

Użyto wspólnego BasicTooltip w foundation i BasicTooltip/Tooltip w material3. (Ifc2e6)

Wersja 1.4.0-alpha05

12 grudnia 2024 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha05 został zwolniony. Wersja 1.4.0-alpha05 zawiera te komity.

Zmiany w interfejsie API

Zmień typ wartości WideNavigationRailState.current/target na enum, aby ułatwić czytelność (I2d6ab)
SplitButton Zmień interfejs API Shape z klasy danych na klasę, aby zapewnić zgodność binarną. (I53812)
Dodano interfejs API tooltip z parametrem onDismissRequest, dzięki któremu twórcy mogą decydować, co się stanie, gdy użytkownik kliknie poza dymek. wycofać stary interfejs API, który nie zawiera tego nowego parametru; (I99aef)
Zmień nazwę opticalCentering na horizontalCenterOptically. Zmień modyfikator na wewnętrzny. Zastąp parametr padding parametrami max start i max end. (I0b904)
Zmień WideNavigationRailState, aby miał wartość bieżącą lub docelową, i usuń typy wyliczenia na rzecz typów logicznych. (Idfa29, b/356039090)
Dodaj NavigationBarItemComponentOverride. (I3a06a)

Poprawki błędów

Popraw działanie górnego i dolnego paska aplikacji, aby zmieniał on kolor, gdy przewiniesz treści do końca. (Idc4e8, b/293665988)
Funkcje zachowania przewijania w przypadku górnego i dolnego paska aplikacji teraz zwracają zapamiętane zachowanie, aby lepiej działać podczas ponownego tworzenia. (I0fdbe, b/207957336)
Parametr modyfikatora jest teraz stosowany po modyfikatorach wewnętrznych, takich jak zachowanie i semantyka przeciągania, a nie przed nimi. Ma to wpływ na kolejność, w jakiej modyfikatory są stosowane. (I8d83f)
Rozwinięta plansza dolna pozostaje rozwinięta po zmianie rozmiaru. (I2870b, b/324934884)
Prawidłowo wyświetlać stan trasy i flagi paska nawigacyjnego w przypadku właściwości okien. (Ie674d, b/362539765)
Przesuń parametr modyfikatora do katalogu głównego szablonu zgodnie z dokumentacją. Dzięki temu implementacja będzie zgodna z M2. (I0235e, b/372311595)

Darowizna zewnętrzna

Funkcja wspólna DatePickerDialog. (I7dced)

Wersja 1.4.0-alpha04

13 listopada 2024 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha04 został zwolniony. Wersja 1.4.0-alpha04 zawiera te komisy.

Zmiany w zachowaniu

Przywróć zmiany kolorów wprowadzone w aosp/3212478 w elementach iconButtonColors, iconToggleButtonColors, outlinedIconButtonColors, outlinedIconToggleButtonColors i outlinedIconToggleButtonBorder. Przeniesienie zwróconego zachowania do nowego zestawu funkcji o nazwie iconButtonVibrantColors itd., aby podkreślić zwracane kolory o wysokim kontraście. (Iffd8d)

Nowe funkcje

Przedstawianie komponentu VerticalDragHandle (I6c770)

Zmiany w interfejsie API

Zmień nazwę DismissibleModalWideNavigationRailDefaults na ModalWideNavigationRailDefaults. (I8e877)
Dodaj NavigationBarComponentOverrides. (I8a3f3)
Dodaj NavigationRailComponentOverride. (I83e13)
Wprowadź element WideNavigationRailState, aby umożliwić zwijanie i rozwijanie szyny, zezwól na pominięcie elementu ModalWideNavigationRail i usuń element DismissibleModalWideNavigationRail. (I88568)
Dodaj domyślne rozmiary xSmall, medium, large i xLarge do domyślnych wartości przycisku przełącznika. (Ie95d1)
Domyślne rozmiary xS, M, L i XL dodaj do domyślnych ustawień przycisków. (If8b6d)

Poprawki błędów

Zgodnie ze specyfikacją kolor ikony podrzędnej elementu filtra został zmieniony z Ustaw głównego na OnSurfaceContainer. Zgodnie ze specyfikacją wszystkie kolory obrysu elementów zostały zmienione z Obrysu na Wariant obrysu. (I68bd4)

Wersja 1.4.0-alpha03

30 października 2024 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha03 został zwolniony. Wersja 1.4.0-alpha03 zawiera te komity.

Zmiany w interfejsie API

Konstruktor SheetState z gęstością został wycofany na rzecz progów pozycji i prędkości. (Ifd16e)
Dodano rememberTooltipPositionProvider, który zawiera zaktualizowaną logikę pozycjonowania. Wycofane: rememberPlainTooltipPositionProvider i rememberRichTooltipPositionProvider. (Ie66e2)
Dodatkowe opcje ModalBottomSheetProperties umożliwiają dostosowywanie kolorów paska stanu i paska nawigacyjnego. Domyślnie te aktualizacje są oparte na kolorze treści, a nie na ciemnym motywie systemu. (Ib874e, b/362539765)
Ulepszyliśmy proces wprowadzania danych w przypadku selektorów dat: w trybie wprowadzania dane pole tekstowe z datą będzie aktywne, aby umożliwić natychmiastowe wpisywanie tekstu. Zmiana ta powoduje dodanie parametru requestFocus do plików DatePicker i DateRangePicker. Możesz zapobiec skupieniu się na false. (I12d09, b/286399710, b/340102743)
Buforowanie ustawień domyślnych kształtu w obiekcie Shape. Ustawienie domyślnego kształtu @Composable dla przycisku przełączania. Zwijanie kształtów do jednego kształtu domyślnego, ponieważ warianty odwołują się do tego samego pliku tokenów. (Iaa014)

Poprawki błędów

Zoptymalizuj zachowanie szkieletu contentPadding, aby uniknąć ciągłego zmieniania treści w polu tekstowym po zmianie wartości contentPadding. (I8c8e2, b/373904168)
Nazwa TextFieldLabelScope progress została zmieniona na labelMinimizedProgress
Nazwa TextFieldLabelPosition Default została zmieniona na Attached. Usunięto elementy interfejsu. (If75c6)
Rozwiązano problem z elementem DatePicker w trybie wprowadzania danych, w którym błędy weryfikacji mogły powodować zmianę wysokości elementu. (I2e229, b/280462363)
Spraw, aby suwak materiału zmieniał swoją wartość po naciśnięciu klawiszy sterujących. (I1c442)

Wersja 1.4.0-alpha02

16 października 2024 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha02 został zwolniony. Wersja 1.4.0-alpha02 zawiera te komity.

Zmiany w interfejsie API

Aktualizacje selektorów dat, które zapewniają spójne używanie lokalizacji w elementach DatePicker i DateRangePicker podczas ustawiania lokalizacji bezpośrednio za pomocą elementu DatePickerState lub DateRangePickerState. Pamiętaj, że jeśli ustawisz lokalizację bezpośrednio na stan, musisz odpowiednio zlokalizować tekst tytułu i nagłówka, ponieważ domyślny tekst będzie nadal stosowany zgodnie z domyślną lokalizacją platformy. (I37073, b/326490763, b/321657276)
Usługa SheetState.isAnimationRunning jest teraz dostępna. (I9a3d7)
DatePickerColors mają teraz pierwszeństwo przed wszystkimi konfliktowymi kolorami zdefiniowanymi w stylach tekstu motywu. Pamiętaj też, że to uaktualnienie zmienia położenie parametru color w funkcjach selektora daty i wprowadza parametr contentColor, który umożliwia dostosowywanie kolorów nagłówka i tytułu. (I30d03, b/347031394)
Zmień nazwę interfejsu SplitButton na SplitButtonLayout i usuń interfejsy API wariantów kolorów SplitButton. Warianty będą tworzone przez ponowne użycie wariantów przycisku udostępnionych przez interfejs SplitButtonLayout.SplitButtonDefaults (I44c36)
Element ModalBottomSheet ma teraz parametr sheetGestureEnabled (I856cb, b/288211587)
Zmieniono nazwy standardMotionScheme i expressiveMotionScheme na standardowe i wyraziste. Obie funkcje są teraz dostępne w obiekcie towarzyszącym MotionScheme po wywołaniu funkcji MotionScheme.standard() i MotionScheme.expressive(). (Iceccf)
Dodawanie parametru maxWidth do prostych i rozwiniętych etykiet. Domyślnie jest to 200 dp w przypadku prostych etykiet narzędzia i 320 dp w przypadku rozbudowanych etykiet narzędzia. (I30ce9)

Poprawki błędów

Parametry DatePicker i DateRangePicker są teraz prawidłowo aktualizowane w przypadku wyświetlanego miesiąca, gdy są ustawione za pomocą displayedMonthMillis stanu. (If9e47, b/333414302)
Treści ModalBottomSheet są teraz usuwane z paska stanu. (I5114c, b/321877275, b/336962418, b/342093067)
[Bottom Sheet] Change back callback priority to PRIORITY_DEFAULT to allow IME keyboard to dismiss first. (I447fb)
Naprawiono problemy z zawieszaniem się funkcji DatePicker i DateRangePicker, gdy minimalny możliwy do wybrania rok jest ustawiony na rok przyszły. (I78656, b/319395747)
Rozwiązanie problemu z selektorem daty, aby zaktualizować interfejs po zastosowaniu zaktualizowanej instancji SelectableDates. (Iad59a, b/290135807, b/339898760)

Wersja 1.4.0-alpha01

2 października 2024 r.

Element androidx.compose.material3:material3-*:1.4.0-alpha01 został zwolniony. Wersja 1.4.0-alpha01 zawiera te komisy.

Zmiany w zachowaniu

Biblioteka nie dodaje już zależności do pliku material-icons-core, więc jeśli Twój projekt na niej polegał, musisz ją jawnie dodać do plików build.gradle[.kts]. (I735ff, b/349894318)
Aby poprawić użyteczność, kontrast kolorów i spójność w systemie (Ibc297), kolor aktywnej etykiety NavigationBarItem i NavigationRailItem zmieniliśmy z onSurface na secondary. Aby przywrócić poprzednie działanie, skopiuj domyślne kolory i zamień selectedTextColor na MaterialTheme.colorScheme.onSurface.
Komponenty Material 3 używają teraz nowego elementu MotionScheme do definiowania ruchu. (Ie0f93)
Nieokreślone zmiany ruchu kołowego wskaźnika postępu (I3c07e)
Zaktualizuj OutlinedIconButtonColors i OutlinedIconToggleButtonColors, aby uzyskać lepszy kontrast kolorów. (I2743d)
Zaktualizowano kolor kontenera i treści w przypadku FilledIconToggleButtonColors i FilledTonalIconToggleButtonColors. (Ic5d0f)
Zmieniono kolor obramowania elementu OutlinedButton z outline na outlineVariant. (057f00)

Zmiany w interfejsie API

Do funkcji enterAlwaysScrollBehavior w funkcji TopAppBar dodano opcjonalny parametr reverseLayout, aby lepiej obsługiwać treści ustawione za pomocą funkcji reverseLayout. (I4e0e5)
Funkcja SegmentedButton obsługuje teraz argument contentPadding. (I5ad91, b/358414376)
PullToRefreshState nie ma już domyślnej implementacji dla isAnimating (I6a593)
Dodano nowe przeciążenia funkcji Material TextField i OutlinedTextField, które korzystają z TextFieldState. Dodano interfejsy API do pudełka z ozdobą, które są zgodne z interfejsem TextFieldDecorator. (If13a1)
Dodano parametr do sterowania polem tekstowym labelPosition. Użycie alwaysMinimize umożliwia wyświetlanie etykiety i obiektu zastępczego w polu tekstowym jednocześnie, nawet gdy pole nie jest aktywne. (I1ef2c)
Dodano materiały SecureTextField i OutlinedSecureTextField do pól do wpisywania hasła. (I7e22d)
Dodano zakres do etykiet pól tekstowych, aby umożliwić wyświetlanie animacji postępu zapytania. (If5ec8)
Dodano obsługę właściwości MotionEvent.CLASSIFICATION_DEEP_PRESS w opisach narzędzia. (I62e6a)
W interfejsie parametr TimePickerState w modelu TimePickerState jest teraz wartością rozszerzenia zamiast zmienną, a jego nazwa została zmieniona na isPm (I89a97).isAfternoon
Aktualizacja klasy typograficznej w celu obsługi skali pogrubionego tekstu. (Ifa13c)
Dodano interfejs API ModalWideNavigationRail i przemianowano interfejsy API ModalExpandedNavigationRail na DismissibleModalWideNavigationRail. (Ic9118)
Zaktualizowano FloatingAppBarScrollBehavior, aby automatycznie obliczać screenOffset bez potrzeby @Composable. (Idf349)
Zaktualizowano interfejs API LoadingIndicator, aby poprawić nazewnictwo obiektu domyślnych. Dodano stałą LoadingIndicatorElevation w pozycji PullToRefresh. (I1d72b)
Zaktualizowano interfejs API LoadingIndicator, aby poprawić nazewnictwo obiektu domyślnych. Dodano stałą LoadingIndicatorElevation w pozycji PullToRefresh. (I1d72b)
Do nieokreślonych wariantów funkcji LinearWavyProgressIndicator i CircularWavyProgressIndicator dodano parametry amplitude i waveSpeed. (I2a0c5)
Obsługa zmiany kształtu ikony przełącznika w zależności od tego, czy jest wciśnięty czy zaznaczony. (Ibc781)
Aktualizacja klasy typograficznej w celu obsługi skali pogrubionego tekstu. (Ifa13c)
SplitButton kształty zniekształcone na podstawie stanu domyślnego lub wciśniętego. Usunięto interfejs API AnimatedTrailingButton, ponieważ interfejs API TrailingButton może oferować te same opcje dostosowywania (I95066)
Dodaj modyfikator, aby animować wyświetlanie i ukrywanie przycisku FAB, np. podczas przewijania treści. (I8338d)
Dodaj do ButtonGroupDefaults kształty połączonych grup przycisków i odstępy, aby użyć ich w próbce. (I68e30)
Dodanie poziomego odstępu dla przycisku końcowego w przycisku podzielonym oraz umożliwienie optycznego wyśrodkowania obliczonego na podstawie różnicy kątów początkowego i końcowego (I122e2)
Wprowadzamy nowy komponent Material MotionScheme, który umożliwia ustawienie schematu ruchu komponentu. Schemat jest ustawiany za pomocą MaterialTheme. (Id50c2)

Poprawki błędów

Zastosować prawidłowy indeks przejścia na fokus do Scaffold podrzędnych komponentów. kolejność to topBar, bottomBar, fab, content, snackbar. (I5936b)
Rozwiązaliśmy problem z elementami DatePicker i DateRangePicker, które w niektórych językach i w ramach szkieletów formatu nie zaczynały się wielką literą. (I1430f)
Integracja tokenów komponentów FAB i FAB Menu (niewielkie wizualne zmiany w odstępach i tekście) (Ib57f3)
ModalBottomSheet jest teraz pierwszym elementem w porządku semantycznym, a zaraz po nim pojawia się zasłaniacz. (I436f9, b/358594665)
Naprawiono problem polegający na tym, że dolny pasek aplikacji nie znikał całkowicie podczas przewijania w trybie od krawędzi do krawędzi (I3ee21).

Tworzenie wiadomości w Material3 w wersji 1.3

Wersja 1.3.2

9 kwietnia 2025 r.

Element androidx.compose.material3:material3-*:1.3.2 został zwolniony. Wersja 1.3.2 zawiera te komitowane zmiany.

Poprawki błędów

ListItem poprawia obliczenie wysokości, rezerwując odpowiednią ilość miejsca w układzie.
Usuń nadmiarowe wypełnienie etykiety NavigationBarItem, aby zachować zgodność ze specyfikacją.
Poprawia układ TabRow w trybie RTL.

Wersja 1.3.1

30 października 2024 r.

Element androidx.compose.material3:material3-*:1.3.1 został zwolniony. Wersja 1.3.1 zawiera te komitowane zmiany.

Poprawki błędów

Parametry DatePicker i DateRangePicker są teraz prawidłowo aktualizowane w przypadku wyświetlanego miesiąca, gdy są ustawione za pomocą displayedMonthMillis stanu. (If9e47, b/333414302)
Naprawiono problemy z zawieszaniem się funkcji DatePicker i DateRangePicker, gdy minimalny możliwy do wybrania rok jest ustawiony na rok przyszły. (I78656, b/319395747)
Rozwiązanie problemu z selektorem daty, aby zaktualizować interfejs po zastosowaniu zaktualizowanej instancji SelectableDates. (Iad59a, b/290135807, b/339898760)
Zmień priorytet wywołania zwrotnego używany przez karty dolne na PRIORITY_DEFAULT, aby umożliwić klawiaturze IME zamknięcie. (I447fb)

Wersja 1.3.0

4 września 2024 r.

Element androidx.compose.material3:material3-*:1.3.0 został zwolniony. Wersja 1.3.0 zawiera te komity.

Ważne zmiany od wersji 1.2.0

Najważniejsze funkcje w wersji 1.3.0

Nowe komponenty Material Design 3

Karuzela
- HorizontalMultiBrowseCarousel i HorizontalUncontainedCarouselUlepszenia dotychczasowych komponentów Material Design 3.
[ModalBottomSheet] Obsługa funkcji przewidywanego cofnięcia na U+ (Iccf32, b/281967264, b/304850357)
[SearchBar] Obsługa przewidywanego przejścia wstecz w U+ (I657f8)
Panel nawigacji (ModalDrawerSheet i DismissibleDrawerSheet) obsługuje teraz funkcję przewidywanego powrotu w U+ jako opcję (Ie5b0b)
DropdownMenu obsługuje teraz niestandardowe kolory, kształty, wzniesienie i obramowania. (I8e981,b/289554448, b/301887035, b/283654243)
Zaktualizowano suwak, aby ułatwić dostępność. Dodano przerwę i wskaźnik zatrzymania. (I3058e)
Zaktualizowaliśmy ProgressIndicator, aby ułatwić dostępność. Dodaliśmy wskaźnik przerwy i zatrzymania. (I21451)
Dodano domyślną kreskę w przypadku rozbudowanych etykiet narzędzia. Obsługa niestandardowych kresek w ramach danej kotwicy LayoutCoordinates. (Ifd42c) Zmiany powodujące niezgodność
Nowe interfejsy API do odświeżania przez przeciągnięcie:
- Uproszczone PullToRefreshState, aby używać wartości ułamkowych zamiast jednostek Dp.
- Stan isRefreshing jest kontrolowany przez użytkownika, a nie przez PullToRefreshState.
- Odseparowano zagnieżdżone połączenie przewijania z poziomu PullToRefreshState. Jest ona obsługiwana przez nową funkcję PullToRefreshBox lub Modifier.pullToRefresh.
- Ta aktualizacja wprowadza zmiany w poprzednich eksperymentalnych interfejsach API. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683) Zmiany w interfejsie
Aby zapewnić wystarczający kontrast kolorów, zaktualizuj nakładkę stanu fokusa na wartość 0,1f. (I7ea77)
Niewielkie zmiany domyślnych kolorów powierzchni i tła w lightColorScheme i darkColorScheme. (I9db52)
Zaktualizowaliśmy kolory suwaka i ProgressIndicator zgodnie z nowymi specyfikacjami kontrastu elementów innych niż tekst. (I26807)
SurfaceContainer wersje są teraz używane przez komponenty. Składniki, które formalnie obliczają kolor za pomocą wartości Surface i TonalElevation, teraz domyślnie używają ról SurfaceContainer, na które nie wpływa podnoszenie tonalności. (b/304584161)
Podstawowe role powierzchni i kontenera na powierzchnię zostały nieznacznie dostosowane, aby zapewnić większą intensywność kolorów w jasnym i ciemnym motywie. (I677a5)
Przeniesienie eksperymentalnych interfejsów API do stabilnych
Poprawa wydajności.

Wersja 1.3.0-rc01

21 sierpnia 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-rc01 został zwolniony. Wersja 1.3.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

ModalBottomSheet jest teraz pierwszym elementem w porządku semantycznym, a zaraz po nim pojawia się zasłaniacz. (I436f9, b/358594665)

Wersja 1.3.0-beta05

24 lipca 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-beta05 został zwolniony. Wersja 1.3.0-beta05 zawiera te komity.

Rozwiązaliśmy problem polegający na tym, że treści BottomSheet są niewidoczne lub przycięte na urządzeniach z Androidem N i O (a10a2d).
Zwiększono granice semantyczne suwaka, aby TalkBack prawidłowo wyświetlał wskaźniki skupienia wokół miniatur. (0b5a1d)

Wersja 1.3.0-beta04

26 czerwca 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-beta04 został zwolniony. Wersja 1.3.0-beta04 zawiera te zatwierdzenia.

Wersja 1.3.0-beta03

12 czerwca 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-beta03 został zwolniony. Wersja 1.3.0-beta03 zawiera te komisy.

Darowizna zewnętrzna

Udostępnij androidx.compose.material3.DropdownMenu z poziomu wspólnego zbioru źródeł. (If62c0)

Wersja 1.3.0-beta02

29 maja 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-beta02 został zwolniony. Wersja 1.3.0-beta02 zawiera te komity.

Zmiany w interfejsie API

Modifier.pullToRefreshIndicator obsługuje funkcję elevation, zaktualizuj interfejsy API funkcji „Przeciągnij, aby odświeżyć”, aby włączone było boolean zamiast funkcji lambda. Obsługa dopasowania treści w PullToRefreshBox (I75679)
Utworzenie zamkniętego interfejsu TooltipScope i implementacji wewnętrznej do użycia w TooltipBox i Label. (I3833e)
Do CarouselItemScope dodaliśmy 2 nowe modyfikatory – maskClip i maskBorder – aby można było łatwo dodawać kształty i obramowania do dowolnego elementu karuzeli (Id67a1).
TimePickerState jest teraz interfejsem i umożliwia ustawienie czasu (I88546)
Zaktualizowano interfejs API do stylizacji linków: przeniesiono TextLinkStyles do TextStyle i usunięto TextDefaults z materiału. (I5477b)

Poprawki błędów

Ikony stanu i paska nawigacji ModalBottomSheet reagują teraz na stan ciemnego motywu. (Ie1fe7, b/338342149)
Dodano do ModalBottomSheet scrim semantykę zamykania arkusza. (0e61cb,b/328801864)

Darowizna zewnętrzna

Udostępnij androidx.compose.material3.AlertDialog z poziomu wspólnego zbioru źródeł (Ia33f5).
Udostępnianie ModalBottomSheet z typowego zbioru źródeł (Id7cc7)

Wersja 1.3.0-beta01

14 maja 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-beta01 został zwolniony. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

Używanie DpSize zamiast CaretProperties. Usuwam CaretProperties. Zmień nazwę CaretScope na TooltipScope. (Id9a76)
Zaktualizowano interfejs API w celu uzyskiwania linków w stylu Material w tekście. W szczególności usunęliśmy z TextDefaults metody tworzenia tematycznych LinkAnnotations i analizowania kodu HTML za pomocą tematycznych linków. Zamiast tego dodaliśmy klasę TextLinkStyles, która umożliwia stylizowanie linków jako parametru w komponowalnym elemencie tekstu. (I31b93)

Wersja 1.3.0-alpha06

1 maja 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-alpha06 został zwolniony. Wersja 1.3.0-alpha06 zawiera te komity.

Zmiany powodujące niezgodność

Nowe interfejsy API do odświeżania przez przeciągnięcie:
- Uproszczone PullToRefreshState, aby używać wartości ułamkowych zamiast jednostek Dp.
- Stan isRefreshing jest kontrolowany przez użytkownika, a nie przez PullToRefreshState.
- Odseparowano zagnieżdżone połączenie przewijania z poziomu PullToRefreshState. Jest ona obsługiwana przez nową funkcję PullToRefreshBox lub Modifier.pullToRefresh.
- Ta aktualizacja wprowadza zmiany w poprzednich eksperymentalnych interfejsach API. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683)

Zmiany w interfejsie API

Pole RippleConfiguration#isEnabled zostało usunięte, a pole LocalRippleConfiguration zostało oznaczone jako dopuszczające wartość pustą. Aby wyłączyć efekt falowania, zamiast RippleConfiguration z wartością isEnabled = false użyj null z wartością LocalRippleConfiguration. (I22725)
ModalBottomSheet dokładniej wyświetla zasłonę na pasku stanu, gdy włączona jest opcja od krawędzi do krawędzi. Treści modalnych kart dolnych mogą teraz zajmować obszary w oknie, co pozwala na wyświetlanie treści nad paskiem nawigacji. Parametr ModalBottomSheet windowInsets został przemianowany na contentWindowInsets, aby można było określić, gdzie mają być stosowane wstawki. Nie są one już powiązane z logiką okna. Typ contentWindowInsets został zmieniony na funkcję zwracającą WindowInsets, aby umożliwić jej rozwiązanie w nowym oknie. (I39630, b/274872542, b/300280229, b/290893168)
PrimaryScrollableTabRow i SecondaryScrollableTabRow korzystają teraz z niestandardowego układu zamiast podkompozycji, co powinno zwiększyć skuteczność. (I991e0)
Oprócz normalnego stylowania, stylowania po najechaniu kursorem i po zaznaczeniu, linki tekstowe zyskały opcję stylowania w stanie wciśniętym. Metody TextDefaults mają argument pressedStyle, który to umożliwia. (Ic473f, b/139312671)

Poprawki błędów

Punkty kotwiczenia panelu nawigacyjnego są teraz dopasowane do szerokości drawerContent. (Ibc72f, b/245355396)
OutlinedTextField Dolne wypełnienie etykiety uwzględnia teraz rozmiar czcionki systemu. (Idc781)
Naprawiono lokalizację pakietu CalendarLocale. (Ifa235)
[Predictive Back] Aktualizacja animacji przewidywanego przejścia wstecz z wykorzystaniem krzywej interpolacji (0.1, 0.1, 0, 1) (I2591a)

Wersja 1.3.0-alpha05

17 kwietnia 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-alpha05 został zwolniony. Wersja 1.3.0-alpha05 zawiera te komity.

Nowe funkcje

Funkcje SearchBar i DockedSearchBar mają nowe przeciążenia, które przyjmują parametr pola tekstowego. Dzięki temu możesz nadać styl polu tekstowemu oddzielnie od reszty paska wyszukiwania oraz przekazywać niestandardowe pola tekstowe. Pole tekstowe bieżącej implementacji jest dostępne jako SearchBarDefaults.InputField. (I50c73, b/275074248, b/278773336, b/326627700)
Do publicznego interfejsu API dodano funkcję lambda drawTick, aby w razie potrzeby można było dostosowywać znaczniki czasu (I0c048).

Zmiany w interfejsie API

Linki tekstowe otrzymały opcję stylizacji w przyciśniętym stanie oprócz zwykłej stylizacji, gdy kursor jest nad linkiem lub gdy link jest zaznaczony (I5f864, b/139312671)
Zaktualizowano CarouselItemInfo, aby odsłonić prostokąt maski, w której jest przycinany element (I785d8).
Usunięto BasicTooltipState z publicznego interfejsu API Material 3. Jego funkcje są połączone z funkcjami TooltipState, dopóki BasicTooltip Foundation nie zostanie ustabilizowany. (Icda29)
Dodano obiekt TextDefaults, który zawiera metody tworzenia obiektu LinkAnnotation i analizowania ciągu znaków z tagami HTML, które stosują MaterialTheme do linków (I98532, b/139312671)
ExposedDropdownMenuBoxScope nie zezwala już na podklasy. Odkryte menu mają teraz wartość MenuAnchorType, która powinna zostać przekazana do menuAnchor, aby lepiej obsługiwać a11y. Należy używać tej funkcji zamiast przekazywania wartości focusable do funkcji ExposedDropdownMenu, która została wycofana. menuAnchor ma nowy parametr do kontrolowania stanu enabled. (I55ee6, b/257209915, b/308840226)
Naprawiono kolor obramowania elementu OutlinedButton, gdy jest wyłączony. Dodano przeciążenie ButtonDefaults.outlinedButtonBorder("enabled"), które przyjmuje stan włączony. (Ie650b, b/318461363)
Dodano nową klasę CarouselItemInfo, aby pomóc klientom uzyskać informacje o rozmiarach produktów. (I9070c)
Konstruktor ColorScheme bez kontenerów powierzchniowych został wycofany. Przejdź do konstruktora, który zawiera kontenery na powierzchni. (I35c11)
[Outlined]Nazwa TextFieldDefaults ContainerBox została zmieniona na Container. (Ie8d3b)

Poprawki błędów

Jeśli sheetSwipeEnabled ma wartość false, element BottomSheetScaffold nie będzie się już przewijać z poziomu elementu zagnieżdżonego. (I5e1c1, b/306464779)
Usunięto adnotację ExperimentalMaterial3Api z poziomu IconButtonSamples.kt. (I111d1)

Wersja 1.3.0-alpha04

3 kwietnia 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-alpha04 został zwolniony. Wersja 1.3.0-alpha04 zawiera te komity.

Nowe funkcje

Dodano 2 wersje eksperymentalne karuzeli Material3: HorizontalMultiBrowseCarousel i HorizontalUncontainedCarousel (I88d64).
Zaktualizowano panel nawigacyjny Compose M3 (ModalDrawerSheet i DismissibleDrawerSheet), aby obsługiwał funkcję przewidywanego cofnięcia w U+ jako opcję (Ie5b0b).
Dodano nowy interfejs API w ramach ikon, aby umożliwić przekazywanie odcienia koloru jako lambda, co pozwala uniknąć ponownego tworzenia. (I5b5a2)
Interfejsy API górnego paska aplikacji obsługują teraz niestandardowe wysokości zarówno w przypadku stałych, jak i zwijętych sekcji. (Ib8b0c, b/323403446)

Zmiany w interfejsie API

Interfejsy API górnego paska aplikacji obsługują teraz niestandardowe wysokości zarówno w przypadku stałych, jak i zwijętych sekcji. Rozwiązaliśmy problem, który powodował zbyt częste ponowne tworzenie pasków aplikacji z jednym wierszem podczas przewijania treści. Rozwiązaliśmy problem, który powodował, że MediumTopAppBar skracał tytuły na urządzeniach z dużymi ustawieniami czcionki/wyświetlania. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676)
Interfejs SegmentedButton i powiązane z nim interfejsy API są teraz stabilne (I8a158)
SwipeToDismissBox, SwipeToDismissBoxDefaults, SwipeToDismissBoxState i SwipeToDismissBoxValue są teraz oznaczone jako stabilne. (I5f000)
Usunięto wycofane typy enumeracji i interfejsy API DismissDirection i DismissValue. (I89ccd)
Dodano tag eksperymentalny do obiektu towarzyszącego CarouselState karuzeli. (I94154)
Wycofam usługę LocalMinimumInteractiveComponentEnforcement i wprowadzę w jej miejsce usługę LocalMinimumInteractiveComponentSize. (I7a7ac)
Konstruktor SearchBarColors jest teraz publiczny. (I769ca)
Dodano parametr gesturesEnabled do SwipeToDismissBox. (Idc59f, b/324170119)
Usunięto interfejsy API pól tekstowych, które zostały oznaczone jako wycofane lub eksperymentalne. (I1305f)

Wersja 1.3.0-alpha03

20 marca 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-alpha03 został zwolniony. Wersja 1.3.0-alpha03 zawiera te komity.

Zmiany wizualne powodujące niezgodność

Aby zapewnić wystarczający kontrast kolorów, zaktualizuj nakładkę stanu fokusa na wartość 0,1f. (I7ea77)
Niewielkie zmiany domyślnych kolorów powierzchni i tła w lightColorScheme i darkColorScheme. (I9db52)

Nowe funkcje

Dodano parametry do dostosowywania ExposedDropdownMenu. W menu jest teraz parametr focusable (domyślnie true), który podczas pracy z polami tekstowymi umożliwiającymi edycję należy ustawić na false. (I4184c, b/323694447, b/278609042)

Zmiany w interfejsie API

Oznaczenie ScaffoldSubcomposeInMeasureFix zostało usunięte. (Ie2a4b)
Urządzenie NavigationRailItemColors jest teraz oznaczone jako @Immutable. (If6112, b/327660613)
Urządzenie NavigationBarItemColors jest teraz oznaczone jako @Immutable. (I42a30, b/298064514)
Zmiana kolejności parametrów w komponowalnym suwaku. (I9f315)
Funkcja ExposedDropdownMenu jest teraz implementowana przy użyciu Popup. Sposób działania powinien być taki sam, z tym wyjątkiem, że menu z możliwością skupienia z polami tekstowymi, które można edytować, mogą zostać zamknięte podczas pisania na klawiaturze.

Poprawki błędów

Podstawowe role powierzchni i kontenera na powierzchnię zostały nieznacznie dostosowane, aby zapewnić większą intensywność kolorów w jasnym i ciemnym motywie. (I677a5)
Zaktualizowaliśmy kolory suwaka i ProgressIndicator zgodnie z nowymi specyfikacjami kontrastu elementów innych niż tekst. (I26807)
Aby zapewnić wystarczający kontrast kolorów, zaktualizuj nakładkę stanu fokusa na wartość 0,1f. (I7ea77)
Niewielkie zmiany domyślnych kolorów powierzchni i tła w lightColorScheme i darkColorScheme. (I9db52)

Wersja 1.3.0-alpha02

6 marca 2024 roku

Element androidx.compose.material3:material3-*:1.3.0-alpha02 został zwolniony. Wersja 1.3.0-alpha02 zawiera te komity.

Zmiany w interfejsie API

Stabilizacja suwaka. Ponownie ustawiam State.onValueChangeFinished jako wartość. Zawijanie onValueChangeFinished w rememberUpdatedState. (I82ab2, b/322269951)
Komponenty nawigacji używają teraz nowych ról SurfaceContainer. Element DrawerDefaults zawiera teraz osobne atrybuty standardContainerColor i modalContainerColor. DrawerDefaults.ModalDrawerElevation to teraz 0.dp. (I7fbac)
Usuwanie stanu @Stable z Slider, ponieważ zmieniamy stan state.onValueChangeFinished na var. (Ied34a, b/322269951)
Specyfikacja animacji ModalBottomSheet i StandardBottomSheet to teraz animacja TweenSpec, zaktualizowana z animacji sprężynowej. Rozwiązanie problemu z widocznym przeregulowaniem. Wycofane konstruktory SheetState bez gęstości zostały usunięte. (I7babc, b/285847707)

Poprawki błędów

SurfaceContainer wersje są teraz używane przez komponenty. Komponenty, które formalnie obliczają kolor za pomocą funkcji Surface i TonalElevation, teraz domyślnie używają ról SurfaceContainer, na które nie wpływa podnoszenie tonalne. (b/304584161)
Rozwiązano błąd, który powodował, że niewybrany, wyłączony kolor kontenera ElevatedFilterChip był czarny. (I400e6, b/322407043)
Poprawiono wskaźnik postępu bez określenia czasu oczekiwania, gdy postęp wynosi 0 (Id6582)
Rozwiązano problem z elementami Slider i RangeSlider w układzie od prawej do lewej (Iab0e1).
Dodawanie wartości SliderRangeTolerance do obliczenia zakresu suwaka, ponieważ zaokrąglanie liczb zmiennoprzecinkowych może być niedokładne. (Ic918a, b/324934900)
Upewnij się, że DatePickerDialog wyświetla przyciski podczas zagnieżdżania DateRangePicker lub wyświetlania dowolnego typu selektora daty na małych ekranach z większymi czcionkami. (Ie4758, b/325107799, b/277768544)
Użytkownik Menu korzysta teraz z roli SurfaceContainer do określania koloru kontenera. MenuDefaults.TonalElevation to teraz 0.dp. (I135b7)
Użytkownik TextField korzysta teraz z roli SurfaceContainerHighest do określania koloru kontenera. (I4dced)
Uprawnione komponenty korzystają teraz z roli SurfaceContainerLow (I7cd2f)
Kolor kontenera DatePicker to teraz SurfaceContainerHigh. DatePickerDefaults.TonalElevation to teraz 0.dp. (Ida753)
Zmienia kolor kontenera i uchwytu przeciągania kart dostępnych. (I72a0a)
Kolor kontenera RichTooltip to teraz SurfaceContainer. (Ia8b45)
Kolor kontenera SearchBar to teraz SurfaceContainerHighest. SearchBarDefaults.TonalElevation to teraz 0.dp. (I88604)
Aktualizuje przełącznik wyłączonych i niewybranych ścieżek/ikon, aby wykorzystać rolę koloru SurfaceContainerHighest. (I7687a)
Kolor kontenera AlertDialog to teraz SurfaceContainerHigh. (Ie0433)
Kolor kontenera BottomAppBar to teraz SurfaceContainer. Kolor TopAppBar onScroll to teraz SurfaceContainer. (I41630)
Kolor kontenera ElevatedCard to teraz SurfaceContainerLow. Kolor kontenera FilledCard: SurfaceContainerHighest. (I35141)
Kolor kontenera ElevatedButton to teraz SurfaceContainerLow. Gdy FilledIconButton jest niewybrany, ma teraz kolor kontenera SurfaceContainerHighest. (I792c9)
Zaktualizowano kolor kontenera TimePicker i kolor tarczy zegara na SurfaceContainerHighest. (I43b93)

Wersja 1.3.0-alpha01

21 lutego 2024 r.

Element androidx.compose.material3:material3-*:1.3.0-alpha01 został zwolniony. Wersja 1.3.0-alpha01 zawiera te commity.

Nowe funkcje

Zaktualizuj funkcję Compose M3 ModalBottomSheet, aby obsługiwała funkcję przewidywanego cofania na U+ (Iccf32, b/281967264, b/304850357)
Zaktualizowano Compose M3 SearchBar, aby obsługiwał funkcję przewidywanego cofnięcia w U+ (I657f8).
Zaktualizowano suwak, aby ułatwić dostępność. Dodano przerwę i wskaźnik zatrzymania. (I3058e)
Zaktualizowaliśmy ProgressIndicator, aby ułatwić dostępność. Dodaliśmy wskaźnik przerwy i zatrzymania. (I21451)
Dodanie domyślnej strzałki w przypadku rozbudowanych etykiet narzędzia. Nowy interfejs API dla rozbudowanych etykiet narzędzia umożliwia teraz wyświetlanie niestandardowej strzałki przy danym zakotwiczeniu LayoutCoordinates. (Ifd42c)

Zmiany w zachowaniu

Komponenty Material Design zostały przeniesione do nowych interfejsów API ripple i nie odwołują się już do RippleTheme.

Zmiany w interfejsie API

Zabawa drawStopIndicator jest teraz publiczna. (I3f59f)
Oznacz funkcję DatePicker formatWithSkeleton jako wewnętrzną (Ic65dc)
DropdownMenu obsługuje teraz niestandardowe kolory, kształty, wzniesienie i obramowania. (I8e981, b/289554448, b/301887035, b/283654243)
Komponenty Material3, które w swoim interfejsie API udostępniają wartość MutableInteractionSource, zostały zaktualizowane, aby udostępniać wartość MutableInteractionSource, która może być pusta i domyślnie ma wartość null. Nie ma tu żadnych zmian semantycznych: przekazanie wartości null oznacza, że nie chcesz podnosić MutableInteractionSource, i w razie potrzeby zostanie on utworzony wewnątrz komponentu. Ustawienie wartości null pozwala niektórym komponentom nigdy nie przydzielać MutableInteractionSource, a innym pozwala tworzyć instancję tylko wtedy, gdy jest to konieczne, co zwiększa wydajność tych komponentów. Jeśli nie używasz wartości MutableInteractionSource przekazywanej do tych komponentów, zalecamy przekazanie zamiast niej wartości null. Zalecamy też wprowadzenie podobnych zmian w własnych komponentach. (I41abb, b/298048146)
Dodaje opcje RippleConfiguration i LocalRippleConfiguration, aby umożliwić dostosowywanie fal za pomocą wartości stałych w poszczególnych komponentach lub poddrzewiu. Możesz na przykład zmienić kolor komponentu, którym nie zarządzasz, lub wyłączyć efekt falowania. W większości przypadków należy używać wartości domyślnych: te interfejsy API są wyjściem awaryjnym umożliwiającym dostosowywanie poszczególnych komponentów lub ograniczonych poddrzewi. W przypadku szerszych zmian i niestandardowych systemów projektowania należy utworzyć własną falę za pomocą funkcji createRippleModifierNode. (I7b5d6, b/298048146)
Dodano nowy interfejs API ripple w material3, który zastępuje wycofany interfejs rememberRipple. Dodaje też tymczasowy CompositionLocal, LocalUseFallbackRippleImplementation, aby cofnąć komponenty material3 do korzystania z wycofanych interfejsów API rememberRipple / RippleTheme. Zostanie on usunięty w kolejnych stabilnych wersjach. Jest to tylko tymczasowe ułatwienie migracji w przypadku, gdy używasz niestandardowego RippleTheme. (I34cbc, b/298048146)

Poprawki błędów

Usunięto podkompozycję w komponentach ModalBottomSheet, aby zwiększyć wydajność. Rozwiązaliśmy problem, który powodował awarię ModalBottomSheet w określonych scenariuszach w połączeniu z LookaheadScope. (I2a198)
Usunięto podkompozycję w komponentach BottomSheetScaffold, aby zwiększyć wydajność. Rozwiązaliśmy problem, który powodował zawieszanie się BottomSheetScaffold w określonych scenariuszach w połączeniu z LookaheadScope. (Ie6401)
Wyrównanie plakietki jest dostosowane tak, aby była bliżej środka treści kotwicy w stosunku do prawego górnego rogu. (I18a28)
Rozwiązaliśmy problem a11y z funkcją DateRangePicker, w której tytuł tekstu Miesiąc–Rok był przekazywany jako element interaktywny do czytnika ekranu, Switch Access i Voice Access. (I2ac55)
Naprawiono błąd dotyczący kolejności parametrów mediumTopAppBarColors. (Ibe64a)

Wersja 1.2

Wersja 1.2.1

6 marca 2024 roku

Element androidx.compose.material3:material3-*:1.2.1 został zwolniony. Wersja 1.2.1 zawiera te komity.

Poprawki błędów

Ustabilizuj stany suwaka. Ponownie ustawiam State.onValueChangeFinished jako wartość. Zawijanie onValueChangeFinished w rememberUpdatedState. (Ie8fd0, b/322269951)
Usuwanie stanu @Stable z Slider, ponieważ zmieniamy stan state.onValueChangeFinished na var. (I82ba1, b/322269951)
Popraw NavigationBar kolory niestandardowe, aby były kopiowane z domyślnych. (80a779, b/326894020)
Napraw regresję w ExposedDropdownMenu, aby umożliwić ponowne ustawienie punktu zaznaczenia (3fcec1, b/323694447)
Napraw problem z buforowaniem kolorów przycisków (3e5bbc b/327371655)

Wersja 1.2.0

7 lutego 2024 r.

Element androidx.compose.material3:material3-*:1.2.0 został zwolniony. Wersja 1.2.0 zawiera te zatwierdzenia.

Znany problem

W wersji PrimaryTabRow w ramach poprawy wydajności wprowadzono błąd dotyczący renderowania interoperacyjności widoku i kompozycji. Aby obejść ten problem, użyj funkcji TabRow z funkcją TabRowDefaults.PrimaryIndicator

Ważne zmiany od wersji 1.1.0

Nowe komponenty Material Design 3

Pociągnij, aby odświeżyć
- PullToRefreshContainer
- PullToRefreshState
Przycisk podzielony na segmenty

Ulepszenia dotychczasowych komponentów Material Design 3.

Dolny pasek aplikacji (wyrównanie do prawej, automatyczne ukrywanie podczas przewijania)
- BottomAppBarScrollBehavior
Aktualizacja wyglądu kart
- PrimaryIndicator
- SecondaryIndicator
Odznaka (aktualizacja wyrównania)

Interfejsy API w wersji eksperymentalnej zostały przeniesione do wersji stabilnej.

Ulepszenia wydajności

Więcej informacji znajdziesz w tym poście na blogu.

Wersja 1.2.0-rc01

24 stycznia 2024 r.

Element androidx.compose.material3:material3-*:1.2.0-rc01 został zwolniony. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Poprawki błędów

Naprawiono błąd dotyczący kolejności parametrów mediumTopAppBarColors. (Ibe64a)
Naprawiono błąd wprowadzony w 1.2.0-beta02 w CardDefaults.cardColors, który powodował, że contentColor nie aktualizował się na podstawie wartości parametru containerColor. (Iee041, b/319671246)
Naprawiono błąd w funkcji disabledContentColor wprowadzony w wersji 1.2.0-beta02 oraz wprowadzono drobną optymalizację. (I6dda1, b/318428829)

Wersja 1.2.0-beta02

10 stycznia 2024 r.

Element androidx.compose.material3:material3-*:1.2.0-beta02 został zwolniony. Wersja 1.2.0-beta02 zawiera te commity.

Znany błąd

Błąd w IconButtonColors spowoduje, że domyślnie disabledContentColor zostanie przypisana wartość alfa (0,38 f) z LocalContentColor, a nie z ustawionej przez użytkownika wartości contentColor. Aby obejść ten problem, musisz jawnie ustawić wartość disabledContentColor. Naprawimy to w kolejne wersji.

Zmiany w interfejsie API

Dodaliśmy możliwość włączenia strzałek w opisie w przypadku interfejsów API typu Plain Tooltip. (Ibf767)
Nazwa elementu SwipeToDismissState, rememberSwipeToDismiss i SwipeToDismissValue została zmieniona na _SwipeToDismissBox_. (I68d6d)

Poprawki błędów

Naprawiono wartość wypełnienia końca ListItem, aby była zgodna ze specyfikacją (Ibd68b, b/305342674).
Kolor obrysu dla obrysowanej karty jest teraz prawidłowo mapowany na OutlineVariant. (I75480, b/310979715)
Kolor dynamiczny jest teraz pobierany z zdefiniowanych przez system ról kolorów. Poprawia to kontrast w przypadku ułatwień dostępu i bardziej dopasowuje dynamiczne kolory do specyfikacji Material (I1de96).
Rozwiązanie problemu z obsługą przycisku ModalBottomSheet na Androidzie T/13 i nowszych, gdy android:enableOnBackInvokedCallback="true". (I728dc, b/306196110)

Wersja 1.2.0-beta01

13 grudnia 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-beta01 został zwolniony. Wersja 1.2.0-beta01 zawiera te commity.

Zmiany w interfejsie API

Oznacz TabIndicatorScope jako eksperymentalny. (I45c88)
Usuwanie wycofanych eksperymentalnych interfejsów API w przypadku opisu. (I438cb)
Zmień nowe przeciążenia TabRow, aby nie używać podkompozycji. W efekcie wskaźniki TabRow są tworzone w inny sposób, z użyciem niestandardowych modyfikatorów. (Ife741)
Wycofanie interfejsów API DismissDirection i DismissValue. Zostały one scalone w wartość SwipeToDismissValue, której wartości wskazują zarówno pozycję, jak i kierunek SwipeToDismissBox. Wartość w polu DismissState.progress jest teraz oznaczona jako FloatRange między 0.0 a 1.0. DismissState wycofane narzędzia Saver i Constructor zostały usunięte. Obiekt komponentu SwipeToDismiss, stan i wartości domyślne zostały oznaczone jako eksperymentalne. (Ib54f2)

Poprawki błędów

Domyślny wskaźnik PullToRefresh to teraz otwarta strzałka, a nie pełny trójkąt. (I67be3)

Wersja 1.2.0-alpha12

29 listopada 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha12 został zwolniony. Wersja 1.2.0-alpha12 zawiera te commity.

Zmiany w interfejsie API

RangeSlider przyjmuje teraz zakres Kotlina (np. 0f..1f) zamiast niestandardowej klasy wartości FloatRange. SnapFlingBehavior.kt używa teraz też zakresu Kotlin. (I025cb)
Oznacz funkcję fabryki modyfikatora jako @Stable. (Ib109f)

Wersja 1.2.0-alpha11

15 listopada 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha11 został zwolniony. Wersja 1.2.0-alpha11 zawiera te zatwierdzenia.

Nowe funkcje

Wdrożono komponenty PullToRefreshContainer i PullToRefreshState, które razem zapewniają implementację odświeżania przez przeciągnięcie w Material 3. (I16456, b/261760718)

Zmiany w interfejsie API

Oznacz SwipeToDismissBox DismissDirection i DismissValue jako eksperymentalne. (I517b0)
Zmień nazwę SwipeToDismiss na SwipeToDismissBox. Zmień nazwę funkcji background na backgroundContent, a funkcji dismissContent na content. (I7f4d3)
Ustaw konstruktor ChipElevation i SelectableChipElevation jako publiczny. (Ie0c48, b/308432421)
Dodaję ModalBottomSheetProperties. Przenoszę securePolicy do ModalBottomSheetProperties. Dodaję użytkowników isFocusable i shouldDismissOnBackPress do listy ModalBottomSheetProperties. Te nowe wartości logiczne pomagają określić, jak modalny panel dolny powinien obsługiwać zdarzenia IME. (Iea56f, b/278216859)
Zaktualizowano stany RangeSlider i Slider, aby usunąć initialOnValueChange, początkowe prefiksy i odpowiednie kdocs. (I57d30)
Klasa ChipBorder i powiązane z nią wywołania funkcji są wycofywane. Zalecamy bezpośrednie używanie klasy BorderStroke. (I89cc2)
Interfejsy API etykiet podstawy to teraz @ExperimentalFoundationApi. (I30b0b)
Funkcje TabRow i ScrollableTabRow nie są już wycofane. Nowe warianty podstawowy i dodatkowy są oznaczone jako eksperymentalne. (I0def6)
Elementy filtra i elementy wejściowe korzystają teraz bezpośrednio z elementu BorderStroke. (I07a8d)
SegmentedButton korzysta teraz bezpośrednio z BorderStroke. (I89b9b)
Zmieniliśmy nazwę ogólnej funkcji AlertDialog na BasicAlertDialog i wycofaliśmy poprzednią funkcję. (Idbe52)
Zmień nazwę interfejsów API SwipeToDismiss na SwipeDismiss i przekształć nowe interfejsy API SwipeDismiss w stabilne. (I14cbe)
Dodano elementy tonalElevation i shadowElevation do interfejsów API tooltip. Dodatkowo interfejsy API TooltipBox, PlainTooltip i RichTooltip wracają do wersji eksperymentalnej, ponieważ zostały przypadkowo opublikowane jako stabilne. (If0f66, b/293939035)
Przeniesienie eksperymentalnych interfejsów API układów do wersji stabilnych. (Iea2c3)
Usunięto adnotację @ExperimentalMaterial3Api z klikalnych kart Material3. (I88dbf)

Poprawki błędów

Rozwiązaliśmy problem, który powodował zawieszanie się SwipeToDismiss w określonych scenariuszach z zagnieżdżonymi układami z wyprzedzeniem i układami leniwymi. (Ica8d1, b/297226562)

Wersja 1.2.0-alpha10

18 października 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha10 został zwolniony. Wersja 1.2.0-alpha10 zawiera te zatwierdzenia.

Zmiany w interfejsie API

Promowanie wersji Badge i BadgedBox na stabilną. (I67f16, b/261565132)
Dodanie parametru securePolicy do elementu ModalBottomSheet, aby użytkownicy mogli określić działanie elementu WindowManager.LayoutParams.FLAG_SECURE. (Icdac8, b/296250262)
Dodano nowe przeciążenia funkcji LinearProgressIndicator i CircularProgressIndicator, które przyjmują progress jako funkcję lambda. Powinny one działać lepiej niż poprzednie wersje. (I824e6, b/295616656)
Zmienia nazwę StandardSizeClasses na AllSizeClasses. (I8cb07)
Połącz funkcje obliczania klas wielkości okna. (Iad935)

Poprawki błędów

Naprawiono błąd DatePicker, który występował podczas szybkiego klikania przycisków strzałek nawigacyjnych, gdy wyświetlany miesiąc znajdował się na skraju dozwolonego zakresu lat. (I46f36, b/290954897, b/297002119)
[Pasek nawigacyjny] Obsługa przezroczystego koloru dla wskaźnika. (Ie0a9b, b/267289987)

Wersja 1.2.0-alpha09

4 października 2023 roku

Element androidx.compose.material3:material3-*:1.2.0-alpha09 został zwolniony. Wersja 1.2.0-alpha09 zawiera te commity.

Zmiany w interfejsie API

Przeniesione interfejsy ModalNavigationDrawer i DismissibleNavigationDrawer korzystają z nowych interfejsów AnchoredDraggable. Metoda animateTo klasy DrawerState została zastąpiona metodami open i close, a offset jest teraz wyświetlany jako liczba zmiennoprzecinkowa zamiast obiektu stanu. Możesz uzyskać do niego dostęp bezpośrednio w currentOffset. (I0a72c)
Dodano funkcje nieskładane, które umożliwiają bezpośrednie tworzenie funkcji DatePickerState i DateRangePickerState. W razie potrzeby te funkcje można używać jako alternatywy dla funkcji kompozytowych rememberDatePickerState i rememberDateRangePickerState. (I70326, b/291524052)
Elementy statyczne i przewijane TabRows mają teraz warianty główny i dodatkowy. Te wartości są poprawnie mapowane na kolory i zachowanie wskaźnika zgodnie z definicją w Material3.
PrimaryScrollableTabRow i SecondaryScrollableTabRow teraz pokazują stan przewijania. (Iec8f5, b/260572337)
Dodawanie nowego parametru sheetMaxWidth, który programiści mogą ustawić, aby określić maksymalną szerokość arkusza. Jeśli chcesz, aby arkusz zajmował całą szerokość ekranu, możesz przekazać parametr Dp.Unspecified. (Ifb7c9, b/266697696)
Dodano interfejsy API PlainTooltipBox i RichTooltipBox jako przestarzałe metody. (I246fa)

Poprawki błędów

Naprawienie problemu z awarią, który występuje, gdy DatePicker jest inicjowany za pomocą DatePickerFormatter, który zawiera określone szkielety dat, które pozostają takie same po przekonwertowaniu na wzorce dat (np. YY). (I01f29)

Wersja 1.2.0-alpha08

20 września 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha08 został zwolniony. Wersja 1.2.0-alpha08 zawiera te zatwierdzenia.

Zachowanie się w sposób niezgodny z oczekiwaniami

Opcja ColorScheme jest teraz niezmienna, co zmniejsza efektywność poszczególnych aktualizacji kolorów, ale zwiększa efektywność częstszego używania kolorów. Powodem tej zmiany jest fakt, że większość aplikacji nie ma potrzeby aktualizowania poszczególnych kolorów. Nadal jest to możliwe, ale będzie wymagać większej liczby ponownego kompilowania niż wcześniej. W związku z tym znacznie zmniejszyliśmy liczbę subskrypcji stanu w całym kodzie Material. Zmniejszy to koszty inicjalizacji i koszt uruchomienia w przypadku wielu standardowych zastosowań. (Ic447d, b/297212873)
Zgodnie ze specyfikacją animacja podniesienia dźwięku nie jest już wyświetlana w różnych stanach interakcji (Icdd12).

Zmiany w interfejsie API

Dodano nową funkcję BottomAppBar, która jako parametr przyjmuje wartość BottomAppBarScrollBehavior, aby automatycznie ją ukrywać podczas przewijania treści. Dodano też FabPosition.EndOverlay, dzięki któremu przycisk szybkiego działania nakłada się na dolny pasek aplikacji w rusztowaniu zamiast być nad nim zakotwiczony. (Iecb47)
Dodaliśmy prosty komponent Label, który jest tworzony na podstawie BasicTooltipBox i nie znika, gdy klikniesz poza jego granicami. (I821f9)

Poprawki błędów

Usunięto użycie rememberSaveable w etykietkach. (Icc131, b/299500338)
Wprowadziliśmy tymczasową flagę, która pozwala określić, czy Scaffold ma mierzyć swoje elementy podrzędne podczas pomiaru czy podczas umieszczania. Domyślnie jest to pomiar. Jeśli masz problemy z nową funkcją, prześlij zgłoszenie. (I0b354)
Naprawiono poziome krawędzie w BottomSheet, używając prawidłowego pomiaru szerokości ekranu urządzenia. (I1df0c, b/299058752)
Naprawiliśmy błąd polegający na tym, że funkcja ModalBottomSheet nie wywoływała funkcji onDismissedRequest, gdy została zamknięta przez przesunięcie w dół. (Idfdd8)

Wersja 1.2.0-alpha07

6 września 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha07 został zwolniony. Wersja 1.2.0-alpha07 zawiera te zatwierdzenia.

Nowe funkcje

W wersji compose material 1.6.0-alpha05 dodano obsługę automatycznego lustrzanego odbicia ikon. Szczegółowe informacje na ten temat znajdziesz w notatkach do wersji.

Zmiany w interfejsie API

SliderState implementuje DraggableState (I9b116)
Zmień kształt na wymagany parametr. Zmień nazwę position na index w funkcji pomocniczej shape. (I34941)
Aktualizuje DatePicker formatWithSkeleton, aby uwzględnić mapę, która jest używana jako pamięć podręczna w celu poprawy wydajności. (I3195f)
Dodano BasicTooltipBox do compose.foundation oraz zaktualizowano PlainTooltipBox i RichTooltipBox, aby używać TooltipBox z nowymi komponentami PlainTooltip i RichTooltip. (I79e1d)

Poprawki błędów

Parametry dynamicLightColorScheme i dynamicDarkColorScheme zwracają teraz wyższe wartości chromatyczne dla ról powierzchni i surfaceContainer. (I5e901)
Rozwiązaliśmy problem, który powodował, że niektóre komponenty korzystające z podkompozycji (np. BottomSheetScaffold) w ramach szkieletu w LookaheadScope próbowały odczytać swój rozmiar zbyt wcześnie. (I297b4, I871f1, b/295536718)

Wersja 1.2.0-alpha06

23 sierpnia 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha06 został zwolniony. Wersja 1.2.0-alpha06 zawiera te commity.

Poprawki błędów

Naprawiono obliczenia DropdownMenu, aby przesunięcia X zależały tylko od lokalnego kierunku układu, a przesunięcia Y nie będą już odwracane, gdy menu znajduje się w pobliżu dołu ekranu.offset (Iccc74, b/294103942)
Naprawiono obliczenia DropdownMenu, aby przesunięcia X zależały tylko od lokalnego kierunku układu, a przesunięcia Y nie będą już odwracane, gdy menu znajduje się w pobliżu dołu ekranu.offset (Ib87a2, b/294103942)

Wersja 1.2.0-alpha05

9 sierpnia 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha05 został zwolniony. Wersja 1.2.0-alpha05 zawiera te commity.

Zmiany w interfejsie API

Aktualizacje kolorów pola wyboru i TriStateCheckbox. CheckboxDefaults.colors() disabledUncheckedColor ma teraz wpływ tylko na obramowanie pola wyboru. Specjalne przypadki, w których musisz ustawić wewnętrzny kolor pola, gdy pole jest wyłączone lub odznaczone, wymagają niestandardowego konstruowania instancji CheckboxColors z żądanymi wartościami kolorów. (I77d17, b/291943198)

Wersja 1.2.0-alpha04

26 lipca 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha04 został zwolniony. Wersja 1.2.0-alpha04 zawiera te commity.

Nowe funkcje

Eksperymentalny interfejs API przycisku segmentowanego (Ifc8fb)
Separatory mają teraz parametr do kontrolowania orientacji, aby obsługiwać separatory pionowe. (I4c899, b/288438593)

Zmiany w interfejsie API

Przenosimy zależność od gęstości na poziom komponentu. Dotyczy to tych komponentów: SwipeToDismiss i komponentów opartych na arkuszach. Użyj nowej podanej przeciążenia, w której gęstość jest parametrem. (I1846e)
Dodatkowe adnotacje określające dozwolone dane wejściowe dla komponentów (Ief234)
Dodaj parametr ikony do przycisku segmentowanego, podziel semantykę, aby można było wybierać przyciski segmentowane w celu implementacji wyboru pojedynczego oraz przełączać je w celu implementacji wyboru wielokrotnego, odpowiednio za pomocą SelectableSegmentedButtonRow i ToggelableSegmentedButtonRow. (I38740)
Nazwa Divider została zmieniona na HorizontalDivider. Dodano funkcję VerticalDivider. (I5975c)
Aby zminimalizować automatyczne tworzenie okna, w eksperymentalnych interfejsach API Material3 zmień użycie ClosedFloatingPointRange na lżejszą wersję FloatRange. (I4aab5)
Dodano nowe wyrównanie Start dla FabPosition (Ib7aea, b/170592777).

Poprawki błędów

ModalBottomSheet uwzględnia lokalny kierunek układu. (Ib4f44, b/285628622)

Wersja 1.2.0-alpha03

21 czerwca 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha03 został zwolniony. Wersja 1.2.0-alpha03 zawiera te komisy.

Zmiany w zachowaniu

W typografii Material 3 includeFontPadding jest teraz domyślnie ustawione na false. Domyślny styl wysokości wiersza został również zmieniony na Trim.None i Alignment.Center, a do TextStyle Typography dodano jawne wartości lineHeight (w sp). Jeśli chcesz dostosować te wartości, zapoznaj się z dokumentacją interfejsu API. Szczegółowe informacje o tych zmianach znajdziesz w tym poście na blogu. (I6266f, Icabc3)

Nowe funkcje

Dodano przeciążenie funkcji RangeSlider, która jest wersją stanu komponentu. Utworzono RangeSliderState, który zawiera wszystkie informacje o bieżącym aktywnym śladzie, pomiary komponentów RangeSlider oraz logikę przeciągania i gestyk. (I8c270)
Pasek wyszukiwania obsługuje teraz cienie dzięki nowemu parametrowi shadowElevation. (Ia5369, b/271040353)
ColorScheme obsługuje teraz nowe role SurfaceContainer.
Nakładkę tonalną powierzchni można teraz wyłączyć za pomocą kompozycję lokalnej LocalTonalElevationEnabled. (Ic203c, b/277774590)

Zmiany w interfejsie API

Otwórz konstruktory kolorów komponentów. (I8c4a6)
Dodanie parametru focusable do obu interfejsów interfejsów tooltip API, aby deweloperzy mogli zdecydować, czy tooltip ma obsługiwać zdarzenia dotykowe, czy nie. Pamiętaj, że może to spowodować przerwanie automatycznego przechodzenia w ramach funkcji ułatwień dostępu. (Ie32d8)
Optymalizacja ułatwień dostępu pod kątem wydajności i przydziału pamięci. (Iede48)
Udostępnij DefaultSizeClasses i utwórz StandardSizeClasses dla WindowSizeClasses (I91838)
zmień WindowWidth/HeightSizeClass na klasy wartości zmiennoprzecinkowych (Ie686e);

Poprawki błędów

Parametr contentWindowInsets w rusztowaniu uwzględnia teraz okna wbudowane. Pamiętaj, że zachowanie wypełniania treści na podstawie parametrów topBar i bottomBar pozostaje niezmienione, gdy te parametry są podane. (I08b73, b/264601542)
Popraw wyrównanie paska aplikacji u góry środka, aby długi tytuł nie był renderowany nad ikonami działań ani ikoną nawigacji. (I4369f, b/236994621)
Pozycje kart mają teraz minimalną szerokość treści wynoszącą 24 dp. Dzięki temu użytkownicy mogą dotknąć wskaźnika karty. (Id8861)
Dynamiczne palety kolorów z dynamicLightColorScheme i dynamicDarkColorScheme obsługują teraz nowe role powierzchni. (I1252e)
Zmiana wyrównania powiadomienia na plakietce, aby nie było przycinane, gdy koliduje z dziadkiem. (Idf75a)

Wersja 1.2.0-alpha02

24 maja 2023 r.

Element androidx.compose.material3:material3-*:1.2.0-alpha02 został zwolniony. Wersja 1.2.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

Dodaj parametr okna w pozycji ModalBottomSheet.
- Zasłona ModalBottomSheet może być teraz wyświetlana za paskiem stanu, gdy windowInsets ma wartość 0.
- Zaktualizowano domyślną funkcję ModalBottomSheet, aby nie była widoczna na paskach systemowych, w tym na pasku nawigacji
- Obsługa wstawiania paska stanu jest dostępna za pomocą uchwytu przeciągania w trybie od krawędzi do krawędzi.
- BottomSheetDefaults zawiera wstawione okna dla BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)
Wycofaj Indicator i dodaj Primary/SecondaryIndicator, aby dopasować specyfikację do M3. PrimaryIndicator pasuje do szerokości treści na karcie, podczas gdy SecondaryIndicator zajmuje całą dostępną szerokość. SecondaryIndicator jest odpowiednikiem wycofanej funkcji Indicator i może być jej bezpośrednim zamiennikiem. (I27604)
Dodano opcję przekazywania wartości ScrollState podczas tworzenia obiektu DropdownMenu lub ExposedDropdownMenu, aby kontrolować stan przewijania pionowego wyświetlanych elementów menu. (Ia0734, b/185304441)
Dodano przeciążenie funkcji Slider, która jest wersją stanu komponentu. Utworzono SliderState, który zawiera wszystkie informacje o bieżącym aktywnym śladzie, pomiary komponentów Slider oraz logikę przeciągania i gestyk. (I124a5)
Zmiana nazwy usługi Semantics o nazwie isContainer na isTraversalGroup (I121f6)
Dodano zoptymalizowany TextStyle.merge(...) z pełną listą parametrów. (Iad234, b/246961787)
Udostępniono interfejsy TooltipState, RichTooltipState i PlainTooltipState. Dodano stany domyślne RichTooltipStateImpl i PlainTooltipStateImpl. Dodano funkcje remember*State, które umożliwiają uzyskanie tych wdrożonych stanów. Usunięto TooltipSync na rzecz TooltipDefault.GlobalMutatorMutex. (I7813d)
Zaktualizowaliśmy DatePickerColors, aby zawierała dodatkowe opcje dostosowywania kolorów selektora daty, elementów nawigacyjnych i tekstu. (I1a685, b/274626815)
Interfejsy DatePickerState i DateRangePickerState są teraz interfejsami publicznymi z domyślnymi implementacjami, które można pobrać za pomocą interfejsów rememberDatePickerState i rememberDateRangePickerState. (I71c52)
Usunęliśmy parametr dateValidator z elementów DatePicker i DateRangePicker oraz wprowadziliśmy interfejs SelectableDates, który można ustawić w stanie, aby kontrolować, które daty lub lata są dostępne do wyboru w interfejsie. (Ic2fc6)
TimePicker usunięty ze stabilnego interfejsu API, spodziewane są dalsze zmiany w interfejsie API stanu (I3f39a)
Element ModalBottomSheet został przeniesiony tylko na Androida. ModalBottomSheet nie jest zalecane do użytku na komputerze, a ta funkcja nie jest aktywnie utrzymywana. (Ib3778)

Poprawki błędów

Naprawiono błąd, który powodował, że gdy działania nakładały się na siebie, aby zmieścić się w szerokości okna dialogowego, działanie AlertDialog odrzucania było wyświetlane pod działaniem potwierdzenia. Ta poprawka dopasowuje implementację do specyfikacji Material Design (I029de, b/235454277).
Naprawiono błąd w elementach ListItem, który powodował nieprawidłowe wypełnianie elementów z 3 wierszami. (I6e235)
ModalBottomSheet może teraz wyświetlać klawiaturę IME (Idc508, b/262140644, b/268380384, b/272483584).

Wersja 1.2.0-alpha01

10 maja 2023 r.

androidx.compose.material3:material3:1.2.0-alpha01 i androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 są dostępne. Wersja 1.2.0-alpha01 zawiera te commity.

Wersja 1.1

Wersja 1.1.2

20 września 2023 r.

androidx.compose.material3:material3:1.1.2 i androidx.compose.material3:material3-window-size-class:1.1.2 są dostępne. Wersja 1.1.2 zawiera te zatwierdzenia.

Poprawki błędów

Naprawiono błąd polegający na tym, że modyfikator był nieprawidłowo przekazywany do 2 komponentów. (b/282761472)
Rozwiązano problem z funkcją TimePickerState, która zwracała nieprawidłowe godziny po zainicjowaniu z 23 godzinami. (b/278242122)
Naprawiono początkowy stan przełącznika w przypadku weryfikacji godziny 12:00 i minut. (b/269768197, b/282790635)
Naprawiono błąd z parametrem state.hour zwracającym nieprawidłową wartość o godzinie 23:00. (b/282761472, b/278242122)

Wersja 1.1.1

21 czerwca 2023 r.

androidx.compose.material3:material3:1.1.1 i androidx.compose.material3:material3-window-size-class:1.1.1 są dostępne. Wersja 1.1.1 zawiera te zatwierdzenia.

Poprawki błędów

Dodaje wywołanie ModalBottomSheet bez parametru windowInset, aby zapewnić zgodność binarną. (Ib7959)
Dodaj parametr okna w pozycji ModalBottomSheet.
- Zasłona ModalBottomSheet może być teraz wyświetlana za paskiem stanu, gdy windowInsets ma wartość 0.
- Zaktualizowano domyślną funkcję ModalBottomSheet, aby nie była widoczna na paskach systemowych, w tym na pasku nawigacji
- Obsługa wstawiania paska stanu jest dostępna za pomocą uchwytu przeciągania w trybie od krawędzi do krawędzi.
- BottomSheetDefaults zawiera wstawione okna dla BottomSheetWindow. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/275486106, b/268433162)

Wersja 1.1.0

10 maja 2023 r.

androidx.compose.material3:material3:1.1.0 i androidx.compose.material3:material3-window-size-class:1.1.0 są dostępne. Wersja 1.1.0 zawiera te zatwierdzenia.

Najważniejsze funkcje wersji 1.1.0

Nowe komponenty systemu Material Design 3

Ulepszenia dotychczasowych komponentów Material Design 3.

Interfejsy API w wersji eksperymentalnej zostały przeniesione do wersji stabilnej.

Więcej informacji znajdziesz w tym poście na blogu.

Wersja 1.1.0-rc01

19 kwietnia 2023 r.

androidx.compose.material3:material3:1.1.0-rc01 i androidx.compose.material3:material3-window-size-class:1.1.0-rc01 są dostępne. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

TimePicker usunięty ze stabilnego interfejsu API, spodziewane są dalsze zmiany w interfejsie API stanu (I3f39a)
Element ModalBottomSheet został przeniesiony tylko na Androida. ModalBottomSheet nie jest zalecane do użytku na komputerze, a ta funkcja nie jest aktywnie utrzymywana. (Ib3778)

Wersja 1.1.0-beta02

5 kwietnia 2023 r.

androidx.compose.material3:material3:1.1.0-beta02 i androidx.compose.material3:material3-window-size-class:1.1.0-beta02 są dostępne. Wersja 1.1.0-beta02 zawiera te commity.

Zmiany w interfejsie API

Użytkownik SheetState ma teraz parametr opcjonalny skipHiddenState
Użytkownik rememberStandardBottomSheetState ma teraz parametr opcjonalny skipHiddenState
Plakietka BottomSheetScaffold ma teraz zdefiniowany ukryty element kotwiczenia, który jest domyślnie wyłączony
Zaktualizowano dokumentację SheetState.requireOffset
Nazwa BottomSheetDefaults.MinimizedShape została zmieniona na BottomSheetDefaults.HiddenShape (I839f4, b/273870234)

Poprawki błędów

Gdy włączona jest funkcja eksploracji dotykiem, nie przechodź z tarczy godzin na minut. (I717d0)
Semantyka uchwytu przeciągania w komponentach ModalBottomSheet i BottomSheetScaffold została połączona. (I05afb)
Parametry BottomSheetScaffold, containerColor i contentColor mają teraz wpływ tylko na zawartość. (I992cb)
BottomSheetScaffold nestedScroll dla treści arkuszy korzysta teraz z przewijania. (I992cb)

Wersja 1.1.0-beta01

22 marca 2023 r.

androidx.compose.material3:material3:1.1.0-beta01 i androidx.compose.material3:material3-window-size-class:1.1.0-beta01 są dostępne. Wersja 1.1.0-beta01 zawiera te commity.

Zmiany w interfejsie API

Dodaj parametr typu układu do kompozytowalnej funkcji TimePicker. Umożliwia używanie różnych układów w zależności od konfiguracji ekranu (Ia0e16).
SearchBarDefaults został oznaczony jako funkcja eksperymentalna. (I65561)
Dodano cienie w elementach BottomSheetScaffold (I94e0f)
Dodaliśmy obsługę wyświetlania selektorów dat bez nagłówka. Zmiany w interfejsie API umożliwiające przekazywanie nagłówka o wartości null podczas tworzenia selektora dat. Możesz teraz przekazywać null w nagłówku, tytule i showToggleMode = false, aby wyświetlić selektor bez interfejsu. (Id3f3a, b/266132421, b/267194809)

Poprawki błędów

Paski wyszukiwania są teraz automatycznie wyodrębniane, gdy nie są aktywne. (I22a7c, b/261444487)
Zaktualizowano DateRangePicker, aby umożliwić wybór zakresu z tą samą datą rozpoczęcia i zakończenia. (I16529, b/272882497)
Pola tekstowe prawidłowo pozycjonują elementy tekstowe, gdy rozmiar czcionki jest mniejszy od oczekiwanego. Może to spowodować zmianę kilku pikseli w aplikacjach na podstawie ustawień czcionki i skryptu. (I8b8d0)
Działania semantyczne na planszy dolnej mają teraz etykiety. (I277b0)

Wersja 1.1.0-alpha08

8 marca 2023 r.

androidx.compose.material3:material3:1.1.0-alpha08 i androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 są dostępne. Wersja 1.1.0-alpha08 zawiera te zatwierdzenia.

Nowe funkcje

Dodaliśmy obsługę właściwości BottomSheetScaffold i BottomSheetScaffoldState. (I063d4)

Zmiany w interfejsie API

Dodaliśmy do funkcji DatePickerState i DateRangePickerState możliwość ustawiania dat po utworzeniu stanu oraz resetowania wyborów przez ustawianie daty null. Ustawianie dat ręcznie powinno być wykonywane ostrożnie. Nowa funkcja setSelection zgłasza wyjątek, jeśli podana data nie spełnia warunku wstępnego (patrz dokumentacja). (Ifa645, b/268609314, b/270427389)
Zmień nazwę pola SheetValue w stanie „Zwiniętym” na PartiallyExpanded, aby bardziej elastycznie i dokładnie odzwierciedlać działanie w tym stanie. (Ia1491)
Zmieniliśmy nazwy parametrów ListItem na _content zamiast _text. Domyślne metody dostępu są teraz w odpowiednich przypadkach ReadOnlyComposables. (I69a25)
Przeniesienie interfejsów API interaktywnej przeglądarki z kategorii eksperymentalnej do stabilnej. (I90d59, b/261561812)

Poprawki błędów

Rozwiązaliśmy problem, który powodował nieprawidłowe obliczanie stanu ModalBottomSheet HalfExpanded, przez co arkusz wydawał się unosić. (I45e84, b/268411386)
Dodaj pole wyboru confirmValueChange do klikalnego przycisku ModalBottomSheet. (I2311a, b/270425759)
Przesuń semantyczne BottomSheet działania do uchwytu przeciągania. (I158ba)
ModalBottomSheet teraz powoduje skupienie się na poleceniach po uruchomieniu i obsługuje przycisk Wstecz. (I4d2ab)
ModalBottomSheet onDismissRequest jest teraz obsługiwany również podczas zagnieżdżonych przewijania. (I655c5, b/268433166)

Wersja 1.1.0-alpha07

22 lutego 2023 roku

androidx.compose.material3:material3:1.1.0-alpha07 i androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 są dostępne. Wersja 1.1.0-alpha07 zawiera te commity.

Nowe funkcje

Dodaj kompozyt danych wejściowych Czas, który działa z rememberTimePickerState(). Kompozycja ta jest zgodna ze specyfikacją M3 dotyczącą danych wejściowych Czas (Ia4fab).
Dodano interfejs API Material 3 DateRangePicker do wybierania zakresu dat. (I7a6c3, b/267194809)
Dodano obsługę trybu wprowadzania danych Material 3 w przypadku wyboru zakresów dat za pomocą interfejsu API DateRangePicker. (Ifdbc4)
Kolory pól tekstowych można teraz dostosowywać:
- Kolory pól tekstowych i miejsc do wklejania danych zależne od stanu skupienia i błędu. Parametr textColor nosi teraz nazwę unfocusedTextColor, a parametr placeholderColor nosi teraz nazwę unfocusedPlaceholderColor.
- Kolor kontenera dla wypełnionych pól tekstowych na podstawie stanu błędu z nowym parametrem errorContainerColor.
Kolory pól tekstowych w menu rozwijanym zostały zaktualizowane o parametry, aby obsługiwać nowe interfejsy API prefiksów i suffiksów. (I9c8b4, b/254284181, b/264766350)

Zmiany w interfejsie API

wycofanie niektórych wersji interfejsu Slider API i usunięcie zbędących przeciążeń Slidera, które są obsługiwane przez nowy eksperymentalny Slider z niestandardowym przyciskiem i ścieżką; Promowanie wersji RangeSlider na stabilną. (Ie8fbd)
Zmieniono nazwę funkcji defaultElevation na elevation w funkcjach podnoszenia poziomu w elementach. (I0f872)
Te interfejsy API pól tekstowych Material 3 nie są już eksperymentalne: TextField, OutlinedTextField, textFieldWithLabelPadding, textFieldWithoutLabelPadding, outlinedTextFieldPadding. (Ieb5c0, b/261561819)
TimePickers is24Hour używa ustawienia systemu (I18856)
Usunięto eksperymentalną adnotację z api interfejsów szkieletu. (Ibb51e, b/261565765, b/261436953)

Poprawki błędów

Domyślny kształt ModalBottomSheet to teraz zawsze SheetDefaults.ExpandedShape. (I0dfca)
Ulepszenia ułatwień dostępu w przypadku interfejsu Material 3 (DatePicker i DateRangePicker). (I5087e)
Usunięto błąd, który powodował rozpowszechnianie ograniczenia maksymalnej wysokości i możliwe było jego zawieszanie. (I30d8c)
Usunięto semantyczne role z klikalnych i wybieralnych powierzchni. Zaktualizowano komponenty, które używały tych ról, aby przypisać role za pomocą modyfikatora semantyki (I793d9).

Wersja 1.1.0-alpha06

8 lutego 2023 r.

androidx.compose.material3:material3:1.1.0-alpha06 i androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 są dostępne. Wersja 1.1.0-alpha06 zawiera te commity.

Nowe funkcje

Pola tekstowe obsługują teraz tekst prefiksu i postfiksu (Ia8578, b/179884561).
Dodano funkcję TimePicker, aby wyświetlać selektor czasu zgodnie ze specyfikacją Material 3. Funkcja ta jest używana w połączeniu z funkcją TimePickerState i łatwą metodą rememberTimePickerState (I71910).
Dane wejściowe dotyczące daty są teraz wyświetlane w trybie DatePicker. Dodano obsługę przełączania się między trybem selektora daty a trybem wprowadzania daty. (Ieeff7)
Dodano interfejs API dla RichTextTooltips. (I58ef3)
Implementacja modalnej planszy dolnej w ramach Material 3, w tym ModalBottomSheet i ModalBottomSheetDefaults. Wprowadza też elementy SheetState i rememberSheetState, które można wykorzystać w przyszłych komponentach arkuszy. (I0853a, b/244189383)

Zmiany w interfejsie API

Stabilizacja interfejsu API showSnackbar (I195c2, b/261424370)
Stabilizacja interfejsów API dla elementu pomocy i elementu z propozycją (Ibb67b, b/261424370)
Przeniesienie interfejsów API ListItem, ListItemDefaults i ListItemColors z wersji eksperymentalnej do wersji stabilnej (I7e7fa, b/261438882)
Przeniesienie interfejsów SliderPositions, SliderDefaults.Thumb i SliderDefaults.Track do wersji stabilnej oraz dodanie interfejsów Slider i RangeSlider, które zawierają niestandardowe miniatury i ścieżki. Wycofujemy też poprzednie interfejsy API Slider i RangeSlider. (Ie5ea6, b/261566890)
Zmienna Modifier.tooltipAnchor() jest teraz publiczna, więc deweloperzy mogą ją przekazać do kotwicy, aby wskazać, że po długim naciśnięciu powinna się wyświetlić etykietka. Zaktualizowano interfejs API PlainTooltipBox, aby nie zezwalać na wartość null dla parametru TooltipState. Teraz ma on wartość domyślną. (Ie2fb7)
Aby zachować spójność, ProgressIndicatorDefaults.circularTrackColor zostało oznaczone jako @Composable. (Id29cc)
Przywrócono metodę LocalMinimuTouchTargetEnforcement gettera właściwości, oznaczono ją jako przestarzałą i przekierowano do LocalMinimumInteractiveComponentEnforcement. (I60dd5)

Wersja 1.1.0-alpha05

26 stycznia 2023 r.

androidx.compose.material3:material3:1.1.0-alpha05 i androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 są dostępne. Wersja 1.1.0-alpha05 zawiera te commity.

Nowe funkcje

DatePickerDialog i ułatwienia dostępu
Dodano niestandardowy miniaturę i ścieżkę do RangeSlider.

Aktualizacje zależności

Compose UI i Compose Material zależą teraz od Lifecycle 2.6.0.

Wersja 1.1.0-alpha04

11 stycznia 2023 r.

androidx.compose.material3:material3:1.1.0-alpha04 i androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 są dostępne. Wersja 1.1.0-alpha04 zawiera te commity.

Nowe funkcje

Początkowy interfejs API DatePicker do wybierania pojedynczej daty za pomocą interfejsu kalendarza. Ten interfejs API jest nadal modyfikowany. (I722b9)
Dodano obsługę prostych etykiet za pomocą PlainTooltipBox. (I0cdfb)
Pasek wyszukiwania (Iad128)
SwipeToDismiss (I458a8, b/242889540)

Zmiany w interfejsie API

Dodano właściwość semantyki IsContainer w sekcji Powierzchnie. Ta właściwość zostanie użyta w późniejszej zmianie, która określa kolejność przechodzenia na podstawie znaczenia semantycznego elementów, takich jak powierzchnie. (I63379)
Oznacz interfejsy API powiązane z drawerem jako stabilne. (Iab01e, b/261439597)
Dodaliśmy parametr koloru ścieżki dla kółkowych wskaźników postępu oraz parametr zakończenia obrysu zarówno dla kółkowych, jak i liniowych wskaźników postępu. (Ie668c, b/216325962, b/222964817)
Dodanie możliwości zwracania wartości null dla ukrytych funkcji wycofanych (Ibf7b0)
Dodaj Modifier.minimumInteractiveComponentSize. Można go użyć, aby zarezerwować co najmniej 48 dp, aby uniknąć niejednoznaczności interakcji dotykowych, jeśli element ma być mniejszy. (I33f58, b/258495559)
Dodano eksperymentalny interfejs API do komponowania AlertDialog, który ma slot na zawartość. (Iec4a2)

Poprawki błędów

Wskaźniki postępu są teraz prawidłowo ograniczone do oczekiwanego zakresu. (I8a7eb, b/262262727)

Znany problem

Podczas aktualizacji z wersji androidx.compose.foundation:1.4.0-alpha03 na androidx.compose.foundation:1.4.0-alpha04 może wystąpić błąd java.lang.NoSuchFieldError. Tutaj problem został zgłoszony po raz pierwszy. Przesłaliśmy poprawkę, która będzie dostępna w następnej aktualizacji Compose. Aby obejść ten problem, zaktualizuj biblioteki androidx.compose.material i androidx.compose.material3 do najnowszej wersji(1.1.0-alpha04) lub obniż wersję biblioteki androidx.compose.foundation do 1.4.0-alpha03.

Wersja 1.1.0-alpha03

7 grudnia 2022 r.

androidx.compose.material3:material3:1.1.0-alpha03 i androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 są dostępne. Wersja 1.1.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

Zmieniliśmy nazwę consumedWindowInsets() na consumeWindowInsets(), a withConsumedWindowInsets() na onConsumedWindowInsetsChanged() i uczyniłeś modyfikatory publicznymi. (Ie44e1)
Dodaj nowe domyślne wypełnienie treści dla przycisku tekstowego z ikoną do użycia. (I8f662)
Dodano wyłączone kolory dla paska nawigacji i szyny. (Ia7892, b/258867034)
Dodano interfejs API Modifier, aby zapytać o informacje dotyczące przewijania przodków (I2ba9d, b/203141462).
Służy w Clickable do prawidłowego opóźnienia interakcji z przyciskiem, gdy gesty mogą stać się zdarzeniami przewijania.
Rozwiązaliśmy problem, który powodował, że Clickables nie opóźniał prawidłowo efektów falujących, gdy był używany w ramach Scrollable ViewGroup.
Zaktualizowano panele i arkusz, aby prawidłowo opóźniać naciśnięcia w przypadku, gdy gesty mogą stać się zdarzeniami przewijania.

Aktualizacje zależności

Compose UI i Compose Material są teraz zależne od wersji Lifecycle 2.5.1. (I05ab0, b/258038814)

Wersja 1.1.0-alpha02

9 listopada 2022 r.

androidx.compose.material3:material3:1.1.0-alpha02 i androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 są dostępne. Wersja 1.1.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

Aby zwiększyć elastyczność, funkcje awaitFirstDown i waitForUpOrCancellation obsługują teraz parametr PointerEventPass (poprawiono też problem z wyświetlaniem menu podczas przewijania przez funkcję ExposedDropdownMenuBox).(I7579a, b/212091796)
Dodano parametr minLines do komponentów material i material3 Text, TextField i OutlinedTextField, który umożliwia ustawienie minimalnej wysokości komponentu w ujęciu liczby wierszy (I4af1d).
wycofanie funkcji TopAppBarDefaults smallTopAppBarColors na rzecz nowej funkcji topAppBarColors, której należy używać podczas tworzenia funkcji TopAppBar; (Ie6cb9)
Dodano parametr minLines do BasicText i BasicTextField. Umożliwia ustawienie minimalnej wysokości tych komponentów w ujęciu liczby wierszy (I24294, b/122476634)

Poprawki błędów

Przytnij zawartość komponentu Material3 IconButton i IconToggleBotton do kształtu warstwy stanu (np. koła). (I9da8f)
Aktualizacja pasków aplikacji z Material3 o średniej i dużej wielkości, aby zastosować ten sam kolor tła na całej ich powierzchni, oraz umożliwić ustawienie zastąpienia kolorów domyślnych przez wartości kolorów przezroczystych. (I67659, b/249688556, b/250838918)

Wersja 1.1.0-alpha01

24 października 2022 r.

androidx.compose.material3:material3:1.1.0-alpha01 i androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 są dostępne. Wersja 1.1.0-alpha01 zawiera te commity.

Poprawki błędów

Poprawki w górnym pasku aplikacji, gdy tytuł jest stosowany za pomocą TextStyle i Brush. (If667e)

Wersja 1.0

Wersja 1.0.1

9 listopada 2022 r.

androidx.compose.material3:material3:1.0.1 i androidx.compose.material3:material3-window-size-class:1.0.1 są dostępne. Wersja 1.0.1 zawiera te zatwierdzenia.

Poprawki błędów

Aktualizacja pasków aplikacji z Material3 o średniej i dużej wielkości, aby zastosować ten sam kolor tła na całej ich powierzchni, oraz umożliwić ustawienie zastąpienia kolorów domyślnych przez wartości kolorów przezroczystych. (I67659, b/249688556, b/250838918)

Wersja 1.0.0

24 października 2022 r.

androidx.compose.material3:material3:1.0.0 i androidx.compose.material3:material3-window-size-class:1.0.0 są dostępne. Wersja 1.0.0 zawiera te zatwierdzenia.

Najważniejsze funkcje wersji 1.0.0

To pierwsza stabilna wersja Compose Material 3.

Motyw Material Design 3 i dynamiczny kolor Material You

Komponenty Material Design 3

Plakietka
- Plakietka, Plakietka w polu
Dolny pasek aplikacji
- BottomAppBar
Przyciski
- Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
Przycisk typu FAB i rozszerzony przycisk typu FAB
- SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
Karty
- Card, OutlinedCard, ElevatedCard
Pole wyboru
- Pole wyboru
Procesory
- AssistChip, ElevatedAssistChip, FilterChip, ElevatedFilterChip, InputChip, SuggestionChip, ElevatedSuggestionChip
Dialogi
- AlertDialog
Separator
- Separator
Menu
- DropdownMenu, DropdownMenuItem, ExposedDropdownMenuBox
Lista
- ListItem
Pasek nawigacyjny
- NavigationBar
Panel nawigacji
- ModalNavigationDrawer, ModalDrawerSheet, DismissibleNavigationDrawer, DismissibleDrawerSheet, PermanentNavigationDrawer, PermanentDrawerSheet
Pasek nawigacyjny
- NavigationRail
Wskaźnik postępu
- CircularProgressIndicator, LinearProgressIndicator
Opcja
- RadioButton
Suwak
- Suwak, RangeSlider
Przełącz
- Przełącz
Karty
- Tab, LeadingIconTab, TabRow, ScrollableTabRow
Pola tekstowe
- TextField, OutlinedTextField
Pasek aplikacji u góry
- TopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
Ikona
- Ikona, przycisk ikony
Tekst
- Text
Surface
- Powierzchnia
Układ
- Scaffold
Kolor treści
- LocalContentColor

Klasa rozmiaru okna

material3-window-size-class to nowa biblioteka, która obsługuje klasy rozmiarów okna: zestaw punktów przecięcia widocznego obszaru, które ułatwiają projektowanie, tworzenie i testowanie układów aplikacji z możliwością zmiany rozmiaru. Za pomocą calculateWindowSizeClass możesz pobrać instancję klasy rozmiaru okna, która pozwala określić wygląd interfejsu użytkownika, np. wyświetlanie paska nawigacyjnego zamiast paska nawigacyjnego u dołu w przypadku większych rozmiarów okna. Więcej informacji i przykłady użycia znajdziesz w dokumentacji interfejsu API WindowSizeClass.
Więcej informacji znajdziesz w tym poście na blogu.

Wersja 1.0.0-rc01

5 października 2022 r.

androidx.compose.material3:material3:1.0.0-rc01 i androidx.compose.material3:material3-window-size-class:1.0.0-rc01 są dostępne. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

Dodano parametr slotu, aby umożliwić obsługę tekstu w interfejsie API pola tekstowego (Iaac0d, b/227146125)

Wersja 1.0.0-beta03

21 września 2022 r.

androidx.compose.material3:material3:1.0.0-beta03 i androidx.compose.material3:material3-window-size-class:1.0.0-beta03 są dostępne. Wersja 1.0.0-beta03 zawiera te komitowane zmiany.

Zmiany w interfejsie API

ExposedDropdownMenuDefaults zawiera teraz wartość wypełnienia dla elementów menu. (I34ee1)
ExposedDropdownMenuBoxScope ma teraz modyfikator Modifier.menuAnchor(), który powinien zostać przekazany do pola tekstowego, aby zapewnić prawidłowe działanie zgodne z a11y. (I27fa3)
Dodanie 2 przeciążonych metod interfejsu Slider API, które umożliwiają użytkownikom przekazywanie miniatury lub ścieżki w celu wypełniania suwaka. (I21c00)

Poprawki błędów

Zaktualizowano mapowanie kolorów ciemnego motywu dla kontenera On Error Container na ton 90 (Ic5612).
Poprawka umożliwiająca ustawienie przezroczystego tła dla małych pasków aplikacji Material 3. (I645e2, b/245575782)

Wersja 1.0.0-beta02

7 września 2022 roku

androidx.compose.material3:material3:1.0.0-beta02 i androidx.compose.material3:material3-window-size-class:1.0.0-beta02 są dostępne. Wersja 1.0.0-beta02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

Domyślne wcięcia komponentów wprowadzone w komponentach m3 w wersji beta01 nie uwzględniają już wcięć IME.
Komponent Material3 Scaffold ma teraz parametr contentWindowInsets, który umożliwia określenie liczby wstawek do obsługi w przypadku slotu na zawartość. (Icf11a, b/243713323)
wycofuje eksperymentalną funkcję SmallTopAppBar z Material 3 i wprowadza równoważną funkcję TopAppBar. Przeprowadź migrację danych na nowe konto. (I74404, b/226918634)
Dodaje opcje kontroli nad przesuwaniem i przypinaniem na górnym pasku aplikacji. (I15c81)
Usuwa startIndent z Divider, przenosi kolor do ostatniego parametru. (If7be2)

Poprawki błędów

Okno dialogowe powinno się identyfikować w systemie TalkBack, ogłaszając słowo „Dialog” podczas wyświetlania. (I857ef)

Wersja 1.0.0-beta01

24 sierpnia 2022 r.

androidx.compose.material3:material3:1.0.0-beta01 i androidx.compose.material3:material3-window-size-class:1.0.0-beta01 są dostępne. Wersja 1.0.0-beta01 zawiera te commity.

Informacje o interfejsie API

Aby zobaczyć najnowsze motywy, komponenty i inne dostępne komponenty, zapoznaj się z artykułem Omówienie interfejsu API Compose Material 3.

Zmiany w interfejsie API

Zaktualizowaliśmy górny pasek aplikacji w Material 3, aby można było go całkowicie zwinąć lub rozłożyć. Zaktualizowano też funkcję zachowania TopAppBarDefaults, aby była to kompozycja, oraz podano domyślne wartości stanu paska aplikacji u góry i specyfikacji animacji. (I642b3)
Zaktualizowano podpisy komponentów FAB, aby pasowały do interfejsu API (I3afaa).
Dodano wbudowaną obsługę wstawek na pasku aplikacji, w drawerach, na pasku nawigacji i na pasku bocznym. Te komponenty, używane osobno lub z Scaffold, będą automatycznie obsługiwać wgłębienia dla deweloperów. Uwaga: ta zmiana nie powoduje automatycznego obsługiwania ikon paska stanu ani przezroczystości paska stanu i paska nawigacyjnego. Aby zapewnić sobie jak najlepsze wrażenia, nadal rób to ręcznie. (I7e4e6, b/183161866)
Zaktualizowano domyślne wartości komponentów, aby zmniejszyć powierzchnię interfejsu API i ulepszyć elastyczność oraz wydajność. (I31820)
Zmieniono kolejność parametrów karty i sekcji panelu nawigacyjnego, aby zachować spójność w interfejsie API (I45d0b).
Usunięto parametr startIndent z funkcji Divider i przeniesiono kolor na ostatni parametr (If7be2).

Wersja 1.0.0-alpha16

10 sierpnia 2022 r.

androidx.compose.material3:material3:1.0.0-alpha16 i androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 są dostępne. Wersja 1.0.0-alpha16 zawiera te commity.

Nowe funkcje

Obsługa ustawiania niestandardowej szerokości szuflady nawigacyjnej. (Ia7f10)

Zmiany w interfejsie API

Zmiana kolejności parametrów karty Tab i Leading icon, aby zachować spójność w interfejsie API (Ie2637)
Oznaczone jako eksperymentalne.BadgeDefaults (I98ef3)
Usuń wycofaną funkcję panelu nawigacyjnego. (I4f2db)
Zmiana kolejności parametrów suwaka w Material 3 w celu zachowania spójności w interfejsie API (I0aee7)
Zmień kolejność parametrów NavigationBar i NavigationRail, aby zachować spójność w interfejsie API (I51cda)
Zmień kolejność parametrów w Material 3, aby zachować spójność w interfejsie API. (If4ae1)
Zmiana kolejności parametrów suwaka w Material 3 w celu zachowania spójności w interfejsie API (I62673)
Zmieniono nazwę parametru „ikony” na „działania”, aby była zgodna z górnym paskiem aplikacji (Id75be).
Oznacz opcje Badge i BadgedBox jako eksperymentalne, ponieważ wyrównanie kotwicy jest nadal modyfikowane. (I1712e, b/236524516)
Zmień adnotacje @ExperimentalMaterial3Api w wariantach przycisku ikony na @OptIn (I070b5)
Treści szuflady nawigacyjnej zostały rozdzielone na osobny komponent, aby umożliwić ich niestandardową szerokość. (Ia7f10)
Usuwanie Divider z MenuDefaults i TabDefaults (I4e33c)

Wersja 1.0.0-alpha15

27 lipca 2022 roku

androidx.compose.material3:material3:1.0.0-alpha15 i androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 są dostępne. Wersja 1.0.0-alpha15 zawiera te zatwierdzenia.

Nowe funkcje

Dozwolić na przeciąganie górnego paska aplikacji z poziomu samego paska. (I65c00, b/205873416)

Zmiany w interfejsie API

Aktualizacje interfejsów API FilterChip i ElevatedFilterChip, które mają na celu usunięcie slotu selectedIcon i zachęcanie do ponownego używania interfejsu leadingIcon do wyświetlania wybranego stanu. (Ie5dc2)
Dodaj role kolorów tła i obrysu. (Id6d54)
Popraw konwencje nazewnictwa domyślnych komponentów. (I62b27)
Oznacz ListItemDefaults i ListItemColors jako eksperymentalne. (I1f3ec)
Zmiany w interfejsie API górnego paska aplikacji, które lepiej odzwierciedlają znaczenie właściwości stanu. Oznacz też interfejs API paska aplikacji jako eksperymentalny. (Ic0ad8)
Aby zwiększyć wykrywalność, do TextFieldColors dodano kolory elementów tekstowych. (Iba1b8)
Dodawanie ButtonDefault.ButtonWithIconContentPadding do stosowania z przyciskami zawierającymi ikonę. (I2bf9c)
Pola tekstowe zostały oznaczone jako eksperymentalne, aby zapewnić większą elastyczność w przyszłych zmianach interfejsu API. (I127b5)
Usunięto adnotację @ExperimentalMaterial3Api z funkcji Checkbox. (I5eefc)
Usunięto adnotację @ExperimentalMaterial3Api z funkcji RadioButton. (I17e2a)
Usunięto adnotację @ExperimentalMaterial3Api z nieinteraktywnych kart. (I9bd49)
Aktualizacja różnych obiektów domyślnych komponentów, aby uwzględnić kolory, kształty itp. (I96e11)

Poprawki błędów

Usunięto niedziałające ikony z próbek elementów wejściowych, aby uniknąć pomyłek użytkowników w aplikacji katalogu. (I9846a)

Wersja 1.0.0-alpha14

29 czerwca 2022 r.

androidx.compose.material3:material3:1.0.0-alpha14 i androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 są dostępne. Wersja 1.0.0-alpha14 zawiera te zatwierdzenia.

Nowe funkcje

Dodano implementację listy M3. Przykładowe użycie znajdziesz w dokumentacji (Id7a20).

Zmiany w interfejsie API

Zmień nazwę parametru z wartości na wartość w parametrze RangeSlider (I3b79a)
Zmiany w interfejsie API dotyczące implementacji InputChip, aby obsługiwać stan wyboru zgodnie ze specyfikacją Material Design. Dodatkowa obsługa kolorów FilterChip w przypadku wybranego stanu wyłączonego. (I55244, b/235792432)
Dodaj BottomAppBar domyślny przycisk szybkiego dostępu (Ida4c8)
Dodano ColorScheme.surfaceColorAtElevation (Id41af)
Interfejsy w bibliotekach compose są teraz tworzone za pomocą domyślnych metod interfejsu w wersji jdk8 (I5bcf1).
Obiekty WindowWidthSizeClass i WindowHeightSizeClass implementują teraz interfejs Comparable, dzięki czemu można je porównywać za pomocą operatorów (<, <=, >=, >) i innych interfejsów API. (I747d0)

Poprawki błędów

Zaktualizuj przykład plakietki, aby zawierał bardziej szczegółowy opis treści. (I10b9d)
Dodawanie opcji użycia rozmiaru czcionki systemowej do selektora motywów w katalogu Material 3. (I10605)
Dodaje przykładowy kod dla plakietki i nieokreślonych wskaźników postępu. (I8fbe0)

Wersja 1.0.0-alpha13

1 czerwca 2022 r.

androidx.compose.material3:material3:1.0.0-alpha13 i androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 są dostępne. Wersja 1.0.0-alpha13 zawiera te zatwierdzenia.

Zmiany w interfejsie API

Obsługa utrzymywania pozycji górnego paska aplikacji po zmianie konfiguracji. (I10459, b/216160958)

Wersja 1.0.0-alpha12

18 maja 2022 r.

androidx.compose.material3:material3:1.0.0-alpha12 i androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 są dostępne. Wersja 1.0.0-alpha12 zawiera te commity.

Poprawki błędów

Element nadrzędny suwaka może teraz mieć szerokość 0. (b/231707291)

Wersja 1.0.0-alpha11

11 maja 2022 roku

androidx.compose.material3:material3:1.0.0-alpha11 i androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 są dostępne. Wersja 1.0.0-alpha11 zawiera te commity.

Nowe funkcje

Dodano RangeSlider do Materiału 3 (I18e38)
Dodaje obsługę Material3 AssistChip i InputChip (I0d25a)
Dodaje obsługę Material3 FilterChip i SuggestionChip (I9fdf3)

Zmiany w interfejsie API

Zmieniono nazwę komponentu TextFieldDefaults.BorderStroke, który rysuje obrys krawędzi w komponencie OutlinedTextField, na TextFieldDefaults.BorderBox. (I5f295)
Zmiany wizualne dotyczące m3 (Iab30e)
Umożliwia przekazywanie kolorów do standardowych przycisków z ikonami. (Ia2445)

Poprawki błędów

Dodaj do material3/Scaffold sprawdzanie błędów lint, aby zapewnić używanie wewnętrznego wypełnienia (I72293, b/226951418)

Wersja 1.0.0-alpha10

20 kwietnia 2022 r.

androidx.compose.material3:material3:1.0.0-alpha10 i androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 są dostępne. Wersja 1.0.0-alpha10 zawiera te commity.

Nowe funkcje

material3-window-size-class to nowa biblioteka, która obsługuje klasy rozmiarów okna: zestaw punktów przecięcia widocznego obszaru, które ułatwiają projektowanie, tworzenie i testowanie układów aplikacji z możliwością zmiany rozmiaru. Za pomocą calculateWindowSizeClass możesz pobrać instancję klasy rozmiaru okna, która pozwala określić wygląd interfejsu użytkownika, np. wyświetlanie paska nawigacyjnego zamiast paska nawigacyjnego u dołu w przypadku większych rozmiarów okna. Więcej informacji i przykłady użycia znajdziesz w dokumentacji interfejsu API WindowSizeClass. Więcej informacji o definicjach klas rozmiarów okien znajdziesz w publicznych wytycznych dotyczących obsługi różnych rozmiarów ekranów.

Zmiany w interfejsie API

Dodaje domyślną wysokość FAB dla BottomAppBar i usuwa końcową literę „λ” z BottomAppBar z FAB. (I92c47)
Dodaje Material3 FilledIconButton, FilledTonalIconButton i OutlinedIconButton. (Ib2bda)
Aktualizacja interfejsu API Snackbar Material 3, aby przyjmował wartości kolorów dla opcjonalnego działania i działania odrzucania. (Ibe4b4)
Częściowe wykorzystanie (obniżenie lub pozycja) zostało wycofane w wersji PointerInputChange. Aby w pełni wdrożyć zmianę, możesz użyć elementu consume(). Możesz użyć isConsumed, aby sprawdzić, czy ktoś inny wcześniej nie wprowadził tej zmiany.
PointerInputChange::copy() zawsze tworzy teraz kopię powierzchowną. Oznacza to, że kopie PointerInputChange zostaną wykorzystane, gdy wykorzystana zostanie jedna z nich. Jeśli chcesz utworzyć niewiążącą instancję PointerInputChange, użyj konstruktora. (Ie6be4, b/225669674)
Zmiany w interfejsie Cards API, które umożliwiają otrzymywanie kolorów kontenera i treści za pomocą interfejsu CardColors oraz obsługę stanu wyłączonego w przypadku kart z możliwością kliknięcia. (I927df)
Aby zachować spójność z innymi komponentami, w polach tekstowych Materiał 3 zmieniliśmy nazwę parametru backgroundColor na containerColor. (I6fbd9)

Poprawki błędów

Aktualizacje standardu IconButton w celu dostosowania go do specyfikacji Material3 (I09eab)
Przesuń wysokość górnego paska material3 Scaffold do wypełniacza przekazywanego do treści, aby treści były renderowane pod górnym paskiem aplikacji. Jeśli PaddingValues są ignorowane, treść może być zasłonięta przez górną belkę. (I83cbc, b/217776202)

Wersja 1.0.0-alpha09

6 kwietnia 2022 roku

Element androidx.compose.material3:material3:1.0.0-alpha09 został zwolniony. Wersja 1.0.0-alpha09 zawiera te zatwierdzenia.

Nowe funkcje

Dodano interfejs API Material 3 Switch (I2c3ad).

Zmiany w interfejsie API

Dodaliśmy obsługę menu rozwijanych z polami tekstowymi (tzw. „wyeksponowane menu rozwijane” lub „pola kombi”). (I1b832)
Dodano parametr shape do MaterialTheme i podsystemu Shape. (I37426)
Dodano parametr ExtendedFloatingActionButton, aby kontrolować, czy przycisk szybkiego dostępu ma być rozwinięty czy zwinięty, z animowanym przejściem między stanami. Dodano rozszerzoną kartę FAB z dodatkowym tekstem dla kart FAB bez ikony. (Iba7f1)

Wersja 1.0.0-alpha08

23 marca 2022 r.

Element androidx.compose.material3:material3:1.0.0-alpha08 został zwolniony. Wersja 1.0.0-alpha08 zawiera te zatwierdzenia.

Nowe funkcje

Dodano obsługę pól tekstowych Material 3. (I795cc, b/199377790)

Zmiany w interfejsie API

Dodaj domyślny separator menu (I01374)
Do klasy ColorScheme dodano parametr koloru surfaceTint. (I2f558)

Poprawki błędów

Napraw w przycisku Material3, aby odczytać domyślną wartość stylu tekstu z motywu Material. (Ie62fc)

Wersja 1.0.0-alpha07

9 marca 2022 r.

Element androidx.compose.material3:material3:1.0.0-alpha07 został zwolniony. Wersja 1.0.0-alpha07 zawiera te commity.

Zmiany w interfejsie API

Aktualizacje interfejsu API powierzchni Material 3, które przywracają przeciążone funkcje dla klikalnych powierzchni, a także dodają funkcję obsługi wybieralnych i przełączalnych powierzchni. (I4bf18)
Funkcje LazyVerticalGrid i LazyHorizontalGrid są teraz stabilne. (I307c0)
Interfejsy LazyVerticalGrid/LazyHorizontalGrid i wszystkie powiązane interfejsy API zostały przeniesione do podpakietu .grid. Zaktualizuj importy z androidx.compose.foundation.lazy na androidx.compose.foundation.lazy.grid. (I2d446)
Przywróciliśmy poprzednią zmianę polegającą na korzystaniu wyłącznie z widoku WindowInsetsControllerCompat i ponownie wymagamy użycia okna, które jest wymagane do zarządzania niektórymi flagami okna. Użyj ViewCompat.getWindowInsetsController zamiast WindowCompat.getInsetsController, aby mieć pewność, że używane jest odpowiednie okno (np. gdy widok znajduje się w oknie dialogowym). (I660ae, b/219572936)
Dodano nowy interfejs API LazyVerticalGrid do definiowania rozmiarów na osi poprzecznej (I17723)

Poprawki błędów

Zmiany w interfejsie Card API, które naśladują zmiany w interfejsie Surface API (I3c8b9)

Wersja 1.0.0-alpha06

23 lutego 2022 r.

Element androidx.compose.material3:material3:1.0.0-alpha06 został zwolniony. Wersja 1.0.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

Dodano element NavigationDrawerItem, który reprezentuje pojedyncze miejsce docelowe w szufladach (Ic396f, b/218286829).
Dodano interfejsy API PermanentNavigationDrawer i DismissibleNavigationDrawer jako wersje eksperymentalne. Te szuflady są odpowiednie dla urządzeń z dużymi ekranami. (I5f8ab, b/218286829)
Dodano obsługę dolnego paska aplikacji Material 3 (Ic432a).
Nazwa NavigationDrawer została zmieniona na ModalNavigationDrawer (I1807d, b/218286829)
Dodano klasę i tokeny suwaka Material 3 (I1ccee).
Dodano implementację karty. Przykładowe użycie znajdziesz w dokumentacji (Ie0146).

Poprawki błędów

Rozwiązaliśmy problem polegający na tym, że czytnik ekranu TalkBack wybierał pusty tytuł paska aplikacji u góry. (Id4690)
Dodano IconSize do FloatingActionButtonDefaults. (Ia71cf)
Naprawiono błąd dotyczący ukrytych przycisków AlertDialog, gdy dodano długi tekst za pomocą przycisku LazyColumn. (Ib2cc9, b/216663029)

Wersja 1.0.0-alpha05

9 lutego 2022 r.

Element androidx.compose.material3:material3:1.0.0-alpha05 został zwolniony. Wersja 1.0.0-alpha05 zawiera te commity.

Nowe funkcje

Dodaliśmy komponenty Material Design 3.

Menu
- DropdownMenu, DropdownMenuItem
Karty
- Card, OutlinedCard, ElevatedCard

Zmiany w interfejsie API

Wycofana funkcja Surface, która przyjmuje wywołanie zwrotne onClick. Klikalne powierzchnie powinny być tworzone za pomocą InteractionSourcei Modifier.clickable(). (I211c6)
Dodano obsługę tłomienia przyciśniętego i wyróżnionego przycisku FAB. (Ibb584)
Zmieniliśmy interfejs API Surface, aby przyjmował parametr InteractionSource, który umożliwia kontrolowanie jego wyglądu w różnych stanach. (Iafbc8)

Poprawki błędów

Dodano brakujące kolory trzeciorzędowe w schematach kolorów dynamicznych (I456c4, b/214588434).

Wersja 1.0.0-alpha04

26 stycznia 2022 r.

Element androidx.compose.material3:material3:1.0.0-alpha04 został zwolniony. Wersja 1.0.0-alpha04 zawiera te commity.

Zmiany w interfejsie API

Dodaliśmy NonRestartableComposable do metod, które są przeciążeniem istniejących metod bez złożonej logiki. Dzięki temu zmniejsza się liczba generowanych przez kompilator sprawdzeń zapamiętywania (równa) wszystkich parametrów, które są powtarzane w wyzwanej funkcji wewnętrznej. (I90490)
Dodano pasek rozdzielający Material 3. (Ica5fc)
Oznacz pole wyboru i pole wyboru radiowego za pomocą eksperymentalnej adnotacji interfejsu API. (Ie44bb)
Dodano obsługę wskaźników postępu Material 3. (Iff232, b/205023841)

Poprawki błędów

Zmień kolor wyłączonego kontenera TextButton's na przezroczysty (I6b248, b/213339737)

Wersja 1.0.0-alpha03

12 stycznia 2022 r.

Element androidx.compose.material3:material3:1.0.0-alpha03 został zwolniony. Wersja 1.0.0-alpha03 zawiera te commity.

Poprawki błędów

Dodaj LocalIndication do MaterialTheme w Material 3. (I7ce4e)
Poprawić promień zaokrąglenia rogów stosowany w przypadku pól wyboru (I38b03, b/175198975, b/202309440).

Aktualizacje zależności

Teraz zależy od Kotlina 1.6.10.

Wersja 1.0.0-alpha02

1 grudnia 2021 r.

Element androidx.compose.material3:material3:1.0.0-alpha02 został zwolniony. Wersja 1.0.0-alpha02 zawiera te commity.

Nowe funkcje

Dodano obsługę pól wyboru i opcji wyboru.
Zaktualizowano, aby zapewnić zgodność z Kotlin 1.6.0

Zmiany w interfejsie API

Usuń szablon szablonu Material 3. (I04f51)
Dodano obsługę Material 3 Checkbox. (Id5542)
Dodano obsługę Material 3 RadioButton. (I20334)

Poprawki błędów

Zmniejsz promień IconButton falowania z 40 pikseli na 20 pikseli. (I68bbe, b/206674345)
Szybka ścieżka ciągu portu dla Text zmieniona z compose.material (I30b03)
Naprawiono, ale przycisk jest zakodowany na stałe, aby był zawsze włączony. (Iea832, b/205335456)

Wersja 1.0.0-alpha01

27 października 2021 roku

Element androidx.compose.material3:material3:1.0.0-alpha01 został zwolniony. Wersja 1.0.0-alpha01 zawiera te commity.

Nowe funkcje

Motyw Material Design 3 i dynamiczny kolor Material You

Komponenty Material Design 3

Przyciski
- Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
Przycisk typu FAB i rozszerzony przycisk typu FAB
- SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
Dialogi
- AlertDialog
Pasek nawigacyjny
- NavigationBar
Panel nawigacji
- NavigationDrawer
Pasek nawigacyjny
- NavigationRail
Pasek aplikacji u góry
- SmallTopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
Plakietka
- Badge, BadgedBox
Ikona
- Icon, IconButton
Tekst
- Text
Surface
- Surface
Układ
- Scaffold
Kolor treści
- LocalContentColor

Więcej informacji znajdziesz w sekcji Material Design 3 i Material You w przewodniku po stylach Material w Compose.