Compose Material 3
最近更新时间 | 稳定版 | 候选版 | Beta 版 | Alpha 版 |
---|---|---|---|---|
2024 年 9 月 4 日 | 1.3.0 | - | - | - |
结构
Compose 由 androidx
中的 7 个 Maven 组 ID 构成。每个组都包含一套特定用途的功能,并各有专属的版本说明。
下表介绍了各个组的内容,点击链接即可查看其版本说明。
组 | 说明 |
---|---|
compose.animation | 在 Jetpack Compose 应用中构建动画,丰富用户体验。 |
compose.compiler | 借助 Kotlin 编译器插件,转换 @Composable functions(可组合函数)并启用优化功能。 |
compose.foundation | 使用现成可用的构建块编写 Jetpack Compose 应用,还可扩展 Foundation 以构建您自己的设计系统元素。 |
compose.material | 使用现成可用的 Material Design 组件构建 Jetpack Compose UI。这是更高层级的 Compose 入口点,旨在提供与 www.material.io 上描述的组件一致的组件。 |
compose.material3 | 使用 Material Design 3(新一代 Material Design)组件构建 Jetpack Compose UI。Material 3 中包括了更新后的主题和组件,以及动态配色等 Material You 个性化功能,旨在与新的 Android 12 视觉风格和系统界面相得益彰。 |
compose.runtime | Compose 编程模型和状态管理的基本构建块,以及 Compose 编译器插件的目标核心运行时。 |
compose.ui | 与设备互动所需的 Compose UI 的基本组件,包括布局、绘图和输入。 |
声明依赖项
如需添加 Compose 的依赖项,您必须将 Google Maven 制品库添加到项目中。如需了解详情,请参阅 Google 的 Maven 制品库。
在应用或模块的 build.gradle
文件中添加所需工件的依赖项:
Groovy
dependencies { implementation "androidx.compose.material3:material3:1.3.0" implementation "androidx.compose.material3:material3-window-size-class:1.3.0" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha01" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.3.0") implementation("androidx.compose.material3:material3-window-size-class:1.3.0") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha01") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
如需详细了解依赖项,请参阅添加 build 依赖项。
反馈
您的反馈将帮助我们改进 Jetpack。如果您发现了新问题,或对此库有任何改进建议,请告诉我们。创建新问题前,请先查看此库中的现有问题。您可以点击星标按钮,为现有问题投票。
如需了解详情,请参阅问题跟踪器文档。
Compose Material3 通用版本 1.0
版本 1.0.0-alpha01
2024 年 4 月 17 日
发布了 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 组件的无主题组件:
- 色调调色板
<ph type="x-smartling-placeholder">
- </ph>
TonalPalette
- 图标
- 触摸目标大小 <ph type="x-smartling-placeholder">
Compose Material3 Adaptive Navigation Suite 版本 1.0
版本 1.0.0-alpha07
2024 年 5 月 1 日
发布了 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)
bug 修复
- 默认情况下使用内容边衬区 (50266df)
版本 1.0.0-alpha06
2024 年 4 月 17 日
发布了 androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06
、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06
和 androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06
。版本 1.0.0-alpha06 中包含这些提交内容。
API 变更
- 将
containerColor
和contentColor
添加到NavigationSuiteScaffoldDefaults
。(I64e3a、b/331993720) - 正在向
NavigationSuiteDefaults
添加itemColors
函数。(Idf719、b/328480012) - 将
NavigationSuiteScope
设为密封状态。(Iefa57)
版本 1.0.0-alpha05
2024 年 3 月 6 日
发布了 androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05
、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05
和 androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05
。版本 1.0.0-alpha05 中包含这些提交内容。
API 变更
- 将
NavigationSuiteItemColors
构造函数设为公开。(Ica83a、b/324886877)
版本 1.0.0-alpha04
2024 年 2 月 21 日
发布了 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 中包含这些提交内容。
依赖项更新
版本 1.0.0-alpha03
2024 年 2 月 7 日
发布了 androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03
、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03
和 androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03
。版本 1.0.0-alpha03 中包含这些提交内容。
API 变更
- 将软件包名称从 navigation-suite 更新为 navigationsuite (I7eff7)
- 更新了在其 API 中公开
MutableInteractionSource
的 Material3 组件,现在公开了一个可为 null 的MutableInteractionSource
(默认为 null)。这里没有语义更改:传递 null 表示您不希望提升MutableInteractionSource
,系统将根据需要在组件内创建它。如果更改为 null,则某些组件永远不会分配MutableInteractionSource
,而允许其他组件仅在需要时延迟创建实例,从而提高这些组件的性能。如果您未使用传递给这些组件的MutableInteractionSource
,建议您改为传递 null。此外,我们还建议您在自己的组件中进行类似的更改。(I41abb、b/298048146)
版本 1.0.0-alpha02
2023 年 12 月 13 日
发布了 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)
bug 修复
- 修复了当根 Surface 具有
modifier.fillMaxSize
时填充整个屏幕的导航组件。(c9cf250、b/312664933)
版本 1.0.0-alpha01
2023 年 11 月 15 日
发布了 androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01
。版本 1.0.0-alpha01 中包含这些提交内容。
新功能
- NavigationSuiteScaffold <ph type="x-smartling-placeholder">
Compose Material3 Adaptive 版本 1.0
版本 1.0.0-alpha06
2024 年 2 月 7 日
发布了 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 中包含这些提交内容。
新功能
版本 1.0.0-alpha05
2024 年 1 月 24 日
发布了 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 中包含这些提交内容。
新功能
- 在 Scaffold 导航和值计算中支持历史记录感知功能 (I71d46)
版本 1.0.0-alpha04
2024 年 1 月 10 日
发布了 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 中包含这些提交内容。
新功能
- 在窗格 Scaffold 中添加了全屏支持 (I1b462)
API 变更
- 将 Posture 中的合页边界属性移到了合页信息列表 (I24f90)
bug 修复
- 修复了
AnimatedPane
不重组的问题 (c3f573d)
版本 1.0.0-alpha03
2023 年 12 月 13 日
发布了 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) - 为基架角色创建基类 (I4784d)
- 从
AnimatedPane
的内容中移除了不必要的参数 (Ibc73b) - 重命名了
collectWindowSizeAsState
并改为返回原始值 (I480f4)
版本 1.0.0-alpha02
2023 年 11 月 29 日
发布了 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 变更
bug 修复
- 修复了未使用
AnimatedPane
时不切换窗格的问题 (d88f181)
版本 1.0.0-alpha01
2023 年 11 月 15 日
发布了 androidx.compose.material3:material3-adaptive:1.0.0-alpha01
。版本 1.0.0-alpha01 中包含这些提交内容。
新功能
Material3 自适应条件 API:
Material3 自适应窗格 Scaffold 指令 API:
- PaneScaffoldDirective <ph type="x-smartling-placeholder">
Material3 自适应窗格 Scaffold API:
- 窗格 Scaffold 基本 API <ph type="x-smartling-placeholder">
Compose Material3 版本 1.3
版本 1.3.0
2024 年 9 月 4 日
发布了 androidx.compose.material3:material3-*:1.3.0
。版本 1.3.0 中包含这些提交内容。
自 1.2.0 以来的重要变更
1.3.0 的主要功能
新的 Material Design 3 组件
- 轮播界面
<ph type="x-smartling-placeholder">
- </ph>
HorizontalMultiBrowseCarousel
和HorizontalUncontainedCarousel
增强了现有 Material Design 3 组件。
- [
ModalBottomSheet
] 现在支持 U+ 上的预测性返回(Iccf32、b/281967264、b/304850357) - [
SearchBar
] 现在支持 U+ 上的预测性返回 (I657f8) - 抽屉式导航栏(
ModalDrawerSheet
和DismissibleDrawerSheet
)现在支持 U+ 上的预测性返回功能 (Ie5b0b) DropdownMenu
现在支持自定义颜色、形状、高度和边框。(I8e981、b/289554448、b/301887035、b/283654243)- 更新了滑块,通过添加间隙和停止指示器来改进无障碍功能。(I3058e)
- 更新了
ProgressIndicator
,通过添加间隙和停止指示器改进了无障碍功能。(I21451) - 为丰富的提示添加了默认插入符号,支持在给定锚点
LayoutCoordinates
的情况下绘制自定义插入符号。(Ifd42c) 重大变更 - 新增了拉取刷新 API:
<ph type="x-smartling-placeholder">
- </ph>
- 将
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
中的 Surface 和背景颜色默认值进行了小幅调整。(I9db52) - 更新了滑块颜色和
ProgressIndicator
颜色,以符合新的非文本对比度规范。(I26807) SurfaceContainer
变体现在由组件使用。使用Surface
和TonalElevation
正式计算颜色的组件现在默认使用SurfaceContainer
角色,这些角色不受色调高度的影响。(b/304584161)- 我们稍微调整了 Surface 和 Surface 容器基准角色,在浅色和深色主题中提供更多的着色。(I677a5)
- 将实验性 API 升级到了稳定版!
- 提升了性能
版本 1.3.0-rc01
2024 年 8 月 21 日
发布了 androidx.compose.material3:material3-*:1.3.0-rc01
。版本 1.3.0-rc01 中包含这些提交内容。
bug 修复
ModalBottomSheet
现在按语义遍历顺序排列,其次是纱罩。(I436f9、b/358594665)
版本 1.3.0-beta05
2024 年 7 月 24 日
发布了 androidx.compose.material3:material3-*:1.3.0-beta05
。版本 1.3.0-beta05 包含这些提交内容。
- 修复了在 Android N 和 O 上
BottomSheet
内容缺失或被截断的问题 (a10a2d) - 增加了滑块的语义边界,以便
TalkBack
在拇指周围正确显示焦点指示标志。(0b5a1d)
版本 1.3.0-beta04
2024 年 6 月 26 日
发布了 androidx.compose.material3:material3-*:1.3.0-beta04
。版本 1.3.0-beta04 包含这些提交内容。
版本 1.3.0-beta03
2024 年 6 月 12 日
发布了 androidx.compose.material3:material3-*:1.3.0-beta03
。版本 1.3.0-beta03 包含这些提交内容。
外部贡献
- 使
androidx.compose.material3.DropdownMenu
可通过通用源代码集使用。(If62c0)
版本 1.3.0-beta02
2024 年 5 月 29 日
发布了 androidx.compose.material3:material3-*:1.3.0-beta02
。版本 1.3.0-beta02 包含这些提交内容。
API 变更
Modifier.pullToRefreshIndicator
支持高度,请更新 Pull To Refresh API 以将其启用为布尔值,而不是 lambda。支持在PullToRefreshBox
中对齐内容 (I75679)- 将
TooltipScope
设为密封接口,并创建要在TooltipBox
和标签中使用的内部实现。(I3833e) - 向
CarouselItemScope
添加了两个新的修饰符(maskClip
和maskBorder
),以便轻松向任何轮播项添加形状和边框 (Id67a1) TimePickerState
现在是一个接口,可用于设置时间 (I88546)- 更新了用于设置链接样式的 API:将
TextLinkStyles
移到了TextStyle
中,并从 Material 中移除了TextDefaults
。(I5477b)
bug 修复
ModalBottomSheet
状态和导航栏图标现在会响应深色主题状态。(Ie1fe7、b/338342149)- 为
ModalBottomSheet
纱罩添加了关闭工作表语义。(0e61cb、b/328801864)
外部贡献
版本 1.3.0-beta01
2024 年 5 月 14 日
发布了 androidx.compose.material3:material3-*:1.3.0-beta01
。版本 1.3.0-beta01 包含这些提交内容。
API 变更
- 使用
DpSize
而非CaretProperties
。正在移除“CaretProperties
”。将CaretScope
重命名为TooltipScope
。(Id9a76) - 更新了用于在文本中获取 Material 主题链接的 API。具体而言,从
TextDefaults
中移除了用于构建主题LinkAnnotations
的方法,并使用主题链接解析 HTML。而是添加了一个TextLinkStyles
类,用于以参数的形式将链接设置为 Text 可组合项的样式。(I31b93)
版本 1.3.0-alpha06
2024 年 5 月 1 日
发布了 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
设为了可为 null。如需停用涟漪效果,请不要通过isEnabled = false
提供RippleConfiguration
,而是向LocalRippleConfiguration
提供null
。(I22725) - 启用无边框后,
ModalBottomSheet
可在状态栏上更准确地绘制纱罩。模态底部工作表内容现在可以使用窗口边衬区,从而允许在导航栏上方显示内容。ModalBottomSheet
参数windowInsets
已重命名为contentWindowInsets
,以指定将在何处应用边衬区,这些元素不再与窗口逻辑相关联。contentWindowInsets
类型已更改为返回WindowInsets
的函数,以便在新窗口中对其进行解析。(I39630、b/274872542、b/300280229、b/290893168) PrimaryScrollableTabRow
和SecondaryScrollableTabRow
现在使用自定义布局而不是子组合,这应该会提升性能。(I991e0)- 除了常规样式设置外,文字链接还有按下状态样式选项,以及悬停和聚焦。每个
TextDefaults
方法都有一个pressedStyle
参数来支持这一点。(Ic473f、b/139312671)
bug 修复
- 抽屉式导航栏拖动锚点现在与
drawerContent
的宽度相匹配。(Ibc72f、b/245355396) - 现在,标签的
OutlinedTextField
上内边距会考虑系统字体大小。(Idc781) - 修复了
CalendarLocale
的软件包位置。(Ifa235) - [预测性返回] 更新了预测性返回动画,以使用 (0.1, 0.1, 0, 1) 的插值曲线 (I2591a)
版本 1.3.0-alpha05
2024 年 4 月 17 日
发布了 androidx.compose.material3:material3-*:1.3.0-alpha05
。版本 1.3.0-alpha05 中包含这些提交内容。
新功能
SearchBar
和DockedSearchBar
具有接受文本字段参数的新过载。这样,您就可以将文本字段的样式与搜索栏的其余部分分开设置,还可以传入自定义文本字段。当前实现的文本字段已作为SearchBarDefaults.InputField
提供。(I50c73、b/275074248、b/278773336、b/326627700)- lambda
drawTick
已添加到公共 API 中,以便根据需要自定义 tick (I0c048)
API 变更
- 除了常规样式设置之外,文本链接还有按下状态样式选项,以及悬停和聚焦(I5f864、b/139312671)
- 更新了
CarouselItemInfo
,以公开用于裁剪项的遮罩 Rect (I785d8) - 从 Material 3 公共 API 中移除了
BasicTooltipState
。在 Foundation 的BasicTooltip
稳定之前,其功能会与TooltipState
合并。(Icda29) - 添加了一个
TextDefaults
对象,其中包含用于构造LinkAnnotation
和解析将MaterialTheme
应用于链接的 HTML 标记字符串的方法(I98532、b/139312671) ExposedDropdownMenuBoxScope
不再允许使用子类。公开的下拉菜单现在包含一个MenuAnchorType
,应将其传递给menuAnchor
以支持更好的 a11y。应使用此方法,而不是将focusable
传递给现已废弃的ExposedDropdownMenu
。menuAnchor
具有用于控制enabled
状态的新参数。(I55ee6、b/257209915、b/308840226)- 修复了
OutlinedButton
停用时的边框颜色。添加了采用启用状态的ButtonDefaults.outlinedButtonBorder("enabled")
过载。(Ie650b、b/318461363) - 添加了新的
CarouselItemInfo
类,用于帮助客户端获取有关商品大小的信息。(I9070c) - 不含 Surface 容器的
ColorScheme
构造函数现已废弃。请迁移到包含 Surface 容器的构造函数。(I35c11) - [轮廓]
TextFieldDefaults
“ContainerBox
”已重命名为“Container
”。(Ie8d3b)
bug 修复
- 如果
sheetSwipeEnabled
为 false,BottomSheetScaffold
将不再从嵌套滚动中滚动。(I5e1c1、b/306464779) - 移除了
IconButtonSamples.kt
中的一些ExperimentalMaterial3Api
“选择启用”注释。(I111d1)
版本 1.3.0-alpha04
2024 年 4 月 3 日
发布了 androidx.compose.material3:material3-*:1.3.0-alpha04
。版本 1.3.0-alpha04 包含这些提交内容。
新功能
- 添加了 Material3 轮播界面的两个实验版本 -
HorizontalMultiBrowseCarousel
和HorizontalUncontainedCarousel
(I88d64) - 更新了 Compose M3 抽屉式导航栏(
ModalDrawerSheet
和DismissibleDrawerSheet
),以便选择启用 U+ 上的预测性返回 (Ie5b0b) - 在 Icon 中添加了一个新 API,以允许将色调作为 lambda 传递以避免重组。(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
和DismissValue
枚举和 API。(I89ccd) - 向轮播界面的
CarouselState
伴生对象添加了实验性代码。(I94154) - 废弃了
LocalMinimumInteractiveComponentEnforcement
,并引入了LocalMinimumInteractiveComponentSize
来取代它。(I7a7ac) SearchBarColors
构造函数现已公开。(I769ca)- 向
SwipeToDismissBox
添加了gesturesEnabled
参数。(Idc59f、b/324170119) - 移除了标记为已废弃和实验性的文本字段 API。(I1305f)
版本 1.3.0-alpha03
2024 年 3 月 20 日
发布了 androidx.compose.material3:material3-*:1.3.0-alpha03
。版本 1.3.0-alpha03 包含这些提交内容。
视觉破坏性变化
- 将对焦状态叠加层更新为 0.1f,以确保足够的色彩对比度。(I7ea77)
- 对
lightColorScheme
和darkColorScheme
中的 Surface 和背景颜色默认值进行了小幅调整。(I9db52)
新功能
- 添加了用于自定义
ExposedDropdownMenu
的参数。特别是,菜单现在包含一个focusable
参数(默认为true
),在使用可编辑文本字段时,该参数应设置为false
。(I4184c、b/323694447、b/278609042)
API 变更
ScaffoldSubcomposeInMeasureFix
标志已被移除。(Ie2a4b)NavigationRailItemColors
现在标记为@Immutable
。(If6112、b/327660613)NavigationBarItemColors
现在标记为@Immutable
。(I42a30、b/298064514)- 对 Slider Track 可组合项中的参数进行了重新排序。(I9f315)
ExposedDropdownMenu
现在使用Popup
实现。行为应该相同,但使用键盘输入内容时,包含可编辑文本字段的可聚焦菜单可能会关闭。
bug 修复
- 我们稍微调整了 Surface 和 Surface 容器基准角色,在浅色和深色主题中提供更多的着色。(I677a5)
- 更新了滑块颜色和
ProgressIndicator
颜色,以符合新的非文本对比度规范。(I26807) - 将对焦状态叠加层更新为 0.1f,以确保足够的色彩对比度。(I7ea77)
- 对
lightColorScheme
和darkColorScheme
中的 Surface 和背景颜色默认值进行了小幅调整。(I9db52)
版本 1.3.0-alpha02
2024 年 3 月 6 日
发布了 androidx.compose.material3:material3-*:1.3.0-alpha02
。版本 1.3.0-alpha02 包含这些提交内容。
API 变更
- 使滑块再次处于稳定状态。将
State.onValueChangeFinished
再次设为一个值。将onValueChangeFinished
封装在rememberUpdatedState
中。(I82ab2、b/322269951) - Navigation 组件现在使用新的
SurfaceContainer
角色。DrawerDefaults
现在提供不同的standardContainerColor
和modalContainerColor
属性。DrawerDefaults.ModalDrawerElevation
现已改为0.dp
。(I7fbac) - 从
Slider
的状态中移除@Stable
,因为我们将state.onValueChangeFinished
更改为var
。(Ied34a、b/322269951) ModalBottomSheet
和StandardBottomSheet
动画规范现在是从弹簧动画更新的TweenSpec
。这解决了出现明显过载的问题。现已移除已废弃且未提供密度的SheetState
构造函数。(I7babc、b/285847707)
bug 修复
SurfaceContainer
变体现在由组件使用。使用 Surface 和TonalElevation
正式计算颜色的组件现在默认使用SurfaceContainer
角色,这些角色不受色调高度的影响。(b/304584161)- 修复了导致
ElevatedFilterChip
未选中且已停用的容器颜色变为黑色的 bug。(I400e6、b/322407043) - 修复了进度为 0 时的不确定进度指示器 (Id6582)
- 修复了 RTL 布局上的
Slider
和RangeSlider
问题 (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
颜色现已变为SurfaceContainer
。(I41630)ElevatedCard
容器颜色现在为SurfaceContainerLow
。FilledCard
的容器颜色为SurfaceContainerHighest
。(I35141)ElevatedButton
容器颜色现在为SurfaceContainerLow
。未选择FilledIconButton
现在的容器颜色为SurfaceContainerHighest
。(I792c9)- 将
TimePicker
容器颜色和时钟刻度盘颜色角色更新为SurfaceContainerHighest
。(I43b93)
版本 1.3.0-alpha01
2024 年 2 月 21 日
发布了 androidx.compose.material3:material3-*:1.3.0-alpha01
。版本 1.3.0-alpha01 中包含这些提交内容。
新功能
- 更新了 Compose M3
ModalBottomSheet
,以支持 U+ 上的预测性返回(Iccf32、b/281967264、b/304850357) - 更新了 Compose M3
SearchBar
,以支持 U+ 上的预测性返回 (I657f8) - 更新了滑块,通过添加间隙和停止指示器来改进无障碍功能。(I3058e)
- 更新了
ProgressIndicator
,通过添加间隙和停止指示器改进了无障碍功能。(I21451) - 新的富媒体提示 API 添加了为富提示的默认插入符号,现在可以在给定锚点
LayoutCoordinates
的情况下绘制自定义插入符号。(Ifd42c)
行为变更
- Material 组件已迁移到新的涟漪 API,不再查询
RippleTheme
。
API 变更
- 有趣的
drawStopIndicator
现已公开。(I3f59f) - 将
DatePicker
的formatWithSkeleton
函数标记为内部函数 (Ic65dc) DropdownMenu
现在支持自定义颜色、形状、高度和边框。(I8e981、b/289554448、b/301887035、b/283654243)- 更新了在其 API 中公开
MutableInteractionSource
的 Material3 组件,现在公开了可为 null 的MutableInteractionSource
(默认为null
)。这里没有语义更改:传递 null 表示您不希望提升MutableInteractionSource
,系统将根据需要在组件内创建它。如果更改为 null,则某些组件永远不会分配MutableInteractionSource
,而允许其他组件仅在需要时延迟创建实例,从而提高这些组件的性能。如果您未使用传递给这些组件的MutableInteractionSource
,建议您改为传递 null。此外,我们还建议您在自己的组件中进行类似的更改。(I41abb、b/298048146) - 添加了
RippleConfiguration
和LocalRippleConfiguration
,以便使用固定值对每个组件 / 子树中的涟漪进行自定义。例如,更改不受您控制的组件的颜色,或停用组件的涟漪。在大多数情况下,应使用默认值:这些 API 是自定义单个组件 / 有限子树的应急方法。对于更广泛的更改和自定义设计系统,应改用createRippleModifierNode
构建自己的涟漪。(I7b5d6、b/298048146) - 在 Material3 中添加了新的 Ripple API,该 API 取代了已废弃的
rememberRipple
。此外,还添加了临时CompositionLocal
LocalUseFallbackRippleImplementation
,以将 Material3 组件还原为使用已废弃的rememberRipple
/RippleTheme
API。此设置将在下一个稳定版中移除,仅供您提供自定义RippleTheme
的情况使用。(I34cbc、b/298048146)
bug 修复
- 移除了
ModalBottomSheet
中的 subcomposition,以提高性能。修复了ModalBottomSheet
在特定场景中与LookaheadScope
组合使用时崩溃的问题。(I2a198) - 移除了
BottomSheetScaffold
中的 subcomposition,以提高性能。修复了BottomSheetScaffold
在特定场景中与LookaheadScope
结合使用会崩溃的问题。(Ie6401) - 调整标记对齐方式,以便相对于右上角更靠近锚点内容的中心。(I18a28)
- 修复了
DateRangePicker
的无障碍问题,即“月-年”文本标题传达给屏幕阅读器、“开关控制”和“Voice Access”用户可操作。(I2ac55) - 修复了
mediumTopAppBarColors
参数顺序 bug。(Ibe64a)
版本 1.2
版本 1.2.1
2024 年 3 月 6 日
发布了 androidx.compose.material3:material3-*:1.2.1
。版本 1.2.1 中包含这些提交内容。
bug 修复
- 再次使滑块状态保持稳定。将
State.onValueChangeFinished
再次设为一个值。将onValueChangeFinished
封装在rememberUpdatedState
中。(Ie8fd0、b/322269951) - 从
Slider
的状态中移除@Stable
,因为我们将state.onValueChangeFinished
更改为var
。(I82ba1、b/322269951) - 修复了
NavigationBar
个自定义颜色,以便从默认值复制。(80a779、b/326894020) - 修复了
ExposedDropdownMenu
中的回归问题,使其再次可聚焦(3fcec1、b/323694447) - 修复了按钮颜色缓存问题 (3e5bbcb/327371655)
版本 1.2.0
2024 年 2 月 7 日
发布了 androidx.compose.material3:material3-*:1.2.0
。版本 1.2.0 中包含这些提交内容。
已知问题
- 为了改进性能,在
PrimaryTabRow
中引入了 View-Compose 互操作性渲染 bug。解决方法是将TabRow
与TabRowDefaults.PrimaryIndicator
搭配使用
自 1.1.0 以来的重要变更
新的 Material Design 3 组件
- 下拉即可刷新 <ph type="x-smartling-placeholder">
- “分段”按钮 <ph type="x-smartling-placeholder">
增强了现有 Material Design 3 组件。
- 底部应用栏(RTL 对齐,滚动时自动隐藏) <ph type="x-smartling-placeholder">
- 标签页外观更新 <ph type="x-smartling-placeholder">
- 标记(对齐方式更新)
将实验性 API 升级到了稳定版!
性能改进
- 如需了解详情,请参阅这篇博文!
版本 1.2.0-rc01
2024 年 1 月 24 日
发布了 androidx.compose.material3:material3-*:1.2.0-rc01
。版本 1.2.0-rc01 中包含这些提交内容。
bug 修复
- 修复了
mediumTopAppBarColors
参数顺序 bug。(Ibe64a) - 修复了在
CardDefaults.cardColors
中的1.2.0-beta02
中引入的以下 bug:无法根据containerColor
参数值更新contentColor
。(Iee041、b/319671246) - 修复了
1.2.0-beta02
中引入的disabledContentColor
中的 bug,并添加了小幅优化。(I6dda1、b/318428829)
版本 1.2.0-beta02
2024 年 1 月 10 日
发布了 androidx.compose.material3:material3-*:1.2.0-beta02
。版本 1.2.0-beta02 中包含这些提交内容。
已知错误
IconButtonColors
中的 bug 会默认将disabledContentColor
分配给LocalContentColor
的 Alpha (0.38f) 值,而不是用户指定的contentColor
。解决方法是明确设置disabledContentColor
。此问题将在下一版本中修复。
API 变更
- 添加了为普通
Tooltip
API 启用提示插入符号的功能。(Ibf767) SwipeToDismissState
、rememberSwipeToDismiss
和SwipeToDismissValue
均已重命名为_SwipeToDismissBox_
。(I68d6d)
bug 修复
- 修复了
ListItem
末尾填充值,以符合规范。(Ibd68b、b/305342674) - 轮廓卡片的轮廓颜色现已正确映射到
OutlineVariant
。(I75480、b/310979715) - 动态颜色现在从系统定义的颜色角色中提取。这样可提高可访问内容的对比度,并使动态配色更贴近 Material 规范。(I1de96)
- 修复了在
android:enableOnBackInvokedCallback="true"
时,Android T/13 及更高版本上的ModalBottomSheet
返回处理问题。(I728dc、b/306196110)
版本 1.2.0-beta01
2023 年 12 月 13 日
发布了 androidx.compose.material3:material3-*:1.2.0-beta01
。版本 1.2.0-beta01 中包含这些提交内容。
API 变更
- 将
TabIndicatorScope
标记为实验性。(I45c88) - 移除了提示的已弃用的实验性 API。(I438cb)
- 将新的
TabRow
重载更改为不使用子组合。这样一来,您就可以通过不同的方式使用提供的自定义修饰符构建TabRow
指示器。(Ife741) - 废弃了
DismissDirection
和DismissValue
API。这些标记已合并到SwipeToDismissValue
中,其值同时表示SwipeToDismissBox
的位置和方向。DismissState.progress
现在标记为介于0.0
和1.0
之间的FloatRange
。现已移除DismissState
已废弃的 Saver 和 Constructor。SwipeToDismiss
组件、状态和默认对象已标记为实验性。(Ib54f2)
bug 修复
PullToRefresh
的默认指示器现在是空心箭头,而不是实心三角形。(I67be3)
版本 1.2.0-alpha12
2023 年 11 月 29 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha12
。版本 1.2.0-alpha12 中包含这些提交内容。
API 变更
RangeSlider
现在接受 Kotlin 范围(例如,0f..1f
),而不是自定义FloatRange
值类。SnapFlingBehavior.kt
现在也使用 Kotlin 范围。(I025cb)- 将修饰符工厂函数标记为了
@Stable
。(Ib109f)
版本 1.2.0-alpha11
2023 年 11 月 15 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha11
。版本 1.2.0-alpha11 中包含这些提交内容。
新功能
- 实现
PullToRefreshContainer
和PullToRefreshState
,两者共同提供了一个拉取刷新实现的功能(在 Material3 中)。(I16456、b/261760718)
API 变更
- 将
SwipeToDismissBox
DismissDirection
和DismissValue
标记为实验性项。(I517b0) - 已将
SwipeToDismiss
重命名为SwipeToDismissBox
。将background
重命名为backgroundContent
,并将dismissContent
重命名为尾随content
lambda。(I7f4d3) - 将
ChipElevation
和SelectableChipElevation
的构造函数设为公开。(Ie0c48、b/308432421) - 正在添加“
ModalBottomSheetProperties
”。正在将securePolicy
移入ModalBottomSheetProperties
。将isFocusable
和shouldDismissOnBackPress
添加到ModalBottomSheetProperties
。这些新的布尔值有助于确定模态底部动作条应如何处理 IME 事件。(Iea56f、b/278216859) - 更新了
RangeSlider
和Slider
状态,以移除initialOnValueChange
、初始前缀和相应的 kdocs。(I57d30) - 废弃了
ChipBorder
类及其关联的函数调用,建议直接使用BorderStroke
。(I89cc2) - 基础工具提示 API 现为
@ExperimentalFoundationApi
。(I30b0b) - 不再废弃
TabRow
和ScrollableTabRow
。新的主要变体和次要变体均被标记为实验性变体。(I0def6) - 过滤条件和输入条状标签现在直接使用
BorderStroke
。(I07a8d) SegmentedButton
现在直接使用BorderStroke
。(I89b9b)- 将通用
AlertDialog
函数重命名为了BasicAlertDialog
,并废弃了之前的函数。(Idbe52) - 将
SwipeToDismiss
API 重命名为了SwipeDismiss
,并将新的SwipeDismiss
API 提升到了稳定版。(I14cbe) - 向提示 API 添加了
tonalElevation
和shadowElevation
。此外,由于TooltipBox
、PlainTooltip
和RichTooltip
API 是不小心发布为稳定版的,我们已将这些 API 移回实验性版本。(If0f66、b/293939035) - 将实验性芯片 API 升级到了稳定版。(Iea2c3)
- 从 Material3 可点击卡片中移除了
@ExperimentalMaterial3Api
注解。(I88dbf)
bug 修复
- 修复了以下问题:在使用嵌套式先行布局和延迟布局的情况下,
SwipeToDismiss
会崩溃。(Ica8d1、b/297226562)
版本 1.2.0-alpha10
2023 年 10 月 18 日
发布了 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
作为 lambda。这些版本应该比先前版本的性能更出色。(I824e6、b/295616656) - 将
StandardSizeClasses
重命名为了AllSizeClasses
。(I8cb07) - 组合使用窗口大小类别的计算函数。(Iad935)
bug 修复
- 修复了当显示的月份位于允许的年份边缘时,快速点击导航箭头按钮时出现
DatePicker
崩溃的问题。(I46f36、b/290954897、b/297002119) - [导航栏/栏] 支持指示器采用透明颜色。(Ie0a9b、b/267289987)
版本 1.2.0-alpha09
2023 年 10 月 4 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha09
。版本 1.2.0-alpha09 中包含这些提交内容。
API 变更
- 迁移了
ModalNavigationDrawer
和DismissibleNavigationDrawer
,以使用新的AnchoredDraggable
API。DrawerState
的animateTo
已替换为 open 和 close 方法,偏移现在以浮点数(而不是状态对象)的形式公开。您可以直接通过currentOffset
访问偏移量。(I0a72c) - 添加了非可组合函数,用于直接创建
DatePickerState
和DateRangePickerState
。必要时,这些函数可用作可组合项rememberDatePickerState
和rememberDateRangePickerState
函数的替代方案。(I70326、b/291524052) - 固定的和可滚动的
TabRows
现在具有主要变体和次要变体。这些属性会正确映射到 Material3 中定义的颜色和指示器行为。 PrimaryScrollableTabRow
和SecondaryScrollableTabRow
现在公开滚动状态。(Iec8f5、b/260572337)- 添加了新的
sheetMaxWidth
参数,开发者可以设置该参数来指定工作表跨度的最大宽度。如果所需的工作表跨越整个屏幕宽度,则可以为 参数传入 Dp.Unspecified。(Ifb7c9、b/266697696) - 将
PlainTooltipBox
和RichTooltipBox
API 重新添加为已废弃的方法。(I246fa)
bug 修复
- 修复了以下问题:使用
DatePickerFormatter
初始化DatePicker
时,具有某些日期框架在转换为日期模式(例如 YY)时保持不变。(I01f29)
版本 1.2.0-alpha08
2023 年 9 月 20 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha08
。版本 1.2.0-alpha08 中包含这些提交内容。
行为破坏性变更
ColorScheme
现在不可变,这会降低个别颜色更新的效率,但使更常见的颜色使用更高效。此更改背后的原因是,大多数应用都不会将更新各个颜色作为主要用例。 这仍然可行,但其重组次数比以前要多,反过来,我们会大幅减少所有 Material 代码的状态订阅量,并影响更多标准用例的初始化和运行时成本。(Ic447d、b/297212873)- 为了符合规范,色调高度不再在不同交互状态下呈现动画效果。(Icdd12)
API 变更
- 添加了新的
BottomAppBar
,它接受BottomAppBarScrollBehavior
作为参数,以便在滚动内容时自动隐藏它。此外,还添加了FabPosition.EndOverlay
,允许 FAB 叠加在 Scaffold 中的底部应用栏上,而不是锚定在其上方。(Iecb47) - 添加了一个简单的标签组件,该组件基于
BasicTooltipBox
构建,点按超出标签边界时不会关闭。(I821f9)
bug 修复
- 不再将
rememberSaveable
用于提示。(Icc131、b/299500338) - 引入了一个临时标志,用于控制 Scaffold 是否应在测量期间或放置期间测量其子项。默认情况下,此值以测量值进行衡量。如果您遇到与新行为有关的问题,请提交问题。(I0b354)
- 通过使用正确的设备屏幕宽度测量值,修复了
BottomSheet
中的水平无边框问题。(I1df0c、b/299058752) - 修复了通过在工作表上向下滑动来关闭
ModalBottomSheet
时不调用onDismissedRequest
的错误。(Idfdd8)
版本 1.2.0-alpha07
2023 年 9 月 6 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha07
。版本 1.2.0-alpha07 中包含这些提交内容。
新功能
compose material 1.6.0-alpha05
中添加了对自动镜像图标的支持。如需详细了解自动镜像图标,请参阅版本说明。
API 变更
SliderState
会实现DraggableState
(I9b116)- 将形状更改为必需参数。在形状辅助函数中将
position
重命名为index
。(I34941) - 更新
DatePicker
formatWithSkeleton
,以添加用作缓存以提升性能的地图。(I3195f) - 向
compose.foundation
添加了BasicTooltipBox
,并更新了PlainTooltipBox
和RichTooltipBox
,以将TooltipBox
与新的PlainTooltip
和RichTooltip
可组合项搭配使用。(I79e1d)
bug 修复
dynamicLightColorScheme
和dynamicDarkColorScheme
现在会为 Surface 和surfaceContainer
角色返回更高的色度颜色。(I5e901)- 修复了以下问题:在
LookaheadScope
内的 Scaffold 中使用 Subcomposition(例如BottomSheetScaffold
)的某些组件尝试过早读取其大小时。(I297b4、I871f1、b/295536718)
版本 1.2.0-alpha06
2023 年 8 月 23 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha06
。版本 1.2.0-alpha06 中包含这些提交内容。
bug 修复
- 修复了
DropdownMenu
的offset
计算,使 x 偏移量仅取决于本地布局方向,并且当菜单靠近屏幕底部时,y 偏移量将不再反转。(Iccc74、b/294103942) - 修复了
DropdownMenu
的offset
计算,使 x 偏移量仅取决于本地布局方向,并且当菜单靠近屏幕底部时,y 偏移量将不再反转。(Ib87a2、b/294103942)
版本 1.2.0-alpha05
2023 年 8 月 9 日
发布了 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
2023 年 7 月 26 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha04
。版本 1.2.0-alpha04 中包含这些提交内容。
新功能
- 实验性 Segmented Button API (Ifc8fb)
- 分隔线现在有一个用于控制方向的参数,以支持垂直分隔线。(I4c899、b/288438593)
API 变更
- 我们会将密度依赖项移至组件级别。这适用于以下组件:
SwipeToDismiss
和基于工作表的组件。当密度是一个参数时,请使用提供的新过载。(I1846e) - 添加了额外的注解,用于指定可组合项允许的输入 (Ief234)
- 通过分别使用
SelectableSegmentedButtonRow
和ToggelableSegmentedButtonRow
为分段按钮和分屏语义添加图标参数,使分段按钮可以选择以实现单选,且可切换以实现多选。(I38740) - 分隔线已重命名为
HorizontalDivider
。添加了VerticalDivider
功能。(I5975c) - 在实验性 Material3 API 中,针对更轻量的
FloatRange
更改了ClosedFloatingPointRange
的使用,以最大限度地减少自动装箱。(I4aab5) - 为
FabPosition
添加了新的开始对齐(Ib7aea、b/170592777)
bug 修复
ModalBottomSheet
遵循局部布局方向。(Ib4f44、b/285628622)
版本 1.2.0-alpha03
2023 年 6 月 21 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha03
。版本 1.2.0-alpha03 中包含这些提交内容。
行为变更
- 在 Material 3 排版中,
includeFontPadding
现在默认为false
。默认行高样式也已更改为Trim.None
和Alignment.Center
,并且显式lineHeight
(以 sp 为单位)已添加到Typography
的TextStyle
。如果您想自定义这些值,请参阅 API 文档。有关这些更改的深入说明,请参阅这篇博文。(I6266f、Icabc3)
新功能
- 为作为组件的有状态版本的
RangeSlider
添加了重载。创建了RangeSliderState
,用于存储当前活跃轨道的所有信息、RangeSlider
组件的测量结果以及拖动和手势逻辑。(I8c270) - 搜索栏现在支持通过新添加的
shadowElevation
参数实现阴影。(Ia5369、b/271040353) ColorScheme
现在支持新的SurfaceContainer
角色。- 现在可以使用
LocalTonalElevationEnabled
CompositionLocal 停用 Surface 色调高度叠加层。(Ic203c、b/277774590)
API 变更
- 打开组件颜色构造函数。(I8c4a6)
- 将可聚焦参数同时添加到这两个提示 API,以便开发者可以使提示不使用触摸事件。请注意,这可能会破坏无障碍功能焦点自动遍历。(Ie32d8)
- 针对性能和内存分配优化了无障碍功能。(Iede48)
- 公开
DefaultSizeClasses
并为WindowSizeClasses
创建StandardSizeClasses
(I91838) - 将
WindowWidth/HeightSizeClass
更改为浮点值类 (Ie686e)
bug 修复
- Scaffold 的
contentWindowInsets
参数现在遵循已使用的窗口边衬区。请注意,如果提供这些参数,基于topBar
和bottomBar
的内容内边距行为将保持不变。(I08b73、b/264601542) - 修复了顶部中心应用栏的对齐方式,以确保长标题不会呈现在操作图标或导航图标上。(I4369f、b/236994621)
- 现在,标签页位置会强制实施 24dp 的最小内容宽度。这为标签页指示器提供了一个可访问的触摸目标。(Id8861)
dynamicLightColorScheme
和dynamicDarkColorScheme
中的动态调色板现在支持新的 Surface 角色。(I1252e)- 更新了标志通知对齐方式,使其在与祖父级发生冲突时不被裁剪。(Idf75a)
版本 1.2.0-alpha02
2023 年 5 月 24 日
发布了 androidx.compose.material3:material3-*:1.2.0-alpha02
。版本 1.2.0-alpha02 中包含这些提交内容。
API 变更
- 向
ModalBottomSheet
添加了窗口边衬区参数。ModalBottomSheet
的纱罩现在可以在状态栏后面绘制,并将windowInsets
设置为 0- 更新了默认的
ModalBottomSheet
功能,以避免位于系统栏(包括导航)之外 - 状态栏边衬区处理由拖动手柄在无边框模式下提供。
BottomSheetDefaults
包含BottomSheetWindow
的窗口边衬区。(I31200、b/274872542、b/272973615、b/272334475、b/268432129、b/275849044、{1286b/206}、b/275、b/206})
- 废弃了
Indicator
并添加Primary
/SecondaryIndicator
,以符合 M3 规范。PrimaryIndicator
用于匹配标签页内容的宽度,而SecondaryIndicator
用于覆盖整个可用宽度。SecondaryIndicator
相当于现已废弃的Indicator
,可以直接替换。(I27604) - 添加了在构造
DropdownMenu
或ExposedDropdownMenu
时传入ScrollState
来控制所显示菜单项的垂直滚动状态的选项。(Ia0734、b/185304441) - 为作为组件的有状态版本的
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
和DateRangePickerState
现在是具有默认实现的公共接口,可由rememberDatePickerState
和rememberDateRangePickerState
检索。(I71c52)- 从
DatePicker
和DateRangePicker
中移除了dateValidator
,并引入了SelectableDates
接口,该接口可在状态上设置,以控制在界面中选择哪些日期或年份。(Ic2fc6) - 从稳定版 API 中移除了
TimePicker
,预计会在 State API 中做出进一步更改 (I3f39a) ModalBottomSheet
已转移到 Android 专用。不建议将ModalBottomSheet
用于桌面设备,并且该功能目前也不会得到积极维护。(Ib3778)
bug 修复
- 修复了当操作相互堆叠以适应对话框宽度时
AlertDialog
关闭操作显示在确认操作之下的问题。此修复使实现符合 Material Design 规范。(I029de、b/235454277) - 修复了
ListItem
中针对三行内容使用不正确的内边距的 bug。(I6e235) ModalBottomSheet
现在可以显示 IME 键盘(Idc508、b/262140644、b/268380384、b/272483584)
版本 1.2.0-alpha01
2023 年 5 月 10 日
发布了 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
2023 年 9 月 20 日
发布了 androidx.compose.material3:material3:1.1.2
和 androidx.compose.material3:material3-window-size-class:1.1.2
。版本 1.1.2 中包含这些提交内容。
bug 修复
- 修复了修饰符错误地传递给两个可组合项的问题。(b/282761472)
- 修复了
TimePickerState
在初始化为 23 小时时返回错误的小时数问题。(b/278242122) - 修复了中午和分钟验证的初始切换状态。(b/269768197、b/282790635)
- 修复了
state.hour
针对晚上 11 点返回错误值的问题。(b/282761472、b/278242122)
版本 1.1.1
2023 年 6 月 21 日
发布了 androidx.compose.material3:material3:1.1.1
和 androidx.compose.material3:material3-window-size-class:1.1.1
。版本 1.1.1 中包含这些提交内容。
bug 修复
- 添加了对不带
windowInset
参数的ModalBottomSheet
的调用,以实现二进制文件兼容性。(Ib7959) - 向
ModalBottomSheet
添加了窗口边衬区参数。ModalBottomSheet
的纱罩现在可以在状态栏后面绘制,并将windowInsets
设置为 0- 更新了默认的
ModalBottomSheet
功能,以避免位于系统栏(包括导航)之外 - 状态栏边衬区处理由拖动手柄在无边框模式下提供。
BottomSheetDefaults
包含BottomSheetWindow
的窗口边衬区。(I31200、b/274872542、b/272973615、b/272334475、b/268432129、b/275849044、{1286b/206}、b/275、b/206})
版本 1.1.0
2023 年 5 月 10 日
发布了 androidx.compose.material3:material3:1.1.0
和 androidx.compose.material3:material3-window-size-class:1.1.0
。版本 1.1.0 中包含这些提交内容。
1.1.0 的主要功能
新的 Material Design 3 组件
- 底部动作条 <ph type="x-smartling-placeholder">
- 日期选择器 <ph type="x-smartling-placeholder">
- 搜索
<ph type="x-smartling-placeholder">
- </ph>
- SearchBar、DockedSearchBar
- 滑动关闭
- 时间选择器 <ph type="x-smartling-placeholder">
- 工具提示
<ph type="x-smartling-placeholder">
- </ph>
- PlainTooltipBox、RichTooltip
增强了现有 Material Design 3 组件。
将实验性 API 升级到了稳定版!
如需了解详情,请参阅这篇博文!
版本 1.1.0-rc01
2023 年 4 月 19 日
发布了 androidx.compose.material3:material3:1.1.0-rc01
和 androidx.compose.material3:material3-window-size-class:1.1.0-rc01
。版本 1.1.0-rc01 中包含这些提交内容。
API 变更
- 从稳定版 API 中移除了
TimePicker
,预计会在 State API 中做出进一步更改 (I3f39a) ModalBottomSheet
已转移到 Android 专用。不建议将ModalBottomSheet
用于桌面设备,并且该功能目前也不会得到积极维护。(Ib3778)
版本 1.1.0-beta02
2023 年 4 月 5 日
发布了 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)
bug 修复
- 启用触摸浏览后,请勿将表盘从小时切换为分钟。(I717d0)
ModalBottomSheet
和BottomSheetScaffold
拖动手柄语义现已合并。(I05afb)BottomSheetScaffold
修饰符、containerColor
和contentColor
参数现在仅影响内容。(I992cb)- 工作表内容的
BottomSheetScaffold nestedScroll
现在可实现投掷。(I992cb)
版本 1.1.0-beta01
2023 年 3 月 22 日
发布了 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,以允许在创建日期选择器时传递 null 标题。您现在可以传递 null 标题、标题和
showToggleMode = false
,以显示无头选择器。(Id3f3a、b/266132421、b/267194809)
bug 修复
- 现在,搜索栏会在闲置时自动清除焦点。(I22a7c、b/261444487)
- 更新了
DateRangePicker
,以允许选择开始和结束日期相同的范围。(I16529、b/272882497) - 现在,当字体大小小于预期时,文本字段会正确定位其文本元素。这可能会导致您的应用因字体设置和脚本而出现一些像素变化。(I8b8d0)
- 底部动作条语义操作现在有标签。(I277b0)
版本 1.1.0-alpha08
2023 年 3 月 8 日
发布了 androidx.compose.material3:material3:1.1.0-alpha08
和 androidx.compose.material3:material3-window-size-class:1.1.0-alpha08
。版本 1.1.0-alpha08 中包含这些提交内容。
新功能
- 添加了对
BottomSheetScaffold
和BottomSheetScaffoldState
的支持。(I063d4)
API 变更
- 向
DatePickerState
和DateRangePickerState
添加了功能,以允许在初始创建状态之后设置日期,以及通过设置 null 时间戳来重置选择。手动设置日期应谨慎;如果提供的日期不符合前提条件,新的setSelection
函数将抛出异常(请参阅文档)。(Ifa645、b/268609314、b/270427389) - 将收起的
SheetValue
重命名为了PartiallyExpanded
,以便更准确灵活地描述在此状态下的行为。(Ia1491) - 将
ListItem
参数名称更新为 _content 而非 _text。现在,默认 getter 在相关情况下为ReadOnlyComposables
。(I69a25) - 从实验性阶段升级交互式 Surface API。(I90d59、b/261561812)
bug 修复
- 修复了
ModalBottomSheet
的HalfExpanded
状态计算不正确,且动作条看起来像浮动的问题。(I45e84、b/268411386) - 为
ModalBottomSheet
添加了confirmValueChange
检查,以纱罩点按。(I2311a、b/270425759) - 移动语义
BottomSheet
操作以拖动手柄。(I158ba) ModalBottomSheet
现在会在启动时命令焦点,处理返回按钮。(I4d2ab)- 现在,嵌套滚动快速滑动期间也会处理
ModalBottomSheet onDismissRequest
。(I655c5、b/268433166)
版本 1.1.0-alpha07
2023 年 2 月 22 日
发布了 androidx.compose.material3:material3:1.1.0-alpha07
和 androidx.compose.material3:material3-window-size-class:1.1.0-alpha07
。版本 1.1.0-alpha07 中包含这些提交内容。
新功能
- 添加了可与
rememberTimePickerState()
配合使用的时间输入可组合项,该可组合项遵循时间输入的 M3 规范 (Ia4fab) - 添加了 Material 3
DateRangePicker
API,用于选择日期范围。(I7a6c3、b/267194809) - 添加了 Material 3 输入模式支持,可通过
DateRangePicker
API 选择日期范围。(Ifdbc4) - 文本字段颜色现在允许自定义:
<ph type="x-smartling-placeholder">
- </ph>
- 基于焦点和错误状态的输入字段和占位符文本颜色。
textColor
形参已重命名为unfocusedTextColor
,placeholderColor
已重命名为unfocusedPlaceholderColor
。 - 已填充文本字段的容器颜色,基于新的
errorContainerColor
参数的错误状态。
- 基于焦点和错误状态的输入字段和占位符文本颜色。
- 公开的下拉菜单文本字段颜色已更新为支持新的前缀和后缀 API 的参数。(I9c8b4、b/254284181、b/264766350)
API 变更
- 还原了某些 Slider API 版本,并移除包含自定义滑块和滑道的全新实验性滑块的冗余滑块重载。将
RangeSlider
提升为稳定版。(Ie8fbd) - 在条状标签的高度函数中将
defaultElevation
重命名为elevation
。(I0f872) - 以下 Material 3 文本字段 API 不再是实验性 API:
TextField
、OutlinedTextField
、textFieldWithLabelPadding
、textFieldWithoutLabelPadding
、outlinedTextFieldPadding
。(Ieb5c0、b/261561819) TimePickers
is24Hour
使用系统设置 (I18856)- 从 Scaffold API 中移除了实验性注解。(Ibb51e、b/261565765、b/261436953)
bug 修复
ModalBottomSheet
的默认形状现在始终为SheetDefaults.ExpandedShape
。(I0dfca)- 改进了 Material 3
DatePicker
和DateRangePicker
的无障碍功能。(I5087e) - 修复了最大高度约束会传播且可能会崩溃的 bug。(I30d8c)
- 从可点击和可选择的 Surface 中移除了语义角色,更新了使用它们通过 Modifier.semantics 设置角色的组件 (I793d9)
版本 1.1.0-alpha06
2023 年 2 月 8 日
发布了 androidx.compose.material3:material3:1.1.0-alpha06
和 androidx.compose.material3:material3-window-size-class:1.1.0-alpha06
。版本 1.1.0-alpha06 中包含这些提交内容。
新功能
- 文本字段现在支持前缀和后缀文本(Ia8578、b/179884561)
- 添加了
TimePicker
函数,以显示符合 Material 3 规范的时间选择器。该函数会与TimePickerState
和便捷方法rememberTimePickerState
结合使用 (I71910) - 日期输入现在是
DatePicker
中的显示模式。添加了对在日期选择器模式和日期输入模式之间切换的支持。(Ieeff7) - 为
RichTextTooltips
添加了 API。(I58ef3) - 新增了 Material 3 的模态底部动作条实现(包括
ModalBottomSheet
和ModalBottomSheetDefaults
)。此外,还引入了SheetState
和rememberSheetState
,它们可用于未来的动作条组件。(I0853a、b/244189383)
API 变更
- 稳定了 API
showSnackbar
(I195c2、b/261424370) - 为辅助条状标签和建议内容信息条稳定了 API(Ibb67b、b/261424370)
- 将
ListItem
、ListItemDefaults
和ListItemColors
API 提升为非实验性 API(I7e7fa、b/261438882) - 将
SliderPositions
、SliderDefaults.Thumb
和SliderDefaults.Track
提升到了稳定版,并添加了包含自定义滑块和滑道的非实验性Slider
和RangeSlider
API。同时废弃了之前的Slider
和RangeSlider
API。(Ie5ea6、b/261566890) - 将
Modifier.tooltipAnchor()
设为了公开模式,以便开发者可以将其传递给锚点,以指示应在长按时显示提示。更新了PlainTooltipBox
API,使TooltipState
不再可为 null,而是现在有默认值。(Ie2fb7) ProgressIndicatorDefaults.circularTrackColor
已被标记为@Composable
,以保持一致。(Id29cc)- 恢复了属性 getter
LocalMinimuTouchTargetEnforcement
,然后将其标记为已废弃并重定向到LocalMinimumInteractiveComponentEnforcement
。(I60dd5)
版本 1.1.0-alpha05
2023 年 1 月 26 日
发布了 androidx.compose.material3:material3:1.1.0-alpha05
和 androidx.compose.material3:material3-window-size-class:1.1.0-alpha05
。版本 1.1.0-alpha05 中包含这些提交内容。
新功能
DatePickerDialog
和无障碍功能支持- 向
RangeSlider
添加了自定义滑块和滑道。
依赖项更新
Compose UI
和Compose Material
现在依赖于 Lifecycle 2.6.0。
版本 1.1.0-alpha04
2023 年 1 月 11 日
发布了 androidx.compose.material3:material3:1.1.0-alpha04
和 androidx.compose.material3:material3-window-size-class:1.1.0-alpha04
。版本 1.1.0-alpha04 中包含这些提交内容。
新功能
- 推出了通过日历界面选择单个日期的初始
DatePicker
API。此 API 仍在更改中。(I722b9) - 通过
PlainTooltipBox
添加了对普通提示的支持。(I0cdfb) - 搜索栏 (Iad128)
SwipeToDismiss
(I458a8、b/242889540)
API 变更
- 在 Surface 上添加了
IsContainer
语义属性。此属性将在稍后的更改中使用,它会根据 Surface 等元素的语义含义确定遍历顺序。(I63379) - 将与抽屉式导航栏相关的 API 标记为稳定。(Iab01e、b/261439597)
- 为圆形进度指示器添加了滑道颜色参数,并为圆形和线形进度指示器添加了描边上限参数。(Ie668c、b/216325962、b/222964817)
- 更多已废弃隐藏函数的返回值类型可为 null (Ibf7b0)
- 添加了
Modifier.minimumInteractiveComponentSize
。它可用于预留至少 48dp 的大小,以便在元素尺寸较小时消除触摸交互的歧义。(I33f58、b/258495559) - 为具有内容槽位的
AlertDialog
可组合项添加了实验性 API。(Iec4a2)
bug 修复
- 进度指示器的进度现已正确限定到预期范围。(I8a7eb、b/262262727)
已知问题
- 从
androidx.compose.foundation:1.4.0-alpha03
更新为androidx.compose.foundation:1.4.0-alpha04
时,您可能会遇到java.lang.NoSuchFieldError
错误。您可以在此处查看最初报告的问题。修复程序已提交,将在下一个 Compose 更新中发布。若要解决此问题,请将您的androidx.compose.material
和androidx.compose.material3
库更新到最新版本 (1.1.0-alpha04),或将您的androidx.compose.foundation
降级到 1.4.0-alpha03。
版本 1.1.0-alpha03
2022 年 12 月 7 日
发布了 androidx.compose.material3:material3:1.1.0-alpha03
和 androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
。版本 1.1.0-alpha03 中包含这些提交内容。
API 变更
- 将
consumedWindowInsets()
重命名为consumeWindowInsets()
,将withConsumedWindowInsets()
重命名为onConsumedWindowInsetsChanged()
,并将 Modifiers 公开。(Ie44e1) - 为具有图标的文本按钮添加了新的默认内容内边距供使用。(I8f662)
- 为导航栏和侧边栏添加了已停用的颜色。(Ia7892、b/258867034)
- 添加了 Modifier API,用于查询祖先实体滚动信息。(I2ba9d、b/203141462)
- 在手势可以变为滚动事件时,用于在
Clickable
中正确延迟按下互动。 - 修复了在
Scrollable ViewGroup
内使用时Clickables
无法正确延迟涟漪效果的问题。 - 更新了抽屉式导航栏和动作条,以便在手势可变为滚动事件时正确延迟按下操作。
依赖项更新
Compose UI
和Compose Material
现在依赖于 Lifecycle 2.5.1。(I05ab0、b/258038814)
版本 1.1.0-alpha02
2022 年 11 月 9 日
发布了 androidx.compose.material3:material3:1.1.0-alpha02
和 androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
。版本 1.1.0-alpha02 中包含这些提交内容。
API 变更
awaitFirstDown
和waitForUpOrCancellation
现在可接受PointerEventPass
,增加了灵活性(也修复了ExposedDropdownMenuBox
在滚动时显示菜单的问题)。(I7579a、b/212091796)- 在 Material 和 Material3 Text、
TextField
和OutlinedTextField
中添加了minLines
参数,从而能够根据行数设置组件的最小高度 (I4af1d) - 废弃了
TopAppBarDefaults smallTopAppBarColors
函数,取而代之的是创建TopAppBar
时应使用的新topAppBarColors
函数。(Ie6cb9) - 向
BasicText
和BasicTextField
添加了minLines
参数。它允许根据行数设置这些可组合项的最小高度(I24294、b/122476634)
bug 修复
- 将 Material3
IconButton
和IconToggleBotton
的内容裁剪到组件的状态层形状(例如圆形)上。(I9da8f) - 更新了 Material3 Medium 和 Large 顶部应用栏,以在整个界面上应用相同的背景颜色,并允许设置使用透明颜色值替换默认颜色。(I67659、b/249688556、b/250838918)
版本 1.1.0-alpha01
2022 年 10 月 24 日
发布了 androidx.compose.material3:material3:1.1.0-alpha01
和 androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
。版本 1.1.0-alpha01 中包含这些提交内容。
bug 修复
- 修复了使用 TextStyle 和 Brush 应用顶部应用栏标题时存在的问题。(If667e)
版本 1.0
版本 1.0.1
2022 年 11 月 9 日
发布了 androidx.compose.material3:material3:1.0.1
和 androidx.compose.material3:material3-window-size-class:1.0.1
。版本 1.0.1 中包含这些提交内容。
bug 修复
- 更新了 Material3 Medium 和 Large 顶部应用栏,以在整个界面上应用相同的背景颜色,并允许设置使用透明颜色值替换默认颜色。(I67659、b/249688556、b/250838918)
版本 1.0.0
2022 年 10 月 24 日
发布了 androidx.compose.material3:material3:1.0.0
和 androidx.compose.material3:material3-window-size-class:1.0.0
。版本 1.0.0 中包含这些提交内容。
1.0.0 的主要功能
这是 Compose Material 3 的第一个稳定版本!
Material Design 3 主题和 Material You 动态配色
Material Design 3 组件
- 标记
- 底部应用栏
- 按钮
- FAB 和扩展型 FAB
- 卡片
- 复选框
- 条状标签
- 对话框
- 分隔线
- 下拉菜单
- 列表
- 导航栏
- 抽屉式导航栏
- 导航栏
- 进度指示器
- 单选按钮
- Slider
- 开关
- 标签页
- 文本字段
- 顶部应用栏
- 图标
- Text
- 界面
- 布局
- 内容颜色
窗口大小类别
material3-window-size-class
是一个为窗口大小类别提供支持的新库:一组主观的视口划分点,您可以根据它们设计、开发和测试可调整大小的应用布局。您可以使用calculateWindowSizeClass
检索窗口大小类别实例,该实例可用于确定界面的显示方式,例如针对较大的窗口显示侧边导航栏(而非底部导航栏)。如需了解详情并查看用法示例,请参阅WindowSizeClass
的 API 参考文档。如需了解详情,请参阅这篇博文!
版本 1.0.0-rc01
2022 年 10 月 5 日
发布了 androidx.compose.material3:material3:1.0.0-rc01
和 androidx.compose.material3:material3-window-size-class:1.0.0-rc01
。版本 1.0.0-rc01 中包含这些提交内容。
API 变更
- 添加了槽位参数以支持文本到文本字段 API(Iaac0d、b/227146125)
版本 1.0.0-beta03
2022 年 9 月 21 日
发布了 androidx.compose.material3:material3:1.0.0-beta03
和 androidx.compose.material3:material3-window-size-class:1.0.0-beta03
。版本 1.0.0-beta03 中包含这些提交内容。
API 变更
ExposedDropdownMenuDefaults
现在公开了菜单项的内边距值。(I34ee1)ExposedDropdownMenuBoxScope
现在具有Modifier.menuAnchor()
修饰符,应将其传递到文本字段,以实现适当的 a11y 行为。(I27fa3)- 为当前的 Slider API 添加了两个过载方法,以允许用户传入滑块或滑道来填充此滑块。(I21c00)
bug 修复
- 已将“On Error”容器的深色主题颜色映射更新为色调 90 (Ic5612)
- 修复了相应问题,以允许为小型 Material 3 顶部应用栏设置透明背景。(I645e2、b/245575782)
版本 1.0.0-beta02
2022 年 9 月 7 日
发布了 androidx.compose.material3:material3:1.0.0-beta02
和 androidx.compose.material3:material3-window-size-class:1.0.0-beta02
。版本 1.0.0-beta02 中包含这些提交内容。
API 变更
- beta01 版 m3 组件中引入的默认组件边衬区不再包括 IME 边衬区。
- Material3 Scaffold 组件现在包含一个
contentWindowInsets
参数,可用于指定要为内容槽处理的边衬区量。(Icf11a、b/243713323) - 废弃了实验性 Material 3
SmallTopAppBar
函数,并引入了等效的TopAppBar
函数。请改为使用新的 TopAppBar 函数。(I74404、b/226918634) - 添加了对顶部应用栏滑动和贴靠行为的控制。(I15c81)
- 从 Divider 中移除了 startIndent,并移动了颜色以作为最后一个参数。(If7be2)
bug 修复
- 通过在对话框显示时读出 Dialog 一词,让 TalkBack 用户能识别出对话框。(I857ef)
版本 1.0.0-beta01
2022 年 8 月 24 日
发布了 androidx.compose.material3:material3:1.0.0-beta01
和 androidx.compose.material3:material3-window-size-class:1.0.0-beta01
。版本 1.0.0-beta01 中包含这些提交内容。
API 参考文档
如需查看最新的主题、组件和其他可组合项,请参阅 Compose Material 3 API 参考文档概览。
API 变更
- 更新了 Material 3 顶部应用栏,以扣合至完全收起到完全展开的状态。此外,还将
TopAppBarDefaults
行为函数更新为可组合项,并为其顶部应用栏状态和动画规格提供默认值。(I642b3) - 更新了 FAB 组件签名,以与 Surface API 匹配 (I3afaa)
- 添加了对顶部应用栏、抽屉式导航栏、导航栏和侧边栏的边衬区内置支持。这些组件单独使用或与 Scaffold 搭配使用时,会自动为开发者处理边衬区。注意:此变更不会自动处理状态栏图标以及状态栏和导航栏的透明度。请继续手动完成上述操作,以确保实现最佳无边框体验。(I7e4e6、b/183161866)
- 更新了组件默认对象,以缩减 API Surface,便于未来实现灵活性和性能改进。(I31820)
- 对条状标签和抽屉式导航栏动作条参数进行了重新排序,以便在 API 内保持一致 (I45d0b)
- 从 Divider 中移除了
startIndent
,并移动了颜色以作为最后一个参数。(If7be2)
版本 1.0.0-alpha16
2022 年 8 月 10 日
发布了 androidx.compose.material3:material3:1.0.0-alpha16
和 androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
。版本 1.0.0-alpha16 中包含这些提交内容。
新功能
- 支持在抽屉式导航栏中指定自定义宽度。(Ia7f10)
API 变更
- 对 Tab 和 LeadingIconTab 的参数进行了重新排序,以便在 API 内保持一致 (Ie2637)
- 将
BadgeDefaults
标记成了实验性对象。(I98ef3) - 移除了已废弃的抽屉式导航栏函数。(I4f2db)
- 对 Material 3 中的滑块参数进行了重新排序,以便在 API 内保持一致 (I0aee7)
- 对
NavigationBar
和NavigationRail
参数重新排序,以便在 API 中保持一致 (I51cda) - 对 Material 3 中的参数进行了重新排序,以便在整个 API 中保持一致。(If4ae1)
- 对 Material 3 中的滑块参数进行了重新排序,以便在 API 内保持一致 (I62673)
- 图标参数已重命名为相关操作,以便与顶部应用栏保持一致 (Id75be)
- 将
Badge
和BadgedBox
标记成了实验性,因为锚点对齐仍为 influx。(I1712e、b/236524516) - 将图标按钮变体上的
@ExperimentalMaterial3Api
注解更改为@OptIn
(I070b5) - 将抽屉式导航栏的内容拆分到自己的可组合项中,以支持在其上指定自定义宽度。(Ia7f10)
- 从
MenuDefaults
和TabDefaults
中移除了Divider
(I4e33c)
版本 1.0.0-alpha15
2022 年 7 月 27 日
发布了 androidx.compose.material3:material3:1.0.0-alpha15
和 androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
。版本 1.0.0-alpha15 中包含这些提交内容。
新功能
- 允许将顶部应用栏从原先位置拖动。(I65c00、b/205873416)
API 变更
- 更新了
FilterChip
和ElevatedFilterChip
API,以移除selectedIcon
槽并促进重复使用leadingIcon
以显示所选状态。(Ie5dc2) - 添加了纱罩和轮廓变体颜色角色。(Id6d54)
- 修复了可组合项默认值的命名惯例。(I62b27)
- 将
ListItemDefaults
和ListItemColors
标记成了实验性。(I1f3ec) - 更改了顶部应用栏 API,以更好地反映其状态属性的含义。此外,将顶部应用栏 API 标记成了实验性。(Ic0ad8)
- 现已将文字选择颜色添加到了
TextFieldColors
中,以便用户更容易发现。(Iba1b8) - 添加了
ButtonDefault.ButtonWithIconContentPadding
,以便与包含图标的按钮一起使用。(I2bf9c) - 将文本字段标记成了实验性,以便日后更灵活地变更 API。(I127b5)
- 从
Checkbox
函数中移除了@ExperimentalMaterial3Api
注解。(I5eefc) - 从
RadioButton
函数中移除了@ExperimentalMaterial3Api
注解。(I17e2a) - 从非交互式卡片中移除了
@ExperimentalMaterial3Api
注解。(I9bd49) - 更新了各种组件默认对象,以包含颜色、形状等。(I96e11)
bug 修复
- 针对目录应用,从输入条状标签示例中移除了无效的尾随图标,以避免用户在此类应用中感到困惑。(I9846a)
版本 1.0.0-alpha14
2022 年 6 月 29 日
发布了 androidx.compose.material3:material3:1.0.0-alpha14
和 androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
。版本 1.0.0-alpha14 中包含这些提交内容。
新功能
- 添加了 M3 列表实现,请参阅用法示例文档 (Id7a20)
API 变更
- 将
RangeSlider
中的参数名称从 values 更改为 value (I3b79a) - 对
InputChip
的实现进行了 API 方面的更改,以根据 Material Design 规范支持可选状态。针对所选停用状态,为FilterChip
颜色提供了额外的支持。(I55244、b/235792432) - 添加了
BottomAppBar
默认 FAB (Ida4c8) - 添加了
ColorScheme.surfaceColorAtElevation
(Id41af) - Compose 库中的接口现在使用 jdk8 默认接口方法构建 (I5bcf1)
WindowWidthSizeClass
和WindowHeightSizeClass
现在实现了 Comparable,因此可以使用运算符(<、<=、>=、>)和其他 API 进行比较。(I747d0)
bug 修复
- 更新了标记示例以提供更有意义的内容说明。(I10b9d)
- 向 Material 3 目录主题选择器添加了使用系统字体大小的选项。(I10605)
- 添加了标记和不确定性进度指示器的示例代码。(I8fbe0)
版本 1.0.0-alpha13
2022 年 6 月 1 日
发布了 androidx.compose.material3:material3:1.0.0-alpha13
和 androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
。版本 1.0.0-alpha13 中包含这些提交内容。
API 变更
- 支持在配置更改时保持顶部应用栏的位置。(I10459、b/216160958)
版本 1.0.0-alpha12
2022 年 5 月 18 日
发布了 androidx.compose.material3:material3:1.0.0-alpha12
和 androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
。版本 1.0.0-alpha12 中包含这些提交内容。
bug 修复
- 滑块父项的宽度现在可以为 0。(b/231707291)
版本 1.0.0-alpha11
2022 年 5 月 11 日
发布了 androidx.compose.material3:material3:1.0.0-alpha11
和 androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
。版本 1.0.0-alpha11 中包含这些提交内容。
新功能
- 向 Material 3 添加了
RangeSlider
(I18e38) - 添加了对 Material3
AssistChip
和InputChip
的支持 (I0d25a) - 添加了对 Material3
FilterChip
和SuggestionChip
的支持 (I9fdf3)
API 变更
- 将
TextFieldDefaults.BorderStroke
可组合项(用于在OutlinedTextField
中绘制边框描边)重命名为TextFieldDefaults.BorderBox
。(I5f295) - 切换 m3 视觉变化 (Iab30e)
- 允许将颜色传递给标准图标按钮。(Ia2445)
bug 修复
- 向 material3/Scaffold 添加了 lint 检查,以确保使用了内部内边距(I72293、b/226951418)
版本 1.0.0-alpha10
2022 年 4 月 20 日
发布了 androidx.compose.material3:material3:1.0.0-alpha10
和 androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
。版本 1.0.0-alpha10 中包含这些提交内容。
新功能
material3-window-size-class
是一个为窗口大小类别提供支持的新库:一组主观的视口划分点,您可以根据它们设计、开发和测试可调整大小的应用布局。您可以使用calculateWindowSizeClass
检索窗口大小类别实例,该实例可用于确定界面的显示方式,例如针对较大的窗口显示侧边导航栏(而非底部导航栏)。如需了解详情并查看用法示例,请参阅WindowSizeClass
的 API 参考文档。如需详细了解窗口大小类别的定义,请参阅有关支持不同屏幕尺寸的公开指南。
API 变更
- 为
BottomAppBar
添加了默认的 FAB 高度,从带有 FAB 的BottomAppBar
中移除了尾随 lambda。(I92c47) - 添加了 Material3
FilledIconButton
、FilledTonalIconButton
和OutlinedIconButton
。(Ib2bda) - 更新了 Material 3 Snackbar API,以接受可选操作和关闭操作的颜色值。(Ibe4b4)
- 废弃了
PointerInputChange
中的部分操作(向下或定位)。您可以借助consume()
完全使用此更改。您可以使用isConsumed
来确定其他人之前是否使用过此更改。 PointerInputChange::copy()
现在始终会创建浅层副本。这意味着,在使用完其中一个副本后,将会使用PointerInputChange
的副本。如需创建未绑定的PointerInputChange
,请改用构造函数。(Ie6be4、b/225669674)- 更改了 Cards API,以通过
CardColors
接口接收容器颜色和内容颜色,并支持可点击卡片的停用状态。(I927df) - Material 3 文本字段中的参数
backgroundColor
已重命名为containerColor
,以提高与其他组件的一致性。(I6fbd9)
bug 修复
- 更新了标准
IconButton
,使其符合 Material3 规范。(I09eab) - 将 Material3 Scaffold 的顶部栏高度移动到传递给内容的内边距,使内容能够在顶部应用栏下方呈现。如果
PaddingValues
被忽略,顶部栏可能会遮盖内容。(I83cbc、b/217776202)
版本 1.0.0-alpha09
2022 年 4 月 6 日
发布了 androidx.compose.material3:material3:1.0.0-alpha09
。版本 1.0.0-alpha09 中包含这些提交内容。
新功能
- 添加了 Material 3 Switch API (I2c3ad)
API 变更
- 新增了对包含文本字段的下拉菜单(即“公开下拉菜单”或“组合框”)的支持。(I1b832)
- 向 MaterialTheme 和 Shape 子系统添加了形状参数。(I37426)
- 向
ExtendedFloatingActionButton
添加了一个扩展参数,用于控制 FAB 处于展开状态还是收起状态,并在每种状态之间添加了动画效果。为处于展开状态的 FAB 添加了扩展型 FAB 过载,并为不带图标的 ExtendedFAB 添加了尾随文本。(Iba7f1)
版本 1.0.0-alpha08
2022 年 3 月 23 日
发布了 androidx.compose.material3:material3:1.0.0-alpha08
。版本 1.0.0-alpha08 中包含这些提交内容。
新功能
- 新增了对 Material 3 文本字段的支持。(I795cc、b/199377790)
API 变更
bug 修复
- 修复了 Material3 按钮,以从 MaterialTheme 读取其默认文本样式值。(Ie62fc)
版本 1.0.0-alpha07
2022 年 3 月 9 日
发布了 androidx.compose.material3:material3:1.0.0-alpha07
。版本 1.0.0-alpha07 中包含这些提交内容。
API 变更
- 更新了 Material 3 Surface API,以恢复可点击 Surface 的过载函数,并添加了一个函数来支持可选择和可切换的 Surface。(I4bf18)
LazyVerticalGrid
和LazyHorizontalGrid
现已稳定。(I307c0)LazyVerticalGrid/LazyHorizontalGrid
和所有相关 API 已移至 .grid 子软件包。请将您的导入从 androidx.compose.foundation.lazy 更新为 androidx.compose.foundation.lazy.grid。(I2d446)- 恢复了之前仅依赖于
WindowInsetsControllerCompat
的 View 的变更,再次需要一个 Window,这对于管理某些窗口标记来说是必需的。废弃了ViewCompat.getWindowInsetsController
,改为使用WindowCompat.getInsetsController
,以确保使用正确的 Window(例如,如果 View 位于对话框中)。(I660ae、b/219572936) - 新增了
LazyVerticalGrid
API,用于定义交叉轴的大小 (I17723)
bug 修复
- 更新了 Card API,以跟踪 Surface API 的更改 (I3c8b9)
版本 1.0.0-alpha06
2022 年 2 月 23 日
发布了 androidx.compose.material3:material3:1.0.0-alpha06
。版本 1.0.0-alpha06 中包含这些提交内容。
API 变更
- 添加了表示抽屉式导航栏中单个目的地的
NavigationDrawerItem
(Ic396f、b/218286829) - 以实验性 API 的形式添加了
PermanentNavigationDrawer
和DismissibleNavigationDrawer
。这些抽屉式导航栏非常适合大屏幕设备。(I5f8ab、b/218286829) - 添加了 Material 3 底部应用栏支持 (Ic432a)
NavigationDrawer
已重命名为ModalNavigationDrawer
(I1807d、b/218286829)- 添加了 Material 3 滑块类和令牌 (I1ccee)
- 添加了 Tab 实现,请参阅用法示例文档 (Ie0146)
bug 修复
- 修复了
TalkBack
屏幕阅读器线性导航选择空白的顶部应用栏标题的问题。(Id4690) - 为
FloatingActionButtonDefaults
添加了IconSize
。(Ia71cf) - 修复了在使用
LazyColumn
添加长文本时隐藏AlertDialog
按钮的bug。(Ib2cc9、b/216663029)
版本 1.0.0-alpha05
2022 年 2 月 9 日
发布了 androidx.compose.material3:material3:1.0.0-alpha05
。版本 1.0.0-alpha05 中包含这些提交内容。
新功能
添加了 Material Design 3 组件
API 变更
- 废弃了使用 onClick 回调的
Surface
函数。应使用InteractionSource
和Modifier.clickable()
创建可点击界面。(I211c6) - 为 FAB 添加了对“按下”和“聚焦”状态高度的支持。(Ibb584)
- 将
Surface
API 更改为接收 InteractionSource,允许控制其在不同状态下的外观。(Iafbc8)
bug 修复
- 在动态配色方案中添加了缺失的第三色(I456c4、b/214588434)
版本 1.0.0-alpha04
2022 年 1 月 26 日
发布了 androidx.compose.material3:material3:1.0.0-alpha04
。版本 1.0.0-alpha04 中包含这些提交内容。
API 变更
- 针对无复杂逻辑的现有方法,向其重载的方法添加了
NonRestartableComposable
。对于在所调用内部函数中重复的所有参数,这会减少编译器产生的记忆检查 (equals)。(I90490) - 添加了 Material 3 分隔线。(Ica5fc)
- 使用实验性 API 注解标记了 Checkbox 和 RadioButton。(Ie44bb)
- 添加了对 Material 3 进度指示器的支持。(Iff232、b/205023841)
bug 修复
- 将已停用的
TextButton's
容器颜色更新为透明(I6b248、b/213339737)
版本 1.0.0-alpha03
2022 年 1 月 12 日
发布了 androidx.compose.material3:material3:1.0.0-alpha03
。版本 1.0.0-alpha03 中包含这些提交内容。
bug 修复
- 向 Material 3 的
MaterialTheme
中添加了LocalIndication
。(I7ce4e) - 修复了向复选框应用的圆角半径存在的问题(I38b03、b/175198975、b/202309440)
依赖项更新
- 现在依赖于 Kotlin
1.6.10
。
版本 1.0.0-alpha02
2021 年 12 月 1 日
发布了 androidx.compose.material3:material3:1.0.0-alpha02
。版本 1.0.0-alpha02 中包含这些提交内容。
新功能
- 添加了对复选框和单选按钮的支持。
- 完成更新,现与 Kotlin
1.6.0
兼容
API 变更
- 从 Material 3 的 scaffold 中移除了抽屉式导航栏。(I04f51)
- 添加了 Material 3
Checkbox
支持。(Id5542) - 添加了 Material 3
RadioButton
支持。(I20334)
bug 修复
- 将
IconButton
涟漪效果半径从 40dp 缩减到了 20dp。(I68bbe、b/206674345) - 从
compose.material
中移植了用于Text
更改的字符串快速路径 (I30b03) - 修复了硬编码按钮始终处于启用状态的 bug。(Iea832、b/205335456)
版本 1.0.0-alpha01
2021 年 10 月 27 日
发布了 androidx.compose.material3:material3:1.0.0-alpha01
。版本 1.0.0-alpha01 中包含这些提交内容。
新功能
Material Design 3 主题和 Material You 动态配色
Material Design 3 组件
如需了解详情,请参阅《Compose 中的 Material 主题设置》指南中的“Material Design 3 和 Material You”部分。