Эта страница переведена с помощью Cloud Translation API.

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

Справочник по API
androidx.compose.material3
( См. справочную документацию по API для всех пакетов создания )

Создавайте пользовательские интерфейсы Jetpack Compose с помощью компонентов Material Design 3 — следующего этапа развития Material Design. Material 3 включает обновленные темы и компоненты, а также функции персонализации Material You, такие как динамический цвет, и разработан с учетом нового визуального стиля Android 12 и системного пользовательского интерфейса.

Последнее обновление	Стабильный выпуск	Кандидат на выпуск	Бета-версия	Альфа-релиз
13 ноября 2024 г.	1.3.1	-	-	1.4.0-альфа04

Структура

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

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

Группа	Описание
сочинить.анимацию	Создавайте анимацию в своих приложениях Jetpack Compose, чтобы улучшить взаимодействие с пользователем.
compose.compiler	Преобразуйте функции @Composable и включите оптимизацию с помощью плагина компилятора Kotlin.
compose.foundation	Создавайте приложения Jetpack Compose с готовыми к использованию стандартными блоками и расширяйте основу для создания собственных элементов системы проектирования.
составить.материал	Создавайте пользовательские интерфейсы Jetpack Compose с готовыми к использованию компонентами Material Design. Это точка входа более высокого уровня в Compose, предназначенная для предоставления компонентов, соответствующих описанным на сайте www.material.io.
Compose.material3	Создавайте пользовательские интерфейсы Jetpack Compose с помощью компонентов Material Design 3 — следующего этапа развития Material Design. Material 3 включает обновленные темы и компоненты, а также функции персонализации Material You, такие как динамический цвет, и разработан с учетом нового визуального стиля Android 12 и системного пользовательского интерфейса.
Compose.runtime	Фундаментальные строительные блоки модели программирования Compose и управления состоянием, а также основная среда выполнения для целевого подключаемого модуля Compose Compiler.
Compose.ui	Фундаментальные компоненты пользовательского интерфейса, необходимые для взаимодействия с устройством, включая макет, рисование и ввод.

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

Чтобы добавить зависимость от Compose, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .

Добавьте зависимости для нужных вам артефактов в файл build.gradle для вашего приложения или модуля:

классный

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

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Котлин

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .

Обратная связь

Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.

Создать новую задачу

Дополнительную информацию см . в документации по системе отслеживания проблем .

Compose Material3 Общая версия 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, версия 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 )

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 , б/331993720 )
Добавление функции itemColors в NavigationSuiteDefaults . ( Idf719 , б/328480012 )
Сделайте NavigationSuiteScope запечатанным. ( Иефа57 )

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 , б/324886877 )

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 )
Перейдите на использование версии классов размеров окон Window Manager. ( I3794d )

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

Обновить имя пакета до навигационного пакета из навигационного пакета ( I7eff7 ).
Компоненты Material3, предоставляющие MutableInteractionSource в своем API, были обновлены и теперь предоставляют MutableInteractionSource с нулевым значением, значение которого по умолчанию равно нулю. Здесь нет никаких семантических изменений: передача null означает, что вы не хотите поднимать MutableInteractionSource , и при необходимости он будет создан внутри компонента. Изменение значения null позволяет некоторым компонентам никогда не выделять MutableInteractionSource , а другим компонентам — только лениво создавать экземпляр, когда это необходимо, что повышает производительность этих компонентов. Если вы не используете MutableInteractionSource который передаете этим компонентам, рекомендуется вместо этого передать значение null. Также рекомендуется внести аналогичные изменения в ваши собственные компоненты. ( I41abb , б / 298048146 )

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 ( If8cb1 , b/313688598 ).

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

Исправлен компонент навигации, заполняющий весь экран, когда корневая поверхность имеет modifier.fillMaxSize . ( c9cf250 , б/312664933 )

15 ноября 2023 г.

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

Новые возможности

НавигацияКомплексЭшаф
- НавигацияКомплексScaffoldМакет
- Навигационный пакет

Compose Material3 Адаптивная версия 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

Свойства границ шарниров в Posture перенесены в список информации о шарнирах ( 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

Измените роли скаффолда на псевдонимы ThreePaneScaffoldRole . ( I65bd1 )
Создайте базовый класс для ролей scaffold ( I4784d ).
Удалите ненужный параметр из содержимого AnimatedPane ( Ibc73b ).
Переименовывает collectWindowSizeAsState и вместо этого возвращает необработанные значения ( I480f4 )

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

29 ноября 2023 г.

androidx.compose.material3:material3-adaptive:1.0.0-alpha02 , androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02 и androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 выпущены. Версия 1.0.0-alpha02 содержит эти коммиты.

Изменения API

Отделите API навигации от API адаптивных шаблонов. ( Ic4045 )
Удалите класс GutterSize . ( I785b3 )

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

Панели исправлений не переключаются, когда AnimatedPane не используется ( d88f181 ).

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

15 ноября 2023 г.

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

Новые возможности

API адаптивных условий Material3:

Поза

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

ПанельЭшафаДиректива

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

Основные API каркаса панели

Создать материал3 версия 1.4

Версия 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 .
Компоненты Материала 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.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-бета02

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 , b/323694447 , b/278609042 )

Изменения API

Флаг ScaffoldSubcomposeInMeasureFix был удален. ( IE2A4B )
NavigationRailItemColors теперь помечен как @Immutable . ( If6112 , b/327660613 )
NavigationBarItemColors теперь помечен как @Immutable . ( I42a30 , b/298064514 )
Пересмотреть параметры в Slider Drack Composable. ( I9f315 )
ExposedDropdownMenu теперь реализован с использованием Popup . Поведение должно быть тем же, за исключением того, что фокусируемые меню с редактируемыми текстовыми полями могут быть отклонены при вводе на клавиатуре.

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

Подводные и поверхностные контейнер. ( I677a5 )
Обновленные цветы слайдера и ProgressIndicator , чтобы следовать новым не текстовым контрастным характеристикам. ( I26807 )
Обновите наложение состояния фокуса, чтобы быть 0,1F, чтобы обеспечить достаточный цветовой контраст. ( I7ea77 )
Небольшие настройки на поверхность и фоновый цвет по умолчанию в lightColorScheme и darkColorScheme . ( I9db52 )

