Составьте материал 3

Структура

Compose — это комбинация из семи идентификаторов групп Maven в androidx . Каждая группа содержит определённый набор функций, каждый из которых сопровождается собственным набором заметок о выпуске.

В этой таблице объясняются группы и ссылки на каждый набор заметок о выпуске.

Объявление зависимостей

Чтобы добавить зависимость от 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.5.0-alpha03"
}

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.5.0-alpha03")
}

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:

• Тональная палитра
  • TonalPalette
• Икона
  • Icon
• Размер сенсорной цели
  • LocalMinimumInteractiveComponentSize

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 содержит следующие коммиты.

Новые функции

• NavigationSuiteScaffold
  • NavigationSuiteScaffoldLayout
  • NavigationSuite

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:

• PaneScaffoldDirective
  • calculateStandardPaneScaffoldDirective
  • calculateDensePaneScaffoldDirective
  • АдаптСтратегия
  • ТриПанельЭшафАдаптСтратегии
  • HingePolicy

API-интерфейсы адаптивных панелей Material3:

• Базовые API-интерфейсы каркаса панели
  • PaneScaffoldScope
  • ThreePaneScaffoldRole
  • PaneAdaptedValue
  • ThreePaneScaffoldValue
  • calculateThreePaneScaffoldValue
  • AnimatedPane

Составьте Material3 Версия 1.5

Версия 1.5.0-альфа03

27 августа 2025 г.

Выпущен androidx.compose.material3:material3-*:1.5.0-alpha03 . Версия 1.5.0-alpha03 содержит следующие коммиты .

Изменение поведения

• Размер флажка и цвета индикатора были скорректированы в соответствии со спецификацией. Для минимизации нарушения работы пользовательского интерфейса добавлен флаг isCheckboxStylingFixEnabled , облегчающий миграцию. Пожалуйста, включите его вручную в своих приложениях. Этот флаг будет удалён в будущей версии. ( I5bcd3 , b/304300693 )

Изменения API

• Добавлен параметр contentPadding для TopAppBar ( Ia5fea )
• Добавить переопределение компонента для каркаса навигационного набора ( I85312 )

Исправления ошибок

• Параметр containerColor в TimePickerDialog теперь применяется правильно, позволяя настраивать цвет фона диалогового окна. ( I47f89 , b/403183883 )
• Модальная панель навигации больше не теряет фокус при сворачивании и теперь закрывается в ответ на нажатие клавиши ESC. ( 4255257 )
• Snackbar теперь правильный порядок фокусировки клавиатуры для кнопок действия и закрытия; кнопка закрытия также поддерживает отображение всплывающей подсказки. ( 11fa13d )

Версия 1.5.0-альфа02

13 августа 2025 г.

Выпущен androidx.compose.material3:material3-*:1.5.0-alpha02 . Версия 1.5.0-alpha02 содержит следующие коммиты .

Изменения API

• В PullToRefreshDefaults переименовал shape в indicatorShape и containerColor в indicatorContainerColor , а также добавил indicatorMaxDistance для использования индикатора. ( Ib6cbe )
• Удалить тег устаревания из PullToRefreshDefaults.indicatorColor ( Iaaee2 )
• Добавлен AppBarWithSearch , заменяющий TopSearchBar и поддерживающий значки навигации/действий. ( I213a5 )

Исправления ошибок

• Исправлена ​​ошибка, из-за которой обратное нажатие неправильно обновляло смещение ящика. ( I85624 , b/427778135 )
• SwipeToDismissBox теперь возвращается к установленному targetValue , если других якорей нет. BottomSheetScaffold теперь возвращается к расширенному targetValue , если других якорей нет. ( I73d5e , b/428856426 )
• Исправлен отступ кнопок в AlertDialog при вертикальном расположении. ( Ia2118 )
• [FAB] Исправлена ​​ошибка, из-за которой FAB оставался кликабельным после того, как Modifier.animateFloatingActionButton скрывал его ( I8ea6c , b/430336834 ).
• [Слайдер] Исправлена ​​навигация с помощью клавиатуры для слайдера ( I3a405 )

Версия 1.5.0-альфа01

30 июля 2025 г.

Выпущен androidx.compose.material3:material3-*:1.5.0-alpha01 . Версия 1.5.0-alpha01 содержит следующие коммиты .

Новые функции

• Добавлен дополнительный поставщик позиционирования для всплывающих подсказок, чтобы разработчики могли управлять размещением подсказки над, под, слева или справа от якоря. Добавьте API, принимающий форму для курсора, чтобы можно было создавать больше пользовательских форм. ( Ie513c )

Изменения API

• Методы TextFieldColors для расчета цветов компонентов на основе состояния теперь общедоступны. ( I03165 )
• Аннотация «Приостановить» удалена из обратного вызова onDismiss . ( Ie3166 )
• DatePickerState.getDisplayedMonth(): YearMonth? и DateRangePickerState.getDisplayedMonth(): YearMonth? были обновлены для возврата значения, не допускающего значение NULL. ( Ice09c , b/427952972 )
• Удалите ModalWideNavigationRailDefaults , переместите его содержимое в WideNavigationRailDefaults и переименуйте его имена, связанные с формой. ( Ic5e61 )
• Цвета WideNavigationRailItem и устаревшие функции копирования должны быть на уровне Hidden. ( Id7e82 )
• Измените уровень устаревших API WideNavigationRail на «Предупреждение» и сделайте их экспериментальными. ( I89085 )

Исправления ошибок

• Гарантирует, что DatePicker учитывает свою локаль при форматировании чисел. Ранее, если DatePicker был настроен на арабскую локаль, он мог неправильно отображать латинские цифры, если в локали устройства использовалась другая система исчисления. ( Iccf76 , b/432616196 )
• Исправлена ​​ошибка LinearProgressIndicator , из-за которой индикатор остановки отображался некорректно в макетах с написанием справа налево. ( I0734c )
• Разделитель PrimaryScrollableTabRow и SecondaryScrollableTabRow теперь расширяется на весь экран, даже если содержимое вкладки не доходит до конца экрана. ( Ic1e9c , b/261741384 )

Составьте Material3 Версия 1.4

Версия 1.4.0-beta03

27 августа 2025 г.

Выпущен androidx.compose.material3:material3-*:1.4.0-beta03 . Версия 1.4.0-beta03 содержит следующие коммиты .

Версия 1.4.0-beta02

13 августа 2025 г.

Выпущен androidx.compose.material3:material3-*:1.4.0-beta02 . Версия 1.4.0-beta02 содержит следующие коммиты .

Изменения зависимости

• Удалить зависимость между graphics-shapes ( I219e0 , b/436230765 )

Изменения API

• В PullToRefreshDefaults переименовал shape в indicatorShape и containerColor в indicatorContainerColor , а также добавил indicatorMaxDistance для использования индикатора. ( Ib6cbe )
• Удалить тег устаревания из PullToRefreshDefaults.indicatorColor ( Iaaee2 )
• BasicAlertDialogOverrideScope был случайно повышен до стабильной версии, а его экспериментальная аннотация была удалена в aosp/3701846 . Он отмечен как внутренний. Он останется общедоступным экспериментальным в версии 1.5.0-альфа ( I9182a ).

Исправления ошибок

• Исправлена ​​ошибка, из-за которой обратное нажатие неправильно обновляло смещение ящика. ( I85624 , b/427778135 )

Версия 1.4.0-beta01

30 июля 2025 г.

Выпущен androidx.compose.material3:material3-*:1.4.0-beta01 . Версия 1.4.0-beta01 содержит следующие коммиты .

Критические изменения

• Все публичные API, отмеченные тегами ExperimentalMaterial3ExpressiveApi или ExperimentalMaterial3ComponentOverrideApi , были удалены. Чтобы продолжить пользоваться этими функциями, перейдите на 1.5.0-alpha . ( Ie4ae0 )
• Ожидайте, что следующие стабилизированные API pullToRefresh будут переименованы в следующем выпуске. ( Ib6cbe )

Новые функции

• Tooltip теперь поддерживает пользовательскую форму и положение курсора (выше, ниже, слева или справа от якоря). ( Ie513c )

Изменения API

• Аннотация «Приостановить» удалена из обратного вызова onDismiss . ( Ie3166 )
• DatePickerState.getDisplayedMonth(): YearMonth? и DateRangePickerState.getDisplayedMonth(): YearMonth? были обновлены для возврата значения, не допускающего значение NULL. ( Ice09c , b/427952972 )
• Удалите ModalWideNavigationRailDefaults , переместите его содержимое в WideNavigationRailDefaults и переименуйте его имена, связанные с формой. ( Ic5e61 )

