Составьте материал 3
androidx.compose.material3
( См. справочную документацию API для всех пакетов Compose )
Последнее обновление | Стабильный релиз | Кандидат на релиз | Бета-версия | Альфа-релиз |
---|---|---|---|---|
16 июля 2025 г. | 1.3.2 | - | - | 1.4.0-альфа18 |
Структура
Compose — это комбинация из семи идентификаторов групп Maven в androidx
. Каждая группа содержит определённый набор функций, каждый из которых сопровождается собственным набором заметок о выпуске.
В этой таблице объясняются группы и ссылки на каждый набор заметок о выпуске.
Группа | Описание |
---|---|
compose.animation | Создавайте анимацию в своих приложениях Jetpack Compose, чтобы обогатить пользовательский опыт. |
compose.компилятор | Преобразуйте функции @Composable и включите оптимизацию с помощью плагина компилятора Kotlin. |
compose.foundation | Создавайте приложения Jetpack Compose с помощью готовых строительных блоков и расширяйте базу для создания собственных элементов системы проектирования. |
сочинить.материал | Создавайте пользовательские интерфейсы Jetpack Compose с помощью готовых компонентов Material Design. Это высокоуровневая точка входа в Compose, предназначенная для предоставления компонентов, соответствующих описанным на сайте www.material.io. |
compose.material3 | Создавайте пользовательские интерфейсы Jetpack Compose с компонентами Material Design 3 — следующим этапом развития Material Design. Material 3 включает в себя обновлённые темы и компоненты, а также функции персонализации Material You, такие как динамическая подсветка, и разработан для соответствия новому визуальному стилю и пользовательскому интерфейсу Android 12. |
compose.runtime | Основные строительные блоки модели программирования Compose и управления состоянием, а также основная среда выполнения для целевого плагина компилятора Compose. |
compose.ui | Основные компоненты пользовательского интерфейса, необходимые для взаимодействия с устройством, включая макет, рисование и ввод. |
Объявление зависимостей
Чтобы добавить зависимость от Compose, необходимо добавить репозиторий Google Maven в свой проект. Подробнее см. в репозитории Google Maven .
Добавьте зависимости для необходимых артефактов в файл build.gradle
вашего приложения или модуля:
классный
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-alpha18" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Котлин
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-alpha18") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .
Обратная связь
Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с уже существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав на кнопку со звёздочкой.
Более подробную информацию см. в документации по системе отслеживания проблем .
Compose Material3 Common Version 1.0
Версия 1.0.0-альфа01
17 апреля 2024 г.
Выпущены androidx.compose.material3:material3-common:1.0.0-alpha01
, androidx.compose.material3:material3-common-android:1.0.0-alpha01
и androidx.compose.material3:material3-common-desktop:1.0.0-alpha01
. Версия 1.0.0-alpha01 содержит эти коммиты .
Новые функции
Компоненты без темы, которые можно использовать для создания компонентов Material Design:
- Тональная палитра
- Икона
- Размер сенсорной цели
Compose Material3 Adaptive Navigation Suite Version 1.0
Версия 1.0.0-альфа07
1 мая 2024 г.
Выпущены androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07
и androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07
Версия 1.0.0-alpha07 содержит эти коммиты .
Изменения API
- Сделать API навигационных пакетов неэкспериментальными ( If62af )
Исправления ошибок
- Использовать вставки для контента по умолчанию ( 50266df )
Версия 1.0.0-альфа06
17 апреля 2024 г.
Выпущены androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06
и androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06
Версия 1.0.0-alpha06 содержит эти коммиты .
Изменения API
- Добавить
containerColor
иcontentColor
вNavigationSuiteScaffoldDefaults
. ( I64e3a , b/331993720 ) - Добавление функции
itemColors
вNavigationSuiteDefaults
. ( Idf719 , b/328480012 ) - Сделайте
NavigationSuiteScope
герметичным. ( Iefa57 )
Версия 1.0.0-альфа05
6 марта 2024 г.
Выпущены androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05
и androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05
. Версия 1.0.0-alpha05 содержит эти коммиты .
Изменения API
- Сделайте конструктор
NavigationSuiteItemColors
публичным. ( Ica83a , b/324886877 )
Версия 1.0.0-альфа04
21 февраля 2024 г.
Выпущены androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04
и androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04
. Версия 1.0.0-alpha04 содержит эти коммиты.
Обновления зависимостей
- Обновите адаптивные зависимости Material3 в соответствии с новыми путями модулей. ( Ibc421 )
- Переход на использование версии классов размеров окон диспетчера окон. ( I3794d )
Версия 1.0.0-альфа03
7 февраля 2024 г.
Выпущены androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03
и androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03
. Версия 1.0.0-alpha03 содержит эти коммиты.
Изменения API
- Обновить имя пакета с navigation-suite на navigationsuite ( I7eff7 )
- Компоненты Material3, предоставляющие
MutableInteractionSource
в своём API, были обновлены и теперь предоставляютMutableInteractionSource
, допускающий значение NULL, который по умолчанию равен NULL. Семантических изменений здесь нет: передача NULL означает, что вы не хотите подниматьMutableInteractionSource
, и он будет создан внутри компонента при необходимости. Изменение на NULL позволяет некоторым компонентам никогда не выделятьMutableInteractionSource
, а другим компонентам — создавать экземпляр только по мере необходимости, что повышает производительность этих компонентов. Если вы не используетеMutableInteractionSource
, передаваемый этим компонентам, рекомендуется передавать NULL. Также рекомендуется внести аналогичные изменения в ваши собственные компоненты. ( I41abb , b/298048146 )
Версия 1.0.0-альфа02
13 декабря 2023 г.
Выпущены androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02
и androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02
. Версия 1.0.0-alpha02 содержит эти коммиты.
Новые функции
- Добавьте
NavigationSuiteType
«None» ( If8cb1 , b/313688598 )
Исправления ошибок
- Исправлена ошибка, из-за которой компонент навигации заполнял весь экран, если у корневой поверхности есть
modifier.fillMaxSize
. ( c9cf250 , b/312664933 )
Версия 1.0.0-альфа01
15 ноября 2023 г.
Выпущена androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01
. Версия 1.0.0-alpha01 содержит следующие коммиты.
Новые функции
Compose Material3 Adaptive Version 1.0
Версия 1.0.0-альфа06
7 февраля 2024 г.
Выпущены androidx.compose.material3:material3-adaptive:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06
и androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06
. Версия 1.0.0-alpha06 содержит эти коммиты.
Новые функции
- Добавлены дополнительные параметры поведения для обратной навигации
ThreePaneScaffoldNavigator
. ( I858aa ) - Добавлен дополнительный контент пункта назначения в историю навигации. ( Ibd7e6 )
Версия 1.0.0-альфа05
24 января 2024 г.
Выпущены androidx.compose.material3:material3-adaptive:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05
и androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05
. Версия 1.0.0-alpha05 содержит эти коммиты.
Новые функции
- Поддержка учета истории при навигации по скаффолду и расчете значений ( I71d46 )
Версия 1.0.0-альфа04
10 января 2024 г.
Выпущены androidx.compose.material3:material3-adaptive:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04
и androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04
. Версия 1.0.0-alpha04 содержит эти коммиты.
Новые функции
- Добавлена поддержка стыков в каркасах панелей ( I1b462 ).
Изменения API
- Свойства границ шарнира перемещены в разделе «Осанка» в список информации о шарнире ( I24f90 ).
Исправления ошибок
- Исправлена ошибка, из-за которой
AnimatedPane
не перестраивался ( c3f573d ).
Версия 1.0.0-альфа03
13 декабря 2023 г.
Выпущены androidx.compose.material3:material3-adaptive:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03
и androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03
. Версия 1.0.0-alpha03 содержит эти коммиты.
Изменения API
- Измените роли scaffold на псевдонимы
ThreePaneScaffoldRole
. ( I65bd1 ) - Создайте базовый класс для ролей scaffold ( I4784d )
- Удалить ненужные параметры из содержимого
AnimatedPane
( Ibc73b ) - Переименовывает
collectWindowSizeAsState
и вместо этого возвращает необработанные значения ( I480f4 )
Версия 1.0.0-альфа02
29 ноября 2023 г.
Выпущены androidx.compose.material3:material3-adaptive:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02
и androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02
. Версия 1.0.0-alpha02 содержит эти коммиты.
Изменения API
- Разделить навигационные API от адаптивных интерфейсов построения API. ( Ic4045 )
- Удалить класс
GutterSize
. ( I785b3 )
Исправления ошибок
- Исправлено: панели не переключаются, если
AnimatedPane
не используется ( d88f181 )
Версия 1.0.0-альфа01
15 ноября 2023 г.
Выпущен androidx.compose.material3:material3-adaptive:1.0.0-alpha01
. Версия 1.0.0-alpha01 содержит следующие коммиты.
Новые функции
API адаптивных условий Material3:
API директив адаптивной панели Material3:
API-интерфейсы адаптивных панелей Material3:
- Базовые API-интерфейсы каркаса панели
Составьте Material3 Версия 1.4
Версия 1.4.0-альфа18
16 июля 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha18
. Версия 1.4.0-alpha18 содержит следующие коммиты .
Новые функции
-
ModalBottomSheetProperties
теперь предоставляет возможность отключить dissolveRequest при щелчке по сетке. ( I8e715 ) - Добавить поддержку
trackCornerSize
в TrackRangeSlider
. ( Iec529 )
Изменения API
- Сделан
railExpanded
обязательным параметром дляWideNavigationRailItem
, добавленmodalContentColor
дляWideNavigationRailColors
и перемещенWideNavigationRailDefaults.modalContainerShape
вModalWideNavigationRailDefaults.containerShape
. ( Id60c5 ) - Переместить новый параметр функции цветов
WideNavigationRail
на последний и объявить устаревшей старую функцию. ( Iac7f7 ) -
PullToRefresh
теперь является стабильным API ( I18537 ) - Обновления API
DatePickers
. Мы удалили конечную дату по умолчанию, равную null, дляDateRangePicker
и сделали её обязательной для передачи. Мы также уточнили использование даты в полночь по UTC в документации API и отметили последние методы получения и установки, использующие API java.time, как экспериментальные. ( I121b3 , b/427952972 ) - Градуировка значка с
tint: ColorProducer
изменен на неэкспериментальный. ( Ia0133 ) - Удалены экспериментальные аннотации из
DatePicker
,DateRangePicker
и их поддерживающих состояний, классов и типов. ( I0e4e0 , b/391848485 ) - Изменено значение фокусируемости по умолчанию на false для исправления фокуса a11y и добавлен параметр
hasAction
вTooltipBox
. ( I62998 ) - Выпускник экспериментальных API
WideNavigationRail
,ShortNavigationBar
иNavigationItem
. ( I3ca3c ) - Удалите аннотации
@ExperimentalMaterial3Api
из некоторых верхних функций панели приложения, вспомогательных классов и объектов. ( I0a9b7 )
Версия 1.4.0-альфа17
2 июля 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha17
. Версия 1.4.0-alpha17 содержит следующие коммиты .
Новые функции
- Обновить анимацию группы кнопок, чтобы анимация достигала 75% от анимации при щелчке, а не при нажатии. ( 593942a , b/423596967 )
Исправления ошибок
- Исправлена ошибка, из-за которой элемент карусели в некоторых случаях мог превышать размер большого элемента при расчете макета, что приводило к обрезанию всего виджета. ( I1c3d7 , b/397489534 )
- Исправлен пропуск
beforeContentPadding
при прокрутке каруселей с перекрывающимися начальными и конечными смещениями. ( c3d5f3a , b/420618979 ) - Обновить включенное поведение
SwipeToDismiss
для наблюдения за установленным состоянием вместо текущего. Восстанавливает существующее поведение, при котором поведение привязки отключается только при установленном состоянии убранного компонента. ( 3844e07 , b/425006844 ) - Всплывающее меню
ExposedDropdownMenu
теперь можно открыть с помощью клавиатуры. Также исправлено: меню теперь доступно с клавиатуры для редактируемого варианта. ( 46ead03 )
Версия 1.4.0-альфа16
18 июня 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha16
. Версия 1.4.0-alpha16 содержит следующие коммиты .
Новые функции
- Добавлен компонент карусели героев, выровненный по центру ( I6f6d3 ).
Изменения API
- Реализовать XR-переопределение вертикальной панели инструментов ( Ia1604 )
- Добавлены программные функции прокрутки в
CarouselState
( I12f8e ) - Добавить
ComponentOverride
дляModalWideNavigationRail
( I4f440 ) - Добавить
ComponentOverride
дляWideNavigationRail
( I6354f ) - Создать
ComponentOverride
дляHorizontalFloatingToolbar
( I51116 ) - Создать
ComponentOverride
дляShortNavigationBar
( I30e24 ) - Ссылки
SwipeToDismissBoxState
наconfirmValueChange
были признаны устаревшими. Вместо этого пользователям следует использовать функцию обратного вызоваonDismissed
APISwipeToDismissBox
. ( Iee780 ) - Добавлен параметр userScrollEnabled в составные элементы карусели. ( I1d4d2 )
-
currentItem
карусели теперь можно наблюдать изCarouselState
. ( Ie87e9 )
Исправления ошибок
- Исправлена ошибка, из-за которой произвольная фигура на FAB, переданная в
FloatingToolbar
, не применяла корректно свою тень. ( Icdcc9 , b/423336922 ) - Все карусели теперь по умолчанию используют семантическую роль «Карусель». ( I7af12 )
- Исправлено некорректное движение большого пальца при обновлении состояния ползунка через
LaunchedEffect
( Id9f31 , b/302774166 ).
Версия 1.4.0-альфа15
20 мая 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha15
. Версия 1.4.0-alpha15 содержит следующие коммиты .
Изменения API
- Добавлена локальная композиция
MotionTheme.LocalMotionScheme
. Это позволяет получить доступ к схеме движения темы изCompositionLocalConsumerModifierNodes
с помощьюcurrentValueOf(MotionTheme.LocalMotionScheme)
. ( I014b1 ) - Конструктор
ColorScheme
без фиксированных цветовых ролей устарел. Пожалуйста, перейдите на конструктор с фиксированными ролями. ( Iad0ee ) - Компонент M3 Text теперь поддерживает
TextAutoSize
. ( I7f524 ) - Добавить API для создания вариантов размера разделенной кнопки и добавить примеры. ( Ice30b )
Исправления ошибок
- Исправлена ошибка, из-за которой
Snackbar
иFloatingActionButton
располагались некорректно при включении режима «от края до края». Scaffold теперь корректно применяет горизонтальные вставки к этим компонентам. ( Ib7c30 , b/244400727 ) - Исправлено движение
BottomSheet
из полностью развёрнутого состояния в частично развёрнутое.BottomSheet
теперь использует быстрый эффектMotionScheme
при скрытии или свёртывании и пространственный эффект по умолчанию при развёртывании. ( Ifa46f , b/416063171 ) - Конструктор
ColorScheme
без ролей контейнера поверхности отмечен как скрытый и больше не рекомендуется к использованию. ( Ia7237 ) - Удалено требование
CircularWavyProgressIndicator
Size.minDimension > 0
, которое раньше приводило к возникновению исключения, для обеспечения большей гибкости. ( Ic9418 , b/377531195 ) - Гиперссылки в
Text(AnnotatedString)
теперь по умолчанию имеют стиль Material. ( I78288 , b/339843816 ) - Исправлена ошибка, из-за которой функция
toShape()
вRoundedPolygon
кэшировала Path, что приводило к возникновению проблемы при выполнении нескольких вызововcreateOutline
с разными размерами. ( I4026d )
Версия 1.4.0-альфа14
7 мая 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha14
. Версия 1.4.0-alpha14 содержит следующие коммиты .
Изменения API
- Добавлен новый компонуемый элемент
AppBarColumn
, работающий по тому же принципу, что иAppBarRow
, но для содержимого, расположенного в столбце. ( Iaf6bd ) - Добавлено максимальное количество элементов в
AppBarRow
. Это необходимо для корректной реализации спецификации материалов для верхних панелей приложений. ( I92ce4 ) - Добавлен метод в
TooltipScope
для полученияlayoutCoordinates
якоря. МетодdrawCaret
объявлен устаревшим, поскольку разработчики могут использовать этот новый метод для полученияlayoutCoordinates
границ якоря и создания соответствующей фигуры, содержащей курсор. ( Ia2e12 , b/329470609 ) - Добавлена поддержка
java.time
для выбора даты: введены перегрузкиrememberDatePickerState/rememberDateRangePickerState
, которые принимают объекты java.time (например, начальныеLocalDate
иYearMonth
). Также добавлены функции расширения для объектов состояния для получения/установки значений с использованием таких типов, какLocalDate
иYearMonth
. Требуется API 26+ или десахаринг. ( I70f29 , b/266202516 , b/281859606 ) - Добавить компонуемый
CenteredTrack
, позволяющий использовать Slider с дорожкой, начинающейся от центра. ( I5b1d6 )
Исправления ошибок
- Улучшена производительность волнистых индикаторов прогресса: линейные типы теперь загружаются примерно на 8,5% быстрее и требуют примерно на 11% меньше выделений, в то время как циклические типы показывают существенное повышение скорости (примерно на 47%) и сокращение выделений примерно на 39%. ( I595d8 )
Версия 1.4.0-альфа13
23 апреля 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha13
. Версия 1.4.0-alpha13 содержит следующие коммиты .
Изменения API
-
isAppearanceLightStatusBars
иisAppearanceLightNavigationBars
вновь представлены вModalBottomSheetProperties
как параметры, доступные только для Android. ( Id4bc0 ) - Добавьте компонуемый объект
AppBarRow
, который обрабатывает переполнение элементами, выходящими за его границы. ( I742bd ) - Обновлен API
DatePicker
иDateRangePicker
для запроса фокуса при переключении в режим ввода даты. Мы заменили логический параметрrequestFocus
на необязательный параметрfocusRequester
, принимающийFocusRequester
. ( I14b69 ) - Удалить модификатор и источник взаимодействия из кликабельных и переключаемых элементов по умолчанию. Вместо этого оставить это в качестве детали реализации. ( I95ed6 )
- Обновлен
ButtonGroup
для перехода в раскрывающееся меню, если кнопок слишком много и они не помещаются на экране. ( I7b88b )
Исправления ошибок
- Bottomsheet теперь использует верхние отступы, если они меньше текущего смещения. Это позволяет пользователям задавать верхние отступы для расширенного поведения.
BottomSheetDefaults.windowInsets
теперь включаетWindowInsets.safeDrawing.Top
. ( I0ab67 , b/321877275 , b/336962418 , b/342093067 ) - Включена анимация появления/исчезновения (затухание/скольжение) для начальных значков/аватаров и конечных значков чипов при их добавлении или удалении. Это в первую очередь полезно для выбираемых чипов (Фильтр, Ввод), но применимо в целом. ( I9af21 )
- Исправлено неправильное поведение RTL-ползунка, вызванное
LookaheadScope
. ( Ieb152 , b/408118041 ) - Исправлен сбой нижней
AppBar
, связанный с прокруткой при скрытом системном пользовательском интерфейсе. ( Ic6140 , b/405996228 )
Версия 1.4.0-альфа12
9 апреля 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha12
. Версия 1.4.0-alpha12 содержит следующие коммиты .
Изменения API
- Удалены параметры, специфичные для Android, из
ModalBottomSheetProperties
( Iab97f , b/362539765 ). - Ввести функции перегрузки для размеров маркеров перетаскивания по умолчанию ( I0ed0d )
- Добавить новые функции
NavigationSuiteScaffold
иNavigationSuiteScaffoldLayout
для поддержки новых типов макетов и добавить поддержку необязательного основного содержимого действия. ( Ib262a , b/353144478 ) - Устаревание
Modifier.weight
с параметром fill вButtonGroup
. Добавление версии без fill. ( Id32bb ) - Переименуйте компоненты
xSmall-
иxLarge-
IconButton по умолчанию, чтобы они отображались какextra
. ( Ib6e0f ) - Добавьте новые функции
NavigationSuite
,NavigationSuiteItem
иNavigationSuiteColors
для поддержки новых типов макетов. ( I203d6 ) - Добавьте новые
NavigationSuiteTypes
и добавьте новую функциюnavigationSuiteType
, которая включает эти варианты макета ( If68f9 )
Исправления ошибок
-
ColorScheme.contentColorFor
теперь сопоставляетsurfaceDim
сonSurface
. ( I8891a ) - Обновлена реализация
DateInputTextField
для решения проблемы, из-за которой поле ввода не отражало программно установленную дату. ( I6c8d1 , b/401143451 ) - Исправлен порядок фокусировки обратной связи для навигационной шины и широкой навигационной шины ( I6cf6f , b/407048224 ).
Версия 1.4.0-альфа11
26 марта 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha11
. Версия 1.4.0-alpha11 содержит следующие коммиты .
Изменения API
- Обновите регистр букв для компонуемых свойств в объектах по умолчанию для кнопок и переключателей. Добавьте методы в
ToggleButtonDefaults
иButtonDefaults
для рекомендуемых отступов, форм, размеров и интервалов между значками, а также стиля текста в зависимости от высоты контейнера. ( Iea69e ) - Удалены устаревшие экспериментальные функции и константы из
FloatingToolbar
. ( I8f339 ) - Компоненты фасада теперь имеют общий интерфейс и общедоступные конструкторы и свойства. ( Ibb172 )
- Добавление модификатора
animateWidth
вButtonGroupScope
, который необходимо будет использовать с дочерними элементами группы кнопок для правильной анимации дочерних элементов. ( Ia3bb6 )
Исправления ошибок
- Исправлен отступ плавающей панели инструментов для обеспечения визуального баланса при сворачивании и улучшенной гибкости для большего содержимого. ( I06c00 )
Версия 1.4.0-альфа10
12 марта 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha10
. Версия 1.4.0-alpha10 содержит следующие коммиты .
Изменения API
-
TabRowDefaults.tabIndicatorOffset
устарел и теперь рекомендуется использоватьTabIndicatorScope.tabIndicatorOffset
. ( Ib36b3 ) - Исправлена опечатка для отступа небольшого содержимого в настройках кнопок по умолчанию. ( I19bfe )
-
TabRow
иScrollableTabRow
устарели в пользу их основных и дополнительных вариантов. Основные и дополнительные строки вкладок более производительны и соответствуют спецификации. ( I918e2 ) - Добавлены
rememberSliderState
иrememberRangeSliderState
. ( I8e384 ) - Добавлен параметр
shouldAutoSnap
вSliderState
для управления механизмом автоматической привязки. Его отключение может быть полезно для пользовательских анимаций. ( I07745 ) - Минимальная ширина прокручиваемой строки вкладок теперь является параметром. Варианты основной и дополнительной строк вкладок больше не являются экспериментальными. ( If6f15 , b/226665301 )
- Сделал класс
ExitAlwaysFloatingToolbarScrollBehavior
публичным, что позволяет создавать элементы без композиции. ( Ibf31c )
Версия 1.4.0-альфа09
26 февраля 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha09
. Версия 1.4.0-alpha09 содержит следующие коммиты .
Изменения API
- Переименовать поля настроек
DragHandle
в состоянии по умолчанию; разделить состояния нажатия и перетаскивания; сделать размеры по умолчанию общедоступными. ( I787b9 ) - Обновления API
TowRowsTopAppBar
. Удалён параметрexpanded
лямбда-функции и добавлены отдельные параметры для высоты развёрнутого и свёрнутого элементов. ( Idd677 , b/306697446 , b/229134133 , b/268068946 )
Исправления ошибок
- Нижние панели приложений теперь отслеживают службу сенсорного исследования (например,
TalkBack
) и остаются видимыми, когда эта служба включена. ( I4b34d )
Версия 1.4.0-альфа08
12 февраля 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha08
. Версия 1.4.0-alpha08 содержит следующие коммиты .
Новые функции
Добавлен API
TimePickerDialog
, который можно использовать дляTimePicker
,TimeInput
или для переключения версии. ( Id2d83 )Новые API панели поиска:
- Свернутые панели поиска и развернутые «представления» поиска теперь являются отдельными компонуемыми элементами.
-
SearchBar
представляет собой панель поиска в свернутом состоянии. -
ExpandedFullScreenSearchBar
иExpandedDockedSearchBar
представляют панель поиска в развёрнутом состоянии. Они открываются в новом окне. -
SearchBarState
для управления состоянием строки поиска -
TopSearchBar
для добавления обработки вставок и поведения прокрутки - Новая перегрузка
InputField
, которая используетSearchBarState
( Ie0723 , b/261496232 , b/283311462 , b/350916229 , b/352872248 )
Изменения API
- Поддержка изменения формы углов кнопок-значков при нажатии. ( I21843 )
- API декоратора/блока оформления текстовых полей больше не являются экспериментальными. ( I31d95 )
- Добавлены образцы и значения по умолчанию для подключенного варианта
ButtonGroup
. ( I5c8ce ) - Сделайте параметр состояния последним в
NavigationSuiteScaffold
иNavigationSuiteScaffoldLayout
. ( I9cc7b )
Исправления ошибок
- Добавлены настраиваемые действия для специальных возможностей в
FloatingToolbars
, благодаря чему службы специальных возможностей теперь могут разворачивать и сворачивать все вариантыFloatingToolbar
. Версия с FAB применяет эти действия к FAB, а версия без FAB — к основному контенту. ( I26420 ) -
FloatingToolbars
теперь отслеживают службу сенсорного исследования (например, TalkBack) и поддерживают панель инструментов развернутой и видимой, когда служба включена. ( I02172 ) - Исправлен сбой в индикаторах прогресса и загрузки в случае, если в качестве прогресса передается
Float.NaN
. ( I4fa96 , b/352364576 )
Версия 1.4.0-альфа07
29 января 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha07
. Версия 1.4.0-alpha07 содержит следующие коммиты .
Новые функции
- Добавлена большая гибкость в настройке внешнего вида флажков с помощью нового API. Этот API предоставляет параметры Stroke, которые позволяют точнее управлять отображением флажка и его контура. ( I65a88 )
- Добавлен API
TwoRowsTopAppBar
— более настраиваемая альтернатива панелям приложений среднего и большого размеров для создания двухстрочных верхних панелей приложений. Разработчики теперь могут управлять содержимым заголовков и подзаголовков как в свёрнутом, так и в развёрнутом состоянии, с возможностью настройки высоты для каждого состояния. ( I0be3c , b/306697446 , b/229134133 , b/268068946 )
Изменения API
- Экспериментальный вариант
BottomAppBar
переименован вFlexibleBottomAppBar
, что обеспечивает больший контроль над расположением и высотой содержимого. ( Iaa448 ) - Обновите имена свойств в объекте по умолчанию группы кнопок на
CapitalCase
. Измените имяanimateFraction
, чтобы оно точнее соответствовало поведению, которое оно представляет. ( I545cd ) - Добавлены перегрузки для распространённых кнопок, позволяющие создавать анимированные фигуры при нажатии. Добавлены кэшированные фигуры кнопок. ( I5ec20 )
- Теперь вы можете управлять реакцией
FloatingToolbar
с FAB на прокрутку, используя свойствоFloatingToolbarScrollBehavior
. Для панелей инструментов, расположенных вдоль центрального края (например, сверху или снизу по центру), мы рекомендуем использовать поведение прокрутки, чтобы скрыть весь компонент при прокрутке и добиться более аккуратного вида. Это также предотвращает смещение FAB от центра, что может произойти при использовании флагаexpanded
для свёртывания. ( I33f67 ) - Обновляет экспериментальные API
TopAppBar
для использованияAlignment.Horizontal
вместо пользовательскогоTopAppBarTitleAlignment
при настройке выравнивания заголовка и подзаголовка. ( I70ca2 ) -
SliderState#onValueChange
теперь общедоступно, что дает пользователю больше контроля ( I104eb ) - Добавлен класс
NavigationSuiteScaffoldState
для анимации компонента навигации. Также добавлены перегрузкиNavigationSuiteScaffold
иNavigationSuiteScaffoldLayout
с параметром состояния. ( I6a8c9 , b/328674235 )
Исправления ошибок
- Переместить классы
IconButtonColors
иIconToggleButtonColors
изIconButtonDefaults.kt
обратно вIconButton.kt
. ( I3c233 )
Внешний вклад
-
SliderState#isDragging
теперь общедоступно. ( I8458a )
Версия 1.4.0-альфа06
15 января 2025 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha06
. Версия 1.4.0-alpha06 содержит следующие коммиты .
Изменение поведения
-
displayCutout
добавлен в группу вставок, которые компоненты Material учитывают по умолчанию, чтобы избежать перекрытия содержимого с вырезом экрана. Это изменение поведения повлияет на поведение компонентов, поддерживающих вставки, вокруг выреза экрана. Это включает в себя значение по умолчанию параметраWindowInsets
для компонентов Material 3, поддерживающих вставки, и значенияWindowInsets
представленные в объектах компонентов Defaults для Material 2 и Material 3. Если это изменение приводит к нежелательному поведению, вручную укажите параметрWindowInsets
для каждого компонента отдельно. ( I43ee9 , b/362508045 )
Изменения API
- Обновления API
TopAppBar
. Верхние панели приложений среднего и большого размера с подзаголовком переименованы в*FlexibleTopAppBar
. Цветовые вариации объединены в единую функциюTopAppBarDefault.topAppBarColors()
, а также добавлен параметр цветаsubtitle
, применяемый к предоставленному подзаголовку Composable ( I41b65 ). - Удалить API
WideNavigationRailArrangement
в пользуArrangement.Vertical
( Id0341 ) - Добавьте новый
VerticalSlider @Composable
. ( I2bfba ) - Добавить новый Track
@Composable
, который позволяет указывать пользовательские внешние углы трека и значки трека. ( I436a4 ) - Обновите API плавающей панели инструментов, чтобы использовать объект
FloatingToolbarColors
вместо одного цвета контейнера. ( I9a054 ) - Добавить и использовать новую экспериментальную аннотацию
ExperimentalMaterial3ComponentOverrideApi
( Ia1eaf ) -
Modifier.indicatorLine
теперь принимает форму текстового поля для обработки обрезки. ( I8c5f3 , b/380704151 ) - Переименуйте экспериментальные функции
FloatingAppBar
вFloatingToolbar
( I1dbf8 ). - Добавлен новый
floatingToolbarVerticalNestedScroll
, который можно прикрепить к прокручиваемому контейнеру для обновления состояния расширения плавающей панели инструментов на основе движения прокрутки, которое пересекает пороговое значение. ( I6d65f ) - Представляем новый API для создания плавающей панели инструментов с прикреплённой плавающей кнопкой действия (FAB). API предоставляет гибкие возможности настройки, позволяя расположить панель инструментов горизонтально или вертикально, а также разместить FAB в начале или конце панели инструментов. ( I9e350 )
Исправления ошибок
- Исправлена проблема со специальными возможностями Snackbar, из-за которой панель сама себя объявляла при закрытии, если включена
TalkBack
. ( /I9db53 )
Внешний вклад
- Унифицированный
BasicTooltip
в Foundation иBasicTooltip/Tooltip
в Material3. ( Ifc2e6 )
Версия 1.4.0-альфа05
12 декабря 2024 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha05
. Версия 1.4.0-alpha05 содержит следующие коммиты .
Изменения API
- Заменить тип в значении
WideNavigationRailState.current/target
на перечисление для лучшей читаемости ( I2d6ab ) -
SplitButton
меняет API Shape с класса данных на класс для обеспечения двоичной совместимости. ( I53812 ) - Добавлен API подсказок с параметром
onDismissRequest
, чтобы разработчики могли определять, что происходит, когда пользователь щёлкает за пределами подсказки. Старый API, не содержащий этого нового параметра, объявлен устаревшим. ( I99aef ) - Измените название
opticalCentering
наhorizontalCenterOptically
. Сделайте модификатор внутренним. Замените параметр padding на максимальное начальное и конечное смещение ( I0b904 ). - Измените
WideNavigationRailState
так, чтобы он имел текущее/целевое значение, удалите перечисления в пользу логических значений. ( Idfa29 , b/356039090 ) - Добавить
NavigationBarItemComponentOverride
. ( I3a06a )
Исправления ошибок
- Исправлено поведение верхней и нижней панели приложений для надежного изменения цвета при полной прокрутке содержимого. ( Idc4e8 , b/293665988 )
- Функции поведения прокрутки для верхней и нижней панелей приложений теперь возвращают запомненное поведение для лучшей работы при рекомпозиции. ( I0fdbe , b/207957336 )
- Параметр модификатора теперь применяется после внутренних модификаторов, таких как поведение и семантика перетаскивания, а не до них. Это влияет на порядок применения модификаторов. ( I8d83f )
- Расширенный нижний лист остается расширенным при изменении размера. ( I2870b , b/324934884 )
- Корректно направлять флаги состояния и панели навигации для свойств Windows. ( Ie674d , b/362539765 )
- Переместить параметр-модификатор в корень скаффолдов, как указано в документации. Это соответствует реализации M2. ( I0235e , b/372311595 )
Внешний вклад
- Унифицированная функция
DatePickerDialog
. ( I7dced )
Версия 1.4.0-альфа04
13 ноября 2024 г.
Выпущен androidx.compose.material3:material3-*:1.4.0-alpha04
. Версия 1.4.0-alpha04 содержит следующие коммиты .
Изменения поведения
- Отменены изменения цветов, представленные в aosp/3212478 в
iconButtonColors
,iconToggleButtonColors
,outlinedIconButtonColors
,outlinedIconToggleButtonColors
иoutlinedIconToggleButtonBorder
. Отменённое поведение перенесено в новый набор функцийiconButtonVibrantColors
и т. д., чтобы подчеркнуть возвращаемые высококонтрастные цвета. ( Iffd8d )
Новые функции
- Представляем компонент
VerticalDragHandle
( I6c770 )
Изменения API
- Переименуйте
DismissibleModalWideNavigationRailDefaults
вModalWideNavigationRailDefaults
. ( I8e877 ) - Добавить
NavigationBarComponentOverrides
. ( I8a3f3 ) - Добавить
NavigationRailComponentOverride
. ( I83e13 ) - Ввести
WideNavigationRailState
для управления сворачиванием/разворачиванием направляющей, разрешить убиратьModalWideNavigationRail
и удалитьDismissibleModalWideNavigationRail
. ( I88568 ) - Добавьте значения по умолчанию для кнопок-переключателей: xSmall, medium, large и xLarge. ( Ie95d1 )
- Добавьте значения по умолчанию для размеров xSmall, medium, large и xLarge в значения по умолчанию для кнопок. ( If8b6d )
Исправления ошибок
- Цвет значка фильтра-чипа был изменён с «Primary» на
OnSurfaceContainer
в соответствии со спецификацией. Все цвета контура чипа были изменены с «Outline» на «Outline Variant» в соответствии со спецификацией. ( I68bd4 )
Версия 1.4.0-альфа03
30 октября 2024 г.
androidx.compose.material3:material3-*:1.4.0-alpha03
выпускается. Версия 1.4.0-Alpha03 содержит эти коммиты .
Изменения API
-
SheetState
конструктор с плотностью устарел в пользу пороговых значений позиционирования и скорости. ( IFD16E ) - Добавлено
rememberTooltipPositionProvider
, который содержит обновленную логику позиционирования. УмеренныйrememberPlainTooltipPositionProvider
иrememberRichTooltipPositionProvider
. ( IE66E2 ) - Дополнительные
ModalBottomSheetProperties
разрешают настройку статуса и навигационных цветов. По умолчанию эти обновления на основе цвета контента вместо статуса темной темы System. ( IB874E , B/362539765 ) - Улучшен опыт ввода для сборщиков дат: в режиме ввода, текстовое поле даты будет сфокусировано для немедленной текстовой записи. Изменение добавляет параметр
requestFocus
кDatePicker
иDateRangePicker
. Вы можете предотвратить фокус, передаваяfalse
. ( I12D09 , B/286399710 , B/340102743 ) - Кэширование формы по умолчанию в объект формы. Создание формы по умолчанию
@Composable
для кнопки переключения. Развертывая формы в одну форму по умолчанию, поскольку варианты указывают на один и тот же файл токена. ( IAA014 )
Исправления ошибок
- Оптимизируйте поведение
contentPadding
каркаса, чтобы избежать всегда переоборудования содержания тела при измененииcontentPadding
. ( I8c8e2 , b/373904168 ) -
progress
TextFieldLabelScope
переименован вlabelMinimizedProgress
-
TextFieldLabelPosition
Default
переименован вAttached
. Участники интерфейса были удалены. ( If75c6 ) - Исправлена проблема с
DatePicker
в режиме ввода, где ошибки проверки могут привести к изменению высоты компонента. ( I2e229 , b/280462363 ) - Заставьте слайдер материала изменить свое значение, когда нажимают клавиши управления. ( I1c442 )
Версия 1.4.0-альфа02
16 октября 2024 г.
androidx.compose.material3:material3-*:1.4.0-alpha02
выпускается. Версия 1.4.0-Alpha02 содержит эти коммиты .
Изменения API
- Обновления до даты сборщиков, чтобы обеспечить последовательное использование локали на протяжении всей
DatePicker
иDateRangePicker
при установлении локали непосредственно черезDatePickerState
илиDateRangePickerState
. Обратите внимание, что при установке локалов непосредственно в штат вам решается убедиться, что заголовок и заголовок текстов локализованы соответствующим образом, поскольку их текст по умолчанию все еще будет применяться в соответствии с локали платформы по умолчанию. ( I37073 , b/326490763 , b/321657276 ) -
SheetState.isAnimationRunning
теперь выставлен. ( I9a3d7 ) -
DatePickerColors
теперь правильно имеет приоритет по сравнению с любыми противоречивыми цветами, определенными в стилях текста типографии темы. Также обратите внимание, что это обновление настраивает позицию параметраcolor
в функциях выбора даты и вводит параметрcontentColor
для настройки цвета заголовка и текста заголовка. ( I30D03 , B/347031394 ) - Переименовать
SplitButton
вSplitButtonLayout
и удалить API-файлы цветовых вариантовSplitButton
, варианты будут достигнуты путем повторного использования вариантов кнопок, предоставленныхSplitButtonDefaults
. ( I44c36 ) -
ModalBottomSheet
теперь имеет параметрsheetGestureEnabled
( I856CB , B/288211587 ) - Переименован
standardMotionScheme
иexpressiveMotionScheme
до стандартного и выразительного. Обе функции теперь доступны через объект CompanionMotionScheme
, вызываяMotionScheme.standard()
иMotionScheme.expressive()
. ( ICECCF ) - Добавление параметра
maxWidth
к простым и богатым подсказкам. Он по умолчанию в спецификации дизайна 200 DP для простых всплесков инструментов и 320 DP для богатых подсказков. ( I30ce9 )
Исправления ошибок
-
DatePicker
иDateRangePicker
теперь правильно обновляют отображаемый месяц при установке черезdisplayedMonthMillis
их штата. ( If9e47 , b/333414302 ) - Контент
ModalBottomSheet
теперь отодвигает контент от строки состояния. ( I5114c , b/321877275 , b/336962418 , b/342093067 ) - [Нижний лист] Измените приоритет обратного вызовов на
PRIORITY_DEFAULT
( I447fb ) - Исправьте сбои в
DatePicker
иDateRangePicker
, когда минимально выбираемый год будет установлен в будущем году. ( I78656 , B/319395747 ) - Исправьте проблему с пикером даты для обновления пользовательского интерфейса, когда применяется обновленный экземпляр
SelectableDates
. ( IAD59A , B/290135807 , B/339898760 )
Версия 1.4.0-альфа01
2 октября 2024 г.
androidx.compose.material3:material3-*:1.4.0-alpha01
выпускается. Версия 1.4.0-Alpha01 содержит эти коммиты .
Изменения поведения
- Библиотека больше не добавляет зависимости к
material-icons-core
поэтому, если ваш проект полагается на это, вам придется явно добавить эту зависимость в ваших файлахbuild.gradle[.kts]
. ( I735ff , b/349894318 ) - Active Label
NavigationBarItem
andNavigationRailItem
Изменение цвета цвета отonSurface
наsecondary
, чтобы улучшить удобство использования, цветовую контрастность и улучшить когерентность в системе ( IBC297 ), чтобы вернуться к предыдущему поведению, копировать цвета по умолчанию и изменитьselectedTextColor
наMaterialTheme.colorScheme.onSurface
. - Материал 3 Компоненты теперь используют новое
MotionScheme
для определения их движения. ( IE0F93 ) - Неопределенные изменения индикатора круговых прогресса ( I3C07E )
- Обновление
OutlinedIconButtonColors
иOutlinedIconToggleButtonColors
для лучшего цветового контраста. ( I2743d ) - Обновленный контейнер и цвет содержимого для
FilledIconToggleButtonColors
иFilledTonalIconToggleButtonColors
. ( IC5D0F ) - Обновлено
OutlinedButton
цвета пограничной границы отoutline
доoutlineVariant
. ( 057F00 )
Изменения API
- Добавлен дополнительный параметр
reverseLayout
в функциюenterAlwaysScrollBehavior
отTopAppBar
для лучшей поддержки контента, который был установлен с помощьюreverseLayout
. ( I4e0e5 ) -
SegmentedButton
теперь поддерживает аргументcontentPadding
. ( I5ad91 , b/3584414376 ) -
PullToRefreshState
больше не имеет реализации по умолчанию дляisAnimating
( i6a593 ) - Добавлены новые перегрузки материала
TextField
иOutlinedTextField
, которые используютTextFieldState
. Добавлены API -интерфейсы для украшения, которые совместимы сTextFieldDecorator
. ( If13a1 ) - Добавлен параметр для управления
labelPosition
текстового поля. ИспользованиеalwaysMinimize
позволяет одновременно, когда поле не сфокусировано с незокурированием метки и заполнителя в текстовом поле одновременно, даже когда поле не сфокусировано. ( I1ef2c ) - Добавлен материал
SecureTextField
иOutlinedSecureTextField
для поля ввода пароля. ( I7e22d ) - Добавлены прицел к текстовым метелкам поля для запроса прогресса анимации. ( If5ec8 )
- Добавляет поддержку для
MotionEvent.CLASSIFICATION_DEEP_PRESS
в подсказки. ( I62e6a ) -
isAfternoon
'sTimePickerState
теперь является расширением VAL вместо VAR на интерфейсе, переименованной вisPm
( I89A97 ) - Обновление класса типографии для поддержки акцентированных шкал типов. ( IFA13C )
- Добавлен
ModalWideNavigationRail
API и переименован в APIModalExpandedNavigationRail
дляDismissibleModalWideNavigationRail
. ( IC9118 ) - Обновлено
FloatingAppBarScrollBehavior
, чтобы автоматически разобратьсяscreenOffset
и не требует@Composable
. ( IDF349 ) - Обновления API
LoadingIndicator
для исправления именования в его объекте по умолчанию. Добавлены постояннуюLoadingIndicatorElevation
вPullToRefresh
. ( I1d72b ) - Обновления API
LoadingIndicator
для исправления именования в его объекте по умолчанию. Добавлены постояннуюLoadingIndicatorElevation
вPullToRefresh
. ( I1d72b ) - Добавлены параметры
amplitude
иwaveSpeed
в неопределенные вариацииLinearWavyProgressIndicator
индикатора иCircularWavyProgressIndicator
. ( I2a0c5 ) - Поддержка Изменения формы кнопки Toggle значка на основе нажатого или проверенного состояния. ( IBC781 )
- Обновление класса типографии для поддержки акцентированных шкал типов. ( IFA13C )
-
SplitButton
Shape Morphs на основе состояния по умолчанию / нажатию. УдаленAnimatedTrailingButton
API, потому что APITrailingButton
может предлагать такие же настройки ( I95066 ) - Добавьте модификатор, чтобы анимировать показ и скрытие FAB, например, когда прокрутки контента. ( 18338d )
- Добавление форм группы подключенных кнопок и расстояния в
ButtonGroupDefaults
для использования в образце. ( I68e30 ) - Кнопка разделения добавить горизонтальную прокладку для кнопки с зацепленной кнопкой и включить оптическое центрирование, рассчитанное по исходным и конечным угловым различиям ( I122E2 )
- Представляем новый материал
MotionScheme
, позволяющий установить схему для движения компонента. Схема устанавливается черезMaterialTheme
. ( ID50C2 )
Исправления ошибок
- Примените правильный индекс обхода фокусировки к
Scaffold
композициям для каркасов. Порядок -topBar
,bottomBar
, Fab, Content, Snackbar. ( I5936b ) - Исправлена проблема на
DatePicker
иDateRangePicker
, где в определенных локатах и скелетах формата некоторые элементы даты (например, имена месяца) не начались с заглавного письма. ( I1430f ) - Интегрируйте токены компонентов Fab и Fab Menu (незначительные визуальные обновления в падки и текст) ( IB57F3 )
-
ModalBottomSheet
теперь первым в порядке семантического обхода, за которым следует Scrim. ( I436f9 , b/358594665 ) - Исправить нижнюю панель приложений, не полностью исчезая при прокрутке под навигационной таблеткой в режиме края к краю ( i3ee21 )
Составьте материал3 версии 1.3
Версия 1.3.2
9 апреля 2025 г.
androidx.compose.material3:material3-*:1.3.2
выпускается. Версия 1.3.2 содержит эти коммиты .
Исправления ошибок
-
ListItem
исправляет свой внутренний расчет высоты, теперь оставляя соответствующее количество места в макете. - Удалить лишнюю
NavigationBarItem
метку, правильно выровнять со спецификацией. - Исправляет макет
TabRow
в режиме RTL.
Версия 1.3.1
30 октября 2024 г.
androidx.compose.material3:material3-*:1.3.1
выпускается. Версия 1.3.1 содержит эти коммиты .
Исправления ошибок
-
DatePicker
иDateRangePicker
теперь правильно обновляют отображаемый месяц при установке черезdisplayedMonthMillis
их штата. ( If9e47 , b/333414302 ) - Исправьте сбои в
DatePicker
иDateRangePicker
, когда минимально выбираемый год будет установлен в будущем году. ( I78656 , B/319395747 ) - Исправьте проблему с пикером даты для обновления пользовательского интерфейса, когда применяется обновленный экземпляр
SelectableDates
. ( IAD59A , B/290135807 , B/339898760 ) - Измените приоритет обратного вызовов, используемый на нижних листах на
PRIORITY_DEFAULT
, чтобы позволить клавиатуре IME увольнять первым. ( I447fb )
Версия 1.3.0
4 сентября 2024 года
androidx.compose.material3:material3-*:1.3.0
выпускается. Версия 1.3.0 содержит эти коммиты .
Важные изменения с версии 1.2.0
Основные особенности 1.3.0
Новый дизайн материала 3 компоненты
- Карусель
-
HorizontalMultiBrowseCarousel
иHorizontalUncontainedCarousel
для существующих компонентов дизайна материала 3.
-
- [
ModalBottomSheet
] теперь поддерживает прогнозирование на U+ ( ICCF32 , B/281967264 , B/304850357 ) - [
SearchBar
] теперь поддерживает прогнозирование на u+ ( i657f8 ) - Ядерный ящик (
ModalDrawerSheet
andDismissibleDrawerSheet
) теперь поддерживает прогнозирование на U+ как Opt-In ( IE5B0B ) -
DropdownMenu
теперь поддерживает пользовательский цвет, форму, высоту и границу. ( I8e981 , b/2895544448 , b/301887035 , b/283654243 ) - Обновлен слайдер для улучшения доступности, добавив индикатор разрыва и остановки. ( I3058e )
- Обновлено
ProgressIndicator
для улучшения доступности, добавив индикатор разрыва и остановки. ( I21451 ) - Добавлена каретка по умолчанию для богатой всплывающей подсказки, поддерживать пользовательскую карету, которая будет нарисована с учетом якоря
LayoutCoordinates
. ( IFD42C ) Разрыв изменений - Новые API-интерфейсы
- Упрощенная
PullToRefreshState
для использования дробных значений вместо единиц DP. - Состояние
isRefreshing
контролируется пользователем, а неPullToRefreshState
. - Отделил вложенное соединение прокрутки от
PullToRefreshState
. Он обрабатывается новымPullToRefreshBox
илиModifier.pullToRefresh
. - Это обновление является нарушающим изменением предыдущих экспериментальных API. ( I0adeb , b/314496282 , b/317177684 , b/323787138 , b/324573502 , b/317177683 ) Изменения разрыва визуальных разрыва
- Упрощенная
- Обновите наложение состояния фокуса, чтобы быть 0,1F, чтобы обеспечить достаточный цветовой контраст. ( I7ea77 )
- Небольшие настройки на поверхность и фоновый цвет по умолчанию в
lightColorScheme
иdarkColorScheme
. ( I9db52 ) - Обновленные цветы слайдера и
ProgressIndicator
, чтобы следовать новым не текстовым контрастным характеристикам. ( I26807 ) - Варианты
SurfaceContainer
теперь используются компонентами. Компоненты, которые формально рассчитывали цвет сSurface
иTonalElevation
, в настоящее время используют ролиSurfaceContainer
по умолчанию, которые не влияют на тональную высоту. ( B/304584161 ) - Подводные и поверхностные контейнер. ( I677a5 )
- Продвижение экспериментальных API до стабильной!
- Улучшения производительности
Версия 1.3.0-rc01
21 августа 2024 г.
androidx.compose.material3:material3-*:1.3.0-rc01
выпускается. Версия 1.3.0-RC01 содержит эти коммиты .
Исправления ошибок
-
ModalBottomSheet
теперь первым в порядке семантического обхода, за которым следует Scrim. ( I436f9 , b/358594665 )
Версия 1.3.0-бета05
24 июля 2024 г.
androidx.compose.material3:material3-*:1.3.0-beta05
выпускается. Версия 1.3.0-бета05 содержит эти коммиты .
- Исправлена проблема, в которой содержимое
BottomSheet
отсутствует или отключено на Android N и O ( A10A2D ) - Повышенные границы семантики слайдера для того, чтобы
TalkBack
правильно показал индикаторы фокуса вокруг больших пальцев. ( 0B5A1D )
Версия 1.3.0-бета04
26 июня 2024 г.
androidx.compose.material3:material3-*:1.3.0-beta04
выпускается. Версия 1.3.0-бета04 содержит эти коммиты .
Версия 1.3.0-бета03
12 июня 2024 г.
androidx.compose.material3:material3-*:1.3.0-beta03
выпускается. Версия 1.3.0-бета03 содержит эти коммиты .
Внешний вклад
- Сделайте
androidx.compose.material3.DropdownMenu
доступен из общего исходного набора. ( If62c0 )
Версия 1.3.0-бета02
29 мая 2024 г.
androidx.compose.material3:material3-*:1.3.0-beta02
выпускается. Версия 1.3.0-бета02 содержит эти коммиты .
Изменения API
-
Modifier.pullToRefreshIndicator
поддерживает возвышение, обновление обновления, чтобы обновить API, чтобы позволить быть логическим, вместо лямбды. Поддержка выравнивания контента вPullToRefreshBox
( i75679 ) - Создание
TooltipScope
герметичным интерфейсом и создание внутренней реализации для использования вTooltipBox
и Label. ( I3833e ) - Добавлены два новых модификатора в
CarouselItemScope
-maskClip
иmaskBorder
- чтобы легко добавить форму и границу в любой элемент карусели ( ID67A1 ) -
TimePickerState
теперь интерфейс и позволяет установить время ( i88546 ) - Обновлено API для стиля ссылок: перенести
TextLinkStyles
вTextStyle
и удалилTextDefaults
из материала. ( I5477b )
Исправления ошибок
- Статус
ModalBottomSheet
и значки бара NAV теперь реагируют на статус темной темы. ( IE1FE7 , B/338342149 ) - Добавлена Семантика закрытия листа в
ModalBottomSheet
Scrim. ( 0E61CB , B/328801864 )
Внешний вклад
- Make
androidx.compose.material3.AlertDialog
доступен из общего набора источников ( IA33F5 ) - Сделайте
ModalBottomSheet
доступным из общего исходного набора ( ID7CC7 )
Версия 1.3.0-beta01
14 мая 2024 г.
androidx.compose.material3:material3-*:1.3.0-beta01
выпускается. Версия 1.3.0-бета01 содержит эти коммиты .
Изменения API
- Использование
DpSize
вместоCaretProperties
. УдалениеCaretProperties
. Переименовать вCaretScope
вTooltipScope
. ( Id9a76 ) - Обновил API для получения материалов тематических ссылок в тексте. В частности, удалили методы из
TextDefaults
для построения тематическихLinkAnnotations
и разбора HTML с тематическими ссылками. Вместо этого добавил классTextLinkStyles
, который позволяет стилизовать ссылки в качестве параметра в текстовый композиционный. ( I31b93 )
Версия 1.3.0-Alpha06
1 мая 2024 г.
androidx.compose.material3:material3-*:1.3.0-alpha06
выпускается. Версия 1.3.0-Alpha06 содержит эти коммиты .
Критические изменения
Новые API-интерфейсы
- Упрощенная
PullToRefreshState
для использования дробных значений вместо единиц DP. - Состояние
isRefreshing
контролируется пользователем, а неPullToRefreshState
. - Отделил вложенное соединение прокрутки от
PullToRefreshState
. Он обрабатывается новымPullToRefreshBox
илиModifier.pullToRefresh
. - Это обновление является нарушающим изменением предыдущих экспериментальных API. ( I0adeb , b/314496282 , b/317177684 , b/323787138 , b/324573502 , b/317177683 )
- Упрощенная
Изменения API
-
RippleConfiguration#isEnabled
был удален, аLocalRippleConfiguration
была сделана по общенациональному. Чтобы отключить пульсацию, вместо того, чтобы обеспечитьRippleConfiguration
сisEnabled = false
, предоставьтеnull
дляLocalRippleConfiguration
. ( I22725 ) -
ModalBottomSheet
более точно рисует Scrim по строке состояния при включении Edge to Edge. Модальное содержание нижнего листа теперь может потреблять вставки в окне, что позволяет иметь видимый контент над навигационной панелью.ModalBottomSheet
windowInsets
, переименованные вcontentWindowInsets
, чтобы указать, где будут применяться вставки, они больше не привязаны к логике окна. ТипcontentWindowInsets
был изменен на функцию, которая возвращаетWindowInsets
, чтобы разрешить его разрешено в своем новом окне. ( I39630 , b/274872542 , b/300280229 , b/290893168 ) -
PrimaryScrollableTabRow
иSecondaryScrollableTabRow
теперь используют пользовательский макет вместо субкомпозиции, что должно повысить производительность. ( I991e0 ) - Текстовые ссылки получили нажатый вариант стиля состояния в дополнение к нормальному стилю, завис и сфокусирован. Каждый из методов
TextDefaults
получил аргументpressedStyle
, чтобы поддержать это. ( IC473F , B/139312671 )
Исправления ошибок
- Ящики навигационного ящика теперь соответствуют ширине
drawerContent
. ( IBC72F , B/245355396 ) -
OutlinedTextField
Top Telectfield Top Padding для метки теперь учетные записи для размера шрифта системного шрифта. ( IDC781 ) - Фиксированное местоположение упаковки
CalendarLocale
. ( IFA235 ) - [Прогнозирующая обратная связь] Обновление прогнозной анимации обратной анимации для использования кривой интерполяции (0,1, 0,1, 0, 1) ( I2591A )
Версия 1.3.0-альфа05
17 апреля 2024 г.
androidx.compose.material3:material3-*:1.3.0-alpha05
выпускается. Версия 1.3.0-Alpha05 содержит эти коммиты .
Новые функции
-
SearchBar
иDockedSearchBar
имеют новые перегрузки, которые принимают параметр текстового поля. Это позволяет стиливать текстовое поле отдельно от остальной части строки поиска, а также передавать пользовательские текстовые поля. Текстовое поле текущей реализации было доступно в качествеSearchBarDefaults.InputField
. ( I50c73 , b/275074248 , b/278773336 , b/3266277700 ) - Lambda
drawTick
был добавлен в публичный API, чтобы при необходимости настроить клещи ( I0C048 )
Изменения API
- Текстовые ссылки получили вариант стиля состояния в дополнение к обычному стилю, завис и сфокусирован ( I5F864 , B/139312671 )
- Обновлен
CarouselItemInfo
, чтобы выставить прямой маски, который обрезается ( i785d8 ) - Удален
BasicTooltipState
из материала 3 Public API. Его функциональность сочетается сTooltipState
, покаBasicTooltip
Foundation не стабилизирован. ( ICDA29 ) - Добавлен объект
TextDefaults
, который содержит методы для построения строкиLinkAnnotation
и разбора HTML-меченной, которая применяетMaterialTheme
к ссылкам ( I98532 , B/139312671 ) -
ExposedDropdownMenuBoxScope
больше не разрешает подклассы. Раскрытые выпадающие меню теперь имеютMenuAnchorType
, которые следует передавать вmenuAnchor
для поддержки лучшего A11Y. Это следует использовать вместо того, чтобы переноситьfocusable
вExposedDropdownMenu
, который сейчас устарел.menuAnchor
имеет новый параметр для контроляenabled
состоянием. ( I55ee6 , b/257209915 , b/308840226 ) - Исправлено цвет границы
OutlinedButton
при отключении. ДобавленаButtonDefaults.outlinedButtonBorder("enabled")
, которая принимает включенное состояние. ( IE650B , B/318461363 ) - Добавлен новый класс
CarouselItemInfo
, чтобы помочь клиентам получить информацию о размерах предметов. ( I9070c ) -
ColorScheme
Constructor без поверхностных контейнеров теперь устарел. Пожалуйста, перейдите в конструктор, который включает в себя контейнеры поверхности. ( I35c11 ) - [Outded]
TextFieldDefaults
ContainerBox
переименован вContainer
. ( IE8D3B )
Исправления ошибок
-
BottomSheetScaffold
больше не будет прокручивать от вложенного прокрутки, еслиsheetSwipeEnabled
является ложным. ( I5e1c1 , b/306464779 ) - Удал некоторую аннотацию Optin
ExperimentalMaterial3Api
вIconButtonSamples.kt
. ( I111d1 )
Версия 1.3.0-альфа04
3 апреля 2024 г.
androidx.compose.material3:material3-*:1.3.0-alpha04
выпускается. Версия 1.3.0-Alpha04 содержит эти коммиты .
Новые функции
- Добавлено две экспериментальные версии материала3 Карусель -
HorizontalMultiBrowseCarousel
иHorizontalUncontainedCarousel
( I88D64 ) - Обновленная компона M3 NAV ящик (
ModalDrawerSheet
andDismissibleDrawerSheet
), чтобы поддержать прогнозирование на U+ как Opt-In ( IE5B0B ) - Добавлен новый API в значке, чтобы позволить проходить цветовой оттенок в качестве лямбды, чтобы избежать переоборудования. ( I5b5a2 )
- Top API API -интерфейсы API теперь поддерживают пользовательские высоты как для фиксированных, так и для складных разделов. ( IB8B0C , B/323403446 )
Изменения API
- Top API API -интерфейсы API теперь поддерживают пользовательские высоты как для фиксированных, так и для складных разделов. Исправлена проблема, из-за которой однострочные лучшие приложения переоценили слишком много раз при прокрутке контента. Решено проблему, в которой усеченные заголовки
MediumTopAppBar
на устройствах с большими настройками шрифта/дисплея. ( IB8B0C , B/323403446 , B/300953236 , B/286296147 , B/330410290 , B/308540676 ) -
SegmentedButton
и Associated API теперь стабильны ( I8A158 ) -
SwipeToDismissBox
,SwipeToDismissBoxDefaults
,SwipeToDismissBoxState
иSwipeToDismissBoxValue
теперь стабильны. ( I5f000 ) - Удаленное устаревшее
DismissDirection
иDismissValue
перечисления и API. ( I89ccd ) - Добавлен экспериментальную метку в компаньон
CarouselState
Companion. ( I94154 ) - Установите
LocalMinimumInteractiveComponentEnforcement
и ввелLocalMinimumInteractiveComponentSize
для его замены. ( I7a7ac ) -
SearchBarColors
Constructor в настоящее время публично. ( I769ca ) - Добавлены параметр в
SwipeToDismissBox
gesturesEnabled
. ( IDC59F , B/324170119 ) - Удаленные API -интерфейсы текстового поля, которые были отмечены как устаревшие и экспериментальные. ( I1305f )
Версия 1.3.0-альфа03
20 марта 2024 г.
androidx.compose.material3:material3-*:1.3.0-alpha03
выпускается. Версия 1.3.0-Alpha03 содержит эти коммиты .
Визуальные разбитые изменения
- Обновите наложение состояния фокуса, чтобы быть 0,1F, чтобы обеспечить достаточный цветовой контраст. ( I7ea77 )
- Небольшие настройки на поверхность и фоновый цвет по умолчанию в
lightColorScheme
иdarkColorScheme
. ( I9db52 )
Новые функции
- Добавлены параметры для настройки
ExposedDropdownMenu
. В частности, в меню теперь естьfocusable
параметр (true
по умолчанию), который должен быть установлен наfalse
при работе с редактируемыми текстовыми полями. ( I4184c , b/323694447 , b/278609042 )
Изменения API
- Флаг
ScaffoldSubcomposeInMeasureFix
был удален. ( IE2A4B ) -
NavigationRailItemColors
теперь помечен как@Immutable
. ( If6112 , b/327660613 ) -
NavigationBarItemColors
теперь помечен как@Immutable
. ( I42a30 , b/298064514 ) - Пересмотреть параметры в Slider Drack Composable. ( I9f315 )
-
ExposedDropdownMenu
теперь реализован с использованиемPopup
. Поведение должно быть тем же, за исключением того, что фокусируемые меню с редактируемыми текстовыми полями могут быть отклонены при вводе на клавиатуре.
Исправления ошибок
- Подводные и поверхностные контейнер. ( I677a5 )
- Обновленные цветы слайдера и
ProgressIndicator
, чтобы следовать новым не текстовым контрастным характеристикам. ( I26807 ) - Обновите наложение состояния фокуса, чтобы быть 0,1F, чтобы обеспечить достаточный цветовой контраст. ( I7ea77 )
- Небольшие настройки на поверхность и фоновый цвет по умолчанию в
lightColorScheme
иdarkColorScheme
. ( I9db52 )
Версия 1.3.0-альфа02
6 марта 2024 г.
androidx.compose.material3:material3-*:1.3.0-alpha02
выпускается. Версия 1.3.0-Alpha02 содержит эти коммиты .
Изменения API
- Снова сделай слайдер стабильно. Создание
State.onValueChangeFinished
. OnvalueChangefinafining Val. ОбертываниеonValueChangeFinished
вrememberUpdatedState
. ( I82ab2 , b/322269951 ) - Навигационные компоненты теперь используют новые роли
SurfaceContainer
. В настоящее времяDrawerDefaults
предоставляют различные атрибутыstandardContainerColor
иmodalContainerColor
.DrawerDefaults.ModalDrawerElevation
теперь0.dp
( I7fbac ) - Удаление
@Stable
из состоянийSlider
, так как мы меняемstate.onValueChangeFinished
. Onvaluechangefinefined вvar
. ( IED34A , B/322269951 ) - Спецификация анимации
ModalBottomSheet
иStandardBottomSheet
теперь являетсяTweenSpec
, обновленной из пружинной анимации. Это решает проблему с видимым перехватом. Установленные конструкторыSheetState
без плотности теперь удалены. ( I7babc , b/285847707 )
Исправления ошибок
- Варианты
SurfaceContainer
теперь используются компонентами. Компоненты, которые формально рассчитывали цвет с поверхностью иTonalElevation
, в настоящее время используют ролиSurfaceContainer
по умолчанию, которые не влияют на тональную высоту. ( B/304584161 ) - Исправлена ошибка, которая вызвала невыбранное, отключенный цвет контейнера
ElevatedFilterChip
, чтобы быть черным. ( I400e6 , b/322407043 ) - Исправить неопределенный индикатор прогресса, когда прогресс составляет 0 ( ID6582 )
- Исправлена проблема с
Slider
иRangeSlider
на компоновке RTL ( IAB0E1 ) - Добавление
SliderRangeTolerance
для расчета диапазона ползунка, так как поплавковое округление может быть неточным. ( IC918A , B/324934900 ) - Убедитесь, что
DatePickerDialog
отображает свои кнопки при гнездеDateRangePicker
или при отображении любого типа выбора даты на небольших экранах с большими шрифтами. ( IE4758 , B/325107799 , B/277768544 ) -
Menu
теперь использует рольSurfaceContainer
для цвета контейнеров.MenuDefaults.TonalElevation
теперь0.dp
( I135B7 ) -
TextField
теперь использует самую высокую рольSurfaceContainerHighest
для цвета контейнеров. ( I4dced ) - Повышенные чипы теперь используют роль
SurfaceContainerLow
( i7cd2f ) - Цвет контейнера
DatePicker
теперьSurfaceContainerHigh
.DatePickerDefaults.TonalElevation
теперь0.dp
( IDA753 ) - Обновления нижних листов цвет контейнера и цвет ручки перетаскивания. ( I72a0a )
- Цвет контейнера
RichTooltip
теперьSurfaceContainer
. ( IA8B45 ) - Цвет контейнера
SearchBar
теперьSurfaceContainerHighest
.SearchBarDefaults.TonalElevation
теперь0.dp
( I88604 ) - Обновления отключили и не выбранные треки/значки для использования верховой цветовой роли
SurfaceContainerHighest
. ( I7687a ) - Цвет контейнера
AlertDialog
теперьSurfaceContainerHigh
. ( IE0433 ) - Цвет контейнера
BottomAppBar
теперьSurfaceContainer
.TopAppBar
onScroll
Color теперьSurfaceContainer
. ( I41630 ) - Цвет контейнеров
ElevatedCard
теперьSurfaceContainerLow
. Цвет контейнераFilledCard
картыSurfaceContainerHighest
. ( I35141 ) -
ElevatedButton
комната контейнера теперь являетсяSurfaceContainerLow
.FilledIconButton
, когда он не выбран теперь имеет цвет контейнераSurfaceContainerHighest
. ( I792c9 ) - Обновления
TimePicker
Container Color и Clock Dial Роль дляSurfaceContainerHighest
. ( I43b93 )
Версия 1.3.0-альфа01
21 февраля 2024 г.
androidx.compose.material3:material3-*:1.3.0-alpha01
выпускается. Версия 1.3.0-Alpha01 содержит эти коммиты.
Новые функции
- Обновление Compose M3
ModalBottomSheet
для поддержки прогнозирования на U+ ( ICCF32 , B/281967264 , B/304850357 ) - Обновленная Compose M3
SearchBar
для поддержки Predictive обратно на u+ ( i657f8 ) - Обновлен слайдер для улучшения доступности, добавив индикатор разрыва и остановки. ( I3058e )
- Обновлено
ProgressIndicator
для улучшения доступности, добавив индикатор разрыва и остановки. ( I21451 ) - Добавляя карету по умолчанию для богатого всплывающего подсказки, New Rich API для подсказки инструментов теперь позволяет нарисовать пользовательскую карету с учетом якоря
LayoutCoordinates
. ( Ifd42c )
Изменения поведения
- Материальные компоненты были мигрированы, чтобы использовать новые Ripple API и больше не запросить
RippleTheme
.
Изменения API
- Веселый
drawStopIndicator
в настоящее время является общедоступным. ( I3f59f ) - Отметьте функцию
formatWithSkeleton
DatePicker
в качестве внутренней ( IC65DC ) -
DropdownMenu
теперь поддерживает пользовательский цвет, форму, высоту и границу. ( I8e981 , b/2895544448 , b/301887035 , b/283654243 ) - Материал3 Компоненты, разоблачающие
MutableInteractionSource
в их API, были обновлены, чтобы теперь выявить нулевыеMutableInteractionSource
, которые по умолчанию по умолчанию вnull
. Здесь нет семантических изменений: передача NULL означает, что вы не хотите подниматьMutableInteractionSource
, и он будет создан внутри компонента, если это необходимо. Изменение на NULL позволяет некоторым компонентам никогда не распределятьMutableInteractionSource
и позволяет другим компонентам только лениво создавать экземпляр, когда им необходимо, что повышает производительность в этих компонентах. Если вы не используетеMutableInteractionSource
которые вы передаете этим компонентам, рекомендуется вместо этого пройти NULL. Также рекомендуется внести аналогичные изменения в своих собственных компонентах. ( I41abb , b/298048146 ) - Добавляет
RippleConfiguration
иLocalRippleConfiguration
, чтобы обеспечить настройку рябовей с использованием фиксированных значений. Например, чтобы изменить цвет компонента, который вы не управляете, или отключить пульсацию для компонента. В большинстве случаев должны использоваться значения по умолчанию: эти API являются вытапленным люком для настройки отдельных компонентов / ограниченных под деревьев. Для более широких изменений и индивидуальных систем проектирования, вы должны вместо этого создать свою собственную Ripple, используяcreateRippleModifierNode
. ( I7b5d6 , b/298048146 ) - Добавляет новый API Ripple в Material3, который заменяет устаревшее
rememberRipple
. Also adds a temporaryCompositionLocal
,LocalUseFallbackRippleImplementation
, to revert material3 components to using the deprecatedrememberRipple
/RippleTheme
APIs. Это будет удалено в следующем стабильном выпуске и предназначено только для того, чтобы быть временной миграционной помощью для тех случаев, когда вы предоставляете пользовательскуюRippleTheme
. ( I34CBC , B/298048146 )
Исправления ошибок
- Удалена подкомпозиция внутри
ModalBottomSheet
для повышения производительности. Исправлена проблема, в которойModalBottomSheet
мог потерпеть крах в определенных сценариях в сочетании сLookaheadScope
. ( I2a198 ) - Удалена подкомпозиция внутри
BottomSheetScaffold
для повышения производительности. Исправлена проблема, в которойBottomSheetScaffold
будет терпеть неудачу в определенных сценариях в сочетании сLookaheadScope
. ( IE6401 ) - Выравнивание значков корректируется, чтобы быть ближе к центру анкерного содержания по отношению к праву в верхнем правом углу. ( I18A28 )
- Исправьте проблему A11Y с помощью
DateRangePicker
, где заголовок текста месяц-летнего текста был представлен как действующий на считыватель экрана, доступительно переключать и голосовой доступ. ( I2ac55 ) - Исправлено
mediumTopAppBarColors
Param Order ошибка. ( Ibe64a )
Версия 1.2
Версия 1.2.1
6 марта 2024 г.
androidx.compose.material3:material3-*:1.2.1
выпускается. Версия 1.2.1 содержит эти коммиты .
Исправления ошибок
- Сделайте повторные состояния слайдера снова. Создание
State.onValueChangeFinished
. OnvalueChangefinafining Val. ОбертываниеonValueChangeFinished
вrememberUpdatedState
. ( IE8FD0 , B/322269951 ) - Удаление
@Stable
из состоянийSlider
, так как мы меняемstate.onValueChangeFinished
. Onvaluechangefinefined вvar
. ( I82ba1 , b/322269951 ) - Исправьте
NavigationBar
цвета пользовательские цвета, чтобы копировать по умолчанию. ( 80A779 , b/326894020 ) - Исправьте регрессию в
ExposedDropdownMenu
, чтобы снова сделать ее фокусировкой ( 3FCEC1 , B/323694447 ) - Проблема с кнопкой кнопки кнопки кнопки ( 3E5BBC B/327371655 )
Версия 1.2.0
7 февраля 2024 г.
androidx.compose.material3:material3-*:1.2.0
выпускается. Версия 1.2.0 содержит эти коммиты.
Известный вопрос
- В
PrimaryTabRow
была представлена ошибка рендеринга взаимодействия с представлением, как часть изменения повышения производительности. Обходной путь состоит в том, чтобы использоватьTabRow
сTabRowDefaults.PrimaryIndicator
Важные изменения с версии 1.1.0
Новый дизайн материала 3 компоненты
- Потяните, чтобы обновить
- Сегментированная кнопка
Улучшения для существующих компонентов дизайна материала 3.
- Нижняя панель приложений (выравнивание RTL, автоматическое скрытие на свитке)
- Вкладки визуальное обновление
- Значок (обновление выравнивания)
Продвижение экспериментальных API до стабильной!
Улучшения производительности
- Пожалуйста, смотрите этот пост в блоге для получения более подробной информации!
Версия 1.2.0-rc01
24 января 2024 г.
androidx.compose.material3:material3-*:1.2.0-rc01
выпускается. Версия 1.2.0-RC01 содержит эти коммиты.
Исправления ошибок
- Исправлено
mediumTopAppBarColors
Param Order ошибка. ( Ibe64a ) - Исправлена ошибка, представленная в
1.2.0-beta02
вCardDefaults.cardColors
, которая не обновлялаcontentColor
на основе значения параметраcontainerColor
. ( IEE041 , B/319671246 ) - Исправлена ошибка в
disabledContentColor
, представленную в1.2.0-beta02
и добавлена небольшая оптимизация. ( I6dda1 , b/318428829 )
Версия 1.2.0-бета02
10 января 2024 г.
androidx.compose.material3:material3-*:1.2.0-beta02
выпускается. Версия 1.2.0-бета02 содержит эти коммиты.
Известная ошибка
- Ошибка в
IconButtonColors
по умолчанию назначитdisabledContentColor
в альфа (0,38F)LocalContentColor
вместо указанного пользователяcontentColor
. Обходной путь состоит в том, чтобы явно установитьdisabledContentColor
. Это будет исправлено в следующем выпуске.
Изменения API
- Добавление возможностей для включения подсказки для подсказок для простых API -интервалов
Tooltip
. ( IBF767 ) -
SwipeToDismissState
,rememberSwipeToDismiss
иSwipeToDismissValue
все переименованы в то, чтобы иметь_SwipeToDismissBox_
. ( I68d6d )
Исправления ошибок
- Фиксированное значение окончательного значения
ListItem
для соответствия спецификации. ( IBD68B , B/305342674 ) - Цвет сброса для изложенной карты теперь правильно отображается с
OutlineVariant
. ( I75480 , b/310979715 ) - Динамический цвет теперь вытягивает из системы, определенных цветовыми ролями. Это улучшает контраст для доступного контента и более тесно выравнивает динамический цвет с спецификацией материала. ( I1de96 )
- Исправлена
ModalBottomSheet
Back обработка на Android T/13+, когдаandroid:enableOnBackInvokedCallback="true"
. ( I728dc , b/306196110 )
Версия 1.2.0-beta01
13 декабря 2023 г.
androidx.compose.material3:material3-*:1.2.0-beta01
выпускается. Версия 1.2.0-бета01 содержит эти коммиты.
Изменения API
- Mark
TabIndicatorScope
как экспериментальный. ( I45c88 ) - Удаление устаревших экспериментальных API для подъема инструментов. ( I438cb )
- Change new
TabRow
overloads to not use subcompositions. This results in a different way to build theTabRow
indicators with custom modifiers provided. ( Ife741 ) - Deprecate
DismissDirection
andDismissValue
API's. These have been merged toSwipeToDismissValue
, whose values indicate both position and direction ofSwipeToDismissBox
.DismissState.progress
is now marked as aFloatRange
between0.0
and1.0
.DismissState
deprecated Saver and Constructor have now been removed.SwipeToDismiss
component, state and defaults object have been remarked as experimental. ( Ib54f2 )
Исправления ошибок
- The default indicator for
PullToRefresh
is now an open arrowhead instead of a solid triangle. ( I67be3 )
Version 1.2.0-alpha12
29 ноября 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha12
is released. Version 1.2.0-alpha12 contains these commits.
Изменения API
-
RangeSlider
now takes a Kotlin range (eg,0f..1f
) instead of a customFloatRange
value class.SnapFlingBehavior.kt
now also uses a Kotlin range. ( I025cb ) - Mark Modifier factory functions as
@Stable
. ( Ib109f )
Version 1.2.0-alpha11
15 ноября 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha11
is released. Version 1.2.0-alpha11 contains these commits.
Новые функции
- Implements
PullToRefreshContainer
andPullToRefreshState
, which together provide a pull to refresh implementation in Material3. ( I16456 , b/261760718 )
Изменения API
- Mark the
SwipeToDismissBox
DismissDirection
andDismissValue
as experimental. ( I517b0 ) - Rename
SwipeToDismiss
toSwipeToDismissBox
. Renamebackground
tobackgroundContent
anddismissContent
to trailingcontent
lambda. ( I7f4d3 ) - Make the constructor for
ChipElevation
andSelectableChipElevation
public. ( Ie0c48 , b/308432421 ) - Adding
ModalBottomSheetProperties
. MovingsecurePolicy
intoModalBottomSheetProperties
. AddingisFocusable
andshouldDismissOnBackPress
toModalBottomSheetProperties
. These new booleans help determine how modal bottom sheet should handle IME events. ( Iea56f , b/278216859 ) - Updated
RangeSlider
andSlider
states to removeinitialOnValueChange
, the initial prefixes, and appropriate kdocs. ( I57d30 ) - Deprecate
ChipBorder
class and its associated function calls, recommend usingBorderStroke
directly instead. ( I89cc2 ) - Foundation Tooltip APIs are now
@ExperimentalFoundationApi
. ( I30b0b ) -
TabRow
andScrollableTabRow
are no longer deprecated. The new Primary and Secondary variants are marked as experimental. ( I0def6 ) - Filter and input chips now use
BorderStroke
directly. ( I07a8d ) -
SegmentedButton
now usesBorderStroke
directly. ( I89b9b ) - Renamed the generic
AlertDialog
function toBasicAlertDialog
, and deprecate the previous function. ( Idbe52 ) - Rename
SwipeToDismiss
APIs toSwipeDismiss
, and promote the newSwipeDismiss
APIs to stable. ( I14cbe ) - Adding
tonalElevation
andshadowElevation
to tooltip APIs. Additionally, movingTooltipBox
,PlainTooltip
, andRichTooltip
APIs back to experimental since they were accidentally released as stable. ( If0f66 , b/293939035 ) - Promote experimental chip APIs to stable. ( Iea2c3 )
- Removed the
@ExperimentalMaterial3Api
annotation from the Material3 clickable Cards. ( I88dbf )
Исправления ошибок
- Fixed an issue where
SwipeToDismiss
would crash in certain scenarios with nested Lookahead and Lazy layouts. ( Ica8d1 , b/297226562 )
Version 1.2.0-alpha10
18 октября 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha10
is released. Version 1.2.0-alpha10 contains these commits.
Изменения API
- Promoting
Badge
andBadgedBox
to stable. ( I67f16 , b/261565132 ) - Adding
securePolicy
as a parameter toModalBottomSheet
, so users can define the behavior forWindowManager.LayoutParams.FLAG_SECURE
. ( Icdac8 , b/296250262 ) - Added new overloads of
LinearProgressIndicator
andCircularProgressIndicator
that takeprogress
as a lambda. These should be more performant than the previous versions. ( I824e6 , b/295616656 ) - Renames
StandardSizeClasses
toAllSizeClasses
. ( I8cb07 ) - Combine calculation functions of window size classes. ( Iad935 )
Исправления ошибок
- Fix a
DatePicker
crash when quickly clicking the navigation arrow buttons when the displayed month is at the edge of the allowed range of years. ( I46f36 , b/290954897 , b/297002119 ) - [Nav rail/bar] Support transparent color for indicator. ( Ie0a9b , b/267289987 )
Версия 1.2.0-альфа09
4 октября 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha09
is released. Version 1.2.0-alpha09 contains these commits.
Изменения API
- Migrated
ModalNavigationDrawer
andDismissibleNavigationDrawer
to use newAnchoredDraggable
APIs.DrawerState
'sanimateTo
has been replaced by the open and close methods, and the offset is now exposed as a float instead of a state object. You can access the offset directly throughcurrentOffset
. ( I0a72c ) - Non-Composable functions have been added for creating a
DatePickerState
andDateRangePickerState
directly. These functions can be used as an alternative to the ComposablerememberDatePickerState
andrememberDateRangePickerState
functions when needed. ( I70326 , b/291524052 ) - Fixed and Scrollable
TabRows
now have Primary and Secondary variants. These correctly map to the color and indicator behavior as defined in Material3. -
PrimaryScrollableTabRow
andSecondaryScrollableTabRow
now expose scroll state. ( Iec8f5 , b/260572337 ) - Adding a new
sheetMaxWidth
parameter that developers can set to specify a maximum width that the sheet will span. Dp.Unspecified can be passed in for the parameter if a sheet that spans the entire screen width is desired. ( Ifb7c9 , b/266697696 ) - Adding back
PlainTooltipBox
andRichTooltipBox
APIs as deprecated methods. ( I246fa )
Исправления ошибок
- Fix a crash when the
DatePicker
is initialized with aDatePickerFormatter
that has certain date skeletons that stay the same when converted to date patterns (such as YY). ( I01f29 )
Версия 1.2.0-альфа08
20 сентября 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha08
is released. Version 1.2.0-alpha08 contains these commits.
Behavior Breaking Change
-
ColorScheme
is now Immutable, making individual color updates less efficient, but making more common usage of colors more efficient. The reasoning behind this change is that the majority of apps wouldn't have updating individual colors as a main use case. This is still possible but it will recompose more than before, in turn we significantly decrease the amount of state subscriptions through all of Material code and will impact initialization and runtime cost of more standard use cases. ( Ic447d , b/297212873 ) - Tonal Elevation no longer animates in different interaction states to match spec. ( Icdd12 )
Изменения API
- Added a new
BottomAppBar
that takes as parameter aBottomAppBarScrollBehavior
in order to auto-hide it when content is scrolled. Also addedFabPosition.EndOverlay
allowing the FAB to overlay the bottom app bar in the scaffold instead of being anchored above it. ( Iecb47 ) - Added a simple Label component that builds on top of
BasicTooltipBox
that won't dismiss when tapping outside of the bounds of the label. ( I821f9 )
Исправления ошибок
- Removed the use of
rememberSaveable
for tooltips. ( Icc131 , b/299500338 ) - Introduced a temporary flag to control whether Scaffold should measure its children during measurement or during placement. By default, this will measure in measurement. If you are facing issues with the new behavior, please file an issue. ( I0b354 )
- Fixed horizontal Edge to Edge in
BottomSheet
by using the correct measurement for device screen width. ( I1df0c , b/299058752 ) - Fixed a bug where
ModalBottomSheet
was not callingonDismissedRequest
when dismissing it by swiping down on the sheet. ( Idfdd8 )
Версия 1.2.0-альфа07
6 сентября 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha07
is released. Version 1.2.0-alpha07 contains these commits.
Новые функции
- Auto-mirror icons support has been added in
compose material 1.6.0-alpha05
, please see the release notes for details on auto-mirror icons.
Изменения API
-
SliderState
implementsDraggableState
( I9b116 ) - Change shape to be a required param. Rename
position
toindex
in shape helper function. ( I34941 ) - Updates the
DatePicker
formatWithSkeleton
to include a map that is used as a cache for performance improvements. ( I3195f ) - Added
BasicTooltipBox
tocompose.foundation
and updatedPlainTooltipBox
andRichTooltipBox
to useTooltipBox
with newPlainTooltip
andRichTooltip
composables. ( I79e1d )
Исправления ошибок
-
dynamicLightColorScheme
anddynamicDarkColorScheme
now return higher chroma colors for surface andsurfaceContainer
roles. ( I5e901 ) - Fixed an issue where some components using Subcomposition (eg
BottomSheetScaffold
) inside a Scaffold inside aLookaheadScope
were attempting to read their size too early. ( I297b4 , I871f1 , b/295536718 )
Версия 1.2.0-альфа06
23 августа 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha06
is released. Version 1.2.0-alpha06 contains these commits.
Исправления ошибок
- Fixed
DropdownMenu
'soffset
calculation so x offsets depend solely on the local layout direction, and y offsets will no longer be reversed when the menu is near the bottom of the screen. ( Iccc74 , b/294103942 ) - Fixed
DropdownMenu
'soffset
calculation so x offsets depend solely on the local layout direction, and y offsets will no longer be reversed when the menu is near the bottom of the screen. ( Ib87a2 , b/294103942 )
Версия 1.2.0-альфа05
9 августа 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha05
is released. Version 1.2.0-alpha05 contains these commits.
Изменения API
- Updates to the Checkbox and
TriStateCheckbox
colors. TheCheckboxDefaults.colors()
disabledUncheckedColor
now only affects the border of the checkbox. Special cases that require you to set the internal box color when disabled and unchecked requires a custom constructed instance of aCheckboxColors
with the desired color values. ( I77d17 , b/291943198 )
Версия 1.2.0-альфа04
26 июля 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha04
is released. Version 1.2.0-alpha04 contains these commits.
Новые функции
- Experimental Segmented Button API ( Ifc8fb )
- Dividers now have a parameter to control orientation to support vertical dividers. ( I4c899 , b/288438593 )
Изменения API
- We are moving the density dependency to the component level. This applies to the following components:
SwipeToDismiss
and Sheet based components. Please use the new overload provided where density is a parameter. ( I1846e ) - Additional annotations to specify allowed inputs to composables ( Ief234 )
- Add an icon parameter to segmented button, split semantics so that segmented buttons can be selectable to implement single-select, and toggleable to implement multi-select, with
SelectableSegmentedButtonRow
andToggelableSegmentedButtonRow
respectively. ( I38740 ) - Divider has been renamed to
HorizontalDivider
. AddedVerticalDivider
functionality. ( I5975c ) - Change the use of
ClosedFloatingPointRange
for the lighter weightFloatRange
in experimental Material3 APIs to minimize autoboxing. ( I4aab5 ) - Added new Start alignment for
FabPosition
( Ib7aea , b/170592777 )
Исправления ошибок
-
ModalBottomSheet
respects local layout direction. ( Ib4f44 , b/285628622 )
Версия 1.2.0-альфа03
21 июня 2023 г.
androidx.compose.material3:material3-*:1.2.0-alpha03
is released. Version 1.2.0-alpha03 contains these commits.
Изменения поведения
-
includeFontPadding
is nowfalse
by default in Material 3 typography. The default line height style has also been changed toTrim.None
andAlignment.Center
, and explicitlineHeight
(in sp) have been added to theTextStyle
s ofTypography
. Consult the API docs if you want to customize these values, and see the blog post for an in-depth explainer of these changes. ( I6266f , Icabc3 )
Новые функции
- Added an overload for
RangeSlider
that is a stateful version of the component. CreatedRangeSliderState
that holds all of the information for the current active track, the measurements of the components of theRangeSlider
, and the drag and gesture logic. ( I8c270 ) - Search bar now supports shadows via the newly added
shadowElevation
parameter. ( Ia5369 , b/271040353 ) -
ColorScheme
now supports newSurfaceContainer
roles . - Surface tonal elevation overlay can now be disabled with the
LocalTonalElevationEnabled
composition local. ( Ic203c , b/277774590 )
Изменения API
- Open the component colors constructors. ( I8c4a6 )
- Adding focusable parameter to both tooltip APIs, so that developers can have the tooltip consume touch events or not. Be cautious that this might break accessibility focus automatic traversal. ( Ie32d8 )
- Optimized accessibility for performance and memory allocations. ( Iede48 )
- Expose
DefaultSizeClasses
and createStandardSizeClasses
forWindowSizeClasses
( I91838 ) - change
WindowWidth/HeightSizeClass
to float value classes ( Ie686e )
Исправления ошибок
- Scaffold's
contentWindowInsets
parameter now respects consumed window insets. Note that the behavior of content padding based ontopBar
andbottomBar
remains unchanged when these parameters are provided. ( I08b73 , b/264601542 ) - Fix the alignment of the center top app bar to ensure that a long title doesn't render over the action icons or the navigation icon. ( I4369f , b/236994621 )
- Tab positions now enforce a minimum content width of 24.dp. This provides an accessible touch target for tab indicators. ( Id8861 )
- Dynamic color palettes from
dynamicLightColorScheme
anddynamicDarkColorScheme
now support new surface roles. ( I1252e ) - Updating the badge notification alignment to not clip when colliding with great grandparent. ( Idf75a )
Версия 1.2.0-альфа02
May 24, 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
is released. Version 1.2.0-alpha02 contains these commits.
Изменения API
- Add window insets parameter to
ModalBottomSheet
.- Scrim for
ModalBottomSheet
may now be drawn behind status bar withwindowInsets
set to zero - Updated default
ModalBottomSheet
functionality to stay outside of system bars including navigation - Status bar inset handling is provided by drag handle in edge-to-edge mode.
-
BottomSheetDefaults
includes window insets forBottomSheetWindow
. ( I31200 , b/274872542 , b/272973615 , b/272334475 , b/268432129 , b/275849044 , b/275486106 , b/268433162 )
- Scrim for
- Deprecate
Indicator
and addPrimary
/SecondaryIndicator
to match the M3 specs.PrimaryIndicator
matches the width of the tab's content whereasSecondaryIndicator
spans the full available width.SecondaryIndicator
is equivalent to the now deprecatedIndicator
and can be a direct replacement. ( I27604 ) - Added an option to pass in a
ScrollState
when constructing aDropdownMenu
or anExposedDropdownMenu
for controlling the vertical scroll state of the displayed menu items. ( Ia0734 , b/185304441 ) - Added an overload for
Slider
that is a stateful version of the component. CreatedSliderState
that holds all of the information for the current active track, the measurements of the components of theSlider
, and the drag and gesture logic. ( I124a5 ) - Renaming the Semantics property
isContainer
toisTraversalGroup
( I121f6 ) - Added optimized
TextStyle.merge(...)
with full parameter list. ( Iad234 , b/246961787 ) - Made
TooltipState
,RichTooltipState
, andPlainTooltipState
public interfaces. AddedRichTooltipStateImpl
andPlainTooltipStateImpl
for default states. Addedremember*State
functions to obtain these implemented states. RemovedTooltipSync
in favor of anTooltipDefault.GlobalMutatorMutex
. ( I7813d ) - Updated the
DatePickerColors
to include additional customization options for the date picker divider, navigation, and text input fields colors. ( I1a685 , b/274626815 ) -
DatePickerState
and theDateRangePickerState
are now public interfaces with default implementations that can be retrieved by therememberDatePickerState
andrememberDateRangePickerState
. ( I71c52 ) - Removed the
dateValidator
fromDatePicker
andDateRangePicker
and introduced aSelectableDates
interface that can be set on the state to control which dates or years are selectable in the UI. ( Ic2fc6 ) -
TimePicker
removed from stable API, further changes are expected in the state API ( I3f39a ) -
ModalBottomSheet
moved to android only.ModalBottomSheet
is not recommended for desktop use, and the functionality is not actively maintained. ( Ib3778 )
Исправления ошибок
- Fixed the
AlertDialog
dismiss action to appear below the confirm action when the actions stacked over each other to fit into the dialog's width. This fix aligns the implementation with the Material Design spec. ( I029de , b/235454277 ) - Fixed bug in
ListItem
using incorrect padding for three-line items. ( I6e235 ) -
ModalBottomSheet
now can display IME keyboard ( Idc508 , b/262140644 , b/268380384 , b/272483584 )
Версия 1.2.0-альфа01
May 10, 2023
androidx.compose.material3:material3:1.2.0-alpha01
and androidx.compose.material3:material3-window-size-class:1.2.0-alpha01
are released. Version 1.2.0-alpha01 contains these commits.
Версия 1.1
Version 1.1.2
20 сентября 2023 г.
androidx.compose.material3:material3:1.1.2
and androidx.compose.material3:material3-window-size-class:1.1.2
are released. Version 1.1.2 contains these commits.
Исправления ошибок
- Fixed modifier incorrectly being passed to two composables. ( b/282761472 )
- Fixed
TimePickerState
returns incorrect hours when initialized with 23 hours. ( b/278242122 ) - Fixed initial toggle state for noon and minute validation. ( b/269768197 , b/282790635 )
- Fixed
state.hour
returning incorrect value for 11pm. ( b/282761472 , b/278242122 )
Версия 1.1.1
21 июня 2023 г.
androidx.compose.material3:material3:1.1.1
and androidx.compose.material3:material3-window-size-class:1.1.1
are released. Version 1.1.1 contains these commits.
Исправления ошибок
- Adds call for
ModalBottomSheet
withoutwindowInset
param for binary compatibility. ( Ib7959 ) - Add window insets parameter to
ModalBottomSheet
.- Scrim for
ModalBottomSheet
may now be drawn behind status bar withwindowInsets
set to zero - Updated default
ModalBottomSheet
functionality to stay outside of system bars including navigation - Status bar inset handling is provided by drag handle in edge-to-edge mode.
-
BottomSheetDefaults
includes window insets forBottomSheetWindow
. ( I31200 , b/274872542 , b/272973615 , b/272334475 , b/268432129 , b/275849044 , b/275486106 , b/268433162 )
- Scrim for
Версия 1.1.0
May 10, 2023
androidx.compose.material3:material3:1.1.0
and androidx.compose.material3:material3-window-size-class:1.1.0
are released. Version 1.1.0 contains these commits.
Major features of 1.1.0
New Material Design 3 components
Enhancements to existing Material Design 3 components.
Promoted experimental APIs to stable!
Please see this blog post for more details!
Версия 1.1.0-rc01
19 апреля 2023 г.
androidx.compose.material3:material3:1.1.0-rc01
and androidx.compose.material3:material3-window-size-class:1.1.0-rc01
are released. Version 1.1.0-rc01 contains these commits.
Изменения API
-
TimePicker
removed from stable API, further changes are expected in the state API ( I3f39a ) -
ModalBottomSheet
moved to android only.ModalBottomSheet
is not recommended for desktop use, and the functionality is not actively maintained. ( Ib3778 )
Версия 1.1.0-beta02
April 5, 2023
androidx.compose.material3:material3:1.1.0-beta02
and androidx.compose.material3:material3-window-size-class:1.1.0-beta02
are released. Version 1.1.0-beta02 contains these commits.
Изменения API
-
SheetState
now has optionalskipHiddenState
parameter -
rememberStandardBottomSheetState
now has optionalskipHiddenState
parameter -
BottomSheetScaffold
now has a defined Hidden anchor, though it is disabled by default -
SheetState.requireOffset
documentation has been updated -
BottomSheetDefaults.MinimizedShape
has been renamed asBottomSheetDefaults.HiddenShape
( I839f4 , b/273870234 )
Исправления ошибок
- Do not switch the dial face from hour to minute when touch exploration is enabled. ( I717d0 )
-
ModalBottomSheet
andBottomSheetScaffold
drag handle semantics are now merged. ( I05afb ) -
BottomSheetScaffold
modifier,containerColor
andcontentColor
parameters now only affect content. ( I992cb ) -
BottomSheetScaffold nestedScroll
for sheet content now implements flings. ( I992cb )
Версия 1.1.0-beta01
22 марта 2023 г.
androidx.compose.material3:material3:1.1.0-beta01
and androidx.compose.material3:material3-window-size-class:1.1.0-beta01
are released. Version 1.1.0-beta01 contains these commits.
Изменения API
- Add layout type param to
TimePicker
composable. It allows to use different layouts, depending on the screen configuration ( Ia0e16 ) -
SearchBarDefaults
has been marked as experimental. ( I65561 ) - Added shadow elevation to
BottomSheetScaffold
( I94e0f ) - Added support for displaying the date pickers without the header part. API changes to allow passing a null headline when creating a date picker. You can now pass null headline, title, and
showToggleMode = false
in order to display a headless picker. ( Id3f3a , b/266132421 , b/267194809 )
Исправления ошибок
- Search bars now automatically clear focus when made inactive. ( I22a7c , b/261444487 )
- Updated the
DateRangePicker
to allow selecting a range with the same date for its start and end. ( I16529 , b/272882497 ) - Text fields now properly position their text elements when font size is smaller than expected. This may result in a few pixels change in your apps based on font settings and script. ( I8b8d0 )
- Bottom sheet semantic actions now have labels. ( I277b0 )
Версия 1.1.0-альфа08
8 марта 2023 г.
androidx.compose.material3:material3:1.1.0-alpha08
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha08
are released. Version 1.1.0-alpha08 contains these commits.
Новые функции
- Added support for
BottomSheetScaffold
andBottomSheetScaffoldState
. ( I063d4 )
Изменения API
- Added functionality to the
DatePickerState
and theDateRangePickerState
to allow setting dates after the initial creation of the state, as well as resetting selections by setting null timestamps. Setting dates manually should be made with caution, and the newsetSelection
function will throw an exception in case a provided date fails a precondition (see documentation). ( Ifa645 , b/268609314 , b/270427389 ) - Rename Collapsed
SheetValue
toPartiallyExpanded
to more accurately and flexibly depict behavior in this state. ( Ia1491 ) - Updated
ListItem
parameter names to _content instead of _text. Default getters are nowReadOnlyComposables
where relevant. ( I69a25 ) - Graduate interactive Surface APIs from experimental. ( I90d59 , b/261561812 )
Исправления ошибок
- Fixed an issue where
ModalBottomSheet
'sHalfExpanded
state was calculated incorrectly and the sheet would appear to be floating. ( I45e84 , b/268411386 ) - Add
confirmValueChange
check to scrim tap forModalBottomSheet
. ( I2311a , b/270425759 ) - Move semantic
BottomSheet
actions to drag handle. ( I158ba ) -
ModalBottomSheet
now commands focus on launch, handles back button. ( I4d2ab ) -
ModalBottomSheet onDismissRequest
is now also handled during nested scroll flings. ( I655c5 , b/268433166 )
Версия 1.1.0-альфа07
22 февраля 2023 г.
androidx.compose.material3:material3:1.1.0-alpha07
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha07
are released. Version 1.1.0-alpha07 contains these commits.
Новые функции
- Add a Time Input composable that works with
rememberTimePickerState()
, it follows the M3 spec for time input ( Ia4fab ) - Added a Material 3
DateRangePicker
API for selecting a range of dates. ( I7a6c3 , b/267194809 ) - Added a Material 3 input mode support for selecting date ranges via the
DateRangePicker
API. ( Ifdbc4 ) - Text field colors now allow customizing:
- The input field and placeholder text colors based on focus and error state. The
textColor
parameter has been renamed tounfocusedTextColor
, andplaceholderColor
has been renamed tounfocusedPlaceholderColor
. - The container color for filled text fields based on error state with the new
errorContainerColor
param.
- The input field and placeholder text colors based on focus and error state. The
- Exposed dropdown menu text field colors have been updated with parameters to support the new prefix and suffix API. ( I9c8b4 , b/254284181 , b/264766350 )
Изменения API
- Reverting some Slider API versions and removing redundant Slider overloads that are covered by the new experimental Slider with custom thumb and track. Promoting
RangeSlider
to be stable. ( Ie8fbd ) - Renamed
defaultElevation
toelevation
in chip's elevation functions. ( I0f872 ) - The following Material 3 text field APIs are no longer experimental:
TextField
,OutlinedTextField
,textFieldWithLabelPadding
,textFieldWithoutLabelPadding
,outlinedTextFieldPadding
. ( Ieb5c0 , b/261561819 ) -
TimePickers
is24Hour
uses system setting ( I18856 ) - Removed experimental annotation from scaffold apis. ( Ibb51e , b/261565765 , b/261436953 )
Исправления ошибок
-
ModalBottomSheet
default shape is now alwaysSheetDefaults.ExpandedShape
. ( I0dfca ) - Accessibility improvements for Material 3
DatePicker
andDateRangePicker
. ( I5087e ) - Fix bug where max height constraint is propagated and may crash. ( I30d8c )
- Removed semantic roles from clickable and selectable surfaces, updated components that used them to set roles using modifier.semantics ( I793d9 )
Версия 1.1.0-альфа06
8 февраля 2023 г.
androidx.compose.material3:material3:1.1.0-alpha06
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha06
are released. Version 1.1.0-alpha06 contains these commits.
Новые функции
- Text fields now support prefix and suffix text ( Ia8578 , b/179884561 )
- Added a
TimePicker
function to show a time picker following the Material 3 spec, used in conjunction withTimePickerState
and convenience methodrememberTimePickerState
( I71910 ) - A date input is now a display mode at the
DatePicker
. Added support for switching between date picker and date input modes. ( Ieeff7 ) - Added API for
RichTextTooltips
. ( I58ef3 ) - Modal bottom sheet implementation for Material 3, including
ModalBottomSheet
andModalBottomSheetDefaults
. Also introducesSheetState
andrememberSheetState
which can be used for future sheet components. ( I0853a , b/244189383 )
Изменения API
- Stablize the API
showSnackbar
( I195c2 , b/261424370 ) - Stablize the APIs for assist chip and suggestion chip ( Ibb67b , b/261424370 )
- Promotes
ListItem
,ListItemDefaults
andListItemColors
API to non-experimental ( I7e7fa , b/261438882 ) - Promoting
SliderPositions
,SliderDefaults.Thumb
, andSliderDefaults.Track
to stable and adding non-experimentalSlider
andRangeSlider
APIs that contain custom thumbs and track. Also deprecating the previousSlider
andRangeSlider
APIs. ( Ie5ea6 , b/261566890 ) - Made
Modifier.tooltipAnchor()
public, so devs can pass it to the anchor to indicate a tooltip should be displayed on long press. UpdatedPlainTooltipBox
API to no longer makeTooltipState
nullable and now has a default. ( Ie2fb7 ) -
ProgressIndicatorDefaults.circularTrackColor
has been marked@Composable
for consistency. ( Id29cc ) - Restored property getter
LocalMinimuTouchTargetEnforcement
and mark it as deprecated and redirect toLocalMinimumInteractiveComponentEnforcement
. ( I60dd5 )
Версия 1.1.0-альфа05
26 января 2023 г.
androidx.compose.material3:material3:1.1.0-alpha05
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha05
are released. Version 1.1.0-alpha05 contains these commits.
Новые функции
-
DatePickerDialog
and accessibility support - Added Custom thumb and track to
RangeSlider
.
Обновления зависимостей
-
Compose UI
andCompose Material
now depend on Lifecycle 2.6.0 .
Версия 1.1.0-альфа04
11 января 2023 г.
androidx.compose.material3:material3:1.1.0-alpha04
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha04
are released. Version 1.1.0-alpha04 contains these commits.
Новые функции
- Initial
DatePicker
API for picking a single date via a calendar UI. This API is still undergoing changes. ( I722b9 ) - Added support for plain tooltips via
PlainTooltipBox
. ( I0cdfb ) - Search bar ( Iad128 )
-
SwipeToDismiss
( I458a8 , b/242889540 )
Изменения API
- Added in
IsContainer
semantics property on Surfaces. This property will be used in a later change that determines traversal order based on the semantic meaning of elements such as surfaces. ( I63379 ) - Mark navigation drawer related APIs as stable. ( Iab01e , b/261439597 )
- Added a track color parameter for circular progress indicators, and a stroke cap parameter for both circular and linear progress indicators. ( Ie668c , b/216325962 , b/222964817 )
- More return type nullability of deprecated-hidden functions ( Ibf7b0 )
- Add
Modifier.minimumInteractiveComponentSize
. It can be used to reserve at least 48.dp in size to disambiguate touch interactions if the element would measure smaller. ( I33f58 , b/258495559 ) - Added experimental API for
AlertDialog
composable that has a content slot. ( Iec4a2 )
Исправления ошибок
- Progress for progress indicators is now properly bounded to its expected range. ( I8a7eb , b/262262727 )
Known Issue
- When updating from
androidx.compose.foundation:1.4.0-alpha03
toandroidx.compose.foundation:1.4.0-alpha04
, you might experience ajava.lang.NoSuchFieldError
error. Here is where the issue was orginially reported. A fix has been submitted, and will be available on the next Compose update. As a work around, update yourandroidx.compose.material
andandroidx.compose.material3
libraries to the latest version(1.1.0-alpha04) or downgrade yourandroidx.compose.foundation
to 1.4.0-alpha03.
Версия 1.1.0-альфа03
December 7, 2022
androidx.compose.material3:material3:1.1.0-alpha03
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
are released. Version 1.1.0-alpha03 contains these commits.
Изменения API
- Renamed
consumedWindowInsets()
toconsumeWindowInsets()
andwithConsumedWindowInsets()
toonConsumedWindowInsetsChanged()
and made the Modifiers public. ( Ie44e1 ) - Add new default content padding for text button with icon to use. ( I8f662 )
- Added disabled colors for navigation bar and rail. ( Ia7892 , b/258867034 )
- Added an Modifier API to query ancestors scroll info. ( I2ba9d , b/203141462 )
- Used in
Clickable
to correctly delay press interactions, when gestures could become scroll events. - Fixed
Clickables
not correctly delaying ripples, when used inside anScrollable ViewGroup
. - Updated Drawers and Sheets to correctly delay presses in case gestures can become scroll events.
Обновления зависимостей
-
Compose UI
andCompose Material
now depend on Lifecycle 2.5.1. ( I05ab0 , b/258038814 )
Версия 1.1.0-альфа02
9 ноября 2022 г.
androidx.compose.material3:material3:1.1.0-alpha02
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
are released. Version 1.1.0-alpha02 contains these commits.
Изменения API
-
awaitFirstDown
andwaitForUpOrCancellation
now accept aPointerEventPass
for greater flexibility (also fixesExposedDropdownMenuBox
showing a menu while scrolling).( I7579a , b/212091796 ) - Added
minLines
parameter into material and material3 Text,TextField
andOutlinedTextField
which allows setting the minimum height of the component in terms of number of lines ( I4af1d ) - Deprecate the
TopAppBarDefaults smallTopAppBarColors
function in favor of a newtopAppBarColors
function that should be used when creating aTopAppBar
. ( Ie6cb9 ) - Added
minLines
parameter to theBasicText
andBasicTextField
. It allows to set the minimum height of these composables in terms of number of lines ( I24294 , b/122476634 )
Исправления ошибок
- Clip the content of a Material3
IconButton
andIconToggleBotton
to the component's state-layer shape (eg circular shape). ( I9da8f ) - Updates Material3 Medium and Large top app bars to apply the same background color across their entire surface, and to allow setting overriding the default colors with transparent color values. ( I67659 , b/249688556 , b/250838918 )
Версия 1.1.0-альфа01
October 24, 2022
androidx.compose.material3:material3:1.1.0-alpha01
and androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
are released. Version 1.1.0-alpha01 contains these commits.
Исправления ошибок
- Fixes to the top app bar when title is applied with a TextStyle and a Brush. ( If667e )
Версия 1.0
Version 1.0.1
9 ноября 2022 г.
androidx.compose.material3:material3:1.0.1
and androidx.compose.material3:material3-window-size-class:1.0.1
are released. Version 1.0.1 contains these commits.
Исправления ошибок
- Updates Material3 Medium and Large top app bars to apply the same background color across their entire surface, and to allow setting overriding the default colors with transparent color values. ( I67659 , b/249688556 , b/250838918 )
Версия 1.0.0
October 24, 2022
androidx.compose.material3:material3:1.0.0
and androidx.compose.material3:material3-window-size-class:1.0.0
are released. Version 1.0.0 contains these commits.
Основные особенности версии 1.0.0
This is the first stable release of Compose Material 3!
Material Design 3 theming and Material You dynamic color
Material Design 3 components
- Значок
- Bottom App Bar
- Кнопки
- FAB and extended FAB
- Карты
- Флажок
- Чипсы
- Диалоги
- Разделитель
- Раскрывающееся меню
- Список
- Панель навигации
- Навигационный ящик
- Navigation rail
- Progress Indicator
- Радиокнопка
- Слайдер
- Выключатель
- Вкладки
- Text Fields
- Top app bar
- Икона
- Текст
- Поверхность
- Макет
- Content color
Window Size Class
material3-window-size-class
is a new library that provides support for window size classes: a set of opinionated viewport breakpoints for you to design, develop, and test resizable application layouts against. You can usecalculateWindowSizeClass
to retrieve a window size class instance, which you can use to determine how your UI should appear, such as showing a navigation rail instead of bottom navigation for larger window sizes. For more information and sample usage see the API reference documentation forWindowSizeClass
.Please see this blog post for more details!
Версия 1.0.0-rc01
5 октября 2022 г.
androidx.compose.material3:material3:1.0.0-rc01
and androidx.compose.material3:material3-window-size-class:1.0.0-rc01
are released. Version 1.0.0-rc01 contains these commits.
Изменения API
- Added slot param for supporting text to text field API ( Iaac0d , b/227146125 )
Версия 1.0.0-beta03
21 сентября 2022 г.
androidx.compose.material3:material3:1.0.0-beta03
and androidx.compose.material3:material3-window-size-class:1.0.0-beta03
are released. Version 1.0.0-beta03 contains these commits.
Изменения API
-
ExposedDropdownMenuDefaults
now exposes a padding value for menu items. ( I34ee1 ) -
ExposedDropdownMenuBoxScope
now has aModifier.menuAnchor()
modifier that should be passed to the text field for proper a11y behavior. ( I27fa3 ) - Adding two overloaded methods for the current Slider API to allow users to pass in a thumb or track to populate the slider. ( I21c00 )
Исправления ошибок
- Updated dark theme color mapping for On Error Container to tone 90 ( Ic5612 )
- Fix to allow setting a transparent background for small Material 3 top app bars. ( I645e2 , b/245575782 )
Версия 1.0.0-beta02
7 сентября 2022 г.
androidx.compose.material3:material3:1.0.0-beta02
and androidx.compose.material3:material3-window-size-class:1.0.0-beta02
are released. Version 1.0.0-beta02 contains these commits.
Изменения API
- Default components insets introduced in m3 components in beta01 version no longer account for IME insets.
- Material3 Scaffold component now has a
contentWindowInsets
parameter, allowing to specify the amount of insets to handle for the content slot. ( Icf11a , b/243713323 ) - Deprecates the experimental Material 3
SmallTopAppBar
function and introduces an equivalentTopAppBar
function. Please migrate your usage to the new one. ( I74404 , b/226918634 ) - Adds control over the top app bar fling and snap behaviors. ( I15c81 )
- Removes startIndent from Divider, moves color to last parameter. ( If7be2 )
Исправления ошибок
- Have Dialogs identify themselves to talkback users by announcing the word Dialog when they are displayed. ( I857ef )
Версия 1.0.0-beta01
24 августа 2022 г.
androidx.compose.material3:material3:1.0.0-beta01
and androidx.compose.material3:material3-window-size-class:1.0.0-beta01
are released. Version 1.0.0-beta01 contains these commits.
Справочник API
To see latest theming, component and other composables available check out the Compose Material 3 API reference overview .
Изменения API
- Updated the Material 3 top app bar to snap into a fully collapsed to a fully extended state. Also, updated the
TopAppBarDefaults
behavior function to be Composables and provide default values for their top app bar state and animation spec. ( I642b3 ) - Updated FAB component signatures to match surface API ( I3afaa )
- Added insets Build-in support for Top app bars, drawers, navigation bar and rail. These components, when used separately or with Scaffold will automatically handle insets for developers. Note: This change doesn't add automatic handling of status bar icons and transparency of the status and navigation bars. Please, continue to do it manually to ensure the best edge-to-edge experience. ( I7e4e6 , b/183161866 )
- Updated component defaults to reduce API surface for future flexibility and performance improvements. ( I31820 )
- Reordered chip and navigation drawer sheet parameters to maintain consistency within the API ( I45d0b )
- Removed
startIndent
from Divider and moved color to be the last parameter.( If7be2 )
Версия 1.0.0-Alpha16
10 августа 2022 г.
androidx.compose.material3:material3:1.0.0-alpha16
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
are released. Версия 1.0.0-Alpha16 содержит эти коммиты.
Новые функции
- Support specifying a custom width on a navigation drawer. ( Ia7f10 )
Изменения API
- Reorder Tab and Leading icon tab parameters to maintain consistency within the API ( Ie2637 )
- Marked
BadgeDefaults
as experimental. ( I98ef3 ) - Remove deprecated navigation drawer function. ( I4f2db )
- Reorder Slider parameters in Material 3 to maintain consistency within the API ( I0aee7 )
- Reorder
NavigationBar
andNavigationRail
parameters to maintain consistency within the API ( I51cda ) - Reorder parameters in Material 3 to maintain consistency across the API. ( If4ae1 )
- Reorder Slider parameters in Material 3 to maintain consistency within the API ( I62673 )
- Renamed icons parameter to actions to be consistent with top app bar ( Id75be )
- Mark
Badge
andBadgedBox
as experimental because the anchor alignment is still influx. ( I1712e , b/236524516 ) - Change
@ExperimentalMaterial3Api
annotations on icon button variants to@OptIn
( I070b5 ) - Separated a navigation drawer's content to its own composable to support specifying a custom width on it. ( Ia7f10 )
- Removes
Divider
fromMenuDefaults
andTabDefaults
( I4e33c )
Version 1.0.0-alpha15
27 июля 2022 г.
androidx.compose.material3:material3:1.0.0-alpha15
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
are released. Версия 1.0.0-Alpha15 содержит эти коммиты.
Новые функции
- Allow dragging the top app bar from the bar itself. ( I65c00 , b/205873416 )
Изменения API
- Updates to the
FilterChip
andElevatedFilterChip
APIs to remove theselectedIcon
slot and promote reusing theleadingIcon
for displaying a selected state. ( Ie5dc2 ) - Add scrim and outline variant color roles. ( Id6d54 )
- Fix naming conventions for composable defaults. ( I62b27 )
- Mark
ListItemDefaults
andListItemColors
as experimental. ( I1f3ec ) - Changes to the top app bar API to better reflect the meaning of its state properties. Also, mark the top app bar API as experimental. ( Ic0ad8 )
- Text selection colors have now been added to
TextFieldColors
for better discoverability. ( Iba1b8 ) - Adding
ButtonDefault.ButtonWithIconContentPadding
to be used with buttons that contain an icon. ( I2bf9c ) - Text fields have been marked as experimental to allow for more flexibility in future API changes. ( I127b5 )
- Removed the
@ExperimentalMaterial3Api
annotation from theCheckbox
function. ( I5eefc ) - Removed the
@ExperimentalMaterial3Api
annotation from theRadioButton
function. ( I17e2a ) - Removed the
@ExperimentalMaterial3Api
annotation from the non-interactive Cards. ( I9bd49 ) - Updates various component defaults objects to include colors, shapes etc. ( I96e11 )
Исправления ошибок
- Removed non-functioning trailing icons from input chip samples to avoid user confusion in the catalog app. ( I9846a )
Версия 1.0.0-Alpha14
29 июня 2022 г.
androidx.compose.material3:material3:1.0.0-alpha14
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
are released. Версия 1.0.0-Alpha14 содержит эти коммиты.
Новые функции
- Added M3 list implementation, see the documentation for sample usage ( Id7a20 )
Изменения API
- Change parameter name from values to value in
RangeSlider
( I3b79a ) - API changes to the
InputChip
implementation to support a selectable state per the Material Design spec. Additional support at theFilterChip
colors for selected disabled state. ( I55244 , b/235792432 ) - Add
BottomAppBar
default FAB ( Ida4c8 ) -
ColorScheme.surfaceColorAtElevation
was added ( Id41af ) - Interfaces in compose libraries are now built using jdk8 default interface methods ( I5bcf1 )
-
WindowWidthSizeClass
andWindowHeightSizeClass
now implement Comparable, so they can be compared using operators (<, <=, >=, >) and other APIs. ( I747d0 )
Исправления ошибок
- Update badge sample to provide more meaningful content description. ( I10b9d )
- Adds option to use the system font size to the Material 3 catalog's theme picker. ( I10605 )
- Adds sample code for Badge and indeterminate progress indicators. ( I8fbe0 )
Version 1.0.0-alpha13
1 июня 2022 г.
androidx.compose.material3:material3:1.0.0-alpha13
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
are released. Версия 1.0.0-Alpha13 содержит эти коммиты.
Изменения API
- Supports maintaining the top app bar position on configuration change. ( I10459 , b/216160958 )
Версия 1.0.0-альфа12
18 мая 2022 г.
androidx.compose.material3:material3:1.0.0-alpha12
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
are released. Version 1.0.0-alpha12 contains these commits.
Исправления ошибок
- Slider parent can now have 0 width. ( b/231707291 )
Версия 1.0.0-альфа11
11 мая 2022 г.
androidx.compose.material3:material3:1.0.0-alpha11
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
are released. Version 1.0.0-alpha11 contains these commits.
Новые функции
- Added
RangeSlider
to Material 3 ( I18e38 ) - Adds Material3
AssistChip
andInputChip
support ( I0d25a ) - Adds Material3
FilterChip
andSuggestionChip
support ( I9fdf3 )
Изменения API
- Renamed
TextFieldDefaults.BorderStroke
composable that draws a border stroke inOutlinedTextField
toTextFieldDefaults.BorderBox
. ( I5f295 ) - Switch m3 visual changes ( Iab30e )
- Allow passing colors to the standard icon buttons. ( Ia2445 )
Исправления ошибок
- Add lint check to material3/Scaffold to ensure that the inner padding is used ( I72293 , b/226951418 )
Version 1.0.0-alpha10
20 апреля 2022 г.
androidx.compose.material3:material3:1.0.0-alpha10
and androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
are released. Версия 1.0.0-Alpha10 содержит эти коммиты.
Новые функции
-
material3-window-size-class
is a new library that provides support for window size classes: a set of opinionated viewport breakpoints for you to design, develop, and test resizable application layouts against. You can usecalculateWindowSizeClass
to retrieve a window size class instance, which you can use to determine how your UI should appear, such as showing a navigation rail instead of bottom navigation for larger window sizes. For more information and sample usage see the API reference documentation forWindowSizeClass
. For more information on window size class definitions, see the public guidance on supporting different screen sizes.
Изменения API
- Adds default FAB elevation for
BottomAppBar
, removes trailing lambda fromBottomAppBar
with FAB. ( I92c47 ) - Adds Material3
FilledIconButton
,FilledTonalIconButton
, andOutlinedIconButton
. ( Ib2bda ) - Updates Material 3 Snackbar API to accept color values for the optional action and dismiss-action. ( Ibe4b4 )
- Partial consumption (down OR position) has been deprecated in
PointerInputChange
. You can useconsume()
to consume the change completely. You can useisConsumed
to determine whether or not someone else has previously consumed the change. -
PointerInputChange::copy()
now always makes a shallow copy. It means that copies ofPointerInputChange
will be consumed once one of the copies is consumed. If you want to create an unboundPointerInputChange
, use constructor instead. ( Ie6be4 , b/225669674 ) - Changes to the Cards API to receive the container and content colors via a
CardColors
interface, and to support a disabled state for clickable cards. ( I927df ) - The parameter
backgroundColor
has been renamedcontainerColor
in Material 3 text fields for improved consistency with other components. ( I6fbd9 )
Исправления ошибок
- Updates to the standard
IconButton
to align it with the Material3 spec. ( I09eab ) - Move the top bar height of material3 Scaffold into the padding passed to content, allowing the content to render underneath the top app bar. If the
PaddingValues
are ignored, then the content might be obscured by the top bar. ( I83cbc , b/217776202 )
Версия 1.0.0-альфа09
April 6, 2022
androidx.compose.material3:material3:1.0.0-alpha09
is released. Version 1.0.0-alpha09 contains these commits.
Новые функции
- Added Material 3 Switch API ( I2c3ad )
Изменения API
- Added support for dropdown menus with text fields (aka 'exposed dropdown menus' or 'combo boxes'.) ( I1b832 )
- Added shape parameter to MaterialTheme and Shape sub system. ( I37426 )
- Added an expanded parameter to
ExtendedFloatingActionButton
to control whether the FAB is expanded or collapsed, with animations between each state. Added Extended FAB overload for extended FABs with trailing text for ExtendedFABs without icon. ( Iba7f1 )
Версия 1.0.0-альфа08
23 марта 2022 г.
androidx.compose.material3:material3:1.0.0-alpha08
is released. Версия 1.0.0-Alpha08 содержит эти коммиты.
Новые функции
- Added support for Material 3 text fields. ( I795cc , b/199377790 )
Изменения API
- Add default divider for menu ( I01374 )
- Added
surfaceTint
color parameter toColorScheme
class. ( I2f558 )
Исправления ошибок
- Fix at the Material3 Button to read its default text style value from the MaterialTheme. ( Ie62fc )
Версия 1.0.0-альфа07
9 марта 2022 г.
androidx.compose.material3:material3:1.0.0-alpha07
is released. Версия 1.0.0-Alpha07 содержит эти коммиты.
Изменения API
- Updates to Material 3 Surface API that brings back the overloaded functions for clickable Surfaces, as well as adding a function to support selectable and toggleable Surfaces. ( I4bf18 )
-
LazyVerticalGrid
andLazyHorizontalGrid
are now stable. ( I307c0 ) -
LazyVerticalGrid/LazyHorizontalGrid
and all related apis were moved into .grid subpackage. Please update your imports from androidx.compose.foundation.lazy to androidx.compose.foundation.lazy.grid. ( I2d446 ) - Reverted previous change of relying solely on a View for
WindowInsetsControllerCompat
, and again require a Window which is required for managing some window flags. DeprecatedViewCompat.getWindowInsetsController
in favor ofWindowCompat.getInsetsController
to ensure that the correct Window is used (such as if the View is in a dialog). ( I660ae , b/219572936 ) - Added a new
LazyVerticalGrid
API to define cross axis sizes ( I17723 )
Исправления ошибок
- Updates to the Card API to follow changes at the Surface API ( I3c8b9 )
Версия 1.0.0-Alpha06
23 февраля 2022 г.
androidx.compose.material3:material3:1.0.0-alpha06
is released. Версия 1.0.0-Alpha06 содержит эти коммиты.
Изменения API
-
NavigationDrawerItem
is added that represents a single destination within the drawers ( Ic396f , b/218286829 ) -
PermanentNavigationDrawer
andDismissibleNavigationDrawer
have been added as experimental APIs. Those are the drawers suitable well for large screen devices. ( I5f8ab , b/218286829 ) - Adds Material 3 bottom app bar support ( Ic432a )
-
NavigationDrawer
has been renamed toModalNavigationDrawer
( I1807d , b/218286829 ) - Added Material 3 Slider class and tokens ( I1ccee )
- Added Tab implementation, see the documentation for sample usage ( Ie0146 )
Исправления ошибок
- Fixed an issue where the
TalkBack
screen reader linear navigation selected an empty top app bar title. ( Id4690 ) - Added
IconSize
toFloatingActionButtonDefaults
. ( Ia71cf ) - Bug fix for hidden
AlertDialog
buttons when a long text is added with aLazyColumn
. ( Ib2cc9 , b/216663029 )
Version 1.0.0-alpha05
9 февраля 2022 г.
androidx.compose.material3:material3:1.0.0-alpha05
is released. Version 1.0.0-alpha05 contains these commits.
Новые функции
Added Material Design 3 components
- Раскрывающееся меню
- Карты
Изменения API
- Deprecated
Surface
function that takes an onClick callback. Clickable surfaces should be created with anInteractionSource
and aModifier.clickable()
. ( I211c6 ) - Added pressed and focused elevation support for FAB. ( Ibb584 )
- Changed the
Surface
API to receive an InteractionSource which allows controlling its appearance in different states. ( Iafbc8 )
Исправления ошибок
- Added missing tertiary colors in dynamic color schemes ( I456c4 , b/214588434 )
Version 1.0.0-alpha04
26 января 2022 г.
androidx.compose.material3:material3:1.0.0-alpha04
is released. Version 1.0.0-alpha04 contains these commits.
Изменения API
- Added
NonRestartableComposable
to methods that are overloads of existing methods without complex logic. This reduces compiler generated memoization checks (equals) for all parameters which are repeated in the inner function that is called. ( I90490 ) - Added Material 3 divider. ( Ica5fc )
- Mark the Checkbox and RadioButton with an experimental API annotation. ( Ie44bb )
- Added support for Material 3 progress indicators. ( Iff232 , b/205023841 )
Исправления ошибок
- Update a disabled
TextButton's
container color to be transparent ( I6b248 , b/213339737 )
Version 1.0.0-alpha03
12 января 2022 г.
androidx.compose.material3:material3:1.0.0-alpha03
is released. Version 1.0.0-alpha03 contains these commits.
Исправления ошибок
- Add
LocalIndication
to Material 3'sMaterialTheme
. ( I7ce4e ) - Fix the corner radius that is applied for Checkboxes ( I38b03 , b/175198975 , b/202309440 )
Обновления зависимостей
- Now depends on Kotlin
1.6.10
.
Версия 1.0.0-альфа02
1 декабря 2021 г.
androidx.compose.material3:material3:1.0.0-alpha02
is released. Version 1.0.0-alpha02 contains these commits.
Новые функции
- Add support for checkbox and radiobutton.
- Updated to be compatible with Kotlin
1.6.0
Изменения API
- Remove drawer from Material 3's scaffold. ( I04f51 )
- Adds Material 3
Checkbox
support. ( Id5542 ) - Adds Material 3
RadioButton
support. ( I20334 )
Исправления ошибок
- Reduce
IconButton
ripple radius from 40dp to 20dp. ( I68bbe , b/206674345 ) - Port string fast path for
Text
changes fromcompose.material
( I30b03 ) - Fixed but that hardcoded button to always be enabled. ( Iea832 , b/205335456 )
Версия 1.0.0-альфа01
27 октября 2021 г.
androidx.compose.material3:material3:1.0.0-alpha01
is released. Version 1.0.0-alpha01 contains these commits.
Новые функции
Material Design 3 theming and Material You dynamic color
Material Design 3 components
- Кнопки
- FAB and extended FAB
- Диалоги
- Панель навигации
- Навигационный ящик
- Navigation rail
- Top app bar
- Значок
- Икона
- Текст
- Поверхность
- Макет
- Content color
For more information, check out the Material Design 3 and Material You section in the Material Theming in Compose guide.