Версия 1.3.0-Alpha02

6 марта 2024 г.

androidx.compose.material3:material3-*:1.3.0-alpha02 выпускается. Версия 1.3.0-Alpha02 содержит эти коммиты .

Изменения API

Снова сделай слайдер стабильно. Создание State.onValueChangeFinished . OnvalueChangefinafining Val. Обертывание onValueChangeFinished в rememberUpdatedState . ( I82ab2 , b/322269951 )
Навигационные компоненты теперь используют новые роли SurfaceContainer . В настоящее время DrawerDefaults предоставляют различные атрибуты standardContainerColor и modalContainerColor . DrawerDefaults.ModalDrawerElevation теперь 0.dp ( I7fbac )
Удаление @Stable из состояний Slider , так как мы меняем state.onValueChangeFinished . Onvaluechangefinefined в var . ( IED34A , B/322269951 )
Спецификация анимации ModalBottomSheet и StandardBottomSheet теперь является TweenSpec , обновленной из пружинной анимации. Это решает проблему с видимым перехватом. Установленные конструкторы SheetState без плотности теперь удалены. ( I7babc , b/285847707 )

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

Варианты SurfaceContainer теперь используются компонентами. Компоненты, которые формально рассчитывали цвет с поверхностью и TonalElevation в настоящее время используют роли SurfaceContainer по умолчанию, которые не влияют на тональную высоту. ( B/304584161 )
Исправлена ошибка, которая вызвала невыбранное, отключенный цвет контейнера ElevatedFilterChip , чтобы быть черным. ( I400e6 , b/322407043 )
Исправить неопределенный индикатор прогресса, когда прогресс составляет 0 ( ID6582 )
Исправлена проблема с Slider и RangeSlider на компоновке RTL ( IAB0E1 )
Добавление SliderRangeTolerance для расчета диапазона ползунка, так как поплавковое округление может быть неточным. ( IC918A , B/324934900 )
Убедитесь, что DatePickerDialog отображает свои кнопки при гнезде DateRangePicker или при отображении любого типа выбора даты на небольших экранах с большими шрифтами. ( IE4758 , B/325107799 , B/277768544 )
Menu теперь использует роль SurfaceContainer для цвета контейнеров. MenuDefaults.TonalElevation теперь 0.dp ( I135B7 )
TextField теперь использует самую высокую роль SurfaceContainerHighest для цвета контейнеров. ( I4dced )
Повышенные чипы теперь используют роль SurfaceContainerLow ( i7cd2f )
Цвет контейнера DatePicker теперь SurfaceContainerHigh . DatePickerDefaults.TonalElevation теперь 0.dp ( IDA753 )
Обновления нижних листов цвет контейнера и цвет ручки перетаскивания. ( I72a0a )
Цвет контейнера RichTooltip теперь SurfaceContainer . ( IA8B45 )
Цвет контейнера SearchBar теперь SurfaceContainerHighest . SearchBarDefaults.TonalElevation теперь 0.dp ( I88604 )
Обновления отключили и не выбранные треки/значки для использования верховой цветовой роли SurfaceContainerHighest . ( I7687a )
Цвет контейнера AlertDialog теперь SurfaceContainerHigh . ( IE0433 )
Цвет контейнера BottomAppBar теперь SurfaceContainer . TopAppBar onScroll Color теперь SurfaceContainer . ( I41630 )
Цвет контейнеров ElevatedCard теперь SurfaceContainerLow . Цвет контейнера FilledCard карты SurfaceContainerHighest . ( I35141 )
ElevatedButton комната контейнера теперь является SurfaceContainerLow . FilledIconButton , когда он не выбран теперь имеет цвет контейнера SurfaceContainerHighest . ( I792c9 )
Обновления TimePicker Container Color и Clock Dial Роль для SurfaceContainerHighest . ( I43b93 )

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

21 февраля 2024 г.

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

Новые возможности

Обновление Compose M3 ModalBottomSheet для поддержки прогнозирования на U+ ( ICCF32 , B/281967264 , B/304850357 )
Обновленная Compose M3 SearchBar для поддержки Predictive обратно на u+ ( i657f8 )
Обновлен слайдер для улучшения доступности, добавив индикатор разрыва и остановки. ( I3058e )
Обновлено ProgressIndicator для улучшения доступности, добавив индикатор разрыва и остановки. ( I21451 )
Добавляя карету по умолчанию для богатого всплывающего подсказки, New Rich API для подсказки инструментов теперь позволяет нарисовать пользовательскую карету с учетом якоря LayoutCoordinates . ( Ifd42c )

Поведение изменяется

Материальные компоненты были мигрированы, чтобы использовать новые Ripple API и больше не запросить RippleTheme .

Изменения API

Веселый drawStopIndicator в настоящее время является общедоступным. ( I3f59f )
Отметьте функцию formatWithSkeleton DatePicker в качестве внутренней ( IC65DC )
DropdownMenu теперь поддерживает пользовательский цвет, форму, высоту и границу. ( I8e981 , b/2895544448 , b/301887035 , b/283654243 )
Материал3 Компоненты, разоблачающие MutableInteractionSource в их API, были обновлены, чтобы теперь выявить нулевые MutableInteractionSource , которые по умолчанию по умолчанию в null . Здесь нет семантических изменений: передача NULL означает, что вы не хотите поднимать MutableInteractionSource , и он будет создан внутри компонента, если это необходимо. Изменение на NULL позволяет некоторым компонентам никогда не распределять MutableInteractionSource и позволяет другим компонентам только лениво создавать экземпляр, когда им необходимо, что повышает производительность в этих компонентах. Если вы не используете MutableInteractionSource которые вы передаете этим компонентам, рекомендуется вместо этого пройти NULL. Также рекомендуется внести аналогичные изменения в своих собственных компонентах. ( I41abb , b/298048146 )
Добавляет RippleConfiguration и LocalRippleConfiguration , чтобы обеспечить настройку рябовей с использованием фиксированных значений. Например, чтобы изменить цвет компонента, который вы не управляете, или отключить пульсацию для компонента. В большинстве случаев должны использоваться значения по умолчанию: эти API являются вытапленным люком для настройки отдельных компонентов / ограниченных под деревьев. Для более широких изменений и индивидуальных систем проектирования, вы должны вместо этого создать свою собственную Ripple, используя createRippleModifierNode . ( I7b5d6 , b/298048146 )
Добавляет новый API Ripple в Material3, который заменяет устаревшее rememberRipple . Also adds a temporary CompositionLocal , LocalUseFallbackRippleImplementation , to revert material3 components to using the deprecated rememberRipple / RippleTheme APIs. Это будет удалено в следующем стабильном выпуске и предназначено только для того, чтобы быть временной миграционной помощью для тех случаев, когда вы предоставляете пользовательскую RippleTheme . ( I34CBC , B/298048146 )

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