Исправления ошибок

• Гарантирует, что DatePicker учитывает свою локаль при форматировании чисел. Ранее, если DatePicker был настроен на арабскую локаль, он мог неправильно отображать латинские цифры, если в локали устройства использовалась другая система исчисления. ( Iccf76 , b/432616196 )
• Исправлена ​​ошибка LinearProgressIndicator , из-за которой индикатор остановки отображался некорректно в макетах с написанием справа налево. ( I0734c )
• Разделитель PrimaryScrollableTabRow и SecondaryScrollableTabRow теперь расширяется на весь экран, даже если содержимое вкладки не доходит до конца экрана. ( Ic1e9c , b/261741384 )

Версия 1.4.0-альфа18

16 июля 2025 г.

Выпущен androidx.compose.material3:material3-*:1.4.0-alpha18 . Версия 1.4.0-alpha18 содержит следующие коммиты .

Новые функции

• ModalBottomSheetProperties теперь предоставляет возможность отключить dissolveRequest при щелчке по сетке. ( I8e715 )
• Добавить поддержку trackCornerSize в Track RangeSlider . ( 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 API SwipeToDismissBox . ( 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 )
• Добавьте новую дорожку @Composable , которая позволяет указывать собственные углы внешних дорожек и значки дорожек. ( I436a4 )
• Обновите API плавающей панели инструментов, чтобы использовать объект FloatingToolbarColors вместо одного цвета контейнера. ( I9a054 )
• Добавьте и используйте новую экспериментальную аннотацию ExperimentalMaterial3ComponentOverrideApi ( Ia1eaf ).
• Modifier.indicatorLine теперь принимает форму текстового поля для обработки обрезки. ( I8c5f3 , б/380704151 )
• Переименуйте экспериментальные функции FloatingAppBar в FloatingToolbar ( I1dbf8 ).
• Добавлен новый floatingToolbarVerticalNestedScroll , который можно прикрепить к прокручиваемому контейнеру для обновления состояния расширения плавающей панели инструментов на основе движения прокрутки, пересекающего пороговое значение. ( I6d65f )
• Представляем новый API для создания плавающей панели инструментов с прикрепленной плавающей кнопкой действия (FAB). API предоставляет гибкие возможности настройки, позволяющие расположить панель инструментов горизонтально или вертикально и разместить FAB в начале или конце панели инструментов. ( I9e350 )

Исправления ошибок

• Исправлена проблема с доступностью Snackbar, из-за которой он объявлял о закрытии, когда TalkBack включен. ( /I9db53 )

Внешний вклад

• Унифицированная BasicTooltip в Foundation и BasicTooltip/Tooltip в материале3. ( 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 меняет Shape API с класса данных на класс для двоичной совместимости. ( I53812 )
• Добавлен API всплывающей подсказки с параметром onDismissRequest , чтобы создатели могли решать, что произойдет, когда пользователь щелкнет за пределами всплывающей подсказки. Устаревший старый API, не содержащий этого нового параметра, устарел. ( I99aef )
• Измените название opticalCentering на horizontalCenterOptically . Делаем модификатор внутренним. Замените параметр заполнения максимальным смещением начала и конца. ( I0b904 )
• Измените WideNavigationRailState , чтобы оно имело текущее/целевое значение, удалите перечисления в пользу логических значений. ( Идфа29 , б/356039090 )
• Добавьте NavigationBarItemComponentOverride . ( I3a06a )

Исправления ошибок

• Исправьте поведение верхней и нижней панели приложений, чтобы надежно менять цвет при полной прокрутке контента. ( Idc4e8 , б/293665988 )
• Функции поведения прокрутки для верхней и нижней панели приложений теперь возвращают запомненное поведение, чтобы лучше работать при рекомпозиции. ( I0fdbe , б/207957336 )
• Параметр модификатора теперь применяется после внутренних модификаторов, таких как поведение перетаскивания и семантика, а не перед. Это влияет на порядок применения модификаторов. ( I8d83f )
• Расширенный нижний лист остается расширенным при изменении размера. ( I2870b , б/324934884 )
• Правильная маршрутизация флагов состояния и панели навигации для свойств Windows. ( Ie674d , б/362539765 )
• Переместите параметр модификатора в корень шаблонов, как описано в документации. Это согласовывает реализацию с M2. ( I0235e , б/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, big и xLarge в значения по умолчанию для переключателя. ( Ie95d1 )
• Добавьте значения размера xSmall, medium, big и xLarge по умолчанию в настройки кнопок по умолчанию. ( Если8b6d )

Исправления ошибок

• Цвет значка завершающего чипа фильтра был обновлен с 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 позволяют настраивать цвета состояния и панели навигации. По умолчанию эти обновления основаны на цвете контента, а не на статусе темной темы системы. ( Ib874e , б/362539765 )
• Улучшен процесс ввода для средств выбора даты: в режиме ввода текстовое поле даты будет сфокусировано для немедленного ввода текста. Это изменение добавляет параметр requestFocus к DatePicker и DateRangePicker . Вы можете предотвратить фокусировку, передав false . ( I12d09 , б / 286399710 , б / 340102743 )
• Кэширование формы по умолчанию в объекте Shape. Установка формы по умолчанию @Composable для кнопки переключения. Свертывание фигур в одну фигуру по умолчанию, поскольку варианты указывают на один и тот же файл токенов. ( Iaa014 )

Исправления ошибок

• Оптимизируйте поведение Scaffold contentPadding , чтобы избежать повторной компоновки содержимого тела при изменении contentPadding . ( I8c8e2 , б/373904168 )
• progress TextFieldLabelScope переименован в labelMinimizedProgress
• TextFieldLabelPosition Default переименован в Attached . Члены интерфейса были удалены. ( Если75c6 )
• Исправлена проблема с DatePicker в режиме ввода, из-за которой ошибки проверки могли привести к изменению высоты компонента. ( I2e229 , б / 280462363 )
• Заставьте ползунок материала менять свое значение при нажатии клавиш управления. ( I1c442 )

Версия 1.4.0-альфа02

16 октября 2024 г.

Выпущен androidx.compose.material3:material3-*:1.4.0-alpha02 . Версия 1.4.0-alpha02 содержит эти коммиты .

Изменения API

• Обновлены средства выбора даты для обеспечения единообразного использования Locale в DatePicker и DateRangePicker при настройке Locale непосредственно через DatePickerState или DateRangePickerState . Обратите внимание: при настройке локалей непосредственно для состояния вы должны убедиться, что тексты заголовков и заголовков локализованы соответствующим образом, поскольку их текст по умолчанию по-прежнему будет применяться в соответствии с локалью платформы по умолчанию. ( I37073 , б / 326490763 , б / 321657276 )
• SheetState.isAnimationRunning теперь доступен. ( I9a3d7 )
• DatePickerColors теперь правильно имеет приоритет над любыми конфликтующими цветами, определенными в текстовых стилях Typography темы. Также обратите внимание, что это обновление корректирует положение параметра color в функциях выбора даты и вводит параметр contentColor для настройки цветов текста заголовка и заголовка. ( I30d03 , б/347031394 )
• Переименуйте SplitButton в SplitButtonLayout и удалите API вариантов цвета SplitButton . Варианты будут получены путем повторного использования вариантов кнопок, предоставленных SplitButtonDefaults . ( I44c36 )
• ModalBottomSheet теперь имеет sheetGestureEnabled ( I856cb , b/288211587 ).
• standardMotionScheme и expressiveMotionScheme переименованы в стандартные и выразительные. Обе функции теперь доступны через сопутствующий объект MotionScheme путем вызова MotionScheme.standard() и MotionScheme.expressive() . ( Iceccf )
• Добавление параметра maxWidth в простые и расширенные всплывающие подсказки. По умолчанию задано разрешение 200 dp для простых подсказок и 320 dp для расширенных подсказок. ( I30ce9 )

Исправления ошибок

• DatePicker и DateRangePicker теперь правильно обновляют отображаемый месяц, если он установлен через displayedMonthMillis их состояния. ( If9e47 , b/333414302 )
• Содержимое ModalBottomSheet теперь перемещает содержимое из строки состояния. ( I5114c , б/321877275 , б/336962418 , б/342093067 )
• [Нижний лист] Измените приоритет обратного обратного вызова на PRIORITY_DEFAULT , чтобы клавиатура IME могла закрываться первой. ( I447fb )
• Исправлены сбои в DatePicker и DateRangePicker , когда минимальный выбираемый год установлен на будущий год. ( I78656 , б / 319395747 )
• Исправлена проблема выбора даты для обновления пользовательского интерфейса при применении обновленного экземпляра SelectableDates . ( Иад59а , б/290135807 , б/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 , б/349894318 )
• Цвет активной метки NavigationBarItem и NavigationRailItem меняется с onSurface на secondary , чтобы улучшить удобство использования, цветовой контраст и улучшить согласованность внутри системы ( Ibc297 ), чтобы вернуться к предыдущему поведению, скопируйте цвета по умолчанию и измените selectedTextColor на MaterialTheme.colorScheme.onSurface .
• Компоненты Material 3 теперь используют новую MotionScheme для определения своего движения. ( Ie0f93 )
• Неопределенные круговые изменения движения индикатора прогресса ( I3c07e )
• Обновите OutlinedIconButtonColors и OutlinedIconToggleButtonColors для улучшения цветового контраста. ( I2743d )
• Обновлен цвет контейнера и содержимого для FilledIconToggleButtonColors и FilledTonalIconToggleButtonColors . ( Ic5d0f )
• Цвет границы OutlinedButton обновлен с outline на outlineVariant . ( 057f00 )

Изменения API

• В функцию enterAlwaysScrollBehavior TopAppBar добавлен необязательный reverseLayout для лучшей поддержки содержимого, установленного с reverseLayout . ( I4e0e5 )
• SegmentedButton теперь поддерживает аргумент contentPadding . ( I5ad91 , б/358414376 )
• PullToRefreshState больше не имеет реализации по умолчанию для isAnimating ( I6a593 ).
• Добавлены новые перегрузки Material TextField и OutlinedTextField , использующие TextFieldState . Добавлены API-интерфейсы оформления, совместимые с TextFieldDecorator . ( Если13а1 )
• Добавлен параметр для управления labelPosition текстового поля. Использование alwaysMinimize позволяет шаблону пользовательского интерфейса одновременно отображать метку и заполнитель в текстовом поле, даже если поле не находится в фокусе. ( I1ef2c )
• Добавлены материалы SecureTextField и OutlinedSecureTextField для полей ввода пароля. ( I7e22d )
• К меткам текстовых полей добавлена область видимости для запроса хода анимации. ( Если5ec8 )
• Добавляет поддержку MotionEvent.CLASSIFICATION_DEEP_PRESS во всплывающие подсказки. ( I62e6a )
• isAfternoon TimePickerState теперь является расширением val вместо var в интерфейсе, переименованным в isPm ( I89a97 ).
• Обновление класса типографики для поддержки выделенных масштабов шрифта. ( Ифа13с )
• Добавлен API ModalWideNavigationRail и API ModalExpandedNavigationRail переименованы в DismissibleModalWideNavigationRail . ( Ic9118 )
• Обновлен FloatingAppBarScrollBehavior для автоматического расчета screenOffset и не требуется @Composable . ( Idf349 )
• Обновления API LoadingIndicator для исправления именования объекта по умолчанию. Добавлена константа LoadingIndicatorElevation в PullToRefresh . ( I1d72b )
• Обновления API LoadingIndicator для исправления именования объекта по умолчанию. Добавлена константа LoadingIndicatorElevation в PullToRefresh . ( I1d72b )
• Добавлены параметры amplitude и waveSpeed к неопределенным вариантам LinearWavyProgressIndicator и CircularWavyProgressIndicator . ( I2a0c5 )
• Поддержка изменения формы кнопки переключения значков в зависимости от ее нажатого или отмеченного состояния. ( Ibc781 )
• Обновление класса типографики для поддержки выделенных масштабов шрифта. ( Ифа13с )
• Форма SplitButton трансформируется в зависимости от состояния по умолчанию/нажатия. Удален API AnimatedTrailingButton , поскольку API TrailingButton может предлагать те же настройки ( I95066 ).
• Добавьте модификатор для анимации отображения и скрытия FAB, например, при прокрутке контента. ( I8338d )
• Добавление форм и интервалов связанных групп кнопок в ButtonGroupDefaults для использования в образце. ( I68e30 )
• Кнопка разделения добавляет горизонтальное отступы для конечной кнопки и включает оптическое центрирование, рассчитанное на основе разницы в начальном и конечном углах ( I122e2 ).
• Представляем новую MotionScheme материала, позволяющую задать схему движения компонента. Схема задается через MaterialTheme . ( ID50c2 )

Исправления ошибок

• Примените правильный индекс прохождения фокуса к дочерним компонентам Scaffold Composables. Порядок: topBar , bottomBar , Fab, Content, Snackbar. ( I5936b )
• Исправлена проблема в DatePicker и DateRangePicker , из-за которой в некоторых локалях и скелетонах формата некоторые элементы даты (например, названия месяцев) не начинались с заглавной буквы. ( I1430f )
• Интеграция токенов компонентов FAB и FAB Menu (незначительные визуальные обновления отступов и текста) ( Ib57f3 ).
• ModalBottomSheet теперь находится первым в порядке семантического обхода, за ним следует холст. ( I436f9 , б/358594665 )
• Исправлена ​​ошибка, из-за которой нижняя панель приложения не исчезала полностью при прокрутке под навигационной панелью в режиме от края до края ( I3ee21 ).

Compose Material3 Версия 1.3

Версия 1.3.2

9 апреля 2025 г.

Выпущен androidx.compose.material3:material3-*:1.3.2 . Версия 1.3.2 содержит эти коммиты .

Исправления ошибок

• ListItem исправляет свой собственный расчет высоты, теперь резервируя соответствующий объем пространства в Layout.
• Удалите лишнее дополнение метки 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 , б / 319395747 )
• Исправлена проблема выбора даты для обновления пользовательского интерфейса при применении обновленного экземпляра SelectableDates . ( Иад59а , б/290135807 , б/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

Новый Material Design 3 компонента

• Карусель
  • HorizontalMultiBrowseCarousel и HorizontalUncontainedCarousel Улучшения существующих компонентов Material Design 3.
• [ ModalBottomSheet ] теперь поддерживает функцию Predictive Back on U+ ( Iccf32 , b/281967264 , b/304850357 )
• [ SearchBar ] теперь поддерживает функцию Predictive Back on U+ ( I657f8 ).
• Nav Drawer ( ModalDrawerSheet и DismissibleDrawerSheet ) теперь поддерживает Predictive Back on U+ в качестве опции ( Ie5b0b ).
• DropdownMenu теперь поддерживает настраиваемый цвет, форму, высоту и границу. ( I8e981 , б/289554448 , б/301887035 , б/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 , на которые не влияет повышение тона. ( б / 304584161 )
• Роли базовой линии поверхности и контейнера поверхности были немного скорректированы, что обеспечивает больше оттенков в светлых и темных темах. ( I677a5 )
• Экспериментальные API переведены в стабильную версию!
• Улучшения производительности

Версия 1.3.0-rc01

21 августа 2024 г.

Выпущен androidx.compose.material3:material3-*:1.3.0-rc01 . Версия 1.3.0-rc01 содержит эти коммиты .

Исправления ошибок

• ModalBottomSheet теперь находится первым в порядке семантического обхода, за ним следует холст. ( I436f9 , б/358594665 )

Версия 1.3.0-бета05

24 июля 2024 г.

Выпущен androidx.compose.material3:material3-*:1.3.0-beta05 . Версия 1.3.0-beta05 содержит эти коммиты .

• Исправлена ​​проблема, из-за которой содержимое BottomSheet отсутствует или обрезается на Android N и O ( a10a2d ).
• Увеличены семантические границы слайдера, чтобы TalkBack правильно отображал индикаторы фокуса вокруг больших пальцев. ( 0b5a1d )

Версия 1.3.0-beta04

26 июня 2024 г.

Выпущен androidx.compose.material3:material3-*:1.3.0-beta04 . Версия 1.3.0-beta04 содержит эти коммиты .

Версия 1.3.0-beta03

12 июня 2024 г.

Выпущен androidx.compose.material3:material3-*:1.3.0-beta03 . Версия 1.3.0-beta03 содержит эти коммиты .

Внешний вклад

• Сделайте androidx.compose.material3.DropdownMenu доступным из общего набора исходных кодов. ( Если62c0 )

Версия 1.3.0-beta02

29 мая 2024 г.

Выпущен androidx.compose.material3:material3-*:1.3.0-beta02 . Версия 1.3.0-beta02 содержит эти коммиты .

Изменения API

• Modifier.pullToRefreshIndicator поддерживает повышение прав, обновление API-интерфейсов Pull To Refresh, чтобы включить логическое значение, а не лямбда-выражение. Поддержка выравнивания содержимого в PullToRefreshBox ( I75679 )
• Создание TooltipScope запечатанного интерфейса и создание внутренней реализации для использования в TooltipBox и Label. ( I3833e )
• В CarouselItemScope добавлены два новых модификатора — maskClip и maskBorder — для легкого добавления формы и границы к любому элементу карусели ( Id67a1 ).
• TimePickerState теперь является интерфейсом и позволяет устанавливать время ( I88546 ).
• Обновлен API для стилизации ссылок: TextLinkStyles перемещены в TextStyle и удалены TextDefaults из материала. ( I5477b )

Исправления ошибок

• Значки статуса ModalBottomSheet и панели навигации теперь реагируют на статус темной темы. ( Ie1fe7 , б/338342149 )
• Добавлена семантика закрытия листа в скрим ModalBottomSheet . ( 0e61cb , б/328801864 )

Внешний вклад

• Сделать androidx.compose.material3.AlertDialog доступным из общего исходного набора ( Ia33f5 ).
• Сделать ModalBottomSheet доступным из общего набора исходных кодов ( Id7cc7 ).

Версия 1.3.0-бета01

14 мая 2024 г.

Выпущен androidx.compose.material3:material3-*:1.3.0-beta01 . Версия 1.3.0-beta01 содержит эти коммиты .

Изменения API

• Использование DpSize вместо CaretProperties . Удаление CaretProperties . Переименуйте CaretScope в TooltipScope . ( Id9a76 )
• Обновлен API для получения тематических ссылок Material в тексте. В частности, из TextDefaults удалены методы для создания тематических LinkAnnotations и анализа HTML с тематическими ссылками. Вместо этого добавлен класс TextLinkStyles , который позволяет стилизовать ссылки в качестве параметра составного текста. ( I31b93 )

Версия 1.3.0-альфа06

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 более точно рисует сетку поверх строки состояния, когда включен параметр «от края до края». Содержимое модального нижнего листа теперь может использовать вставки окон, что позволяет отображать содержимое над панелью навигации. Параметр ModalBottomSheet windowInsets переименован в contentWindowInsets , чтобы указать, где будут применяться вставки. Они больше не привязаны к логике окна. Тип contentWindowInsets был изменен на функцию, которая возвращает WindowInsets , чтобы разрешить его в новом окне. ( I39630 , б / 274872542 , б / 300280229 , б / 290893168 )
• PrimaryScrollableTabRow и SecondaryScrollableTabRow теперь используют собственный макет вместо подкомпозиции, что должно повысить производительность. ( I991e0 )
• Текстовые ссылки получили опцию стилизации нажатого состояния в дополнение к обычному стилю, наведению курсора и фокусу. Каждый из методов TextDefaults имеет аргумент pressedStyle для поддержки этого. ( Ic473f , б/139312671 )

Исправления ошибок

• Якоря перетаскивания панели навигации теперь соответствуют ширине drawerContent . ( Ibc72f , б/245355396 )
• Отступы OutlinedTextField для метки теперь учитывают размер системного шрифта. ( Idc781 )
• Исправлено расположение пакета CalendarLocale . ( Ифа235 )
• [Прогнозирующий обратный эффект] Обновление прогнозирующей обратной анимации для использования кривой интерполяции (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 , б/275074248 , б/278773336 , б/326627700 )
• лямбда drawTick была добавлена ​​в общедоступный API, чтобы при необходимости настроить тики ( I0c048 ).

Изменения API

• Текстовые ссылки получили опцию стиля нажатого состояния в дополнение к обычному стилю, наведению курсора и фокусу ( I5f864 , b/139312671 ).
• Обновлен CarouselItemInfo для отображения маски Rect, по которой обрезается элемент ( I785d8 ).
• Удален BasicTooltipState из общедоступного API Материала 3. Его функциональность сочетается с TooltipState до тех пор, пока BasicTooltip Foundation не стабилизируется. ( Icda29 )
• Добавлен объект TextDefaults , содержащий методы для создания LinkAnnotation и анализа строки с HTML-тегом, которая применяет MaterialTheme к ссылкам ( I98532 , b/139312671 ).
• ExposedDropdownMenuBoxScope больше не допускает подклассы. Открытые раскрывающиеся меню теперь имеют MenuAnchorType , который следует передать в menuAnchor для лучшей поддержки a11y. Это следует использовать вместо передачи focusable в ExposedDropdownMenu , который сейчас устарел. menuAnchor имеет новый параметр для управления enabled состоянием. ( I55ee6 , б / 257209915 , б / 308840226 )
• Исправлен цвет границы OutlinedButton при отключении. Добавлена перегрузка ButtonDefaults.outlinedButtonBorder("enabled") , которая принимает включенное состояние. ( Ie650b , б/318461363 )
• Добавлен новый класс CarouselItemInfo , который помогает клиентам получать информацию о размерах предметов. ( I9070c )
• Конструктор ColorScheme без поверхностных контейнеров больше не поддерживается. Перейдите на конструктор, включающий наземные контейнеры. ( I35c11 )
• [Обведено] TextFieldDefaults ContainerBox переименован в Container . ( Ie8d3b )

Исправления ошибок

• BottomSheetScaffold больше не будет выполнять прокрутку из вложенной прокрутки, если sheetSwipeEnabled равно false. ( I5e1c1 , б/306464779 )
• Удалены некоторые аннотации ExperimentalMaterial3Api OptIn в IconButtonSamples.kt . ( I111d1 )

Версия 1.3.0-альфа04

3 апреля 2024 г.

Выпущен androidx.compose.material3:material3-*:1.3.0-alpha04 . Версия 1.3.0-alpha04 содержит эти коммиты .

Новые функции

• Добавлены две экспериментальные версии карусели Material3 — HorizontalMultiBrowseCarousel и HorizontalUncontainedCarousel ( I88d64 ).
• Обновлен Compose M3 Nav Drawer ( ModalDrawerSheet и DismissibleDrawerSheet ) для поддержки Predictive Back on U+ в качестве опции ( Ie5b0b ).
• Добавлен новый API в Icon, позволяющий передавать цветовой оттенок как лямбда-выражение во избежание перекомпоновки. ( I5b5a2 )
• API-интерфейсы верхней панели приложений теперь поддерживают настраиваемую высоту как для фиксированных, так и для сворачиваемых разделов. ( Ib8b0c , b/323403446 )

Изменения API

• API-интерфейсы верхней панели приложений теперь поддерживают настраиваемую высоту как для фиксированных, так и для сворачиваемых разделов. Исправлена проблема, из-за которой однострочные верхние панели приложений перестраивались слишком много раз при прокрутке контента. Решена проблема, из-за которой MediumTopAppBar обрезал заголовки на устройствах с большими настройками шрифта/отображения. ( Ib8b0c , b/323403446 , b/300953236 , b/286296147 , b/330410290 , b/308540676 )
• SegmentedButton и связанные API теперь стабильны ( I8a158 ).
• SwipeToDismissBox , SwipeToDismissBoxDefaults , SwipeToDismissBoxState и SwipeToDismissBoxValue теперь помечены как стабильные. ( I5f000 )
• Удалены устаревшие DismissDirection и API DismissDirection и DismissValue . ( I89ccd )
• В сопутствующий объект CarouselState объекта Carousel добавлен экспериментальный тег. ( I94154 )
• LocalMinimumInteractiveComponentEnforcement устарел и вместо него введен LocalMinimumInteractiveComponentSize . ( I7a7ac )
• Конструктор SearchBarColors теперь общедоступен. ( I769ca )
• В SwipeToDismissBox добавлен gesturesEnabled . ( Idc59f , б/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 , б / 323694447 , б / 278609042 )

Изменения API

• Флаг ScaffoldSubcomposeInMeasureFix был удален. ( Ie2a4b )
• NavigationRailItemColors теперь помечен как @Immutable . ( Если6112 , б/327660613 )
• NavigationBarItemColors теперь помечен как @Immutable . ( I42a30 , б/298064514 )
• Измените порядок параметров в компонуемом слайдере. ( 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 завершил val. Обертывание onValueChangeFinished в rememberUpdatedState . ( I82ab2 , б/322269951 )
• Компоненты навигации теперь используют новые роли SurfaceContainer . DrawerDefaults теперь предоставляет отдельные атрибуты standardContainerColor и modalContainerColor . DrawerDefaults.ModalDrawerElevation теперь имеет 0.dp ( I7fbac )
• Удаление @Stable из состояний Slider , поскольку мы меняем state.onValueChangeFinished на var . ( Ied34a , b/322269951 )
• Спецификация анимации ModalBottomSheet и StandardBottomSheet теперь является TweenSpec , обновленной на основе анимации Spring. Это решает проблему с видимым перерегулированием. Устаревшие конструкторы SheetState без плотности теперь удалены. ( I7babc , б/285847707 )

Исправления ошибок

• Варианты SurfaceContainer теперь используются компонентами. Компоненты, которые формально рассчитывали цвет с помощью Surface и TonalElevation , теперь по умолчанию используют роли SurfaceContainer , на которые не влияет повышение тона. ( б / 304584161 )
• Исправлена ошибка, из-за которой невыбранный отключенный цвет контейнера ElevatedFilterChip был черным. ( I400e6 , б/322407043 )
• Исправлен неопределенный индикатор прогресса, когда прогресс равен 0 ( Id6582 ).
• Исправлена ​​проблема с Slider и RangeSlider в макете RTL ( Iab0e1 ).
• Добавление SliderRangeTolerance для расчета диапазона ползунка, поскольку округление с плавающей запятой может быть неточным. ( Ic918a , б/324934900 )
• Убедитесь, что DatePickerDialog отображает свои кнопки при вложении DateRangePicker или при отображении любого типа средства выбора даты на маленьких экранах с более крупными шрифтами. ( Ie4758 , б/325107799 , б/277768544 )
• Menu теперь использует роль SurfaceContainer для цвета контейнера. MenuDefaults.TonalElevation теперь имеет 0.dp ( I135b7 )
• TextField теперь использует роль SurfaceContainerHighest для цвета контейнера. ( I4dced )
• Чипы с повышенными правами теперь используют роль SurfaceContainerLow ( I7cd2f ).
• Цвет контейнера DatePicker теперь — SurfaceContainerHigh . DatePickerDefaults.TonalElevation теперь имеет 0.dp ( Ида753 )
• Обновляет цвет контейнера нижних листов и цвет маркера перетаскивания. ( I72a0a )
• Цвет контейнера RichTooltip теперь — SurfaceContainer . ( Ia8b45 )
• Цвет контейнера SearchBar теперь SurfaceContainerHighest . SearchBarDefaults.TonalElevation теперь имеет 0.dp ( I88604 )
• Обновления отключают и не выбирают дорожки/значки, чтобы использовать цветовую роль SurfaceContainerHighest . ( I7687a )
• Цвет контейнера AlertDialog теперь SurfaceContainerHigh . ( Ie0433 )
• Цвет контейнера BottomAppBar теперь SurfaceContainer . Цвет TopAppBar onScroll теперь SurfaceContainer . ( I41630 )
• Цвет контейнера ElevatedCard теперь — SurfaceContainerLow . Цвет контейнера FilledCard SurfaceContainerHighest . ( I35141 )
• Цвет контейнера ElevatedButton теперь SurfaceContainerLow . Когда FilledIconButton не выбран, теперь он имеет цвет контейнера SurfaceContainerHighest . ( I792c9 )
• Обновляет цвет контейнера TimePicker и роль цвета циферблата часов на SurfaceContainerHighest . ( I43b93 )

Версия 1.3.0-альфа01

21 февраля 2024 г.

Выпущен androidx.compose.material3:material3-*:1.3.0-alpha01 . Версия 1.3.0-alpha01 содержит эти коммиты.

Новые функции

• Обновите Compose M3 ModalBottomSheet для поддержки функции Predictive Back on U+ ( Iccf32 , b/281967264 , b/304850357 )
• Обновлена SearchBar Compose M3 для поддержки функции Predictive Back on U+ ( I657f8 ).
• Обновлен слайдер для улучшения доступности за счет добавления индикатора пробела и остановки. ( I3058e )
• Обновлен ProgressIndicator для улучшения доступности за счет добавления индикатора разрыва и остановки. ( I21451 )
• Добавление курсора по умолчанию для расширенной всплывающей подсказки, новый API расширенной всплывающей подсказки теперь позволяет рисовать пользовательскую курсорную метку с учетом привязки LayoutCoordinates . ( Ifd42c )

Изменения поведения

• Компоненты материалов были перенесены для использования новых API-интерфейсов Ripple и больше не запрашивают RippleTheme .

Изменения API

• Забавный drawStopIndicator теперь общедоступен. ( I3f59f )
• Отметьте функцию formatWithSkeleton DatePicker как внутреннюю ( Ic65dc ).
• DropdownMenu теперь поддерживает настраиваемый цвет, форму, высоту и границу. ( I8e981 , б/289554448 , б/301887035 , б/283654243 )
• Компоненты Material3, предоставляющие MutableInteractionSource в своем API, были обновлены и теперь предоставляют MutableInteractionSource с нулевым значением, который по умолчанию имеет значение null . Здесь нет никаких семантических изменений: передача null означает, что вы не хотите поднимать MutableInteractionSource , и при необходимости он будет создан внутри компонента. Изменение значения на null позволяет некоторым компонентам никогда не выделять MutableInteractionSource , а другим компонентам — только лениво создавать экземпляр, когда им это необходимо, что повышает производительность этих компонентов. Если вы не используете MutableInteractionSource , который передаете этим компонентам, рекомендуется вместо этого передать значение null. Также рекомендуется внести аналогичные изменения в ваши собственные компоненты. ( I41abb , б / 298048146 )
• Добавляет RippleConfiguration и LocalRippleConfiguration , позволяющие настраивать пульсацию для каждого компонента или поддерева с использованием фиксированных значений. Например, чтобы изменить цвет компонента, которым вы не управляете, или отключить пульсацию для компонента. В большинстве случаев следует использовать значения по умолчанию: эти API являются запасным выходом для настройки отдельных компонентов/ограниченных поддеревьев. Для более широких изменений и пользовательских систем проектирования вам следует вместо этого создать свою собственную Ripple, используя createRippleModifierNode . ( I7b5d6 , б/298048146 )
• Добавляет новый API-интерфейс Ripple в материале3, который заменяет устаревший rememberRipple . Also adds a temporary CompositionLocal , LocalUseFallbackRippleImplementation , to revert material3 components to using the deprecated rememberRipple / RippleTheme APIs. This will be removed in the next stable release, and is only intended to be a temporary migration aid for cases where you are providing a custom RippleTheme . ( I34cbc , b/298048146 )

Исправления ошибок

• Removed subcomposition inside ModalBottomSheet to improve performance. Fixed an issue where ModalBottomSheet could crash in specific scenarios in combination with LookaheadScope . ( I2a198 )
• Removed subcomposition inside BottomSheetScaffold to improve performance. Fixed an issue where BottomSheetScaffold would crash in specific scenarios in combination with LookaheadScope . ( Ie6401 )
• The badge alignment is adjusted to be closer to the center of the anchor content in respect to the top-right corner. ( I18a28 )
• Fix an a11y issue with the DateRangePicker where the Month-Year text title was conveyed as actionable to the screen reader, Switch access, and Voice access users. ( I2ac55 )
• Fixed mediumTopAppBarColors param order bug. ( Ibe64a )

Версия 1.2

Версия 1.2.1

6 марта 2024 г.

androidx.compose.material3:material3-*:1.2.1 is released. Version 1.2.1 contains these commits .

Исправления ошибок

• Make the Slider states stable again. Making State.onValueChangeFinished a val again. Wrapping onValueChangeFinished in a rememberUpdatedState . ( Ie8fd0 , b/322269951 )
• Removing @Stable from the states of Slider since we're changing state.onValueChangeFinished to a var . ( I82ba1 , b/322269951 )
• Fix NavigationBar custom colors to copy from defaults. ( 80a779 , b/326894020 )
• Fix regression in ExposedDropdownMenu to make it focusable again ( 3fcec1 , b/323694447 )
• Fix button color caching issue ( 3e5bbc b/327371655 )

Версия 1.2.0

7 февраля 2024 г.

androidx.compose.material3:material3-*:1.2.0 is released. Версия 1.2.0 содержит эти коммиты.

Known Issue

• A View-Compose interop rendering bug was introduced in PrimaryTabRow as part of a performance improvement change. The workaround is to use TabRow with TabRowDefaults.PrimaryIndicator

Важные изменения с версии 1.1.0

New Material Design 3 Components

• Потяните, чтобы обновить
  • PullToRefreshContainer
  • PullToRefreshState
• Segmented Button
  • SegmentedButton
  • SingleChoiceSegmentedButtonRow
  • MultiChoiceSegmentedButtonRow

Enhancements to existing Material Design 3 components.

• Bottom app bar (RTL alignment, auto-hide on scroll)
  • BottomAppBarScrollBehavior
• Tabs visual update
  • PrimaryIndicator
  • SecondaryIndicator
• Badge (alignment update)

Promoted experimental APIs to stable!

Performance improvements

• Please see this blog post for more details!

Версия 1.2.0-rc01

24 января 2024 г.

androidx.compose.material3:material3-*:1.2.0-rc01 is released. Версия 1.2.0-rc01 содержит эти коммиты.

Исправления ошибок

• Fixed mediumTopAppBarColors param order bug. ( Ibe64a )
• Fixed a bug introduced in 1.2.0-beta02 in CardDefaults.cardColors that did not update contentColor based on the containerColor param value. ( Iee041 , b/319671246 )
• Fixed a bug in disabledContentColor introduced in 1.2.0-beta02 and added small optimization. ( I6dda1 , b/318428829 )

Версия 1.2.0-бета02

10 января 2024 г.

androidx.compose.material3:material3-*:1.2.0-beta02 is released. Версия 1.2.0-beta02 содержит эти коммиты.

Known Bug

• A bug in IconButtonColors will by default assign disabledContentColor to an alpha (0.38f) of LocalContentColor instead of the user specified contentColor . The workaround is to explicitly set the disabledContentColor . This will be fixed in the next release.

Изменения API

• Adding the capability to enable tooltip carets for Plain Tooltip APIs. ( Ibf767 )
• SwipeToDismissState , rememberSwipeToDismiss and SwipeToDismissValue are all renamed to have _SwipeToDismissBox_ . ( I68d6d )

Исправления ошибок

• Fixed ListItem end padding value to align with spec. ( Ibd68b , b/305342674 )
• Outline color for outlined card is now correctly mapped to OutlineVariant . ( I75480 , b/310979715 )
• Dynamic color now pulls from system defined color roles. This improves contrast for accessible content, and more closely aligns dynamic color to the Material spec. ( I1de96 )
• Fixed ModalBottomSheet back handling on Android T/13+ when android:enableOnBackInvokedCallback="true" . ( I728dc , b/306196110 )

Версия 1.2.0-бета01

13 декабря 2023 г.

androidx.compose.material3:material3-*:1.2.0-beta01 is released. Версия 1.2.0-beta01 содержит эти коммиты.

Изменения API

• Mark TabIndicatorScope as experimental. ( I45c88 )
• Removing deprecated experimental APIs for tooltip. ( I438cb )
• Change new TabRow overloads to not use subcompositions. This results in a different way to build the TabRow indicators with custom modifiers provided. ( Ife741 )
• Deprecate DismissDirection and DismissValue API's. These have been merged to SwipeToDismissValue , whose values indicate both position and direction of SwipeToDismissBox . DismissState.progress is now marked as a FloatRange between 0.0 and 1.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 custom FloatRange 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 and PullToRefreshState , which together provide a pull to refresh implementation in Material3. ( I16456 , b/261760718 )

Изменения API

• Mark the SwipeToDismissBox DismissDirection and DismissValue as experimental. ( I517b0 )
• Rename SwipeToDismiss to SwipeToDismissBox . Rename background to backgroundContent and dismissContent to trailing content lambda. ( I7f4d3 )
• Make the constructor for ChipElevation and SelectableChipElevation public. ( Ie0c48 , b/308432421 )
• Adding ModalBottomSheetProperties . Moving securePolicy into ModalBottomSheetProperties . Adding isFocusable and shouldDismissOnBackPress to ModalBottomSheetProperties . These new booleans help determine how modal bottom sheet should handle IME events. ( Iea56f , b/278216859 )
• Updated RangeSlider and Slider states to remove initialOnValueChange , the initial prefixes, and appropriate kdocs. ( I57d30 )
• Deprecate ChipBorder class and its associated function calls, recommend using BorderStroke directly instead. ( I89cc2 )
• Foundation Tooltip APIs are now @ExperimentalFoundationApi . ( I30b0b )
• TabRow and ScrollableTabRow 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 uses BorderStroke directly. ( I89b9b )
• Renamed the generic AlertDialog function to BasicAlertDialog , and deprecate the previous function. ( Idbe52 )
• Rename SwipeToDismiss APIs to SwipeDismiss , and promote the new SwipeDismiss APIs to stable. ( I14cbe )
• Adding tonalElevation and shadowElevation to tooltip APIs. Additionally, moving TooltipBox , PlainTooltip , and RichTooltip 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 and BadgedBox to stable. ( I67f16 , b/261565132 )
• Adding securePolicy as a parameter to ModalBottomSheet , so users can define the behavior for WindowManager.LayoutParams.FLAG_SECURE . ( Icdac8 , b/296250262 )
• Added new overloads of LinearProgressIndicator and CircularProgressIndicator that take progress as a lambda. These should be more performant than the previous versions. ( I824e6 , b/295616656 )
• Renames StandardSizeClasses to AllSizeClasses . ( 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 )

Version 1.2.0-alpha09

4 октября 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha09 is released. Version 1.2.0-alpha09 contains these commits.

Изменения API

• Migrated ModalNavigationDrawer and DismissibleNavigationDrawer to use new AnchoredDraggable APIs. DrawerState 's animateTo 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 through currentOffset . ( I0a72c )
• Non-Composable functions have been added for creating a DatePickerState and DateRangePickerState directly. These functions can be used as an alternative to the Composable rememberDatePickerState and rememberDateRangePickerState 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 и SecondaryScrollableTabRow теперь отображают состояние прокрутки. ( 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 and RichTooltipBox APIs as deprecated methods. ( I246fa )

Исправления ошибок

• Fix a crash when the DatePicker is initialized with a DatePickerFormatter 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. Версия 1.2.0-alpha08 содержит эти коммиты.

Изменение поведения

• 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 a BottomAppBarScrollBehavior in order to auto-hide it when content is scrolled. Also added FabPosition.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 calling onDismissedRequest 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. Версия 1.2.0-alpha07 содержит эти коммиты.

Новые функции

• 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 implements DraggableState ( I9b116 )
• Change shape to be a required param. Rename position to index 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 to compose.foundation and updated PlainTooltipBox and RichTooltipBox to use TooltipBox with new PlainTooltip and RichTooltip composables. ( I79e1d )

Исправления ошибок

• dynamicLightColorScheme and dynamicDarkColorScheme now return higher chroma colors for surface and surfaceContainer roles. ( I5e901 )
• Fixed an issue where some components using Subcomposition (eg BottomSheetScaffold ) inside a Scaffold inside a LookaheadScope 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. Версия 1.2.0-alpha06 содержит эти коммиты.

Исправления ошибок

• Fixed DropdownMenu 's offset 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 's offset 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

August 9, 2023

androidx.compose.material3:material3-*:1.2.0-alpha05 is released. Версия 1.2.0-alpha05 содержит эти коммиты.

Изменения API

• Updates to the Checkbox and TriStateCheckbox colors. The CheckboxDefaults.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 a CheckboxColors with the desired color values. ( I77d17 , b/291943198 )

Версия 1.2.0-альфа04

26 июля 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha04 is released. Версия 1.2.0-alpha04 содержит эти коммиты.

Новые функции

• 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 and ToggelableSegmentedButtonRow respectively. ( I38740 )
• Divider has been renamed to HorizontalDivider . Added VerticalDivider functionality. ( I5975c )
• Change the use of ClosedFloatingPointRange for the lighter weight FloatRange 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. Версия 1.2.0-alpha03 содержит эти коммиты.

Изменения поведения

• includeFontPadding is now false by default in Material 3 typography. The default line height style has also been changed to Trim.None and Alignment.Center , and explicit lineHeight (in sp) have been added to the TextStyle s of Typography . 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. Created RangeSliderState that holds all of the information for the current active track, the measurements of the components of the RangeSlider , and the drag and gesture logic. ( I8c270 )
• Search bar now supports shadows via the newly added shadowElevation parameter. ( Ia5369 , b/271040353 )
• ColorScheme now supports new SurfaceContainer 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 create StandardSizeClasses for WindowSizeClasses ( 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 on topBar and bottomBar 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 and dynamicDarkColorScheme now support new surface roles. ( I1252e )
• Updating the badge notification alignment to not clip when colliding with great grandparent. ( Idf75a )

Версия 1.2.0-альфа02

24 мая 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha02 is released. Версия 1.2.0-alpha02 содержит эти коммиты.

Изменения API

• Add window insets parameter to ModalBottomSheet .
  • Scrim for ModalBottomSheet may now be drawn behind status bar with windowInsets 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 for BottomSheetWindow . ( I31200 , b/274872542 , b/272973615 , b/272334475 , b/268432129 , b/275849044 , b/275486106 , b/268433162 )
• Deprecate Indicator and add Primary / SecondaryIndicator to match the M3 specs. PrimaryIndicator matches the width of the tab's content whereas SecondaryIndicator spans the full available width. SecondaryIndicator is equivalent to the now deprecated Indicator and can be a direct replacement. ( I27604 )
• Added an option to pass in a ScrollState when constructing a DropdownMenu or an ExposedDropdownMenu 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. Created SliderState that holds all of the information for the current active track, the measurements of the components of the Slider , and the drag and gesture logic. ( I124a5 )
• Renaming the Semantics property isContainer to isTraversalGroup ( I121f6 )
• Added optimized TextStyle.merge(...) with full parameter list. ( Iad234 , b/246961787 )
• Made TooltipState , RichTooltipState , and PlainTooltipState public interfaces. Added RichTooltipStateImpl and PlainTooltipStateImpl for default states. Added remember*State functions to obtain these implemented states. Removed TooltipSync in favor of an TooltipDefault.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 the DateRangePickerState are now public interfaces with default implementations that can be retrieved by the rememberDatePickerState and rememberDateRangePickerState . ( I71c52 )
• Removed the dateValidator from DatePicker and DateRangePicker and introduced a SelectableDates 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

10 мая 2023 г.

androidx.compose.material3:material3:1.2.0-alpha01 and androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 are released. Версия 1.2.0-alpha01 содержит эти коммиты.

Версия 1.1

Версия 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. Версия 1.1.1 содержит эти коммиты.

Исправления ошибок

• Adds call for ModalBottomSheet without windowInset param for binary compatibility. ( Ib7959 )
• Add window insets parameter to ModalBottomSheet .
  • Scrim for ModalBottomSheet may now be drawn behind status bar with windowInsets 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 for BottomSheetWindow . ( I31200 , b/274872542 , b/272973615 , b/272334475 , b/268432129 , b/275849044 , b/275486106 , b/268433162 )

Версия 1.1.0

10 мая 2023 г.

androidx.compose.material3:material3:1.1.0 and androidx.compose.material3:material3-window-size-class:1.1.0 are released. Версия 1.1.0 содержит эти коммиты.

Major features of 1.1.0

New Material Design 3 components

• Bottom sheets
  • ModalBottomSheet , BottomSheetScaffold
• Date pickers
  • DatePicker , DateRangePicker , DatePickerDialog
• Поиск
  • SearchBar , DockedSearchBar
• SwipeToDismiss
• Time Pickers
  • TimePicker
  • TimeInput
• Подсказки
  • PlainTooltipBox , RichTooltip

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. Версия 1.1.0-rc01 содержит эти коммиты.

Изменения 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

5 апреля 2023 г.

androidx.compose.material3:material3:1.1.0-beta02 and androidx.compose.material3:material3-window-size-class:1.1.0-beta02 are released. Версия 1.1.0-beta02 содержит эти коммиты.

Изменения API

• SheetState now has optional skipHiddenState parameter
• rememberStandardBottomSheetState now has optional skipHiddenState 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 as BottomSheetDefaults.HiddenShape ( I839f4 , b/273870234 )

Исправления ошибок

• Do not switch the dial face from hour to minute when touch exploration is enabled. ( I717d0 )
• ModalBottomSheet and BottomSheetScaffold drag handle semantics are now merged. ( I05afb )
• BottomSheetScaffold modifier, containerColor and contentColor parameters now only affect content. ( I992cb )
• BottomSheetScaffold nestedScroll for sheet content now implements flings. ( I992cb )

Версия 1.1.0-бета01

22 марта 2023 г.

androidx.compose.material3:material3:1.1.0-beta01 and androidx.compose.material3:material3-window-size-class:1.1.0-beta01 are released. Версия 1.1.0-beta01 содержит эти коммиты.

Изменения 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 )

Version 1.1.0-alpha08

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 and BottomSheetScaffoldState . ( I063d4 )

Изменения API

• Added functionality to the DatePickerState and the DateRangePickerState 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 new setSelection function will throw an exception in case a provided date fails a precondition (see documentation). ( Ifa645 , b/268609314 , b/270427389 )
• Rename Collapsed SheetValue to PartiallyExpanded to more accurately and flexibly depict behavior in this state. ( Ia1491 )
• Updated ListItem parameter names to _content instead of _text. Default getters are now ReadOnlyComposables where relevant. ( I69a25 )
• Graduate interactive Surface APIs from experimental. ( I90d59 , b/261561812 )

Исправления ошибок

• Fixed an issue where ModalBottomSheet 's HalfExpanded state was calculated incorrectly and the sheet would appear to be floating. ( I45e84 , b/268411386 )
• Add confirmValueChange check to scrim tap for ModalBottomSheet . ( 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 )

Version 1.1.0-alpha07

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 to unfocusedTextColor , and placeholderColor has been renamed to unfocusedPlaceholderColor .
  • The container color for filled text fields based on error state with the new errorContainerColor param.
• 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 to elevation 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 always SheetDefaults.ExpandedShape . ( I0dfca )
• Accessibility improvements for Material 3 DatePicker and DateRangePicker . ( 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. Версия 1.1.0-alpha06 содержит эти коммиты.

Новые функции

• 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 with TimePickerState and convenience method rememberTimePickerState ( 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 and ModalBottomSheetDefaults . Also introduces SheetState and rememberSheetState 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 and ListItemColors API to non-experimental ( I7e7fa , b/261438882 )
• Promoting SliderPositions , SliderDefaults.Thumb , and SliderDefaults.Track to stable and adding non-experimental Slider and RangeSlider APIs that contain custom thumbs and track. Also deprecating the previous Slider and RangeSlider 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. Updated PlainTooltipBox API to no longer make TooltipState 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 to LocalMinimumInteractiveComponentEnforcement . ( 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. Версия 1.1.0-alpha05 содержит эти коммиты.

Новые функции

• DatePickerDialog and accessibility support
• Added Custom thumb and track to RangeSlider .

Обновления зависимостей

• Compose UI and Compose 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. Версия 1.1.0-alpha04 содержит эти коммиты.

Новые функции

• 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 to androidx.compose.foundation:1.4.0-alpha04 , you might experience a java.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 your androidx.compose.material and androidx.compose.material3 libraries to the latest version(1.1.0-alpha04) or downgrade your androidx.compose.foundation to 1.4.0-alpha03.

Версия 1.1.0-альфа03

7 декабря 2022 г.

androidx.compose.material3:material3:1.1.0-alpha03 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 are released. Версия 1.1.0-alpha03 содержит эти коммиты.

Изменения API

• Renamed consumedWindowInsets() to consumeWindowInsets() and withConsumedWindowInsets() to onConsumedWindowInsetsChanged() 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 an Scrollable ViewGroup .
• Updated Drawers and Sheets to correctly delay presses in case gestures can become scroll events.

Обновления зависимостей

• Compose UI and Compose Material now depend on Lifecycle 2.5.1. ( I05ab0 , b/258038814 )

Версия 1.1.0-альфа02

November 9, 2022

androidx.compose.material3:material3:1.1.0-alpha02 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 are released. Версия 1.1.0-alpha02 содержит эти коммиты.

Изменения API

• awaitFirstDown and waitForUpOrCancellation now accept a PointerEventPass for greater flexibility (also fixes ExposedDropdownMenuBox showing a menu while scrolling).( I7579a , b/212091796 )
• Added minLines parameter into material and material3 Text, TextField and OutlinedTextField 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 new topAppBarColors function that should be used when creating a TopAppBar . ( Ie6cb9 )
• Added minLines parameter to the BasicText and BasicTextField . 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 and IconToggleBotton 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

24 октября 2022 г.

androidx.compose.material3:material3:1.1.0-alpha01 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 are released. Версия 1.1.0-alpha01 содержит эти коммиты.

Исправления ошибок

• Fixes to the top app bar when title is applied with a TextStyle and a Brush. ( If667e )

Версия 1.0

Версия 1.0.1

November 9, 2022

androidx.compose.material3:material3:1.0.1 and androidx.compose.material3:material3-window-size-class:1.0.1 are released. Версия 1.0.1 содержит эти коммиты.

Исправления ошибок

• 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

24 октября 2022 г.

androidx.compose.material3:material3:1.0.0 and androidx.compose.material3:material3-window-size-class:1.0.0 are released. Версия 1.0.0 содержит эти коммиты.

Основные особенности версии 1.0.0

This is the first stable release of Compose Material 3!

Material Design 3 theming and Material You dynamic color

• MaterialTheme
• Цвет
  • Цветовая схема
  • lightColorScheme , darkColorScheme
• Dynamic color
  • dynamicLightColorScheme , dynamicDarkColorScheme
• Типографика
  • Типографика
• Формы
  • Формы

Material Design 3 components

• Значок
  • Badge , BadgedBox
• Bottom App Bar
  • BottomAppBar
• Кнопки
  • Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
• FAB and extended FAB
  • SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
• Карты
  • Card , OutlinedCard , ElevatedCard
• Флажок
  • Флажок
• Чипсы
  • AssistChip , ElevatedAssistChip , FilterChip , ElevatedFilterChip , InputChip , SuggestionChip , ElevatedSuggestionChip
• Диалоги
  • AlertDialog
• Разделитель
  • Разделитель
• Dropdown Menu
  • DropdownMenu , DropdownMenuItem , ExposedDropdownMenuBox
• Список
  • ListItem
• Панель навигации
  • NavigationBar
• Навигационный ящик
  • ModalNavigationDrawer , ModalDrawerSheet , DismissibleNavigationDrawer , DismissibleDrawerSheet , PermanentNavigationDrawer , PermanentDrawerSheet
• Navigation rail
  • NavigationRail
• Progress Indicator
  • CircularProgressIndicator , LinearProgressIndicator
• Радиокнопка
  • RadioButton
• Слайдер
  • Slider , RangeSlider
• Выключатель
  • Выключатель
• Вкладки
  • Tab , LeadingIconTab , TabRow , ScrollableTabRow
• Текстовые поля
  • TextField , OutlinedTextField
• Top app bar
  • TopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
• Икона
  • Icon , IconButton
• Текст
  • Текст
• Поверхность
  • Поверхность
• Макет
  • Строительные леса
• Цвет содержимого
  • LocalContentColor

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 use calculateWindowSizeClass 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 for WindowSizeClass .

• 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. Версия 1.0.0-rc01 содержит эти коммиты.

Изменения API

• Added slot param for supporting text to text field API ( Iaac0d , b/227146125 )

Версия 1.0.0-бета03

21 сентября 2022 г.

androidx.compose.material3:material3:1.0.0-beta03 and androidx.compose.material3:material3-window-size-class:1.0.0-beta03 are released. Версия 1.0.0-beta03 содержит эти коммиты.

Изменения API

• ExposedDropdownMenuDefaults now exposes a padding value for menu items. ( I34ee1 )
• ExposedDropdownMenuBoxScope now has a Modifier.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. Версия 1.0.0-beta02 содержит эти коммиты.

Изменения 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 equivalent TopAppBar 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. Версия 1.0.0-beta01 содержит эти коммиты.

Справочник 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 )

Version 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. Version 1.0.0-alpha16 contains these commits.

Новые функции

• 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 and NavigationRail 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 and BadgedBox 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 from MenuDefaults and TabDefaults ( 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. Version 1.0.0-alpha15 contains these commits.

Новые функции

• Allow dragging the top app bar from the bar itself. ( I65c00 , b/205873416 )

Изменения API

• Updates to the FilterChip and ElevatedFilterChip APIs to remove the selectedIcon slot and promote reusing the leadingIcon for displaying a selected state. ( Ie5dc2 )
• Add scrim and outline variant color roles. ( Id6d54 )
• Fix naming conventions for composable defaults. ( I62b27 )
• Mark ListItemDefaults and ListItemColors 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 the Checkbox function. ( I5eefc )
• Removed the @ExperimentalMaterial3Api annotation from the RadioButton 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 )

Version 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. Version 1.0.0-alpha14 contains these commits.

Новые функции

• 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 the FilterChip colors for selected disabled state. ( I55244 , b/235792432 )
• Add BottomAppBar default FAB ( Ida4c8 )
• ColorScheme.surfaceColorAtElevation was added ( Id41af )
• Интерфейсы в библиотеках компоновки теперь создаются с использованием методов интерфейса jdk8 по умолчанию ( I5bcf1 ).
• WindowWidthSizeClass and WindowHeightSizeClass 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. Version 1.0.0-alpha13 contains these commits.

Изменения 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. Версия 1.0.0-alpha12 содержит эти коммиты.

Исправления ошибок

• Slider parent can now have 0 width. ( b/231707291 )

Version 1.0.0-alpha11

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 and InputChip support ( I0d25a )
• Adds Material3 FilterChip and SuggestionChip support ( I9fdf3 )

Изменения API

• Renamed TextFieldDefaults.BorderStroke composable that draws a border stroke in OutlinedTextField to TextFieldDefaults.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. Version 1.0.0-alpha10 contains these commits.

Новые функции

• 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 use calculateWindowSizeClass 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 for WindowSizeClass . 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 from BottomAppBar with FAB. ( I92c47 )
• Adds Material3 FilledIconButton , FilledTonalIconButton , and OutlinedIconButton . ( 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 use consume() to consume the change completely. You can use isConsumed to determine whether or not someone else has previously consumed the change.
• PointerInputChange::copy() now always makes a shallow copy. It means that copies of PointerInputChange will be consumed once one of the copies is consumed. If you want to create an unbound PointerInputChange , 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 renamed containerColor 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 )

Version 1.0.0-alpha09

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 )

Version 1.0.0-alpha08

23 марта 2022 г.

androidx.compose.material3:material3:1.0.0-alpha08 is released. Version 1.0.0-alpha08 contains these commits.

Новые функции

• Added support for Material 3 text fields. ( I795cc , b/199377790 )

Изменения API

• Add default divider for menu ( I01374 )
• Added surfaceTint color parameter to ColorScheme class. ( I2f558 )

Исправления ошибок

• Fix at the Material3 Button to read its default text style value from the MaterialTheme. ( Ie62fc )

Version 1.0.0-alpha07

9 марта 2022 г.

androidx.compose.material3:material3:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

Изменения 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 and LazyHorizontalGrid 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. Deprecated ViewCompat.getWindowInsetsController in favor of WindowCompat.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 )

Version 1.0.0-alpha06

23 февраля 2022 г.

androidx.compose.material3:material3:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

Изменения API

• NavigationDrawerItem is added that represents a single destination within the drawers ( Ic396f , b/218286829 )
• PermanentNavigationDrawer and DismissibleNavigationDrawer 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 to ModalNavigationDrawer ( 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 to FloatingActionButtonDefaults . ( Ia71cf )
• Bug fix for hidden AlertDialog buttons when a long text is added with a LazyColumn . ( Ib2cc9 , b/216663029 )

Версия 1.0.0-альфа05

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

• Раскрывающееся меню
  • DropdownMenu , DropdownMenuItem
• Карты
  • Card , OutlinedCard , ElevatedCard

Изменения API

• Deprecated Surface function that takes an onClick callback. Clickable surfaces should be created with an InteractionSource and a Modifier.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 )

Версия 1.0.0-альфа04

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's MaterialTheme . ( I7ce4e )
• Fix the corner radius that is applied for Checkboxes ( I38b03 , b/175198975 , b/202309440 )

Обновления зависимостей

• Теперь зависит от 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.
• Обновлен для совместимости с 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 from compose.material ( I30b03 )
• Fixed but that hardcoded button to always be enabled. ( Iea832 , b/205335456 )

Версия 1.0.0-альфа01

October 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

• MaterialTheme
• Цвет
  • ColorScheme
  • lightColorScheme , darkColorScheme
• Dynamic color
  • dynamicLightColorScheme , dynamicDarkColorScheme
• Типографика
  • Typography

Material Design 3 components

• Кнопки
  • Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
• FAB and extended FAB
  • SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
• Диалоги
  • AlertDialog
• Панель навигации
  • NavigationBar
• Навигационный ящик
  • NavigationDrawer
• Navigation rail
  • NavigationRail
• Top app bar
  • SmallTopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
• Значок
  • Badge , BadgedBox
• Икона
  • Icon , IconButton
• Текст
  • Text
• Поверхность
  • Surface
• Макет
  • Scaffold
• Цвет содержимого
  • LocalContentColor

For more information, check out the Material Design 3 and Material You section in the Material Theming in Compose guide.