Compose Material 3

運用新一代的 Material Design 3 元件建構 Jetpack Compose UI。Material 3 具有新的主題設定和元件，另外還提供了動態色彩等 Material You 個人化功能，與全新的 Android 12 視覺風格及系統 UI 相互呼應。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 9 月 4 日 1.3.0 - - -

結構

Compose 是由 androidx 中的七個 Maven 群組 ID 所組成。每個群組都包含一個指定功能子集，且各有一組專屬的版本資訊。

下表提供各群組的說明和每組版本資訊的連結。

群組說明
compose.animation在 Jetpack Compose 應用程式中建構動畫，提供豐富的使用者體驗。
compose.compiler透過 Kotlin 編譯器外掛程式轉換 @Composable 函式，並啟用最佳化功能。
compose.foundation透過現成的構成元素編寫 Jetpack Compose 應用程式，然後進一步擴充基礎，建構出自己的設計系統元件。
compose.material運用現成的 Material Design 元件建構 Jetpack Compose UI。這是更高層級的 Compose 進入點，用意是確保提供的元件與 www.material.io 上所述元件相符。
compose.material3運用新一代的 Material Design 3 元件建構 Jetpack Compose UI。Material 3 提供新的主題設定和元件，以及動態色彩等 Material You 個人化功能，可呼應全新的 Android 12 視覺風格和系統 UI。
compose.runtimeCompose 程式設計模型和狀態管理的基本構成元素，以及 Compose Compiler 外掛程式指定的核心執行階段。
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.3.0"
}

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

Compose Material3 Common 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 自動調整導覽套件 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)