Удалена подкомпозиция внутри ModalBottomSheet для повышения производительности. Исправлена проблема, в которой ModalBottomSheet мог потерпеть крах в определенных сценариях в сочетании с LookaheadScope . ( I2a198 )
Удалена подкомпозиция внутри BottomSheetScaffold для повышения производительности. Исправлена проблема, в которой BottomSheetScaffold будет терпеть неудачу в определенных сценариях в сочетании с LookaheadScope . ( IE6401 )
Выравнивание значков корректируется, чтобы быть ближе к центру анкерного содержания по отношению к праву в верхнем правом углу. ( I18A28 )
Исправьте проблему A11Y с помощью DateRangePicker , где заголовок текста месяц-летнего текста был представлен как действующий на считыватель экрана, доступительно переключать и голосовой доступ. ( I2ac55 )
Исправлено mediumTopAppBarColors Param Order ошибка. ( Ibe64a )

Версия 1.2

Версия 1.2.1

6 марта 2024 г.

androidx.compose.material3:material3-*:1.2.1 выпускается. Версия 1.2.1 содержит эти коммиты .

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

Сделайте повторные состояния слайдера снова. Создание State.onValueChangeFinished . OnvalueChangefinafining Val. Обертывание onValueChangeFinished в rememberUpdatedState . ( IE8FD0 , B/322269951 )
Удаление @Stable из состояний Slider , так как мы меняем state.onValueChangeFinished . Onvaluechangefinefined в var . ( I82ba1 , b/322269951 )
Исправьте NavigationBar пользовательские цвета, чтобы копировать по умолчанию. ( 80A779 , b/326894020 )
Исправьте регрессию в ExposedDropdownMenu чтобы снова сделать ее фокусировкой ( 3FCEC1 , B/323694447 )
Проблема с кнопкой кнопки кнопки кнопки ( 3E5BBC B/327371655 )

Версия 1.2.0

7 февраля 2024 г.

androidx.compose.material3:material3-*:1.2.0 выпускается. Версия 1.2.0 содержит эти коммиты.

Известный вопрос

В PrimaryTabRow была представлена ошибка рендеринга взаимодействия с представлением, как часть изменения повышения производительности. Обходной путь состоит в том, чтобы использовать TabRow с TabRowDefaults.PrimaryIndicator

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

Новый дизайн материала 3 компоненты

Потянуть, чтобы обновить
- Pulltorefreshcontainer
- Pulltorefreshstate
Сегментированная кнопка

Улучшения для существующих компонентов дизайна материала 3.

Нижняя панель приложений (выравнивание RTL, автоматическое скрытие на свитке)
- BottonAppbarscrollbehavior
Вкладки визуальное обновление
- Первичный индикатор
- Вторичный индикатор
Значок (обновление выравнивания)

Продвижение экспериментальных API до стабильной!

Улучшение производительности

Пожалуйста, смотрите этот пост в блоге для получения более подробной информации!

Версия 1.2.0-rc01

24 января 2024 г.

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

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

Исправлено mediumTopAppBarColors Param Order ошибка. ( Ibe64a )
Исправлена ошибка, представленная в 1.2.0-beta02 в CardDefaults.cardColors , которая не обновляла contentColor на основе значения параметра containerColor . ( IEE041 , B/319671246 )
Исправлена ошибка в disabledContentColor представленную в 1.2.0-beta02 и добавлена небольшая оптимизация. ( I6dda1 , b/318428829 )

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

10 января 2024 г.

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

Известная ошибка

Ошибка в IconButtonColors по умолчанию назначит disabledContentColor в альфа (0,38F) LocalContentColor вместо указанного пользователя contentColor . Обходной путь состоит в том, чтобы явно установить disabledContentColor . Это будет исправлено в следующем выпуске.

Изменения API

Добавление возможностей для включения подсказки для подсказок для простых API Tooltip . ( IBF767 )
SwipeToDismissState , rememberSwipeToDismiss и SwipeToDismissValue все переименованы в то, чтобы иметь _SwipeToDismissBox_ . ( I68d6d )

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

Фиксированное значение окончательного значения ListItem для соответствия спецификации. ( IBD68B , B/305342674 )
Цвет сброса для изложенной карты теперь правильно отображается с OutlineVariant . ( I75480 , b/310979715 )
Динамический цвет теперь вытягивает из системы, определенных цветовыми ролями. Это улучшает контраст для доступного контента и более тесно выравнивает динамический цвет с спецификацией материала. ( I1de96 )
Исправлена ModalBottomSheet Back обработка на Android T/13+, когда android:enableOnBackInvokedCallback="true" . ( I728dc , b/306196110 )

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

13 декабря 2023 г.

androidx.compose.material3:material3-*:1.2.0-beta01 выпускается. Версия 1.2.0-бета01 содержит эти коммиты.

Изменения API

Mark TabIndicatorScope как экспериментальный. ( I45c88 )
Удаление устаревших экспериментальных API для подъема инструментов. ( I438cb )
Измените новые перегрузки TabRow чтобы не использовать подкомпозиции. Это приводит к другому способу создания индикаторов TabRow с предоставленными пользовательскими модификаторами. ( IFE741 )
Установите DismissDirection и DismissValue API. Они были объединены с SwipeToDismissValue , чьи значения указывают как положение, так и направление SwipeToDismissBox . DismissState.progress теперь отмечается как FloatRange от 0.0 до 1.0 . DismissState устарела и конструктор теперь удалены. Компонент SwipeToDismiss , государство и дефолт объект были отмечены как экспериментальные. ( IB54F2 )

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

