Compose Material 3

使用 Material Design 3（新一代 Material Design）组件构建 Jetpack Compose UI。Material 3 中包括了更新后的主题和组件，以及动态配色等 Material You 个性化功能，旨在与新的 Android 12 视觉风格和系统界面相得益彰。
最近更新时间 稳定版 候选版 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.runtimeCompose 编程模型和状态管理的基本构建块，以及 Compose 编译器插件的目标核心运行时。
compose.ui与设备互动所需的 Compose UI 的基本组件，包括布局、绘图和输入。

声明依赖项

如需添加 Compose 的依赖项，您必须将 Google Maven 制品库添加到项目中。如需了解详情，请参阅 Google 的 Maven 制品库。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项：

Groovy

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-alpha03"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

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 组件的无主题组件：

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 中包含这些提交内容。

依赖项更新

  • 将 Material3 自适应依赖项更新为新的模块路径。（Ibc421）
  • 改用窗口大小类别的窗口管理器版本。（I3794d）

版本 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 中包含这些提交内容。

新功能

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 中包含这些提交内容。

新功能

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 中包含这些提交内容。

新功能

  • 为 ThreePaneScaffoldNavigator 返回导航添加了其他行为选项。（I858aa）
  • 向导航历史记录添加了可选的目的地内容。（Ibd7e6）

版本 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 变更

  • 从自适应基架 API 中拆分了导航 API。（Ic4045）
  • 移除了 GutterSize 类。（I785b3）

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：

Material3 自适应窗格 Scaffold API：

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">
  • [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）

外部贡献

  • 使 androidx.compose.material3.AlertDialog 可从通用源代码集使用 (Ia33f5)
  • 使 ModalBottomSheet 可从通用源代码集使用 (Id7cc7)

版本 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 组件

增强了现有 Material Design 3 组件。

将实验性 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 修复

版本 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 组件

增强了现有 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 添加了自定义滑块和滑道。

依赖项更新

版本 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 组件

窗口大小类别

  • 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 变更

版本 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 中包含这些提交内容。

新功能

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 中包含这些提交内容。

新功能

API 变更

  • 为菜单添加了默认分隔线 (I01374)
  • 向 ColorScheme 类添加了 surfaceTint 颜色参数。(I2f558)

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 修复

版本 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 修复

版本 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”部分。