修正錯誤

  • 根據預設使用內容插邊 (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 變更

  • 在 NavigationSuiteScaffoldDefaults 中新增 containerColor 和 contentColor。(I64e3a、b/331993720)
  • 將 itemColors 函式新增至 NavigationSuiteDefaults。(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 變更

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 元件現已更新，現在會顯示預設為空值的可為空值 MutableInteractionSource。這裡沒有語意變更：傳遞空值表示您不想提升 MutableInteractionSource，系統會視需要在元件中建立。如果將值變更為空值，部分元件就不會分配 MutableInteractionSource，並允許其他元件只在需要時延遲建立執行個體，從而提升這些元件的效能。如果您沒有使用傳遞至這些元件的 MutableInteractionSource，建議您改為傳遞空值。此外，我們也建議您在元件中做出類似的變更。(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 版本包含以下修訂項目。

新功能

修正錯誤

  • 修正在根介面含有 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 自動調整版本 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)

修正錯誤

  • 修正 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 變更

  • 將 scaffold 角色變更為 ThreePaneScaffoldRole 的別名。(I65bd1)。
  • 建立 Scaffold 角色的基礎類別 (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 變更

  • 從自動調整的 Scaffold API 中分割導覽 API。(Ic4045)。
  • 移除 GutterSize 類別。(I785b3)。

修正錯誤

  • 未使用 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 的主要功能

全新質感設計 3 元件

  • 輪轉介面
  • [ModalBottomSheet] 現在支援 U+ 的預測返回手勢 (Iccf32、b/281967264、b/304850357)
  • [SearchBar] 現在支援 U+ 的預測返回功能 (I657f8)
  • Nav 導覽匣 (ModalDrawerSheet 和 DismissibleDrawerSheet) 現在支援啟用 U+ 的預測返回功能 (Ie5b0b)
  • DropdownMenu 現在支援自訂顏色、形狀、高度和框線。(I8e981、b/289554448、b/301887035、b/283654243)
  • 更新滑桿，透過加入間隔和停止指標，改善無障礙功能。(I3058e)。
  • 已更新 ProgressIndicator，新增間隔和停止指標，藉此提升無障礙功能。(I21451)。
  • 為複合式工具提示新增預設插入點，支援在指定錨點 LayoutCoordinates 繪製自訂插入點。(Ifd42c)。 破壞性變更
  • 新的下拉即可重新整理 API：
    • 簡化 PullToRefreshState，以便使用小值而非 Dp 單位。
    • isRefreshing 狀態是由使用者控制，而非 PullToRefreshState。
    • 將巢狀捲動連線與 PullToRefreshState 區隔開來。由新的 PullToRefreshBox 或 Modifier.pullToRefresh 處理。
    • 這項更新是先前的實驗性 API 的破壞性變更。(I0adeb、b/314496282、b/317177684、b/323787138、b/324573502、b/317177683) 視覺破壞性變更
  • 將焦點狀態重疊更新為 0.1f，確保有足夠的色彩對比。(I7ea77)。
  • 針對 lightColorScheme 和 darkColorScheme 中的表面和背景顏色預設進行微調。(I9db52)。
  • 更新滑桿和 ProgressIndicator 顏色，以便遵循新的非文字對比度規格。(I26807)。
  • 元件現已使用 SurfaceContainer 變化版本。根據預設，使用 Surface 和 TonalElevation 正式計算顏色的元件現在會使用 SurfaceContainer 角色，但不受色調高度影響。(b/304584161)。
  • Surface 和 Surface 容器的基準角色已略做調整，可在淺色和深色主題中增添色調。(I677a5)。
  • 將實驗性 API 升級為穩定版！
  • 提升效能

1.3.0-rc01 版本

2024 年 8 月 21 日

發布 androidx.compose.material3:material3-*:1.3.0-rc01。1.3.0-rc01 版包含這些修訂版本。

修正錯誤

  • ModalBottomSheet 目前依語意週遊順序排列，後接 scrim。(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 支援高度，請將提取至重新整理 API 更新為啟用為布林值，而非 lambda。支援 PullToRefreshBox 中的內容對齊方式 (I75679)
  • 將 TooltipScope 設為密封介面，並建立內部實作以用於 TooltipBox 和標籤。(I3833e)。
  • 在 CarouselItemScope - maskClip 和 maskBorder 中新增兩個修飾符，以便輕鬆在任何輪轉介面項目中加入形狀和邊框 (Id67a1)
  • TimePickerState 現在是介面並允許設定時間 (I88546)
  • 更新了用來設定連結樣式的 API：將 TextLinkStyles 移至 TextStyle，並將 TextDefaults 從材質中移除。(I5477b)。

修正錯誤

  • ModalBottomSheet 狀態和導覽列圖示現在會回應深色主題狀態。(Ie1fe7、b/338342149)
  • 已將關閉工作表語意新增至 ModalBottomSheet Scrim。(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)。
  • 更新 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 提供給 LocalRippleConfiguration，而不是提供帶有 isEnabled = false 的 RippleConfiguration。(I22725)。
  • 啟用「無邊框」功能後，ModalBottomSheet 可在狀態列上更精確地繪製圖片。強制回應底部功能表內容現在可以使用視窗插邊，以便在導覽列上方顯示內容。ModalBottomSheet 參數 windowInsets 已重新命名為 contentWindowInsets，用於指定要套用插邊的位置，而這些參數不再連結至視窗邏輯。contentWindowInsets 類型已變更為會傳回 WindowInsets 的函式，以便在新視窗內解析。(I39630、b/274872542、b/300280229、b/290893168)
  • PrimaryScrollableTabRow 和 SecondaryScrollableTabRow 現在使用自訂版面配置，而非子組合，這樣應該可以改善效能。(I991e0)。
  • 除了一般樣式、懸停和聚焦之外，文字連結現在使用按下的狀態樣式選項。每個 TextDefaults 方法都會得到一個支援該函式的 pressedStyle 引數。(Ic473f、b/139312671)

修正錯誤

  • 導覽匣拖曳錨點現在與 drawerContent 的寬度相同。(Ibc72f、b/245355396)
  • OutlinedTextField 標籤的頂端邊框間距現在可計入系統字型大小。(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，以便視需要自訂滴答 (I0c048)

API 變更

  • 除了一般樣式、懸停和聚焦之外，文字連結使用按下的狀態樣式選項 (I5f864、b/139312671)
  • 更新 CarouselItemInfo，以顯示要裁剪該項目的遮罩矩形 (I785d8)
  • 已從 Material 3 公用 API 中移除 BasicTooltipState。其功能會與 TooltipState 結合，直到基礎的 BasicTooltip 保持穩定為止。(Icda29)。
  • 新增了 TextDefaults 物件，其中包含建構 LinkAnnotation 及剖析 HTML 標記字串的方法，這些字串會將 MaterialTheme 套用至連結 (I98532、b/139312671)
  • ExposedDropdownMenuBoxScope 已不再允許使用子類別。公開的下拉式選單現在有一個 MenuAnchorType，應傳遞至 menuAnchor 以支援更好的 a11y。您應使用這個方法，而不是將 focusable 傳遞至已淘汰的 ExposedDropdownMenu。menuAnchor 有控制 enabled 狀態的新參數。(I55ee6、b/257209915、b/308840226)
  • 修正停用時 OutlinedButton 的邊框顏色。新增了可接受已啟用狀態的 ButtonDefaults.outlinedButtonBorder("enabled") 超載。(Ie650b、b/318461363)
  • 已新增 CarouselItemInfo 類別，可協助客戶取得商品尺寸相關資訊。(I9070c)。
  • 不含表面容器的 ColorScheme 建構函式現已淘汰。請遷移至含有途徑容器的建構函式。(I35c11)。
  • [外框]TextFieldDefaults ContainerBox 已重新命名為「Container」。(Ie8d3b)。

修正錯誤

  • 如果 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 Nav Drawer (ModalDrawerSheet 和 DismissibleDrawerSheet)，以支援啟用 U+ 的預測返回功能 (Ie5b0b)
  • 在圖示中新增 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 版

March 20, 2024

發布 androidx.compose.material3:material3-*:1.3.0-alpha03。1.3.0-alpha03 版包含這些修訂版本。

視覺破壞性變更

  • 將焦點狀態重疊更新為 0.1f，確保有足夠的色彩對比。(I7ea77)。
  • 針對 lightColorScheme 和 darkColorScheme 中的表面和背景顏色預設進行微調。(I9db52)。

新功能

  • 已新增參數來自訂 ExposedDropdownMenu。具體來說，選單現在有 focusable 參數 (預設為 true)，使用可編輯文字欄位時應設為 false。(I4184c、b/323694447、b/278609042)

API 變更

  • 已移除 ScaffoldSubcomposeInMeasureFix 標記。(Ie2a4b)。
  • NavigationRailItemColors 現已標示為 @Immutable。(If6112、b/327660613)
  • NavigationBarItemColors 現已標示為 @Immutable。(I42a30、b/298064514)
  • 重新排序滑桿追蹤可組合項中的參數。(I9f315)。
  • ExposedDropdownMenu 現在是使用 Popup 實作。除了可聚焦的選單，在鍵盤上輸入內容時，系統會關閉可聚焦選單的行為。

修正錯誤

  • Surface 和 Surface 容器的基準角色已略做調整，可在淺色和深色主題中增添色調。(I677a5)。
  • 更新滑桿和 ProgressIndicator 顏色，以便遵循新的非文字對比度規格。(I26807)。
  • 將焦點狀態重疊更新為 0.1f，確保有足夠的色彩對比。(I7ea77)。
  • 針對 lightColorScheme 和 darkColorScheme 中的表面和背景顏色預設進行微調。(I9db52)。

1.3.0-alpha02 版本

2024 年 3 月 6 日

發布 androidx.compose.material3:material3-*:1.3.0-alpha02。1.3.0-alpha02 版包含這些修訂版本。

API 變更

  • 再次將滑桿狀態設為穩定。再次將 State.onValueChangeFinished 設為 val。在 rememberUpdatedState 中納入 onValueChangeFinished。(I82ab2、b/322269951)
  • Navigation 元件現在會使用新的 SurfaceContainer 角色。DrawerDefaults 現在提供不同的 standardContainerColor 和 modalContainerColor 屬性。DrawerDefaults.ModalDrawerElevation 現在是 0.dp。(I7fbac)。
  • 由於即將將 state.onValueChangeFinished 變更為 var，因此從 Slider 狀態移除 @Stable。(Ied34a、b/322269951)
  • ModalBottomSheet 和 StandardBottomSheet 動畫規格現在為 TweenSpec，並且已從彈簧效果更新。此方法可解決明顯的超載問題。現已移除已淘汰且不含密度的 SheetState 建構函式。(I7babc、b/285847707)。

修正錯誤

  • 元件現已使用 SurfaceContainer 變化版本。根據預設，透過 Surface 和 TonalElevation 正式計算顏色的元件現在會使用 SurfaceContainer 角色，不受色調高度影響。(b/304584161)。
  • 修正導致 ElevatedFilterChip 未選取且停用的容器顏色變成黑色的錯誤。(I400e6、b/322407043)
  • 修正進度為 0 時不確定的進度指標 (Id6582)
  • 修正 RTL 版面配置的 Slider 和 RangeSlider 問題 (Iab0e1)
  • 由於浮動四捨五入可能不準確，因此為滑桿範圍計算加入 SliderRangeTolerance。(Ic918a、b/324934900)
  • 建立巢狀結構 DateRangePicker，或在大型字型小螢幕中顯示任何類型的日期挑選器時，請確認 DatePickerDialog 會顯示其按鈕。(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。這裡沒有語意變更：傳遞空值表示您不想提升 MutableInteractionSource，系統會視需要在元件中建立。如果將值變更為空值，部分元件就不會分配 MutableInteractionSource，並允許其他元件只在需要時延遲建立執行個體，從而提升這些元件的效能。如果您沒有使用傳遞至這些元件的 MutableInteractionSource，建議您改為傳遞空值。此外，我們也建議您在元件中做出類似的變更。(I41abb、b/298048146)
  • 新增 RippleConfiguration 和 LocalRippleConfiguration，允許使用固定值依元件 / 子樹狀結構自訂漣漪效果。例如，變更非您控制的元件顏色或停用元件的漣漪效果。在大多數情況下，應使用預設值：這些 API 是自訂個別元件 / 有限子樹狀結構的自訂程序。如要擴大變更和自訂設計系統，請改用 createRippleModifierNode 自行建構漣漪效果。(I7b5d6、b/298048146)
  • 在 Material3 中新增分享關係圖，取代已淘汰的 rememberRipple。此外，也新增臨時 CompositionLocal、LocalUseFallbackRippleImplementation，將 Material3 元件還原為使用已淘汰的 rememberRipple / RippleTheme API。這項資訊將在下一個穩定版本中移除，僅供您提供自訂 RippleTheme 的情況用於暫時遷移。(I34cbc、b/298048146)。

修正錯誤

  • 已移除 ModalBottomSheet 中的子組合以提升成效。已修正搭配 LookaheadScope 使用時，ModalBottomSheet 在特定情況下可能會異常終止的問題(I2a198)。
  • 已移除 BottomSheetScaffold 中的子組合以提升成效。修正 BottomSheetScaffold 與特定情境結合 LookaheadScope 在特定情境中會異常終止的問題。(Ie6401)。
  • 徽章的對齊方式會配合右上角的錨定內容中心進行調整。(I18a28)。
  • 修正 DateRangePicker 的 11 年性問題，該問題將「月-年」文字標題傳達給螢幕閱讀器、切換控制功能和 Voice 存取權使用者可執行的操作。(I2ac55)。
  • 已修正 mediumTopAppBarColors 參數順序錯誤。(Ibe64a)。

1.2 版本

1.2.1 版本

2024 年 3 月 6 日

發布 androidx.compose.material3:material3-*:1.2.1。1.2.1 版包含這些修訂版本。

修正錯誤

  • 再次將滑桿狀態設為穩定。再次將 State.onValueChangeFinished 設為 val。在 rememberUpdatedState 中納入 onValueChangeFinished。(Ie8fd0、b/322269951)
  • 由於即將將 state.onValueChangeFinished 變更為 var，因此從 Slider 狀態移除 @Stable。(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 互通性轉譯錯誤。解決方法是將 TabRow 與 TabRowDefaults.PrimaryIndicator 搭配使用

自 1.1.0 版以來的重要異動

全新質感設計 3 元件

強化現有質感設計 3 元件。

將實驗性 API 升級為穩定版！

提升效能

1.2.0-rc01 版本

2024 年 1 月 24 日

發布 androidx.compose.material3:material3-*:1.2.0-rc01。查看 1.2.0-rc01 版的修訂項目。

修正錯誤

  • 已修正 mediumTopAppBarColors 參數順序錯誤。(Ibe64a)。
  • 修正 CardDefaults.cardColors 中 1.2.0-beta02 引入的錯誤，該錯誤並未根據 containerColor 參數值更新 contentColor。(Iee041、b/319671246)
  • 修正了 disabledContentColor 中導入的 1.2.0-beta02 錯誤，並新增了小型最佳化設定。(I6dda1、b/318428829)

1.2.0-beta02 版

2024 年 1 月 10 日

發布 androidx.compose.material3:material3-*:1.2.0-beta02。1.2.0-beta02 版包含此連結所列的修訂項目。

已知錯誤

  • 根據預設，IconButtonColors 中的錯誤會將 disabledContentColor 指派到 LocalContentColor 的 Alpha (0.38f)，而不是指定使用者 contentColor。解決方法是明確設定 disabledContentColor。我們將在下一個版本中修正這個問題。

API 變更

  • 新增功能，為 Plain Tooltip API 啟用工具提示插入點。(Ibf767)。
  • SwipeToDismissState、rememberSwipeToDismiss 和 SwipeToDismissValue 都已重新命名為 _SwipeToDismissBox_。(I68d6d)。

修正錯誤

  • 已修正 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 個已淘汰的「節省模式」和「建構函式」。SwipeToDismiss 元件、狀態和預設物件已標示為實驗性物件。(Ib54f2)。

修正錯誤

  • 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。這些新的布林值可協助判斷強制回應底部功能表應如何處理輸入法編輯器事件。(Iea56f、b/278216859)
  • 已更新 RangeSlider 和 Slider 狀態，移除 initialOnValueChange、初始前置字串和適當的 kdocs。(I57d30)。
  • 淘汰 ChipBorder 類別及相關聯的函式呼叫，建議改用 BorderStroke。(I89cc2)。
  • 基礎工具提示 API 現已改名為 @ExperimentalFoundationApi。(I30b0b)。
  • TabRow 和 ScrollableTabRow 已淘汰，新的「Primary」和「Secondary」變化版本標示為實驗性。(I0def6)。
  • 篩選器與輸入方塊現在直接使用 BorderStroke。(I07a8d)。
  • SegmentedButton 現在直接使用 BorderStroke。(I89b9b)。
  • 一般 AlertDialog 函式已重新命名為 BasicAlertDialog，並淘汰先前的函式(Idbe52)。
  • 將 SwipeToDismiss API 重新命名為 SwipeDismiss，並將新的 SwipeDismiss API 升級為穩定版。(I14cbe)。
  • 將 tonalElevation 和 shadowElevation 新增至工具提示 API。此外，由於 TooltipBox、PlainTooltip 和 RichTooltip API 會意外發布為穩定版，因此請將這些 API 移回實驗功能。(If0f66、b/293939035)
  • 將實驗性晶片 API 升級為穩定版。(Iea2c3)。
  • 已從 Material3 可點擊資訊卡中移除 @ExperimentalMaterial3Api 註解。(I88dbf)。

修正錯誤

  • 修正問題：在某些使用巢狀 Lookahead 和 Lazy 版面配置的情況下，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)。

修正錯誤

  • 修正當顯示月份位於允許年份範圍邊緣時，快速按一下導覽箭頭按鈕時會發生 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 已由開放和關閉方法取代，而偏移值現在會以浮點值的形式公開，而非狀態物件。您可以直接透過 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)。

修正錯誤

  • 修正使用 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 變更

  • 新增了可接受 BottomAppBarScrollBehavior 參數的 BottomAppBar，以便在捲動內容時自動隱藏。也新增了 FabPosition.EndOverlay，讓 FAB 能重疊在 Scaffold 中的底部應用程式列，而不是錨定在其上方。(Iecb47)。
  • 新增以 BasicTooltipBox 為基礎建構的簡易標籤元件，這個元件無法在標籤邊界外輕觸時關閉。(I821f9)。

修正錯誤

  • 已移除在工具提示中使用 rememberSaveable 的功能。(Icc131、b/299500338)
  • 推出暫時性標記，以控制 Scaffold 是否應在測量期間或放置期間測量子項。根據預設，系統會在測量時進行測量。如果您遇到新行為的相關問題，請回報問題。(I0b354)。
  • 使用正確的裝置螢幕寬度測量結果，將 BottomSheet 中的水平邊緣修正為 Edge。(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)。
  • 已將 BasicTooltipBox 新增至 compose.foundation 並更新 PlainTooltipBox 和 RichTooltipBox，以使用 TooltipBox 搭配新的 PlainTooltip 和 RichTooltip 可組合項。(I79e1d)。

修正錯誤

  • dynamicLightColorScheme 和 dynamicDarkColorScheme 現在會針對途徑和 surfaceContainer 角色傳回較高的色度。(I5e901)。
  • 修正了以下問題：在 LookaheadScope 內部的 Scaffold 中使用子組合 (例如 BottomSheetScaffold) 的部分元件嘗試太早讀取大小。(I297b4、I871f1、b/295536718)

1.2.0-alpha06 版本

2023 年 8 月 23 日

發布 androidx.compose.material3:material3-*:1.2.0-alpha06。查看 1.2.0-alpha06 版的修訂項目。

修正錯誤

  • 修正 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 的 Start 對齊方式 (Ib7aea、b/170592777)

修正錯誤

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 組合本機組合停用途徑色調高度重疊功能。(Ic203c、b/277774590)

API 變更

  • 開啟元件顏色建構函式。(I8c4a6)。
  • 在兩個工具提示 API 中新增可聚焦參數，讓開發人員可以提供工具提示是否使用觸控事件。請留意，這可能會破壞無障礙焦點自動遍歷的功能。(Ie32d8)。
  • 針對效能和記憶體配置調整無障礙功能。(Iede48)。
  • 公開 DefaultSizeClasses 並為 WindowSizeClasses 建立 StandardSizeClasses (I91838)
  • 將 WindowWidth/HeightSizeClass 變更為浮點值類別 (Ie686e)

修正錯誤

  • Scaffold 的 contentWindowInsets 參數現在會遵循耗用的視窗插邊。請注意，提供這些參數時，根據 topBar 和 bottomBar 產生的內容邊框間距行為會維持不變。(I08b73、b/264601542)
  • 修正位於頂端應用程式列中央的對齊方式，確保長標題不會出現在動作圖示或導覽圖示上方。(I4369f、b/236994621)
  • 現在，分頁位置的內容寬度不得小於 24dp。這樣可以為分頁指標提供便利的觸控目標。(Id8861)。
  • dynamicLightColorScheme 和 dynamicDarkColorScheme 的動態調色盤現在支援新的介面角色。(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 設為零)
    • 已更新預設的 ModalBottomSheet 功能，以便留在系統資訊列外 (包括導覽)
    • 在無邊框模式下拖曳控點，即可運用狀態列插邊處理功能。
    • BottomSheetDefaults 包含 BottomSheetWindow 的視窗插邊。(I31200、b/274872542、b/272973615、b/272334475、b/268432129、b/275849044、{1486/265})
  • 淘汰 Indicator，並根據 M3 規格新增 Primary/SecondaryIndicator。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 介面，以控制可在 UI 中選取的日期或年份。(Ic2fc6)。
  • TimePicker 已從穩定版 API 中移除，預期會有進一步變更 (I3f39a)
  • 「ModalBottomSheet」已移至 Android 專用。我們不建議在電腦上使用 ModalBottomSheet，而且相關功能不會主動維護。(Ib3778)。

修正錯誤

  • 修正了當動作相互堆疊的情況符合對話方塊寬度時，AlertDialog 關閉動作會顯示在確認動作下方。這項修正可以讓實作方式與質感設計規格保持一致。(I029de、b/235454277)
  • 修正 ListItem 中針對三行項目使用不正確邊框間距的錯誤。(I6e235)。
  • ModalBottomSheet 現在可以顯示輸入法編輯器鍵盤 (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 版包含以下修訂項目。

修正錯誤

  • 已修正修飾符誤傳遞至兩個可組合項(b/282761472)。
  • 已修正在 23 小時內初始化時，TimePickerState 會傳回不正確的營業時間。(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 版本包含以下修訂項目。

修正錯誤

  • 新增對二進位檔相容性沒有 windowInset 參數的 ModalBottomSheet 呼叫。(Ib7959)。
  • 將視窗插邊參數新增至 ModalBottomSheet。
    • ModalBottomSheet 的裁剪現在可在狀態列後方繪製 (windowInsets 設為零)
    • 已更新預設的 ModalBottomSheet 功能，以便留在系統資訊列外 (包括導覽)
    • 在無邊框模式下拖曳控點，即可運用狀態列插邊處理功能。
    • BottomSheetDefaults 包含 BottomSheetWindow 的視窗插邊。(I31200、b/274872542、b/272973615、b/272334475、b/268432129、b/275849044、{1486/265})

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 元件

強化現有質感設計 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 變更

  • TimePicker 已從穩定版 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)

修正錯誤

  • 啟用觸控探索時，請勿將撥號畫面從小時改為分鐘。(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，允許在建立日期挑選器時傳遞空值的廣告標題。您現在可以傳遞空值的廣告標題、標題和 showToggleMode = false，以顯示無頭挑選器。(Id3f3a、b/266132421、b/267194809)

修正錯誤

  • 從現在開始，搜尋列會在閒置時自動清除焦點。(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 新增功能，允許在初始建立狀態後設定日期，以及透過設定空值時間戳記重設選項。設定日期時請務必謹慎，新的 setSelection 函式會在提供的日期不符合先決條件時擲回例外狀況 (請參閱說明文件)。(Ifa645、b/268609314、b/270427389)
  • 將收合的 SheetValue 重新命名為 PartiallyExpanded，以更準確、更靈活的方式呈現處於此狀態的行為。(Ia1491)。
  • 已將 ListItem 參數名稱更新為 _content，而非 _text。預設的 getter 目前為 ReadOnlyComposables (相關項目)。(I69a25)。
  • 以實驗功能升級互動式 Surface API。(I90d59、b/261561812)

修正錯誤

  • 修正 ModalBottomSheet 的 HalfExpanded 狀態未正確計算，且工作表似乎會浮動的問題(I45e84、b/268411386)
  • 新增 confirmValueChange 檢查，以抓取 ModalBottomSheet 的輕觸動作。(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)。
  • 您現在可以自訂文字欄位顏色功能：
    • 根據焦點和錯誤狀態輸入的欄位和預留位置文字顏色。textColor 參數已重新命名為 unfocusedTextColor，而 placeholderColor 已重新命名為 unfocusedPlaceholderColor。
    • 已填入文字欄位的容器顏色，取決於使用新的 errorContainerColor 參數的錯誤狀態。
  • 公開的下拉式選單文字欄位顏色已更新為參數，可支援新的前置字元 API 和後置字串 API。(I9c8b4、b/254284181、b/264766350)

API 變更

  • 還原部分 Slider API 版本，並移除透過自訂縮圖和測試群組所涵蓋的多餘滑桿超載。正在提升 RangeSlider 的穩定性。(Ie8fbd)。
  • 在方塊的高度函式中，defaultElevation 已重新命名為 elevation。(I0f872)。
  • 下列 Material 3 文字欄位 API 已不再是實驗功能：TextField、OutlinedTextField、textFieldWithLabelPadding、textFieldWithoutLabelPadding、outlinedTextFieldPadding。(Ieb5c0、b/261561819)
  • TimePickers is24Hour 使用系統設定 (I18856)
  • 從 scaffold API 中移除實驗性註解。(Ibb51e、b/261565765、b/261436953)

修正錯誤

  • ModalBottomSheet 預設形狀現在一律為 SheetDefaults.ExpandedShape。(I0dfca)。
  • 改善 Material 3 DatePicker 和 DateRangePicker 的無障礙功能。(I5087e)。
  • 修正套用高度限制後可能會當機的錯誤。(I30d8c)。
  • 將語意角色從可點擊和可選取的介面中移除，而這些元件已更新元件，用於透過 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 函式，可與 TimePickerState 和便利方法 rememberTimePickerState，在顯示 Material 3 規格後顯示時間挑選器 (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 現在不得為空值且會有預設值(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 版本包含以下修訂項目。

新功能

  • 推出可透過日曆 UI 選擇單一日期的初始 DatePicker API。我們仍會對這個 API 進行變更 (I722b9)
  • 透過 PlainTooltipBox 新增對純工具提示的支援 (I0cdfb)
  • 推出搜尋列 (Iad128)
  • 推出 SwipeToDismiss (I458a8、b/242889540)

API 變更

  • 在 Surface 上新增 IsContainer 語意屬性。這項屬性會在日後的變更中用到，屆時我們會根據 surfaces 等元素的語意含義來決定周遊順序 (I63379)
  • 將導覽匣相關 API 標示為穩定版。(Iab01e、b/261439597)
  • 為圓形進度指標新增軌跡色彩參數，並為圓形和線性進度指標新增筆劃上限參數 (Ie668c、b/216325962、b/222964817)
  • 針對已淘汰的隱藏函式，提供更多傳回類型的「是否可為空值」屬性。(Ibf7b0)
  • 新增 Modifier.minimumInteractiveComponentSize。這可用於保留至少 48.dp 的大小，在元素的測量尺寸較小時減少觸控互動 (I33f58、b/258495559)。
  • 針對含有內容版位的 AlertDialog 可組合項新增了實驗性 API。(Iec4a2)

修正錯誤

  • 進度指標的進度現在不會超過預期範圍限制。(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()，並將 Modifier 設為公開。(Ie44e1)
  • 為使用圖示的文字按鈕新增預設內容邊框間距。(I8f662)
  • 為導覽列和邊欄新增停用的顏色。(Ia7892、b/258867034)
  • 新增用於查詢祖系捲動資訊的 Modifier API。(I2ba9d、b/203141462)
  • 如果手勢可能產生捲動事件，用在 Clickable 中可正確延遲按下的互動動作。
  • 修正了在 Scrollable ViewGroup 中使用 Clickables 時無法正確延遲漣漪效果的問題。
  • 更新 Drawer 和 Sheet，以便在手勢可能變成捲動事件時正確延遲按下動作。

依附元件更新

  • 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 文字、TextField 和 OutlinedTextField 中新增 minLines 參數，以便能夠以行數來設定元件的最小高度 (I4af1d)
  • 淘汰 TopAppBarDefaults smallTopAppBarColors 函式，在建立 TopAppBar 時應使用的新的 topAppBarColors 函式。(Ie6cb9)
  • 在 BasicText 和 BasicTextField 中新增 minLines 參數。這樣即可針對行數來設定這些可組合項的最小高度 (I24294、b/122476634)

修正錯誤

  • 將 Material3 IconButton 和 IconToggleBotton 的內容剪輯為元件的狀態層形狀 (例如圓形)。(I9da8f)
  • 更新 Material3 中型和大型頂端應用程式列，即可在其整個介面上套用相同的背景顏色，並允許進行以透明色值覆寫預設顏色的設定。(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 版的修訂項。

修正錯誤

  • 修正用 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 版的修訂項。

修正錯誤

  • 更新 Material3 中型和大型頂端應用程式列，即可在其整個介面上套用相同的背景顏色，並允許進行以透明色值覆寫預設顏色的設定。(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 變更

  • 新增了支援文字到文字欄位 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)

修正錯誤

  • 將 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 函式。請將使用方式遷移至新的函式。(I74404、b/226918634)
  • 新增對頂端應用程式列快速滑過和貼齊行為的控制項。(I15c81)
  • 從 Divider 中移除 startIndent，將顏色移至最後一個參數。(If7be2)

修正錯誤

  • 讓對話方塊在顯示時通知字詞 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 行為函式更新為 Composables，並針對其頂端應用程式列狀態和動畫規格提供預設值 (I642b3)。
  • 更新了懸浮動作按鈕 (FAB) 元件簽章以符合介面 API (I3afaa)
  • 新增了適用於頂端應用程式列、導覽匣、導覽列和邊欄的插邊內建支援機制。無論是單獨使用或與 Scaffold 搭配使用，這些元件都會為開發人員自動處理插邊。注意：這項變更不會自動處理狀態列圖示以及狀態列和導覽列的透明度。請繼續手動處理，確保提供最佳的無邊框體驗。(I7e4e6、b/183161866)
  • 更新了元件預設值以減少 API 介面，藉此提升日後的彈性與效能。(I31820)
  • 重新安排方塊和導覽匣工作表參數的順序，藉此在 API 內維持一致性 (I45d0b)
  • 將 startIndent 從 Divider 中移除，並將顏色移到最後一個參數 (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 和 Leading 圖示分頁參數的順序，藉此在 API 內保持一致 (Ie2637)
  • 將 BadgeDefaults 標示為實驗性質。(I98ef3)
  • 移除已淘汰的導覽匣函式。(I4f2db)
  • 重新安排 Material 3 中 Slider 參數的順序，藉此在 API 內維持一致性 (I0aee7)
  • 重新安排 NavigationBar 和 NavigationRail 參數的順序，藉此在 API 內維持一致性 (I51cda)
  • 重新安排 Material 3 中的參數順序，藉此在 API 內維持一致性。(If4ae1)
  • 重新安排 Material 3 中 Slider 參數的順序，藉此在 API 內維持一致性 (I62673)
  • 將 icons 參數重新命名為 actions，藉此與頂端應用程式列保持一致 (Id75be)
  • 將 Badge 和 BadgedBox 標示為實驗性質，因為目前仍可大量使用錨點對齊。(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)。

修正錯誤

  • 已從輸入方塊範例中移除無法運作的結尾圖示，以免在目錄應用程式中混淆使用者 (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 中的值 (I3b79a)
  • API 變更為 InputChip 實作，以便根據 Material Design 規格支援可選取狀態。 針對所選停用狀態，提供 FilterChip 顏色的額外支援。(I55244、b/235792432)。
  • 新增 BottomAppBar 預設 FAB (Ida4c8)
  • 已新增 ColorScheme.surfaceColorAtElevation (Id41af)
  • Compose 程式庫中的介面現為使用 jdk8 預設介面方法建構 (I5bcf1)
  • WindowWidthSizeClass 和 WindowHeightSizeClass 現在實作 Comparable，使其得以使用運算子 (<、<=、>=、>) 和其他 API 比較。(I747d0)

修正錯誤

  • 更新標記範例以提供更多實質的內容說明。(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 版的修訂項。

修正錯誤

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 版的修訂項。

新功能

  • 將 RangeSlider 新增至 Material 3 (I18e38)
  • 新增 Material3 AssistChip 和 InputChip 支援 (I0d25a)
  • 新增 Material3 FilterChip 和 SuggestionChip 支援 (I9fdf3)

API 變更

  • 重新命名 TextFieldDefaults.BorderStroke 可組合項，該可組合項用於繪製 OutlinedTextField 至 TextFieldDefaults.BorderBox 的框線(I5f295)。
  • 切換 m3 視覺效果 (Iab30e)
  • 允許將顏色傳遞至標準圖示按鈕。(Ia2445)

修正錯誤

  • 在 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) 高度，從 BottomAppBar 移除懸浮動作按鈕 (FAB) 結尾的 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)

修正錯誤

  • 更新標準 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 新增 Extended 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)

修正錯誤

  • 修正 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)

修正錯誤

  • 更新 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)
  • 已將 PermanentNavigationDrawer 和 DismissibleNavigationDrawer 新增為實驗性 API。這些導覽匣非常適合大螢幕裝置使用。(I5f8ab、b/218286829)
  • 新增了 Material 3 底部應用程式列支援 (Ic432a)
  • NavigationDrawer 已重新命名為 ModalNavigationDrawer (I1807d、b/218286829)
  • 新增了 Material 3 Slider 類別和權杖 (I1ccee)
  • 新增了 Tab 實作，請查看說明文件中的使用範例 (Ie0146)

修正錯誤

  • 修正了以下問題：TalkBack 螢幕閱讀器線性導覽選取了空白的頂端應用程式列標題。(Id4690)
  • 已將 IconSize 新增至 FloatingActionButtonDefaults。(Ia71cf)
  • 修正使用 LazyColumn 新增長文字內容時，無法顯示 AlertDialog 按鈕的問題。(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 變更

  • 已淘汰 Surface 函式，該函式會接收 onClick 回呼。應使用 InteractionSource 和 Modifier.clickable() 來建立可點擊途徑。(I211c6)
  • 新增了支援 FAB 的點按式和聚焦式提升權限。(Ibb584)
  • 變更了 Surface API，以便接收 InteractionSource，這可以控制其在不同狀態下的外觀。(Iafbc8)

修正錯誤

1.0.0-alpha04 版

2022 年 1 月 26 日

發布 androidx.compose.material3:material3:1.0.0-alpha04。查看 1.0.0-alpha04 版的修訂項。

API 變更

  • 將 NonRestartableComposable 新增至屬於現有方法超載且無複雜邏輯的方法。如此一來，對於呼叫內部函式中重複的所有參數，可減少編譯器產生的記憶檢查 (等於)。(I90490)
  • 新增了 Material 3 分割線。(Ica5fc)
  • 使用實驗性 API 註解標記 Checkbox 和 RadioButton。(Ie44bb)
  • 開始支援 Material 3 進度指標 (Iff232、b/205023841)。

修正錯誤

1.0.0-alpha03 版

2022 年 1 月 12 日

發布 androidx.compose.material3:material3:1.0.0-alpha03。查看 1.0.0-alpha03 版的修訂項。

修正錯誤

依附元件更新

  • 現在依附於 Kotlin 1.6.10。

1.0.0-alpha02 版

2021 年 12 月 1 日

發布 androidx.compose.material3:material3:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

新功能

  • 新增對 Checkbox 和 Radiobutton 的支援。
  • 已更新為可與 Kotlin 1.6.0 相容

API 變更

  • 從 Material 3 的 Scaffold 中移除導覽匣。(I04f51)
  • 新增 Material 3 Checkbox 支援。(Id5542)
  • 新增 Material 3 RadioButton 支援。(I20334)

修正錯誤

  • 將 IconButton 漣漪半徑從 40 dp 降到 20 dp。(I68bbe、b/206674345)
  • Text 的通訊埠字串快速路徑從 compose.material 中進行變更 (I30b03)
  • 修正系統一律啟用硬式編碼按鈕的問題。(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 一節。