Индикатор по умолчанию для PullToRefresh теперь является открытой стрелкой вместо твердого треугольника. ( I67be3 )

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

29 ноября 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha12 выпускается. Версия 1.2.0-Alpha12 содержит эти коммиты.

Изменения API

RangeSlider теперь принимает диапазон Kotlin (например, 0f..1f ) вместо пользовательского класса значений FloatRange . SnapFlingBehavior.kt теперь также использует диапазон Kotlin. ( I025CB )
Марк модификатор Factory функционирует как @Stable . ( IB109F )

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

15 ноября 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha11 выпускается. Версия 1.2.0-альфа11 содержит эти коммиты.

Новые возможности

Реализует PullToRefreshContainer и PullToRefreshState , которые вместе обеспечивают притяжение, чтобы обновить реализацию в Material3. ( I16456 , B/261760718 )

Изменения API

Отметьте SwipeToDismissBox DismissDirection и DismissValue как экспериментальное. ( I517b0 )
Переименовать SwipeToDismiss в SwipeToDismissBox . Переименовать background до backgroundContent и dismissContent в следующий content Lambda. ( I7f4d3 )
Сделайте конструктор для ChipElevation и SelectableChipElevation Public. ( IE0C48 , B/308432421 )
Добавление ModalBottomSheetProperties . Перемещение securePolicy в ModalBottomSheetProperties . Добавление isFocusable и shouldDismissOnBackPress в ModalBottomSheetProperties . Эти новые логины помогают определить, как модальный нижний лист должен обрабатывать события IME. ( IEA56F , B/278216859 )
Обновленные состояния RangeSlider и Slider для удаления initialOnValueChange , начальных префиксов и соответствующих KDOC. ( I57d30 )
Умолете класс ChipBorder и связанные с ним функциональные вызовы, вместо этого рекомендуйте использовать BorderStroke . ( I89cc2 )
Фонд подсказки инструментов теперь @ExperimentalFoundationApi . ( I30b0b )
TabRow и ScrollableTabRow больше не устаревают. Новые первичные и вторичные варианты отмечены как экспериментальные. ( I0def6 )
Фильтр и входные чипы теперь используют BorderStroke напрямую. ( I07a8d )
SegmentedButton теперь использует BorderStroke напрямую. ( I89b9b )
Переименован в общей функции AlertDialog в BasicAlertDialog и выпустите предыдущую функцию. ( Idbe52 )
Переименовать APIS SwipeToDismiss в SwipeDismiss и содействовать новым APIS SwipeDismiss до стабильного. ( I14cbe )
Добавление tonalElevation и shadowElevation к API -интерфейсам для выявления инструментов. Кроме того, перемещение API -интерфейсов TooltipBox , PlainTooltip и RichTooltip обратно в экспериментальные, так как они были случайно выпущены как стабильные. ( If0f66 , b/293939035 )
Содействовать экспериментальным API -интерфейсам к стабильному. ( IEA2C3 )
Удалил аннотацию @ExperimentalMaterial3Api из Material3 Clickable Cards. ( I88dbf )

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

Исправлена проблема, в которой SwipeToDismiss потерпел крушение в определенных сценариях с вложенными лайкейками и ленивыми макетами. ( ICA8D1 , B/297226562 )

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

18 октября 2023 г.

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

Изменения API

Продвигание Badge и BadgedBox до стабильной. ( I67F16 , B/261565132 )
Добавление securePolicy в качестве параметра в ModalBottomSheet , поэтому пользователи могут определить поведение для WindowManager.LayoutParams.FLAG_SECURE . ( ICDAC8 , B/296250262 )
Добавлены новые перегрузки LinearProgressIndicator и CircularProgressIndicator которые занимаются progress как лямбда. Они должны быть более эффективными, чем предыдущие версии. ( I824E6 , B/295616656 )
Переименование StandardSizeClasses в AllSizeClasses . ( I8cb07 )
Объедините функции расчета классов размера окна. ( IAD935 )

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

Исправьте сбой DatePicker , когда быстро нажимает на кнопки стрелка навигации, когда отображаемый месяц находится на краю допустимого диапазона лет. ( I46f36 , b/290954897 , b/297002119 )
[NAV RAIL/BAR] Поддержка прозрачного цвета для индикатора. ( IE0A9B , B/267289987 )

Версия 1.2.0-Alpha09

4 октября 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha09 выпускается. Версия 1.2.0-Alpha09 содержит эти коммиты.

Изменения API

Мигрировал ModalNavigationDrawer и DismissibleNavigationDrawer для использования новых AnchoredDraggable API. Animateto's animateTo DrawerState была заменена на открытые и близкие методы, а смещение теперь выставлено как плавание вместо объекта состояния. Вы можете получить доступ к смещению непосредственно через currentOffset . ( I0a72c )
Неособочные функции были добавлены для создания DatePickerState и DateRangePickerState напрямую. Эти функции могут использоваться в качестве альтернативы композиционным функциям rememberDatePickerState и rememberDateRangePickerState , когда это необходимо. ( I70326 , b/291524052 )
Исправленные и прокручиваемые TabRows теперь имеют первичные и вторичные варианты. Они правильно сопоставляются с поведением цвета и индикатора, как определено в материале3.
PrimaryScrollableTabRow и SecondaryScrollableTabRow теперь обнажают состояние прокрутки. ( IEC8F5 , B/260572337 )
Добавление нового параметра sheetMaxWidth , который разработчики могут установить, чтобы указать максимальную ширину, которую будет охватывать лист. DP.UNPACIFIFITED может быть передан для параметра, если желателен лист, который охватывает всю ширину экрана. ( IFB7C9 , B/266697696 )
Добавление API -интерфейсов PlainTooltipBox и RichTooltipBox в качестве устаревших методов. ( I246fa )

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

Исправьте сбой, когда инициализируется DatePicker с помощью DatePickerFormatter , у которого есть определенные скелеты даты, которые остаются прежними при преобразовании на сегодняшний день (например, YY). ( I01F29 )

Версия 1.2.0-Alpha08

20 сентября 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha08 выпускается. Версия 1.2.0-Alpha08 содержит эти коммиты.

Поведение нарушение изменения

ColorScheme в настоящее время неизменен, что делает индивидуальные обновления цвета менее эффективными, но делает более распространенное использование цветов более эффективными. Причина этого изменения заключается в том, что большинство приложений не будут обновлять отдельные цвета в качестве основного варианта использования. Это все еще возможно, но оно будет перекомплектовать больше, чем раньше, в свою очередь, мы значительно уменьшаем количество подписок состояния по всему коду материала и повлияем на инициализацию и стоимость времени выполнения более стандартных вариантов использования. ( IC447D , B/297212873 )
Тональная высота больше не анимирует в разных состояниях взаимодействия в соответствии с спецификацией. ( ICDD12 )

Изменения API

Добавлен новый BottomAppBar , который принимает в качестве параметра BottomAppBarScrollBehavior , чтобы автоматически скрыть его при прокрутке контента. Также добавлен FabPosition.EndOverlay позволяя FAB накладываться на нижнюю панель приложений в каркасе вместо того, чтобы быть закрепленным над ним. ( IECB47 )
Добавлен простой компонент метки, который строится на вершине BasicTooltipBox , который не будет отклоняться при постукивании за пределы границ метки. ( I821f9 )

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

Удалили использование rememberSaveable для всплесков инструментов. ( ICC131 , B/299500338 )
Ввел временный флаг, чтобы контролировать, следует ли измерять каркасы во время измерения или во время размещения. По умолчанию это будет измерять в измерении. Если вы сталкиваетесь с проблемами с новым поведением, пожалуйста, подайте проблему. ( I0b354 )
Фиксированный горизонтальный край до края в BottomSheet используя правильное измерение для ширины экрана устройства. ( I1df0c , b/299058752 )
Исправлена ошибка, в которой ModalBottomSheet не призывал onDismissedRequest при увольнении, сбиваясь на лист. ( IDFDD8 )

Версия 1.2.0-Alpha07

6 сентября 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha07 выпускается. Версия 1.2.0-Alpha07 содержит эти коммиты.

Новые возможности

Поддержка иконки Auto-Mirror была добавлена в compose material 1.6.0-alpha05 , пожалуйста, см. Примечания по выпуску для получения подробной информации о значках автоматического зеркала.

Изменения API

SliderState реализует DraggableState ( i9b116 )
Изменить форму, чтобы быть обязательным парамом. Переименовать position , чтобы index функцию вспомогательной. ( I34941 )
Обновляет формат DatePicker formatWithSkeleton , чтобы включить карту, которая используется в качестве кэша для улучшения производительности. ( I3195f )
Добавлен BasicTooltipBox для compose.foundation и обновленного PlainTooltipBox и RichTooltipBox для использования TooltipBox с новыми композициями PlainTooltip и RichTooltip . ( I79e1d )

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

dynamicLightColorScheme и dynamicDarkColorScheme теперь возвращают более высокие цвета хромы для ролей поверхности и surfaceContainer . ( I5e901 )
Исправлена проблема, в которой некоторые компоненты с использованием подкомпозиции (например, BottomSheetScaffold ) внутри каркаса внутри LookaheadScope пытались прочитать их размер слишком рано. ( I297b4 , i871f1 , b/295536718 )

Версия 1.2.0-Alpha06

23 августа 2023 года

androidx.compose.material3:material3-*:1.2.0-alpha06 выпускается. Версия 1.2.0-Alpha06 содержит эти коммиты.

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

Фиксированное offset расчет DropdownMenu поэтому x смещения зависят исключительно от локального направления макета, и y -смещения больше не будут изменены, когда меню находится рядом с нижней частью экрана. ( ICCC74 , B/294103942 )
Фиксированное offset расчет DropdownMenu поэтому x смещения зависят исключительно от локального направления макета, и y -смещения больше не будут изменены, когда меню находится рядом с нижней частью экрана. ( IB87A2 , B/294103942 )

Версия 1.2.0-Alpha05

9 августа 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha05 выпускается. Версия 1.2.0-Alpha05 содержит эти коммиты.

Изменения API

Обновления в флажок и цветах TriStateCheckbox . CheckboxDefaults.colors() disabledUncheckedColor теперь только влияет на границу флажона. Специальные случаи, которые требуют от вас установить цвет внутреннего коробки при отключении и неконтролировании, требуется созданный настраиваемый экземпляр CheckboxColors с желаемыми значениями цвета. ( I77d17 , b/291943198 )

Версия 1.2.0-Alpha04

26 июля 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha04 выпускается. Версия 1.2.0-Alpha04 содержит эти коммиты.

Новые возможности

Экспериментальная сегментированная кнопка API ( IFC8FB )
Разделители теперь имеют параметр для управления ориентацией для поддержки вертикальных разделителей. ( I4c899 , b/288438593 )

Изменения API

Мы перемещаем зависимость плотности на уровень компонентов. Это относится к следующим компонентам: SwipeToDismiss и листовые компоненты. Пожалуйста, используйте новую перегрузку, предоставленную там, где плотность является параметром. ( I1846E )
Дополнительные аннотации для указания разрешенных входов в композиции ( IEF234 )
Добавьте параметр значка в сегментированную кнопку, разделенную семантику, чтобы сегментированные кнопки можно было выбрать для реализации однопользования и под необходимыми для реализации многопользователя, с SelectableSegmentedButtonRow и ToggelableSegmentedButtonRow соответственно. ( I38740 )
Разделитель был переименован в HorizontalDivider . Добавлена функциональность VerticalDivider . ( I5975c )
Измените использование ClosedFloatingPointRange для более легкого FloatRange веса в экспериментальном материале3 API, чтобы минимизировать автобоксинг. ( I4aab5 )
Добавлен новый стартовый выравнивание для FabPosition ( IB7AEA , B/170592777 )

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

ModalBottomSheet уважает направление локальной планировки. ( IB4F44 , B/285628622 )

Версия 1.2.0-Alpha03

21 июня 2023 г.

androidx.compose.material3:material3-*:1.2.0-alpha03 выпускается. Версия 1.2.0-Alpha03 содержит эти коммиты.

Поведение изменяется

includeFontPadding теперь является false по умолчанию в типографии Материала 3. Стиль Typography lineHeight по умолчанию также был изменен на Trim.None и Alignment.Center TextStyle Проконсультируйтесь с документами API, если вы хотите настроить эти значения, и посмотрите пост в блоге для углубленного объяснения этих изменений. ( I6266f , icabc3 )

Новые возможности

Добавлена перегрузка для RangeSlider , которая является современной версией компонента. Созданный RangeSliderState , который содержит всю информацию для текущей активной дорожки, измерения компонентов RangeSlider и логики перетаскивания и жеста. ( I8c270 )
Поисковой панель теперь поддерживает тени через недавно добавленный параметр shadowElevation . ( IA5369 , B/271040353 )
ColorScheme теперь поддерживает новые роли SurfaceContainer .
Поверхностное тональное наложение теперь может быть отключено с помощью локальной композиции LocalTonalElevationEnabled . ( IC203C , B/277774590 )

Изменения API

Откройте конструкторы цветов компонентов. ( I8c4a6 )
Добавление фокусируемого параметра в обоих API -интерфейсов инструментов, чтобы разработчики могли иметь подсказку, потребляя сенсорные события или нет. Будьте осторожны, что это может сломать автоматическое обход. ( IE32D8 )
Оптимизированная доступность для производительности и распределения памяти. ( Iede48 )
Разоблачить DefaultSizeClasses и создавать StandardSizeClasses для WindowSizeClasses ( i91838 )
Изменить WindowWidth/HeightSizeClass на классы значений с плаванием ( IE686E )

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

Параметр contentWindowInsets от ContentWindowinsets теперь уважает потребляемые оконные вставки. Обратите внимание, что поведение контента на основе topBar и bottomBar остается неизменным, когда эти параметры предоставляются. ( I08B73 , B/264601542 )
Установите выравнивание центральной верхней панели приложений, чтобы убедиться, что длинный заголовок не отображает значки действия или значок навигации. ( I4369f , b/236994621 )
Положения вкладок теперь обеспечивают минимальную ширину содержания 24.dp. Это обеспечивает доступную сенсорную цель для индикаторов вкладок. ( ID8861 )
Динамические цветовые палитры из dynamicLightColorScheme и dynamicDarkColorScheme теперь поддерживают новые роли поверхности. ( I1252E )
Обновление выравнивания уведомлений о значке, чтобы не обрезать при столкновении с прабабушкой. ( IDF75A )

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

24 мая 2023 г.

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

Изменения API

Добавьте параметр Window Insets в ModalBottomSheet .
- Scrim для ModalBottomSheet теперь может быть нарисован за панелью состояния с windowInsets установленным на ноль
- Обновленная функциональность ModalBottomSheet по умолчанию, чтобы оставаться за пределами системных баров, включая навигацию
- Обработка стержней состояния обеспечивается ручкой перетаскивания в режиме края к краю.
- BottomSheetDefaults включает в себя оконные вставки для BottomSheetWindow . ( I31200 , b/274872542 , b/272973615 , b/2723344475, b/268432129 , b/275849044 , b/275486106 , b/268433162 )
Установите Indicator и добавьте Primary / SecondaryIndicator чтобы соответствовать спецификациям M3. PrimaryIndicator соответствует ширине контента вкладки, тогда как SecondaryIndicator охватывает полную доступную ширину. SecondaryIndicator эквивалентен ныне устаревшему Indicator и может быть прямой заменой. ( I27604 )
Добавлена опция для прохождения в ScrollState при конструировании DropdownMenu или ExposedDropdownMenu для управления вертикальным состоянием прокрутки отображаемых пунктов меню. ( IA0734 , B/1853044441 )
Добавлена перегрузка для Slider , которая является современной версией компонента. Создан SliderState , который содержит всю информацию для текущей активной дорожки, измерения компонентов Slider и логику перетаскивания и жеста. ( I124A5 )
Переименование Семантики isContainer в isTraversalGroup ( I121F6 )
Добавлены оптимизированный TextStyle.merge(...) с полным списком параметров. ( IAD234 , B/246961787 )
Сделанные интерфейсы TooltipState , RichTooltipState и PlainTooltipState . Добавлены RichTooltipStateImpl и PlainTooltipStateImpl для состояний по умолчанию. Добавлено remember*State функции для получения этих реализованных состояний. Удален TooltipSync в пользу TooltipDefault.GlobalMutatorMutex . ( I7813d )
Обновлено DatePickerColors , чтобы включить дополнительные параметры настройки для разделителя, навигации и поля текста. ( I1A685 , B/274626815 )
DatePickerState и The DateRangePickerState в настоящее время являются публичными интерфейсами с реализациями по умолчанию, которые могут быть извлечены с помощью rememberDatePickerState и rememberDateRangePickerState . ( I71c52 )
Удалили dateValidator из DatePicker и DateRangePicker и представил интерфейс SelectableDates , который можно установить в состояние для управления, какие даты или годы выбираются в пользовательском интерфейсе. ( IC2FC6 )
TimePicker удален из стабильного API, в государственном API ожидаются дальнейшие изменения ( I3F39A )
ModalBottomSheet переехал только в Android. ModalBottomSheet не рекомендуется для использования настольных компьютеров, и функциональность не поддерживается активно. ( IB3778 )

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

Исправлена AlertDialog отклоните действие, чтобы появиться ниже подтвержденного действия, когда действия, сложенные друг на друга, чтобы вписаться в ширину диалога. Это исправление выравнивает реализацию со спецификацией дизайна материала. ( I029DE , B/235454277 )
Исправлена ошибка в ListItem используя неправильную прокладку для трехстрочных элементов. ( I6e235 )
ModalBottomSheet теперь может отображать клавиатуру IME ( IDC508 , B/262140644 , B/268380384 , B/272483584 )

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

10 мая 2023 года

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

Версия 1.1

Версия 1.1.2

20 сентября 2023 г.

androidx.compose.material3:material3:1.1.2 и androidx.compose.material3:material3-window-size-class:1.1.2 выпускаются. Версия 1.1.2 содержит эти коммиты.

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

Фиксированный модификатор неправильно передается в два композиционных устройства. ( B/282761472 )
Фиксированная TimePickerState возвращает неверные часы при инициативе за 23 часа. ( B/278242122 )
Исправлено начальное состояние переключения для полудня и мельчайшая проверка. ( B/269768197 , B/282790635 )
Фиксированное state.hour возвращает неправильное значение за 11 вечера. ( B/282761472 , B/278242122 )

Версия 1.1.1

21 июня 2023 г.

androidx.compose.material3:material3:1.1.1 и androidx.compose.material3:material3-window-size-class:1.1.1 выпускаются. Версия 1.1.1 содержит эти коммиты.

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

Добавляет звонок для ModalBottomSheet без windowInset Param для двоичной совместимости. ( IB7959 )
Добавьте параметр Window Insets в ModalBottomSheet .
- Scrim для ModalBottomSheet теперь может быть нарисован за панелью состояния с windowInsets установленным на ноль
- Обновленная функциональность ModalBottomSheet по умолчанию, чтобы оставаться за пределами системных баров, включая навигацию
- Обработка стержней состояния обеспечивается ручкой перетаскивания в режиме края к краю.
- BottomSheetDefaults включает в себя оконные вставки для BottomSheetWindow . ( I31200 , b/274872542 , b/272973615 , b/2723344475, b/268432129 , b/275849044 , b/275486106 , b/268433162 )

Версия 1.1.0

10 мая 2023 года

androidx.compose.material3:material3:1.1.0 и androidx.compose.material3:material3-window-size-class:1.1.0 выпускаются. Версия 1.1.0 содержит эти коммиты.

Основные особенности 1.1.0

Новый дизайн материала 3 компоненты

Улучшения для существующих компонентов дизайна материала 3.

Продвижение экспериментальных API до стабильной!

Пожалуйста, смотрите этот пост в блоге для получения более подробной информации!

Версия 1.1.0-rc01

19 апреля 2023 года

androidx.compose.material3:material3:1.1.0-rc01 и androidx.compose.material3:material3-window-size-class:1.1.0-rc01 выпускаются. Версия 1.1.0-rc01 содержит эти коммиты.

Изменения API

TimePicker удален из стабильного API, в государственном API ожидаются дальнейшие изменения ( I3F39A )
ModalBottomSheet переехал только в Android. ModalBottomSheet не рекомендуется для использования настольных компьютеров, и функциональность не поддерживается активно. ( IB3778 )

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

5 апреля 2023 г.

androidx.compose.material3:material3:1.1.0-beta02 и androidx.compose.material3:material3-window-size-class:1.1.0-beta02 выпускаются. Версия 1.1.0-beta02 содержит эти коммиты.

Изменения API

SheetState теперь имеет дополнительный параметр skipHiddenState
rememberStandardBottomSheetState теперь имеет дополнительный параметр skipHiddenState
BottomSheetScaffold теперь имеет определенное скрытое якорь, хотя по умолчанию он отключен
SheetState.requireOffset документация была обновлена
BottomSheetDefaults.MinimizedShape был переименован в BottomSheetDefaults.HiddenShape ( I839F4 , B/273870234 )

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

Не переключайте лицевое лицо от часа на минуту, когда включена исследование. ( I717d0 )
ModalBottomSheet и BottomSheetScaffold Drag Handling Semantics теперь объединены. ( I05afb )
Модификатор BottomSheetScaffold , параметры containerColor и contentColor теперь влияют только на содержание. ( I992CB )
BottomSheetScaffold nestedScroll для содержимого листа теперь реализует щели. ( I992CB )

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

22 марта 2023 года

androidx.compose.material3:material3:1.1.0-beta01 и androidx.compose.material3:material3-window-size-class:1.1.0-beta01 выпускаются. Версия 1.1.0-beta01 содержит эти коммиты.

Изменения API

Добавить тип макета в композицию TimePicker . Он позволяет использовать разные макеты, в зависимости от конфигурации экрана ( IA0E16 )
SearchBarDefaults был отмечен как экспериментальный. ( I65561 )
Добавлено поднятие тени в BottomSheetScaffold ( i94e0f )
Добавлена поддержка для отображения сборщиков даты без части заголовка. API меняется, чтобы разрешить передачу нулевого заголовка при создании выбора даты. Теперь вы можете передать нулевой заголовок, заголовок и showToggleMode = false чтобы отобразить безголовный сборщик. ( Id3f3a , b/266132421 , b/267194809 )

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

Поисковые панели теперь автоматически очищают фокус, когда становятся неактивными. ( 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 )

Version 1.1.0-alpha06

8 февраля 2023 г.

androidx.compose.material3:material3:1.1.0-alpha06 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 are released. Version 1.1.0-alpha06 contains these commits.

Новые возможности

Text fields now support prefix and suffix text ( Ia8578 , b/179884561 )
Added a TimePicker function to show a time picker following the Material 3 spec, used in conjunction 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 )

Version 1.1.0-alpha05

26 января 2023 г.

androidx.compose.material3:material3:1.1.0-alpha05 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 are released. Version 1.1.0-alpha05 contains these commits.

Новые возможности

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

Dependency Updates

Compose UI and Compose Material now depend on Lifecycle 2.6.0 .

Version 1.1.0-alpha04

11 января 2023 г.

androidx.compose.material3:material3:1.1.0-alpha04 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 are released. Version 1.1.0-alpha04 contains these commits.

Новые возможности

Initial DatePicker API for picking a single date via a calendar UI. This API is still undergoing changes. ( I722b9 )
Added support for plain tooltips via PlainTooltipBox . ( I0cdfb )
Search bar ( Iad128 )
SwipeToDismiss ( I458a8 , b/242889540 )

Изменения API

Added in IsContainer semantics property on Surfaces. This property will be used in a later change that determines traversal order based on the semantic meaning of elements such as surfaces. ( I63379 )
Mark navigation drawer related APIs as stable. ( Iab01e , b/261439597 )
Added a track color parameter for circular progress indicators, and a stroke cap parameter for both circular and linear progress indicators. ( Ie668c , b/216325962 , b/222964817 )
More return type nullability of deprecated-hidden functions ( Ibf7b0 )
Add Modifier.minimumInteractiveComponentSize . It can be used to reserve at least 48.dp in size to disambiguate touch interactions if the element would measure smaller. ( I33f58 , b/258495559 )
Added experimental API for AlertDialog composable that has a content slot. ( Iec4a2 )

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

Progress for progress indicators is now properly bounded to its expected range. ( I8a7eb , b/262262727 )

Known Issue

When updating from androidx.compose.foundation:1.4.0-alpha03 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.

Version 1.1.0-alpha03

7 декабря 2022 г.

androidx.compose.material3:material3:1.1.0-alpha03 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 are released. Version 1.1.0-alpha03 contains these commits.

Изменения API

Renamed consumedWindowInsets() 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.

Dependency Updates

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

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

9 ноября 2022 г.

androidx.compose.material3:material3:1.1.0-alpha02 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 are released. Версия 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

October 24, 2022

androidx.compose.material3:material3:1.1.0-alpha01 and androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 are released. Версия 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

9 ноября 2022 г.

androidx.compose.material3:material3:1.0.1 and androidx.compose.material3:material3-window-size-class:1.0.1 are released. Version 1.0.1 contains these commits.

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

Updates Material3 Medium and Large top app bars to apply the same background color across their entire surface, and to allow setting overriding the default colors with transparent color values. ( I67659 , b/249688556 , b/250838918 )

Версия 1.0.0

October 24, 2022

androidx.compose.material3:material3:1.0.0 and androidx.compose.material3:material3-window-size-class:1.0.0 are released. Версия 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

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
Dialogs
- AlertDialog
Разделитель
- Разделитель
Dropdown Menu
- DropdownMenu , DropdownMenuItem , ExposedDropdownMenuBox
Список
- ListItem
Панель навигации
- NavigationBar
Navigation drawer
- ModalNavigationDrawer , ModalDrawerSheet , DismissibleNavigationDrawer , DismissibleDrawerSheet , PermanentNavigationDrawer , PermanentDrawerSheet
Navigation rail
- NavigationRail
Progress Indicator
- CircularProgressIndicator , LinearProgressIndicator
Radio Button
- RadioButton
Слайдер
- Slider , RangeSlider
Выключатель
- Выключатель
Вкладки
- Tab , LeadingIconTab , TabRow , ScrollableTabRow
Text Fields
- TextField , OutlinedTextField
Top app bar
- TopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
Икона
- Icon , IconButton
Текст
- Текст
Поверхность
- Поверхность
Макет
- Строительные леса
Content color
- 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 )

Version 1.0.0-beta03

September 21, 2022

androidx.compose.material3:material3:1.0.0-beta03 and androidx.compose.material3:material3-window-size-class:1.0.0-beta03 are released. Version 1.0.0-beta03 contains these commits.

Изменения API

ExposedDropdownMenuDefaults now exposes a padding value for menu items. ( I34ee1 )
ExposedDropdownMenuBoxScope now has 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 )

Version 1.0.0-beta02

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

androidx.compose.material3:material3:1.0.0-beta02 and androidx.compose.material3:material3-window-size-class:1.0.0-beta02 are released. Version 1.0.0-beta02 contains these commits.

Изменения API

Default components insets introduced in m3 components in beta01 version no longer account for IME insets.
Material3 Scaffold component now has a contentWindowInsets parameter, allowing to specify the amount of insets to handle for the content slot. ( Icf11a , b/243713323 )
Deprecates the experimental Material 3 SmallTopAppBar function and introduces an 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-бета01

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

August 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

June 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 )
Interfaces in compose libraries are now built using jdk8 default interface methods ( 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 )

Version 1.0.0-alpha12

May 18, 2022

androidx.compose.material3:material3:1.0.0-alpha12 and androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 are released. Version 1.0.0-alpha12 contains these commits.

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

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

Version 1.0.0-alpha11

May 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

April 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

March 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

February 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 )

Version 1.0.0-alpha05

9 февраля 2022 г.

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

Новые возможности

Added Material Design 3 components

Dropdown menu
- 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 )

Version 1.0.0-alpha04

26 января 2022 г.

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

Изменения API

Added NonRestartableComposable to methods that are overloads of existing methods without complex logic. This reduces compiler generated memoization checks (equals) for all parameters which are repeated in the inner function that is called. ( I90490 )
Added Material 3 divider. ( Ica5fc )
Mark the Checkbox and RadioButton with an experimental API annotation. ( Ie44bb )
Added support for Material 3 progress indicators. ( Iff232 , b/205023841 )

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

Update a disabled TextButton's container color to be transparent ( I6b248 , b/213339737 )

Version 1.0.0-alpha03

12 января 2022 г.

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

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

Add LocalIndication to Material 3's MaterialTheme . ( I7ce4e )
Fix the corner radius that is applied for Checkboxes ( I38b03 , b/175198975 , b/202309440 )

Dependency Updates

Now depends on Kotlin 1.6.10 .

Version 1.0.0-alpha02

December 1, 2021

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

Новые возможности

Add support for checkbox and radiobutton.
Updated to be compatible with Kotlin 1.6.0

Изменения API

Remove drawer from Material 3's scaffold. ( I04f51 )
Adds Material 3 Checkbox support. ( Id5542 )
Adds Material 3 RadioButton support. ( I20334 )

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

Reduce IconButton ripple radius from 40dp to 20dp. ( I68bbe , b/206674345 )
Port string fast path for Text changes 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. Версия 1.0.0-alpha01 содержит эти коммиты.

Новые возможности

Material Design 3 theming and Material You dynamic color

Material Design 3 components

Кнопки
- Button , ElevatedButton , FilledTonalButton , OutlinedButton , TextButton
FAB and extended FAB
- SmallFloatingActionButton , FloatingActionButton , LargeFloatingActionButton , ExtendedFloatingActionButton
Dialogs
- AlertDialog
Панель навигации
- NavigationBar
Navigation drawer
- NavigationDrawer
Navigation rail
- NavigationRail
Top app bar
- SmallTopAppBar , CenterAlignedTopAppBar , MediumTopAppBar , LargeTopAppBar
Значок
- Badge , BadgedBox
Икона
- Icon , IconButton
Текст
- Text
Поверхность
- Surface
Макет
- Scaffold
Content color
- LocalContentColor

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