Compose Material 3

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

結構

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.2"
    implementation "androidx.compose.material3:material3-window-size-class:1.3.2"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha17"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

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-alpha01androidx.compose.material3:material3-common-android:1.0.0-alpha01androidx.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-alpha07androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07androidx.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-alpha06androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06。1.0.0-alpha06 版包含這些修訂項目

API 變更

  • containerColorcontentColor 新增至 NavigationSuiteScaffoldDefaults。(I64e3ab/331993720)
  • itemColors 函式新增至 NavigationSuiteDefaults。(Idf719b/328480012)
  • NavigationSuiteScope 設為密封。(Iefa57)

1.0.0-alpha05 版本

2024 年 3 月 6 日

發布 androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05androidx.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-alpha04androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha041.0.0-alpha04 版包含以下修訂項目。

依附元件更新

  • 將 Material3 自適應依附元件更新為新的模組路徑。(Ibc421)
  • 遷移至使用 Window Manager 版本的視窗大小類別。(I3794d)

1.0.0-alpha03 版本

2024 年 2 月 7 日

發布 androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03查看 1.0.0-alpha03 版的修訂項

API 變更

  • 將套件名稱從 navigation-suite 更新為 navigationsuite (I7eff7)
  • 我們已更新 API 中公開 MutableInteractionSource 的 Material3 元件,現在會公開可為空值的 MutableInteractionSource,預設值為 null。這裡沒有語意變更:傳遞空值表示您不希望提升 MutableInteractionSource,且系統會在元件內建立 MutableInteractionSource (如有需要)。變更為空值可讓某些元件永遠不會分配 MutableInteractionSource,其他元件則只會在需要時延遲建立執行個體,進而提升這些元件的效能。如果您未使用傳遞至這些元件的 MutableInteractionSource,建議改為傳遞空值。建議您在自己的元件中進行類似變更。(I41abbb/298048146)

1.0.0-alpha02 版

2023 年 12 月 13 日

發布 androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha021.0.0-alpha02 版本包含以下修訂項目。

新功能

修正錯誤

  • 修正根介面含有 modifier.fillMaxSize 時,導覽元件會填滿整個畫面的問題。(c9cf250b/312664933)

1.0.0-alpha01 版

2023 年 11 月 15 日

發布 androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha011.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

Compose Material3 Adaptive 1.0 版

1.0.0-alpha06 版本

2024 年 2 月 7 日

發布 androidx.compose.material3:material3-adaptive:1.0.0-alpha06androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha061.0.0-alpha06 版包含此連結所列的修訂項目。

新功能

  • ThreePaneScaffoldNavigator 返回導覽新增其他行為選項。(I858aa)
  • 在瀏覽記錄中新增選用目的地內容。(Ibd7e6)

1.0.0-alpha05 版本

2024 年 1 月 24 日

發布 androidx.compose.material3:material3-adaptive:1.0.0-alpha05androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05androidx.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-alpha04androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha041.0.0-alpha04 版包含以下修訂項目。

新功能

  • 在窗格架構中新增無邊框支援 (I1b462)

API 變更

  • 將 Posture 中的鉸鏈邊界屬性移至鉸鏈資訊清單 (I24f90)

修正錯誤

  • 修正 AnimatedPane 未重新組合的問題 (c3f573d)

1.0.0-alpha03 版本

2023 年 12 月 13 日

發布 androidx.compose.material3:material3-adaptive:1.0.0-alpha03androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03androidx.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-alpha02androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha021.0.0-alpha02 版本包含以下修訂項目。

API 變更

  • 將導覽 API 從自動調整式 Scaffold API 分離。(Ic4045)
  • 移除 GutterSize 類別。(I785b3)

修正錯誤

  • 修正未使用 AnimatedPane 時,窗格不會切換的問題 (d88f181)

1.0.0-alpha01 版

2023 年 11 月 15 日

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

新功能

Material3 自適應條件 API:

Material3 自動調整式窗格架構指令 API:

Material3 自動調整窗格 scaffold API:

Compose Material3 1.4 版

1.4.0-alpha17 版

2025 年 7 月 2 日

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

新功能

  • 更新按鈕群組的動畫,在點選時動畫會播放至 75%,而非按壓時。(593942ab/423596967)

修正錯誤

  • 修正問題:在某些情況下,輪播項目可能會在版面配置計算期間超出大型元素大小,導致整個小工具遭到裁剪。(I1c3d7b/397489534)
  • 修正捲動輪轉介面時,如果開始和結束偏移量重疊,會跳過 beforeContentPadding 的問題。(c3d5f3ab/420618979)
  • 更新 SwipeToDismiss 的啟用行為,以觀察結算狀態而非目前狀態。還原現有行為,只有在元件處於已關閉狀態時,才會停用錨點行為。(3844e07b/425006844)
  • 現在可以透過鍵盤輸入開啟 ExposedDropdownMenu 的彈出式選單。此外,也修正了可編輯變體現在可透過鍵盤存取選單的問題。(46ead03)

1.4.0-alpha16 版

2025 年 6 月 18 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha16。1.4.0-alpha16 版包含這些修訂項目

新功能

  • 新增置中對齊的主要輪轉介面元件 (I6f6d3)

API 變更

  • 實作 XR 覆寫垂直工具列 (Ia1604)
  • CarouselState 中新增程式輔助捲動函式 (I12f8e)
  • ModalWideNavigationRail 新增 ComponentOverride (I4f440)
  • WideNavigationRail 新增 ComponentOverride (I6354f)
  • 為「HorizontalFloatingToolbar」建立「ComponentOverride」(I51116)
  • 為「ShortNavigationBar」建立「ComponentOverride」 (I30e24)
  • SwipeToDismissBoxStateconfirmValueChange 的參照已標示為已淘汰。使用者應改用 SwipeToDismissBox API onDismissed 回呼。(Iee780)
  • 在輪轉介面可組合函式中新增 userScrollEnabled 參數。(I1d4d2)
  • 現在可以從 CarouselState 觀察輪播的 currentItem。(Ie87e9)

修正錯誤

  • 修正問題:傳遞至 FloatingToolbar 的任意 FAB 形狀未正確套用陰影。(Icdcc9b/423336922)
  • 所有輪轉介面現在預設都會使用輪轉介面語意角色。(I7af12)
  • 修正透過 LaunchedEffect 更新滑桿狀態時,滑桿控點移動不正確的問題 (Id9f31b/302774166)

1.4.0-alpha15 版本

2025 年 5 月 20 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha15。1.4.0-alpha15 版包含這些修訂項目

API 變更

  • 新增了 MotionTheme.LocalMotionScheme,即組合區域。這樣一來,您就能透過 currentValueOf(MotionTheme.LocalMotionScheme)CompositionLocalConsumerModifierNodes 存取主題動作配置。(I014b1)
  • 不含固定顏色角色的 ColorScheme 建構函式現已淘汰,請遷移至包含固定角色的建構函式。(Iad0ee)
  • M3 Text 元件現在支援 TextAutoSize。(I7f524)
  • 新增 API,用於建構分割按鈕大小變體,並新增範例。(Ice30b)

修正錯誤

  • 修正問題:啟用無邊框模式時,SnackbarFloatingActionButton 的位置不正確。Scaffold 現在會正確地將水平插邊套用至這些元件。(Ib7c30b/244400727)
  • 修正 BottomSheet 動作,從完全展開到部分展開。BottomSheet 現在隱藏或摺疊時會使用 MotionScheme 的快速效果,展開時則會使用預設空間效果。(Ifa46fb/416063171)
  • 沒有介面容器角色的 ColorScheme 建構函式已標示為隱藏,不建議再使用。(Ia7237)
  • 移除了 CircularWavyProgressIndicator Size.minDimension > 0 規定 (過去會擲回例外狀況),提供更大的彈性。(Ic9418b/377531195)
  • Text(AnnotatedString) 中的超連結現在預設採用 Material 樣式。(I78288b/339843816)
  • 修正 RoundedPolygon 中的 toShape() 函式會快取路徑的問題,導致使用不同大小進行多次 createOutline 呼叫時發生問題。(I4026d)

1.4.0-alpha14 版

2025 年 5 月 7 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha14。1.4.0-alpha14 版包含這些修訂項目

API 變更

  • 新增了 AppBarColumn 可組合函式,運作方式與 AppBarRow 相同,但適用於以直欄形式配置的內容。(Iaf6bd)
  • AppBarRow 中新增項目上限,這是正確導入頂端應用程式列 Material 規格的必要條件。(I92ce4)
  • TooltipScope 中新增方法,以取得錨點的 layoutCoordinates。由於開發人員可以使用這個新方法取得錨點界線 layoutCoordinates,並建立包含插入號的適當形狀,因此我們將淘汰 drawCaret 方法。(Ia2e12b/329470609)
  • 新增對日期挑選器的 java.time 支援:導入接受 java.time 物件 (例如初始 LocalDateYearMonth) 的 rememberDatePickerState/rememberDateRangePickerState 多載。此外,也在狀態物件上新增擴充功能函式,可使用 LocalDateYearMonth 等型別取得/設定值。需要 API 26 以上版本或 desugaring。(I70f29b/266202516b/281859606)
  • 新增 CenteredTrack 可組合函式,允許使用從中心開始的滑桿。(I5b1d6)

修正錯誤

  • 提升波浪進度指標的效能:線性類型現在的載入速度提升約 8.5%,配置減少約 11%;圓形類型的速度大幅提升約 47%,配置減少約 39%。(I595d8)

1.4.0-alpha13 版

2025 年 4 月 23 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha13。1.4.0-alpha13 版包含這些修訂項目

API 變更

  • isAppearanceLightStatusBarsisAppearanceLightNavigationBars 重新導入 ModalBottomSheetProperties,做為僅限 Android 的參數。(Id4bc0)
  • 新增 AppBarRow 可組合函式,處理超出邊界的項目溢位。(I742bd)
  • 更新 DatePickerDateRangePicker API,以便在切換至日期輸入模式時要求焦點。我們已將 requestFocus 布林值參數替換為選用的 focusRequester 參數,該參數會採用 FocusRequester。(I14b69)
  • 從預設可點選和可切換的項目中移除修飾符和互動來源。請改為將其視為實作詳細資料。(I95ed6)
  • 更新 ButtonGroup,如果按鈕過多而無法顯示在畫面上,就會溢位到下拉式選單。(I7b88b)

修正錯誤

  • 如果底部功能表小於目前的偏移量,現在會使用頂端插邊。使用者可藉此為展開行為提供頂端插邊。BottomSheetDefaults.windowInsets 現在包含 WindowInsets.safeDrawing.Top。(I0ab67b/321877275b/336962418b/342093067)
  • 啟用進入/離開動畫 (淡入/滑動),在新增或移除 Chip 前方圖示/Avatar 和後方圖示時顯示。這項功能主要適用於可選取的動態磚 (篩選器、輸入),但一般也適用。(I9af21)
  • 修正 LookaheadScope 導致的 RTL 滑桿行為異常問題。(Ieb152b/408118041)
  • 修正與隱藏系統 UI 捲動相關的 Bottom AppBar 當機問題。(Ic6140b/405996228)

1.4.0-alpha12 版

2025 年 4 月 9 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha12。1.4.0-alpha12 版包含這些修訂項目

API 變更

  • ModalBottomSheetProperties 移除 Android 專屬參數 (Iab97fb/362539765)
  • 推出拖曳控點大小預設值的超載函式 (I0ed0d)
  • 新增 NavigationSuiteScaffoldNavigationSuiteScaffoldLayout 函式,支援新的版面配置類型,並新增對選用主要動作內容的支援。(Ib262ab/353144478)
  • ButtonGroup 中,使用填滿參數淘汰 Modifier.weight。新增沒有填滿的版本。(Id32bb)
  • xSmall-xLarge- IconButton 元件預設值重新命名為 extra。(Ib6e0f)
  • 新增 NavigationSuiteNavigationSuiteItemNavigationSuiteColors 函式,支援新的版面配置類型。(I203d6)
  • 新增 NavigationSuiteTypes,並新增包含這些版面配置選項的 navigationSuiteType 函式 (If68f9)

修正錯誤

  • ColorScheme.contentColorFor 現在會將 surfaceDim 對應至 onSurface。(I8891a)
  • 更新 DateInputTextField 實作方式,解決輸入欄位未反映以程式輔助設定日期的問題。(I6c8d1b/401143451)
  • 修正導覽邊欄和寬版導覽邊欄的 TalkBack 對焦順序 (I6cf6fb/407048224)

1.4.0-alpha11 版

2025 年 3 月 26 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha11。1.4.0-alpha11 版包含這些修訂項目

API 變更

  • 更新按鈕和切換按鈕預設物件中可組合函式屬性的大小寫。在 ToggleButtonDefaultsButtonDefaults 中新增方法,根據容器高度建議內容邊框間距、形狀、圖示大小、圖示間距和文字樣式。(Iea69e)
  • FloatingToolbar 中移除已淘汰的實驗性函式和常數。(I8f339)
  • 高程元件現在共用介面,並具有公開建構函式和屬性。(Ibb172)
  • ButtonGroupScope 中新增 animateWidth 修飾符,必須與按鈕群組的子項搭配使用,才能正確為子項製作動畫。(Ia3bb6)

修正錯誤

  • 修正浮動工具列的邊框間距,確保在摺疊時的視覺平衡,並提升較大內容的彈性。(I06c00)

1.4.0-alpha10 版本

2025 年 3 月 12 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha10。1.4.0-alpha10 版包含這些修訂項目

API 變更

  • TabRowDefaults.tabIndicatorOffset 已淘汰,請改用 TabIndicatorScope.tabIndicatorOffset。(Ib36b3)
  • 修正按鈕預設值中小型內容邊框間距的錯字。(I19bfe)
  • TabRowScrollableTabRow 已淘汰,並改用各項目的「主要」和「次要」變體。主要和次要分頁列的效能更高,且更符合規格。(I918e2)
  • 新增 rememberSliderStaterememberRangeSliderState。(I8e384)
  • SliderState 中新增 shouldAutoSnap,可控制自動對齊機制,停用這項機制有助於自訂動畫。(I07745)
  • 可捲動分頁列的最小分頁寬度現在是參數。主要和次要分頁列變體不再是實驗版,(If6f15b/226665301)
  • 將類別設為 ExitAlwaysFloatingToolbarScrollBehavior 公開,允許在沒有組合的情況下建立。(Ibf31c)

1.4.0-alpha09 版本

2025 年 2 月 26 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha09。1.4.0-alpha09 版包含這些修訂項目

API 變更

  • 在預設狀態下重新命名 DragHandle 的設定欄位;區分按下和拖曳狀態;將預設大小設為公開。(I787b9)
  • TowRowsTopAppBar API 更新。移除 expanded lambda 參數,並為展開和收合高度新增個別參數。(Idd677b/306697446b/229134133b/268068946)

修正錯誤

  • 底部應用程式列現在會監控觸控探索服務 (例如 TalkBack),並在服務開啟時保持顯示。(I4b34d)

1.4.0-alpha08 版本

2025 年 2 月 12 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha08。1.4.0-alpha08 版包含這些修訂項目

新功能

  • 新增 TimePickerDialog API,可用於 TimePickerTimeInput 或切換版本。(Id2d83)

  • 新的搜尋列 API:

    • 收合式搜尋列和展開式搜尋「檢視畫面」現在是不同的可組合函式。
    • SearchBar 代表收合狀態的搜尋列。
    • ExpandedFullScreenSearchBarExpandedDockedSearchBar 代表展開狀態的搜尋列。這些連結會在新視窗中開啟。
    • SearchBarState,用於控管搜尋列的狀態
    • TopSearchBar,即可新增插邊處理和捲動行為
    • 使用 SearchBarStateInputField 新多載 (Ie0723b/261496232b/283311462b/350916229b/352872248)

API 變更

  • 支援在按下時變形圖示按鈕的圓角形狀。(I21843)
  • 文字欄位裝飾器/裝飾方塊 API 不再處於實驗階段。(I31d95)
  • 已為 ButtonGroup 新增連結變體的範例和預設值。(I5c8ce)
  • NavigationSuiteScaffoldNavigationSuiteScaffoldLayout 中,將狀態參數設為最後一個參數。(I9cc7b)

修正錯誤

  • FloatingToolbars 中新增自訂無障礙操作,無障礙服務現在可以展開或收合所有 FloatingToolbar 變體。配備懸浮動作按鈕的版本會將此設定套用至懸浮動作按鈕,而沒有懸浮動作按鈕的版本則會套用至主要內容。(I26420)
  • FloatingToolbars現在請觀察觸控探索服務 (例如 TalkBack),並在服務開啟時保持工具列展開和顯示狀態。(I02172)
  • 修正進度和載入指標的當機問題,避免 Float.NaN 做為進度傳遞時發生當機。(I4fa96b/352364576)

1.4.0-alpha07 版本

2025 年 1 月 29 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha07。1.4.0-alpha07 版包含這些修訂項目

新功能

  • 新增 API,可更彈性地自訂核取方塊的外觀。這個 API 提供筆觸參數,可進一步控制勾號和核取方塊外框的轉譯方式。(I65a88)
  • 新增 TwoRowsTopAppBar API,可取代中型和大型應用程式列,建立兩列頂端應用程式列,並提供更多自訂選項。開發人員現在可以控制收合和展開狀態的標題和副標題內容,並自訂每種狀態的高度。(I0be3cb/306697446b/229134133b/268068946)

API 變更

  • 將實驗性 BottomAppBar 變數重新命名為 FlexibleBottomAppBar,提供更多內容排列和高度的控制權。(Iaa448)
  • 將 Button Group 預設物件中的屬性命名更新為 CapitalCase。更新 animateFraction 的名稱,更準確地反映其代表的行為。(I545cd)
  • 新增常用按鈕的超載,以便在按下互動時顯示動畫形狀。新增快取按鈕形狀。(I5ec20)
  • 您現在可以提供 FloatingToolbarScrollBehavior,控制含有 FAB 的 FloatingToolbar 對捲動的反應。如果是位於中央邊緣 (例如頂端或底部中央) 的工具列,建議使用捲動行為,在捲動時隱藏整個元件,讓畫面更簡潔。這也能避免 FAB 偏離中心,使用 expanded 旗標進行摺疊時可能會發生這種情況。(I33f67)
  • 更新實驗性 TopAppBar API,在設定標題和副標題的對齊方式時,使用 Alignment.Horizontal 而非自訂 TopAppBarTitleAlignment。(I70ca2)
  • SliderState#onValueChange 現已公開,可讓使用者進一步控管 (I104eb)
  • 導入 NavigationSuiteScaffoldState,允許導覽元件的動畫效果。此外,也介紹具有狀態參數的 NavigationSuiteScaffoldNavigationSuiteScaffoldLayout 超載。(I6a8c9b/328674235)

修正錯誤

  • IconButtonColorsIconToggleButtonColors 類別從 IconButtonDefaults.kt 移回 IconButton.kt。(I3c233)

外部貢獻

  • SliderState#isDragging 現已公開。(I8458a)

1.4.0-alpha06 版本

2025 年 1 月 15 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha06。1.4.0-alpha06 版包含這些修訂項目

行為變更

  • 在 Material 元件預設考量的插邊群組中新增 displayCutout,避免內容與螢幕凹口重疊。這項行為變更會影響內插感知元件在螢幕凹口周圍的行為。包括適用於插邊感知 Material 3 元件的 WindowInsets 參數預設值,以及 Material 2 和 Material 3 元件 Defaults 物件中提供的 WindowInsets 值。如果這項變更導致不當行為,請手動指定每個元件的 WindowInsets 參數。(I43ee9b/362508045)

API 變更

  • TopAppBar API 更新。將附有副標題的中型和大型頂端應用程式列重新命名為 *FlexibleTopAppBar。將顏色變化統一為單一 TopAppBarDefault.topAppBarColors() 函式,並新增 subtitle 顏色參數,用於套用至提供的副標題可組合函式 (I41b65)
  • 移除 WideNavigationRailArrangement API,改用 Arrangement.Vertical (Id0341)
  • 新增 VerticalSlider @Composable。(I2bfba)
  • 新增 @Composable 軌道,可指定自訂外部軌道角落和軌道圖示。(I436a4)
  • 更新浮動工具列 API,改用 FloatingToolbarColors 物件,而非單一容器顏色。(I9a054)
  • 新增及使用新的實驗性註解 ExperimentalMaterial3ComponentOverrideApi (Ia1eaf)
  • Modifier.indicatorLine 現在會採用文字欄位的形狀來處理剪裁作業。(I8c5f3b/380704151)
  • 將實驗性的 FloatingAppBar 函式重新命名為 FloatingToolbar (I1dbf8)
  • 新增 floatingToolbarVerticalNestedScroll,可附加至可捲動的容器,根據超過門檻的捲動動作更新浮動工具列的展開狀態。(I6d65f)
  • 我們推出新的 API,可建立附有懸浮動作按鈕 (FAB) 的懸浮工具列。這個 API 提供彈性的自訂選項,可讓您水平或垂直排列工具列,並將 FAB 放在工具列的開頭或結尾。(I9e350)

修正錯誤

  • 修正 Snackbar 無障礙功能問題,避免在 TalkBack 處於開啟狀態時,Snackbar 在關閉時自行公告。(/I9db53)

外部貢獻

  • 基礎架構中的 BasicTooltip 和 Material 3 中的 BasicTooltip/Tooltip 均已通用化。(Ifc2e6)

1.4.0-alpha05 版

2024 年 12 月 12 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha05。1.4.0-alpha05 版包含這些修訂項目

API 變更

  • 替換列舉的 WideNavigationRailState.current/target 值中的型別,以提高可讀性 (I2d6ab)
  • SplitButton 將 Shape API 從資料類別變更為類別,以確保二進位檔相容性。(I53812)
  • 新增了含有 onDismissRequest 參數的工具提示 API,因此製作者可以決定使用者點選工具提示外部時會發生什麼情況。淘汰不含這個新參數的舊版 API。(I99aef)
  • opticalCentering 的命名方式變更為 horizontalCenterOptically。將修飾符設為內部。將邊框間距參數換成最大開始和結束偏移量。(I0b904)
  • WideNavigationRailState 變更為目前/目標值,並移除列舉,改用布林值。(Idfa29b/356039090)
  • 新增 NavigationBarItemComponentOverride。(I3a06a)

修正錯誤

  • 修正頂端和底部應用程式列的行為,確保在內容捲動到底時,顏色會穩定變更。(Idc4e8b/293665988)
  • 頂端和底部應用程式列的捲動行為函式現在會傳回記憶的行為,以便在重組作業中獲得更出色的效能。(I0fdbeb/207957336)
  • 修飾符參數現在會套用至拖曳行為和語意等內部修飾符之後,而非之前。這會影響修飾符的套用順序。(I8d83f)
  • 變更大小時,展開的底部功能表會維持展開狀態。(I2870bb/324934884)
  • 正確為視窗屬性傳送狀態和導覽列旗標。(Ie674db/362539765)
  • 如文件所述,將修飾符參數移至 scaffolds 根目錄。這與 M2 的實作方式一致。(I0235eb/372311595)

外部貢獻

  • 已將 DatePickerDialog 函式一般化。(I7dced)

1.4.0-alpha04 版本

2024 年 11 月 13 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha04。1.4.0-alpha04 版包含這些修訂項目

行為變更

  • aosp/3212478 中導入的顏色變更還原至 iconButtonColorsiconToggleButtonColorsoutlinedIconButtonColorsoutlinedIconToggleButtonColorsoutlinedIconToggleButtonBorder。我們已將還原的行為移至名為 iconButtonVibrantColors 等的新函式集,強調傳回的高對比色彩。(Iffd8d)

新功能

  • 導入 VerticalDragHandle 元件 (I6c770)

API 變更

  • DismissibleModalWideNavigationRailDefaults 重新命名為 ModalWideNavigationRailDefaults。(I8e877)
  • 新增 NavigationBarComponentOverrides。(I8a3f3)
  • 新增 NavigationRailComponentOverride。(I83e13)
  • 導入 WideNavigationRailState 來處理導覽列的收合/展開作業,允許 ModalWideNavigationRail 可關閉,並刪除 DismissibleModalWideNavigationRail。(I88568)
  • 將 xSmall、medium、large 和 xLarge 大小的預設值新增至切換按鈕預設值。(Ie95d1)
  • 將 xSmall、medium、large 和 xLarge 大小的預設值新增至按鈕預設值。(If8b6d)

修正錯誤

  • 根據規格,篩選器晶片尾端圖示顏色已從「主要」更新為 OnSurfaceContainer。根據規格,所有晶片外框顏色已從「外框」更新為「外框變體」。(I68bd4)

1.4.0-alpha03 版

2024 年 10 月 30 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha03。1.4.0-alpha03 版包含這些修訂項目

API 變更

  • 已淘汰具有密度的 SheetState 建構函式,並改用位置和速度門檻。(Ifd16e)
  • 新增 rememberTooltipPositionProvider,其中包含更新後的定位邏輯。淘汰了 rememberPlainTooltipPositionProviderrememberRichTooltipPositionProvider。(Ie66e2)
  • 其他 ModalBottomSheetProperties 則可自訂狀態列和導覽列的顏色。根據預設,這些項目會根據內容顏色更新,而非系統深色主題狀態。(Ib874eb/362539765)
  • 改善日期挑選器的輸入體驗:在輸入模式下,系統會將焦點放在日期文字欄位,方便使用者立即輸入文字。這項變更會在 DatePickerDateRangePicker 中新增 requestFocus 參數。您可以傳遞 false 來防止焦點。(I12d09b/286399710b/340102743)
  • 將形狀預設值快取到 Shape 物件中。製作切換按鈕的預設形狀 @Composable。由於變體指向相同的符記檔案,因此會將形狀摺疊成一個預設形狀。(Iaa014)

修正錯誤

  • 最佳化 Scaffold contentPadding 行為,避免在 contentPadding 變更時一律重組主體內容。(I8c8e2b/373904168)
  • TextFieldLabelScope progress 已重新命名為 labelMinimizedProgress
  • TextFieldLabelPosition Default 已重新命名為 Attached。介面成員已移除。(If75c6)
  • 修正輸入模式中 DatePicker 的問題,驗證錯誤可能會導致元件高度變更。(I2e229b/280462363)
  • 按下控制鍵時,讓 Material Slider 變更值。(I1c442)

1.4.0-alpha02 版

2024 年 10 月 16 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha02。1.4.0-alpha02 版包含這些修訂項目

API 變更

  • 更新日期挑選器,確保在透過 DatePickerStateDateRangePickerState 直接設定地區時,DatePickerDateRangePicker 會使用一致的地區設定。請注意,如果直接將語言代碼設為狀態,您必須確保系統會相應地本地化標題和廣告標題文字,因為系統仍會根據預設平台語言代碼套用預設文字。(I37073b/326490763b/321657276)
  • SheetState.isAnimationRunning 現已公開。(I9a3d7)
  • DatePickerColors 現在會正確優先於主題的「Typography」文字樣式中定義的任何衝突顏色。此外,請注意,這項更新會調整日期挑選器函式中 color 參數的位置,並導入 contentColor 參數,用於自訂標題和標題文字顏色。(I30d03b/347031394)
  • SplitButton 重新命名為 SplitButtonLayout,並移除 SplitButton 顏色變體 API,變體將透過重複使用 SplitButtonDefaults 提供的按鈕變體達成。(I44c36)
  • ModalBottomSheet 現在有 sheetGestureEnabled 參數 (I856cbb/288211587)
  • 已將 standardMotionSchemeexpressiveMotionScheme 重新命名為「標準」和「生動」。現在只要呼叫 MotionScheme.standard()MotionScheme.expressive(),即可透過 MotionScheme 伴隨物件存取這兩個函式。(Iceccf)
  • 在純文字和進階工具提示中新增 maxWidth 參數。純文字工具提示的預設設計規格為 200 dp,豐富工具提示則為 320 dp。(I30ce9)

修正錯誤

  • 現在透過狀態的 displayedMonthMillis 設定時,DatePickerDateRangePicker 會正確更新顯示的月份。(If9e47b/333414302)
  • ModalBottomSheet」內容現在會將內容移離狀態列。(I5114cb/321877275b/336962418b/342093067)
  • [Bottom Sheet] Change back callback priority to PRIORITY_DEFAULT to allow IME keyboard to dismiss first. (I447fb)
  • 修正將可選取的最低年份設為未來年份時,DatePickerDateRangePicker 中的當機問題。(I78656b/319395747)
  • 修正日期挑選器問題,以便在套用更新後的 SelectableDates 執行個體時更新 UI。(Iad59ab/290135807b/339898760)

1.4.0-alpha01 版

2024 年 10 月 2 日

發布 androidx.compose.material3:material3-*:1.4.0-alpha01。1.4.0-alpha01 版包含這些修訂項目

行為變更

  • 程式庫不再將依附元件新增至 material-icons-core,因此如果專案依賴該依附元件,您必須在 build.gradle[.kts] 檔案中明確新增該依附元件。(I735ffb/349894318)
  • NavigationBarItemNavigationRailItem 的有效標籤顏色會從 onSurface 變更為 secondary,以提升可用性、顏色對比度,並改善系統內的一致性 (Ibc297)。如要還原先前的行為,請複製預設顏色,並將 selectedTextColor 變更為 MaterialTheme.colorScheme.onSurface
  • Material 3 元件現在使用新的 MotionScheme 定義動作。(Ie0f93)
  • 不確定的圓形進度指標動作變更 (I3c07e)
  • 更新 OutlinedIconButtonColorsOutlinedIconToggleButtonColors,提升色彩對比度。(I2743d)
  • 更新 FilledIconToggleButtonColorsFilledTonalIconToggleButtonColors 的容器和內容顏色。(Ic5d0f)
  • 已將「OutlinedButton」的框線顏色從「outline」更新為「outlineVariant」。(057f00)

API 變更

  • TopAppBarenterAlwaysScrollBehavior 函式中新增選用 reverseLayout 參數,以便更妥善地支援以 reverseLayout 設定的內容。(I4e0e5)
  • SegmentedButton 現在支援 contentPadding 引數。(I5ad91b/358414376)
  • PullToRefreshState 不再有 isAnimating 的預設實作項目 (I6a593)
  • 新增使用 TextFieldState 的 Material TextFieldOutlinedTextField 超載。新增與 TextFieldDecorator 相容的裝飾方塊 API。(If13a1)
  • 新增參數來控制文字欄位的 labelPosition。使用 alwaysMinimize 可讓文字欄位在未聚焦時,同時顯示標籤和預留位置的 UI 模式。(I1ef2c)
  • 為密碼輸入欄位新增 Material SecureTextFieldOutlinedSecureTextField。(I7e22d)
  • 在文字欄位標籤中新增範圍,以查詢動畫進度。(If5ec8)
  • 在工具提示中新增對 MotionEvent.CLASSIFICATION_DEEP_PRESS 的支援。(I62e6a)
  • TimePickerStateisAfternoon 現在是擴充功能值,而非介面中的變數,並已重新命名為 isPm (I89a97)
  • 更新字體排版類別,支援強調的字體比例。(Ifa13c)
  • 新增 ModalWideNavigationRail API,並將 ModalExpandedNavigationRail API 重新命名為 DismissibleModalWideNavigationRail。(Ic9118)
  • 更新 FloatingAppBarScrollBehavior,自動計算 screenOffset,不需 @Composable。(Idf349)
  • 更新 LoadingIndicator API,修正預設物件的命名。在 PullToRefresh 中新增了 LoadingIndicatorElevation 常數。(I1d72b)
  • 更新 LoadingIndicator API,修正預設物件的命名。在 PullToRefresh 中新增了 LoadingIndicatorElevation 常數。(I1d72b)
  • LinearWavyProgressIndicatorCircularWavyProgressIndicator 的不確定變體中新增 amplitudewaveSpeed 參數。(I2a0c5)
  • 支援根據圖示切換按鈕的按下或勾選狀態,變更按鈕形狀。(Ibc781)
  • 更新字體排版類別,支援強調的字體比例。(Ifa13c)
  • SplitButton 形狀會根據預設 / 按下狀態變形。移除了 AnimatedTrailingButton API,因為 TrailingButton API 可提供相同的自訂項目 (I95066)
  • 新增修飾符,為顯示和隱藏 FAB 的動作加上動畫效果,例如在內容捲動時。(I8338d)
  • ButtonGroupDefaults 中新增已連結的按鈕群組形狀和間距,以用於範例。(I68e30)
  • 分割按鈕會為尾端按鈕新增水平邊框間距,並根據開始和結束角差異計算光學置中 (I122e2)
  • 推出新的 Material MotionScheme,可設定元件動作的配置。配置是透過 MaterialTheme 設定。(Id50c2)

修正錯誤

  • Scaffold 子項可組合函式套用正確的焦點遍歷索引。順序為 topBarbottomBar、FAB、內容、資訊列。(I5936b)
  • 修正 DatePickerDateRangePicker 的問題:在特定語言代碼和格式架構中,部分日期元素 (例如月份名稱) 並非以大寫字母開頭。(I1430f)
  • 整合 FAB 和 FAB 選單元件符記 (對邊框間距和文字進行小幅視覺更新) (Ib57f3)
  • ModalBottomSheet 現在位於語意遍歷順序的第一個位置,後面接著是半透明遮罩。(I436f9b/358594665)
  • 修正在無邊框模式下,於導覽藥丸下方捲動時,底部應用程式列不會完全消失的問題 (I3ee21)

Compose Material3 1.3 版

1.3.2 版

2025 年 4 月 9 日

發布 androidx.compose.material3:material3-*:1.3.2。1.3.2 版包含這些修訂項目

修正錯誤

  • ListItem 會修正其內建高度計算,現在會在版面配置中保留適當的空間量。
  • 移除過多的 NavigationBarItem 標籤邊框間距,正確對齊規格。
  • 修正 RTL 模式下的 TabRow 版面配置。

1.3.1 版本

2024 年 10 月 30 日

發布 androidx.compose.material3:material3-*:1.3.1。1.3.1 版包含這些修訂項目

修正錯誤

  • 現在透過狀態的 displayedMonthMillis 設定時,DatePickerDateRangePicker 會正確更新顯示的月份。(If9e47b/333414302)
  • 修正將可選取的最低年份設為未來年份時,DatePickerDateRangePicker 中的當機問題。(I78656b/319395747)
  • 修正日期挑選器問題,以便在套用更新後的 SelectableDates 執行個體時更新 UI。(Iad59ab/290135807b/339898760)
  • 將底部功能表使用的返回回呼優先順序變更為 PRIORITY_DEFAULT,允許輸入法編輯器鍵盤優先關閉。(I447fb)

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

  • 輪轉介面
  • [ModalBottomSheet] 現在支援 U+ 上的預測返回手勢 (Iccf32b/281967264b/304850357)
  • [SearchBar] 現在支援 U 以上版本的預測返回手勢 (I657f8)
  • 導覽匣 (ModalDrawerSheetDismissibleDrawerSheet) 現在支援 U+ 上的預測返回功能 (選擇啟用) (Ie5b0b)
  • DropdownMenu 現在支援自訂顏色、形狀、高度和邊框。(I8e981b/289554448b/301887035b/283654243)
  • 更新滑桿,新增間距和停止指標,提升無障礙功能。(I3058e)
  • 更新 ProgressIndicator,新增間隙和停止指標,提升無障礙功能。(I21451)
  • 為豐富的工具提示新增預設插入號,支援繪製指定錨點 LayoutCoordinates 的自訂插入號。(Ifd42c) 破壞性變更
  • 全新「下拉更新」API:
    • 簡化 PullToRefreshState,改用分數值而非 Dp 單位。
    • isRefreshing 狀態是由使用者控制,而非 PullToRefreshState
    • PullToRefreshState 分離巢狀捲動連線。這項作業是由新的 PullToRefreshBoxModifier.pullToRefresh 處理。
    • 這項更新會對先前的實驗性 API 造成重大變更。(I0adebb/314496282b/317177684b/323787138b/324573502b/317177683) 視覺重大變更
  • 將焦點狀態疊加層更新為 0.1f,確保色彩對比度充足。(I7ea77)
  • lightColorSchemedarkColorScheme 中,對表面和背景顏色預設值進行小幅調整。(I9db52)
  • 更新滑桿和 ProgressIndicator 顏色,以符合新的非文字對比度規格。(I26807)
  • 元件現在會使用 SurfaceContainer 變體。正式計算顏色時,原本使用 SurfaceTonalElevation 的元件現在預設會使用 SurfaceContainer 角色,這些角色不會受到色調高程影響。(b/304584161)
  • 介面和介面容器的基準角色已略有調整,可在淺色和深色主題中提供更多色調。(I677a5)
  • 實驗性 API 升級為穩定版!
  • 提升效能

1.3.0-rc01 版本

2024 年 8 月 21 日

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

修正錯誤

  • ModalBottomSheet 現在位於語意遍歷順序的第一個位置,後面接著是半透明遮罩。(I436f9b/358594665)

1.3.0-beta05 版

2024 年 7 月 24 日

發布 androidx.compose.material3:material3-*:1.3.0-beta05。1.3.0-beta05 版包含這些修訂項目

  • 修正 Android N 和 O (a10a2d) 缺少或截斷 BottomSheet 內容的問題
  • 增加滑桿的語意界限,以便 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 和 Label 中使用。(I3833e)
  • CarouselItemScope 中新增 maskClipmaskBorder 這兩個修飾符,方便為任何輪播項目新增形狀和邊框 (Id67a1)
  • TimePickerState 現在是介面,可供設定時間 (I88546)
  • 更新了連結樣式 API:將 TextLinkStyles 移至 TextStyle,並從 Material 中移除 TextDefaults。(I5477b)

修正錯誤

  • ModalBottomSheet狀態和導覽列圖示現在會根據深色主題狀態調整。(Ie1fe7b/338342149)
  • ModalBottomSheet 遮罩中新增關閉工作表語意。(0e61cbb/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,以便在文字中取得 Material 主題連結。具體來說,我們從 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 分離巢狀捲動連線。這項作業是由新的 PullToRefreshBoxModifier.pullToRefresh 處理。
    • 這項更新會對先前的實驗性 API 造成重大變更。(I0adebb/314496282b/317177684b/323787138b/324573502b/317177683)

API 變更

  • RippleConfiguration#isEnabled 已移除,LocalRippleConfiguration 則已設為可為空值。如要停用漣漪效果,請提供 nullLocalRippleConfiguration,而不是提供 RippleConfigurationisEnabled = false。(I22725)
  • 啟用無邊框模式時,ModalBottomSheet可更準確地在狀態列上繪製半透明遮罩。模態底部功能表內容現在可以取用視窗插邊,讓導覽列上方的內容可見。ModalBottomSheet 參數 windowInsets 已重新命名為 contentWindowInsets,用於指定要套用插邊的位置,這些插邊不再與視窗邏輯相關聯。contentWindowInsets 類型已變更為會傳回 WindowInsets 的函式,以便在新視窗中解析。(I39630b/274872542b/300280229b/290893168)
  • PrimaryScrollableTabRowSecondaryScrollableTabRow 現在使用自訂版面配置,而非子組合,這應該能提升效能。(I991e0)
  • 除了正常、懸停和焦點樣式,文字連結現在也提供按下狀態樣式選項。TextDefaults 方法各取得一個 pressedStyle 引數,以支援該功能。(Ic473fb/139312671)

修正錯誤

  • 導覽匣的拖曳錨點現在會與 drawerContent 的寬度相符。(Ibc72fb/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 版包含這些修訂項目

新功能

  • SearchBarDockedSearchBar 有新的超載,會採用文字欄位參數。這樣一來,您就能分別設定文字欄位的樣式和其餘搜尋列的樣式,以及傳入自訂文字欄位。目前實作的文字欄位已設為 SearchBarDefaults.InputField。(I50c73b/275074248b/278773336b/326627700)
  • lambda drawTick 已新增至公開 API,可視需要自訂刻度 (I0c048)

API 變更

  • 除了正常樣式、懸停和焦點樣式外,文字連結現在也提供按下狀態樣式選項 (I5f864b/139312671)
  • 更新 CarouselItemInfo,公開項目裁剪的遮罩 Rect (I785d8)
  • 已從 Material 3 公用 API 移除 BasicTooltipState。在 Foundation 的 BasicTooltip 穩定之前,這項功能會與 TooltipState 合併。(Icda29)
  • 新增 TextDefaults 物件,內含建構 LinkAnnotation 和剖析套用 MaterialTheme 至連結的 HTML 標記字串的方法 (I98532b/139312671)
  • ExposedDropdownMenuBoxScope 不再允許子類別。外顯下拉式選單現在有 MenuAnchorType,應傳遞至 menuAnchor,以支援更完善的無障礙功能。請使用這個方法,不要再將 focusable 傳遞至 ExposedDropdownMenu (這個方法現已淘汰)。menuAnchor 有新的參數可控制 enabled 狀態。(I55ee6b/257209915b/308840226)
  • 修正停用時 OutlinedButton 的邊框顏色。新增了可取得啟用狀態的 ButtonDefaults.outlinedButtonBorder("enabled") 多載。(Ie650bb/318461363)
  • 新增 CarouselItemInfo 類別,協助用戶端取得商品尺寸資訊。(I9070c)
  • 不含介面容器的 ColorScheme 建構函式現已淘汰,請遷移至包含介面容器的建構函式。(I35c11)
  • [Outlined]TextFieldDefaults ContainerBox 已重新命名為 Container。(Ie8d3b)

修正錯誤

  • 如果 sheetSwipeEnabled 為 false,BottomSheetScaffold 將不再從巢狀捲動中捲動。(I5e1c1b/306464779)
  • 已移除 IconButtonSamples.kt 中的部分 ExperimentalMaterial3Api OptIn 註解。(I111d1)

1.3.0-alpha04 版本

2024 年 4 月 3 日

發布 androidx.compose.material3:material3-*:1.3.0-alpha04。1.3.0-alpha04 版包含這些修訂項目

新功能

  • 新增 Material3 輪播的兩個實驗性版本 - HorizontalMultiBrowseCarouselHorizontalUncontainedCarousel (I88d64)
  • 更新 Compose M3 導覽匣 (ModalDrawerSheetDismissibleDrawerSheet),支援在 U+ 上選擇啟用預測返回手勢 (Ie5b0b)
  • 在 Icon 中新增 API,允許將顏色色調做為 lambda 傳遞,避免重組。(I5b5a2)
  • 頂端應用程式列 API 現在支援固定和可收合區塊的自訂高度。 (Ib8b0cb/323403446)

API 變更

  • 頂端應用程式列 API 現在支援固定和可收合區塊的自訂高度。修正單行頂端應用程式列在捲動內容時,重組次數過多的問題。修正問題:在字型/顯示設定較大的裝置上,MediumTopAppBar 會截斷標題。(Ib8b0cb/323403446b/300953236b/286296147b/330410290b/308540676)
  • SegmentedButton 和相關聯的 API 現在是穩定版 (I8a158)
  • SwipeToDismissBoxSwipeToDismissBoxDefaultsSwipeToDismissBoxStateSwipeToDismissBoxValue 現在標示為穩定版。(I5f000)
  • 已移除已淘汰的 DismissDirectionDismissValue 列舉和 API。(I89ccd)
  • 在 Carousel 的 CarouselState 伴隨物件中新增實驗性標記。(I94154)
  • 淘汰 LocalMinimumInteractiveComponentEnforcement,並推出 LocalMinimumInteractiveComponentSize 取代。(I7a7ac)
  • SearchBarColors 建構函式現在是公開函式。(I769ca)
  • SwipeToDismissBox 中新增 gesturesEnabled 參數。(Idc59fb/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)
  • lightColorSchemedarkColorScheme 中,對表面和背景顏色預設值進行小幅調整。(I9db52)

新功能

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

API 變更

  • 已移除 ScaffoldSubcomposeInMeasureFix 標記。(Ie2a4b)
  • NavigationRailItemColors 現已標示為 @Immutable。(If6112b/327660613)
  • NavigationBarItemColors 現已標示為 @Immutable。(I42a30b/298064514)
  • 重新排序 Slider Track 可組合函式中的參數。(I9f315)
  • ExposedDropdownMenu 現已使用 Popup 實作。除了可編輯文字欄位的可聚焦選單可能會在鍵盤輸入時關閉,其餘行為應相同。

修正錯誤

  • 介面和介面容器的基準角色已略有調整,可在淺色和深色主題中提供更多色調。(I677a5)
  • 更新滑桿和 ProgressIndicator 顏色,以符合新的非文字對比度規格。(I26807)
  • 將焦點狀態疊加層更新為 0.1f,確保色彩對比度充足。(I7ea77)
  • lightColorSchemedarkColorScheme 中,對表面和背景顏色預設值進行小幅調整。(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 中。(I82ab2b/322269951)
  • 導覽元件現在會使用新的 SurfaceContainer 角色。DrawerDefaults 現在提供不同的 standardContainerColormodalContainerColor 屬性。DrawerDefaults.ModalDrawerElevation 現已改名為 0.dp。(I7fbac)
  • 由於我們將「state.onValueChangeFinished」變更為「var」,因此會從「Slider」的狀態中移除「@Stable」。(Ied34ab/322269951)
  • ModalBottomSheetStandardBottomSheet 動畫規格現在是 TweenSpec,已從彈簧效果更新。這可解決可見的過衝問題。已移除不含密度的已淘汰 SheetState 建構函式。(I7babcb/285847707)

修正錯誤

  • 元件現在會使用 SurfaceContainer 變體。正式計算顏色時,元件會使用 Surface 和 TonalElevation,現在預設會使用 SurfaceContainer 角色,這些角色不受色調高度影響。(b/304584161)
  • 修正導致 ElevatedFilterChip 未選取、停用容器顏色為黑色的錯誤。(I400e6b/322407043)
  • 修正進度為 0 時的不確定進度指標 (Id6582)
  • 修正 RTL 版面配置的 SliderRangeSlider 問題 (Iab0e1)
  • 新增 SliderRangeTolerance,用於計算滑桿範圍,因為浮點數四捨五入可能不準確。(Ic918ab/324934900)
  • 確認在巢狀結構中加入 DateRangePicker 時,或是在字型較大的小型螢幕上顯示任何類型的日期挑選器時,DatePickerDialog 會顯示按鈕。(Ie4758b/325107799b/277768544)
  • Menu 現在會使用 SurfaceContainer 角色做為容器顏色。MenuDefaults.TonalElevation 現已改名為 0.dp。(I135b7)
  • TextField 現在會使用 SurfaceContainerHighest 角色做為容器顏色。(I4dced)
  • 凸顯式方塊現在會運用 SurfaceContainerLow 角色 (I7cd2f)
  • DatePicker 容器顏色現在是 SurfaceContainerHighDatePickerDefaults.TonalElevation 現已改名為 0.dp。(Ida753)
  • 更新底部功能表容器顏色和拖曳控點顏色。(I72a0a)
  • RichTooltip 容器顏色現在是 SurfaceContainer。(Ia8b45)
  • SearchBar 容器顏色現在是 SurfaceContainerHighestSearchBarDefaults.TonalElevation 現已改名為 0.dp。(I88604)
  • 更新切換按鈕,停用並取消選取軌道/圖示,以運用 SurfaceContainerHighest 顏色角色。(I7687a)
  • AlertDialog 容器顏色現在是 SurfaceContainerHigh。(Ie0433)
  • BottomAppBar 容器顏色現在是 SurfaceContainerTopAppBar onScroll 顏色現在為 SurfaceContainer。(I41630)
  • ElevatedCard 容器顏色現在是 SurfaceContainerLowFilledCard的容器顏色為 SurfaceContainerHighest。(I35141)
  • ElevatedButton 容器顏色現在是 SurfaceContainerLow。未選取時,FilledIconButton 現在會顯示 SurfaceContainerHighest 的容器顏色。(I792c9)
  • TimePicker 容器顏色和時鐘錶面顏色角色更新為 SurfaceContainerHighest。(I43b93)

1.3.0-alpha01 版本

2024 年 2 月 21 日

發布 androidx.compose.material3:material3-*:1.3.0-alpha011.3.0-alpha01 版包含此連結所列的修訂項目。

新功能

  • 更新 Compose M3 ModalBottomSheet,支援 U+ 上的預測返回手勢 (Iccf32b/281967264b/304850357)
  • 更新 Compose M3 SearchBar,以支援 U+ 上的預測返回手勢 (I657f8)
  • 更新滑桿,新增間距和停止指標,提升無障礙功能。(I3058e)
  • 更新 ProgressIndicator,新增間隙和停止指標,提升無障礙功能。(I21451)
  • 為多媒體工具提示新增預設插入號,現在可透過新的多媒體工具提示 API,根據錨點 LayoutCoordinates 繪製自訂插入號。(Ifd42c)

行為變更

  • Material 元件已遷移至使用新的漣漪 API,不再查詢 RippleTheme

API 變更

  • 現在已公開推出有趣的 drawStopIndicator。(I3f59f)
  • DatePickerformatWithSkeleton 函式標示為內部 (Ic65dc)
  • DropdownMenu 現在支援自訂顏色、形狀、高度和邊框。(I8e981b/289554448b/301887035b/283654243)
  • 我們已更新 API 中公開 MutableInteractionSource 的 Material3 元件,現在會公開可為空值的 MutableInteractionSource,預設值為 null。這裡沒有語意變更:傳遞空值表示您不希望提升 MutableInteractionSource,且系統會在元件內建立 MutableInteractionSource (如有需要)。變更為空值可讓某些元件永遠不會分配 MutableInteractionSource,其他元件則只會在需要時延遲建立執行個體,進而提升這些元件的效能。如果您未使用傳遞至這些元件的 MutableInteractionSource,建議改為傳遞空值。建議您在自己的元件中進行類似變更。(I41abbb/298048146)
  • 新增 RippleConfigurationLocalRippleConfiguration,可使用固定值自訂每個元件 / 子樹狀結構的漣漪效果。舉例來說,變更您無法控制的元件顏色,或是停用元件的漣漪效果。在大多數情況下,應使用預設值:這些 API 是個別元件 / 有限子樹狀結構的自訂逸出閘。如要進行更廣泛的變更和自訂設計系統,請改用 createRippleModifierNode 建構自己的漣漪效果。(I7b5d6b/298048146)
  • 在 Material 3 中新增了漣漪效果 API,取代已淘汰的 rememberRipple。此外,還新增了暫時的 CompositionLocalLocalUseFallbackRippleImplementation,可將 material3 元件還原為使用已淘汰的 rememberRipple / RippleTheme API。這項功能會在下一個穩定版中移除,僅適用於提供自訂 RippleTheme 的情況,做為暫時的遷移輔助工具。(I34cbcb/298048146)

修正錯誤

  • 移除 ModalBottomSheet 內的子組合,以提升效能。修正問題:在特定情境下,ModalBottomSheet 可能會與 LookaheadScope 搭配使用時異常終止。(I2a198)
  • 移除 BottomSheetScaffold 內的子組合,以提升效能。修正問題:在特定情境下,BottomSheetScaffold 會與 LookaheadScope 搭配使用時異常終止。(Ie6401)
  • 徽章對齊方式已調整,會更靠近錨定內容的中心,且位於右上角。(I18a28)
  • 修正 DateRangePicker 的無障礙功能問題,避免系統將「月-年」文字標題傳達為可供螢幕閱讀器、切換控制功能和語音存取使用者操作的項目。(I2ac55)
  • 修正 mediumTopAppBarColors 參數順序錯誤。(Ibe64a)

1.2 版本

1.2.1 版本

2024 年 3 月 6 日

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

修正錯誤

  • 再次穩定滑桿狀態。再次將「State.onValueChangeFinished」設為有效。將 onValueChangeFinished 包裝在 rememberUpdatedState 中。(Ie8fd0b/322269951)
  • 由於我們將「state.onValueChangeFinished」變更為「var」,因此會從「Slider」的狀態中移除「@Stable」。(I82ba1b/322269951)
  • 修正 NavigationBar 自訂顏色,從預設值複製。(80a779b/326894020)
  • 修正 ExposedDropdownMenu 的回歸問題,使其再次可聚焦 (3fcec1b/323694447)
  • 修正按鈕顏色快取問題 (3e5bbcb/327371655)

1.2.0 版本

2024 年 2 月 7 日

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

已知問題

  • PrimaryTabRow 中,我們為提升效能而進行變更,但這項變更卻導致 View-Compose 互通性算繪錯誤。解決方法是搭配使用 TabRowTabRowDefaults.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 版的修訂項目

修正錯誤

  • 修正 mediumTopAppBarColors 參數順序錯誤。(Ibe64a)
  • 修正 1.2.0-beta02 中導入的錯誤,該錯誤不會根據 containerColor 參數值更新 contentColorCardDefaults.cardColors(Iee041b/319671246)
  • 修正 1.2.0-beta02 中導入的 disabledContentColor 錯誤,並進行小幅最佳化。(I6dda1b/318428829)

1.2.0-beta02 版

2024 年 1 月 10 日

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

已知錯誤

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

API 變更

  • 新增功能,可為 Plain Tooltip API 啟用工具提示插入號。(Ibf767)
  • SwipeToDismissStaterememberSwipeToDismissSwipeToDismissValue 都已重新命名為 _SwipeToDismissBox_。(I68d6d)

修正錯誤

  • 修正 ListItem 結尾邊框間距值,使其符合規格。(Ibd68bb/305342674)
  • 帶有外框的資訊卡外框顏色現在已正確對應至 OutlineVariant。(I75480b/310979715)
  • 動態色彩現在會從系統定義的色彩角色中提取。這項變更可提升無障礙內容的對比度,並讓動態色彩更符合 Material 規格。(I1de96)
  • 修正 Android T/13 以上版本在 android:enableOnBackInvokedCallback="true" 時的 ModalBottomSheet 返回處理方式。(I728dcb/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)
  • 淘汰 DismissDirectionDismissValue API。這些屬性已合併為 SwipeToDismissValue,其值會指出 SwipeToDismissBox 的位置和方向。「DismissState.progress」現已標示為介於「0.0」和「1.0」之間的「FloatRange」。已移除已淘汰的 DismissState Saver 和建構函式。SwipeToDismiss 元件、狀態和預設物件已重新標示為實驗性質。(Ib54f2)

修正錯誤

  • PullToRefresh 的預設指標現在是開放式箭頭,而非實心三角形。(I67be3)

1.2.0-alpha12 版本

2023 年 11 月 29 日

發布 androidx.compose.material3:material3-*:1.2.0-alpha121.2.0-alpha12 版本包含以下修訂項目。

API 變更

  • RangeSlider 現在會採用 Kotlin 範圍 (例如 0f..1f),而不是自訂 FloatRange 值類別。SnapFlingBehavior.kt 現在也使用 Kotlin 範圍。(I025cb)
  • 將 Modifier 工廠函式標示為 @Stable。(Ib109f)

1.2.0-alpha11 版本

2023 年 11 月 15 日

發布 androidx.compose.material3:material3-*:1.2.0-alpha111.2.0-alpha11 版本包含以下修訂項目。

新功能

  • 實作 PullToRefreshContainerPullToRefreshState,兩者共同在 Material Design 3 中提供「下拉式重新整理」實作。(I16456b/261760718)

API 變更

  • SwipeToDismissBox DismissDirectionDismissValue 標示為實驗性質。(I517b0)
  • SwipeToDismiss 重新命名為 SwipeToDismissBox。將 background 重新命名為 backgroundContent,並將 dismissContent 重新命名為結尾的 content lambda。(I7f4d3)
  • ChipElevationSelectableChipElevation 的建構函式設為公開。(Ie0c48b/308432421)
  • 正在新增「ModalBottomSheetProperties」。正在將「securePolicy」移至「ModalBottomSheetProperties」。將 isFocusableshouldDismissOnBackPress 新增至 ModalBottomSheetProperties。這些新布林值可協助判斷模態底部功能表應如何處理 IME 事件。(Iea56fb/278216859)
  • 更新 RangeSliderSlider 狀態,移除 initialOnValueChange、初始前置字元和適當的 kdocs。(I57d30)
  • 淘汰 ChipBorder 類別及其相關聯的函式呼叫,建議直接使用 BorderStroke。(I89cc2)
  • 基礎工具提示 API 現已改為 @ExperimentalFoundationApi。(I30b0b)
  • TabRowScrollableTabRow 不再淘汰。新的主要和次要變體會標示為實驗性質。(I0def6)
  • 篩選器和輸入方塊現在會直接使用 BorderStroke。(I07a8d)
  • SegmentedButton 現在會直接使用 BorderStroke。(I89b9b)
  • 將一般 AlertDialog 函式重新命名為 BasicAlertDialog,並淘汰先前的函式。(Idbe52)
  • SwipeToDismiss API 重新命名為 SwipeDismiss,並將新的 SwipeDismiss API 升級為穩定版。(I14cbe)
  • tonalElevationshadowElevation 新增至工具提示 API。此外,由於 TooltipBoxPlainTooltipRichTooltip API 意外發布為穩定版,因此我們將這些 API 移回實驗版。(If0f66b/293939035)
  • 將實驗性方塊 API 升級為穩定版。(Iea2c3)
  • 已從 Material3 可點選資訊卡中移除 @ExperimentalMaterial3Api 註解。(I88dbf)

修正錯誤

  • 修正問題:在特定情境下,SwipeToDismiss 會在搭配巢狀 Lookahead 和 Lazy 版面配置使用時異常終止。(Ica8d1b/297226562)

1.2.0-alpha10 版本

2023 年 10 月 18 日

發布 androidx.compose.material3:material3-*:1.2.0-alpha101.2.0-alpha10 版本包含以下修訂項目。

API 變更

  • BadgeBadgedBox 升級為穩定版。(I67f16b/261565132)
  • securePolicy 新增為 ModalBottomSheet 的參數,讓使用者定義 WindowManager.LayoutParams.FLAG_SECURE 的行為。(Icdac8b/296250262)
  • 新增 LinearProgressIndicatorCircularProgressIndicator 的超載,並將 progress 做為 lambda。這些版本應比舊版更有效能。(I824e6b/295616656)
  • StandardSizeClasses 重新命名為 AllSizeClasses。(I8cb07)
  • 合併視窗大小類別的計算函式。(Iad935)

修正錯誤

  • 修正 DatePicker 錯誤:當顯示的月份位於允許的年份範圍邊緣時,快速點選導覽箭頭按鈕會導致當機。(I46f36b/290954897b/297002119)
  • [導覽軌/列] 支援指標的透明色。(Ie0a9bb/267289987)

1.2.0-alpha09 版本

2023 年 10 月 4 日

發布 androidx.compose.material3:material3-*:1.2.0-alpha091.2.0-alpha09 版本包含以下修訂項目。

API 變更

  • 已遷移 ModalNavigationDrawerDismissibleNavigationDrawer,改用新的 AnchoredDraggable API。DrawerStateanimateTo 已替換為開啟和關閉方法,且偏移值現在會以浮點數形式公開,而非狀態物件。您可以直接透過 currentOffset 存取抵換單位。(I0a72c)
  • 新增非可組合函式,可直接建立 DatePickerStateDateRangePickerState。在需要時,這些函式可做為可組合函式 rememberDatePickerStaterememberDateRangePickerState 的替代方案。(I70326b/291524052)
  • Fixed 和 Scrollable TabRows 現在有 Primary 和 Secondary 變體。這些項目會正確對應至 Material 3 中定義的顏色和指標行為。
  • PrimaryScrollableTabRowSecondaryScrollableTabRow 現在會公開捲動狀態。(Iec8f5b/260572337)
  • 新增 sheetMaxWidth 參數,開發人員可設定此參數,指定工作表可跨越的最大寬度。如果需要跨越整個螢幕寬度的工作表,可以為參數傳遞 Dp.Unspecified。(Ifb7c9b/266697696)
  • 重新新增 PlainTooltipBoxRichTooltipBox 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 程式碼中的狀態訂閱數量,並影響更多標準用途的初始化和執行階段費用。(Ic447db/297212873)
  • 為符合規格,色調高度不再以不同互動狀態進行動畫處理 (Icdd12)。

API 變更

  • 新增 BottomAppBar,以 BottomAppBarScrollBehavior 做為參數,以便在捲動內容時自動隱藏。此外,還新增了 FabPosition.EndOverlay,讓 FAB 能夠在 Scaffold 中覆蓋底部應用程式列,而不是錨定在底部應用程式列上方。(Iecb47)
  • 新增簡單的 Label 元件,以 BasicTooltipBox 為基礎建構,輕觸標籤邊界外不會關閉。(I821f9)

修正錯誤

  • 移除工具提示的 rememberSaveable 用法。(Icc131b/299500338)
  • 導入臨時旗標,控制 Scaffold 是否應在測量或放置期間測量子項。根據預設,這項指標會以評估單位計算。如果新版行為造成問題,請提報問題。(I0b354)
  • BottomSheet 中,使用裝置螢幕寬度的正確測量值,將水平邊緣固定為無邊框。(I1df0cb/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)
  • 將 shape 變更為必要參數。在形狀輔助函式中,將 position 重新命名為 index。(I34941)
  • 更新 DatePicker formatWithSkeleton,加入地圖做為快取,提升效能。(I3195f)
  • compose.foundation 中新增 BasicTooltipBox,並更新 PlainTooltipBoxRichTooltipBox,使用含有新 PlainTooltipRichTooltip 可組合函式的 TooltipBox。(I79e1d)

修正錯誤

  • dynamicLightColorSchemedynamicDarkColorScheme 現在會傳回表面和 surfaceContainer 角色的高彩度顏色。(I5e901)
  • 修正問題:在 LookaheadScope 內的 Scaffold 中,部分使用 Subcomposition 的元件 (例如 BottomSheetScaffold) 嘗試過早讀取大小。(I297b4I871f1b/295536718)

1.2.0-alpha06 版本

2023 年 8 月 23 日

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

修正錯誤

  • 修正 DropdownMenuoffset 計算方式,使 x 偏移量完全取決於本機版面配置方向,且選單位於畫面底部附近時,y 偏移量不會再反轉。(Iccc74b/294103942)
  • 修正 DropdownMenuoffset 計算方式,使 x 偏移量完全取決於本機版面配置方向,且選單位於畫面底部附近時,y 偏移量不會再反轉。(Ib87a2b/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 的例項。(I77d17b/291943198)

1.2.0-alpha04 版本

2023 年 7 月 26 日

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

新功能

  • 實驗性區隔按鈕 API (Ifc8fb)
  • 分隔線現在有參數可控制方向,支援垂直分隔線。(I4c899b/288438593)

API 變更

  • 我們將密度依附元件移至元件層級。這項規定適用於下列元件:SwipeToDismiss 和以試算表為基礎的元件。請使用新提供的超載,其中密度是參數。(I1846e)
  • 額外註解,用於指定可組合項目的允許輸入內容 (Ief234)
  • 在分段按鈕中新增圖示參數、分割語意,讓分段按鈕可選取以實作單選,並可切換以實作多選,分別使用 SelectableSegmentedButtonRowToggelableSegmentedButtonRow。(I38740)
  • 「分隔線」已重新命名為「HorizontalDivider」。新增 VerticalDivider 功能。(I5975c)
  • 在實驗性 Material 3 API 中,將 ClosedFloatingPointRange 的使用方式改為較輕量的 FloatRange,盡量減少自動裝箱。(I4aab5)
  • FabPosition 新增「開始」對齊方式 (Ib7aeab/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.NoneAlignment.Center,且明確的 lineHeight (以 sp 為單位) 已新增至 TypographyTextStyle。如要自訂這些值,請參閱 API 說明文件,並參閱這篇網誌文章,深入瞭解這些變更。(I6266fIcabc3)

新功能

  • RangeSlider 新增多載,這是元件的有狀態版本。建立 RangeSliderState,其中包含目前有效軌道的所有資訊、RangeSlider 元件的測量結果,以及拖曳和手勢邏輯。(I8c270)
  • 搜尋列現在支援陰影,方法是透過新加入的 shadowElevation 參數。(Ia5369b/271040353)
  • ColorScheme 現在支援新的SurfaceContainer角色
  • 現在可以使用 LocalTonalElevationEnabled 本機組合停用 Surface 色調高程疊加層。(Ic203cb/277774590)

API 變更

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

修正錯誤

  • Scaffold 的 contentWindowInsets 參數現在會遵守已耗用的視窗插邊。請注意,提供這些參數時,系統仍會根據 topBarbottomBar 決定內容邊框間距。(I08b73b/264601542)
  • 修正中央頂端應用程式列的對齊方式,確保長標題不會在動作圖示或導覽圖示上算繪。(I4369fb/236994621)
  • 現在分頁位置會強制執行 24 dp 的內容寬度下限。這會為分頁指標提供可存取的觸控目標。(Id8861)
  • dynamicLightColorSchemedynamicDarkColorScheme 的動態調色盤現在支援新的介面角色。(I1252e)
  • 更新徽章通知對齊方式,避免與曾祖父發生衝突時遭到裁剪。(Idf75a)

1.2.0-alpha02 版本

2023 年 5 月 24 日

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

API 變更

  • ModalBottomSheet 中新增視窗插邊參數。
    • 現在,當 windowInsets 設為零時,ModalBottomSheet 的半透明遮罩可能會繪製在狀態列後方
    • 更新預設 ModalBottomSheet 功能,使其位於系統資訊列 (包括導覽列) 之外
    • 在無邊框模式下,系統會透過拖曳控點處理狀態列插邊。
    • BottomSheetDefaults 包含 BottomSheetWindow 的視窗插邊。(I31200b/274872542b/272973615b/272334475b/268432129b/275849044b/275486106b/268433162)
  • 淘汰 Indicator,並新增 Primary/SecondaryIndicator,以符合 M3 規格。PrimaryIndicator 的寬度與分頁內容的寬度相符,而 SecondaryIndicator 則會跨越整個可用寬度。SecondaryIndicator 等於現已淘汰的 Indicator,可直接取代。(I27604)
  • 新增選項,可在建構 DropdownMenuExposedDropdownMenu 時傳入 ScrollState,用來控制顯示的選單項目的垂直捲動狀態。(Ia0734b/185304441)
  • Slider 新增多載,這是元件的有狀態版本。建立 SliderState,其中包含目前有效軌道的所有資訊、Slider 元件的測量結果,以及拖曳和手勢邏輯。(I124a5)
  • 將語意屬性 isContainer 重新命名為 isTraversalGroup (I121f6)
  • 新增最佳化 TextStyle.merge(...),並提供完整參數清單。(Iad234b/246961787)
  • TooltipStateRichTooltipStatePlainTooltipState 設為公開介面。新增 RichTooltipStateImplPlainTooltipStateImpl,做為預設狀態。新增 remember*State 函式,取得這些實作狀態。已移除 TooltipSync,改用 TooltipDefault.GlobalMutatorMutex。(I7813d)
  • 更新 DatePickerColors,加入日期挑選器分隔線、導覽和文字輸入欄位顏色的其他自訂選項。(I1a685b/274626815)
  • DatePickerStateDateRangePickerState 現在是公開介面,內含可透過 rememberDatePickerStaterememberDateRangePickerState 擷取的預設實作。(I71c52)
  • 移除了 dateValidator 中的 DatePickerDateRangePicker,並導入 SelectableDates 介面,可在狀態中設定,控管 UI 中可選取的日期或年份。(Ic2fc6)
  • 從穩定版 API 中移除 TimePicker,狀態 API (I3f39a) 預計會進一步變更
  • ModalBottomSheet」已改為僅適用於 Android。ModalBottomSheet 不建議用於電腦,且這項功能不會積極維護。(Ib3778)

修正錯誤

  • 修正 AlertDialog 關閉動作,當動作彼此堆疊以符合對話方塊寬度時,關閉動作會顯示在確認動作下方。這項修正可讓實作項目符合 Material Design 規格。(I029deb/235454277)
  • 修正 ListItem 的錯誤,三行項目使用不正確的邊框間距。(I6e235)
  • ModalBottomSheet 現在可以顯示 IME 鍵盤 (Idc508b/262140644b/268380384b/272483584)

1.2.0-alpha01 版本

2023 年 5 月 10 日

發布 androidx.compose.material3:material3:1.2.0-alpha01androidx.compose.material3:material3-window-size-class:1.2.0-alpha011.2.0-alpha01 版本包含以下修訂項目。

1.1 版本

1.1.2 版本

2023 年 9 月 20 日

發布 androidx.compose.material3:material3:1.1.2androidx.compose.material3:material3-window-size-class:1.1.21.1.2 版包含此連結所列的修訂項目。

修正錯誤

  • 修正修飾符錯誤地傳遞至兩個可組合項的問題。(b/282761472)
  • 修正以 23 小時初始化時,TimePickerState 會傳回錯誤時數的問題。(b/278242122)
  • 修正中午和分鐘驗證的初始切換狀態。(b/269768197b/282790635)
  • 修正 state.hour 在晚上 11 點傳回錯誤值的問題。(b/282761472b/278242122)

1.1.1 版

2023 年 6 月 21 日

發布 androidx.compose.material3:material3:1.1.1androidx.compose.material3:material3-window-size-class:1.1.11.1.1 版本包含以下修訂項目。

修正錯誤

  • 新增對 ModalBottomSheet 的呼叫,但不含 windowInset 參數,以確保二進位檔相容性。(Ib7959)
  • ModalBottomSheet 中新增視窗插邊參數。
    • 現在,當 windowInsets 設為零時,ModalBottomSheet 的半透明遮罩可能會繪製在狀態列後方
    • 更新預設 ModalBottomSheet 功能,使其位於系統資訊列 (包括導覽列) 之外
    • 在無邊框模式下,系統會透過拖曳控點處理狀態列插邊。
    • BottomSheetDefaults 包含 BottomSheetWindow 的視窗插邊。(I31200b/274872542b/272973615b/272334475b/268432129b/275849044b/275486106b/268433162)

1.1.0 版本

2023 年 5 月 10 日

發布 androidx.compose.material3:material3:1.1.0androidx.compose.material3:material3-window-size-class:1.1.01.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-rc01androidx.compose.material3:material3-window-size-class:1.1.0-rc011.1.0-rc01 版包含此連結所列的修訂項目

API 變更

  • 從穩定版 API 中移除 TimePicker,狀態 API (I3f39a) 預計會進一步變更
  • ModalBottomSheet」已改為僅適用於 Android。ModalBottomSheet 不建議用於電腦,且這項功能不會積極維護。(Ib3778)

1.1.0-beta02 版

2023 年 4 月 5 日

發布 androidx.compose.material3:material3:1.1.0-beta02androidx.compose.material3:material3-window-size-class:1.1.0-beta021.1.0-beta02 版本包含以下修訂項目。

API 變更

  • SheetState 現在有選用的 skipHiddenState 參數
  • rememberStandardBottomSheetState 現在有選用的 skipHiddenState 參數
  • BottomSheetScaffold 現在已定義隱藏錨點,但預設為停用
  • 已更新SheetState.requireOffset說明文件
  • BottomSheetDefaults.MinimizedShape 已重新命名為 BottomSheetDefaults.HiddenShape (I839f4b/273870234)

修正錯誤

  • 啟用觸控探索時,請勿將錶面從小時切換為分鐘。(I717d0)
  • ModalBottomSheetBottomSheetScaffold 的拖曳控點語意現已合併。(I05afb)
  • BottomSheetScaffold 修飾符、containerColorcontentColor 參數現在只會影響內容。(I992cb)
  • BottomSheetScaffold nestedScroll 現在會實作工作表內容的快速滑動。(I992cb)

1.1.0-beta01 版本

2023 年 3 月 22 日

發布 androidx.compose.material3:material3:1.1.0-beta01androidx.compose.material3:material3-window-size-class:1.1.0-beta011.1.0-beta01 版本包含以下修訂項目。

API 變更

  • TimePicker 可組合函式中新增版面配置類型參數。可根據螢幕設定使用不同的版面配置 (Ia0e16)
  • SearchBarDefaults 已標示為實驗功能。(I65561)
  • BottomSheetScaffold 中新增陰影高度 (I94e0f)
  • 新增支援功能,可顯示不含標題部分的日期挑選器。API 變更:建立日期挑選器時,允許傳遞空值標題。您現在可以傳遞空值廣告標題、標題和 showToggleMode = false,顯示無標題的選擇器。(Id3f3ab/266132421b/267194809)

修正錯誤

  • 搜尋列現在會自動清除焦點 (如果處於閒置狀態)。(I22a7cb/261444487)
  • 更新 DateRangePicker,允許選取開始和結束日期相同的範圍。(I16529b/272882497)
  • 如果字型大小小於預期,文字欄位現在會正確放置文字元素。根據字型設定和文字,應用程式可能會出現幾個像素的變化。(I8b8d0)
  • 底部功能表的語意動作現在有標籤。(I277b0)

1.1.0-alpha08 版本

2023 年 3 月 8 日

發布 androidx.compose.material3:material3:1.1.0-alpha08androidx.compose.material3:material3-window-size-class:1.1.0-alpha081.1.0-alpha08 版包含此連結所列的修訂項目。

新功能

  • 新增對 BottomSheetScaffoldBottomSheetScaffoldState 的支援。(I063d4)

API 變更

  • DatePickerStateDateRangePickerState 中新增功能,允許在初始建立狀態後設定日期,以及透過設定空值時間戳記重設選取項目。手動設定日期時請務必謹慎,如果提供的日期未通過前提條件 (請參閱文件),新的 setSelection 函式會擲回例外狀況。(Ifa645b/268609314b/270427389)
  • 將「Collapsed」SheetValue 重新命名為「PartiallyExpanded」,以便更準確且彈性地描述此狀態下的行為。(Ia1491)
  • ListItem 參數名稱更新為 _content,而非 _text。現在預設 getter 會在適當位置使用 ReadOnlyComposables。(I69a25)
  • 將互動式 Surface API 從實驗階段升級。(I90d59b/261561812)

修正錯誤

  • 修正 ModalBottomSheetHalfExpanded 狀態計算錯誤,導致工作表似乎會浮動的問題。(I45e84b/268411386)
  • 在半透明幕簾輕觸事件中新增 confirmValueChange 檢查,以取得 ModalBottomSheet。(I2311ab/270425759)
  • 將語意 BottomSheet 動作移至拖曳控點。(I158ba)
  • ModalBottomSheet 現在會在啟動時命令焦點,並處理返回按鈕。(I4d2ab)
  • 現在也會在巢狀捲動甩動期間處理 ModalBottomSheet onDismissRequest。(I655c5b/268433166)

1.1.0-alpha07 版本

2023 年 2 月 22 日

發布 androidx.compose.material3:material3:1.1.0-alpha07androidx.compose.material3:material3-window-size-class:1.1.0-alpha071.1.0-alpha07 版包含以下修訂項目。

新功能

  • 新增可與 rememberTimePickerState() 搭配使用的時間輸入可組合項,並遵循時間輸入的 M3 規格 (Ia4fab)
  • 新增 Material 3 DateRangePicker API,用於選取日期範圍。(I7a6c3b/267194809)
  • 新增 Material 3 輸入模式支援,可透過 DateRangePicker API 選取日期範圍。(Ifdbc4)
  • 文字欄位顏色現在可供自訂:
    • 根據焦點和錯誤狀態,設定輸入欄位和預留位置文字的顏色。textColor 參數已重新命名為 unfocusedTextColor,而 placeholderColor 已重新命名為 unfocusedPlaceholderColor
    • 根據錯誤狀態,使用新的 errorContainerColor 參數設定已填入文字欄位的容器顏色。
  • 展開式下拉式選單文字欄位顏色已更新參數,可支援新的前置字元和後置字元 API。(I9c8b4b/254284181b/264766350)

API 變更

  • 還原部分 Slider API 版本,並移除新實驗性 Slider (含自訂指標和軌跡) 涵蓋的冗餘 Slider 超載。將 RangeSlider 升級為穩定版。(Ie8fbd)
  • 在晶片的升級函式中,已將 defaultElevation 重新命名為 elevation。(I0f872)
  • 下列 Material 3 文字欄位 API 不再是實驗性 API:TextFieldOutlinedTextFieldtextFieldWithLabelPaddingtextFieldWithoutLabelPaddingoutlinedTextFieldPadding。(Ieb5c0b/261561819)
  • TimePickers is24Hour 使用系統設定 (I18856)
  • 從 Scaffold API 中移除實驗性註解。(Ibb51eb/261565765b/261436953)

修正錯誤

  • ModalBottomSheet 的預設形狀一律為 SheetDefaults.ExpandedShape。(I0dfca)
  • 改善 Material 3 DatePickerDateRangePicker 的無障礙功能。(I5087e)
  • 修正最大高度限制條件會傳播並可能導致當機的錯誤。(I30d8c)
  • 從可點選和可選取的介面移除語意角色,並更新使用這些角色的元件,透過修飾符.semantics 設定角色 (I793d9)

1.1.0-alpha06 版本

2023 年 2 月 8 日

發布 androidx.compose.material3:material3:1.1.0-alpha06androidx.compose.material3:material3-window-size-class:1.1.0-alpha061.1.0-alpha06 版本包含以下修訂項目。

新功能

  • 文字欄位現在支援前置文字和後置文字 (Ia8578b/179884561)
  • 新增 TimePicker 函式,可與 TimePickerState 和便利方法 rememberTimePickerState,在顯示 Material 3 規格後接著提供時間挑選器 (I71910)
  • 日期輸入現在是 DatePicker 的顯示模式。新增對切換動作的支援,讓使用者在日期挑選器與日期輸入模式之間切換 (Ieeff7)
  • 新增 RichTextTooltips 的 API (I58ef3)
  • 實作 Material 3 的強制回應底部功能表,包括 ModalBottomSheetModalBottomSheetDefaults,並同時推出 SheetStaterememberSheetState (可用於日後的功能表元件 (I0853ab/244189383)

API 變更

  • 調整 API showSnackbar 的穩定性 (I195c2b/261424370)
  • 調整輔助方塊和建議方塊的 API 穩定性 (Ibb67bb/261424370)
  • ListItemListItemDefaultsListItemColors API 升級為非實驗 API (I7e7fab/261438882)
  • SliderPositionsSliderDefaults.ThumbSliderDefaults.Track 升級為穩定版,新增內含自訂指標及測試群組的非實驗 SliderRangeSlider API,以及淘汰先前的 SliderRangeSlider API (Ie5ea6b/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-alpha05androidx.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-alpha04androidx.compose.material3:material3-window-size-class:1.1.0-alpha041.1.0-alpha04 版本包含以下修訂項目。

新功能

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

API 變更

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

修正錯誤

  • 進度指標的進度現在不會超過預期範圍限制。(I8a7ebb/262262727)。

已知問題

  • androidx.compose.foundation:1.4.0-alpha03 更新為 androidx.compose.foundation:1.4.0-alpha04 時,您可能會遇到 java.lang.NoSuchFieldError 錯誤,這個網頁是最初回報問題的地方。我們已提交修正程式,預計下次 Compose 更新時就會發布。目前暫時性的解決方法是將 androidx.compose.materialandroidx.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-alpha03androidx.compose.material3:material3-window-size-class:1.1.0-alpha03查看 1.1.0-alpha03 版的修訂項

API 變更

  • 已將 consumedWindowInsets() 重新命名為 consumeWindowInsets(),將 withConsumedWindowInsets() 重新命名為 onConsumedWindowInsetsChanged(),並將 Modifier 設為公開。(Ie44e1)
  • 為使用圖示的文字按鈕新增預設內容邊框間距。(I8f662)
  • 為導覽列和邊欄新增停用的顏色。(Ia7892b/258867034)
  • 新增用於查詢祖系捲動資訊的 Modifier API。(I2ba9db/203141462)
  • 如果手勢可能產生捲動事件,用在 Clickable 中可正確延遲按下的互動動作。
  • 修正了在 Scrollable ViewGroup 中使用 Clickables 時無法正確延遲漣漪效果的問題。
  • 更新 Drawer 和 Sheet,以便在手勢可能變成捲動事件時正確延遲按下動作。

依附元件更新

  • Compose UICompose Material 現已依附於 Lifecycle 2.5.1。(I05ab0b/258038814)

1.1.0-alpha02 版本

2022 年 11 月 9 日

發布 androidx.compose.material3:material3:1.1.0-alpha02androidx.compose.material3:material3-window-size-class:1.1.0-alpha02查看 1.1.0-alpha02 版的修訂項

API 變更

  • awaitFirstDownwaitForUpOrCancellation 現在接受 PointerEventPass,以增加彈性 (同時修正捲動時 ExposedDropdownMenuBox 顯示選單)。(I7579a(b/212091796))
  • 在 material 和 material3 文字、TextFieldOutlinedTextField 中新增 minLines 參數,以便能夠以行數來設定元件的最小高度 (I4af1d)
  • 淘汰 TopAppBarDefaults smallTopAppBarColors 函式,在建立 TopAppBar 時應使用的新的 topAppBarColors 函式。(Ie6cb9)
  • BasicTextBasicTextField 中新增 minLines 參數。這樣即可針對行數來設定這些可組合項的最小高度 (I24294b/122476634)

修正錯誤

  • 將 Material3 IconButtonIconToggleBotton 的內容剪輯為元件的狀態層形狀 (例如圓形)。(I9da8f)
  • 更新 Material3 中型和大型頂端應用程式列,即可在其整個介面上套用相同的背景顏色,並允許進行以透明色值覆寫預設顏色的設定。(I67659b/249688556b/250838918)

1.1.0-alpha01 版

2022 年 10 月 24 日

發布 androidx.compose.material3:material3:1.1.0-alpha01androidx.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.1androidx.compose.material3:material3-window-size-class:1.0.1查看 1.0.1 版的修訂項

修正錯誤

  • 更新 Material3 中型和大型頂端應用程式列,即可在其整個介面上套用相同的背景顏色,並允許進行以透明色值覆寫預設顏色的設定。(I67659b/249688556b/250838918)

1.0.0 版

2022 年 10 月 24 日

發布 androidx.compose.material3:material3:1.0.0androidx.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-rc01androidx.compose.material3:material3-window-size-class:1.0.0-rc01查看 1.0.0-rc01 版的修訂項

API 變更

  • 新增了支援文字到文字欄位 API 的運算單元參數 (Iaac0db/227146125)

1.0.0-beta03 版

2022 年 9 月 21 日

發布 androidx.compose.material3:material3:1.0.0-beta03androidx.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 頂端應用程式列設定透明背景。(I645e2b/245575782)

1.0.0-beta02 版

2022 年 9 月 7 日

發布 androidx.compose.material3:material3:1.0.0-beta02androidx.compose.material3:material3-window-size-class:1.0.0-beta02查看 1.0.0-beta02 版的修訂項

API 變更

  • 在 beta01 版中,m3 元件引入的預設元件插邊不再納入 IME 插邊。
  • Material3 Scaffold 元件現在擁有 contentWindowInsets 參數,可指定要為內容版面處理的插邊數量。(Icf11ab/243713323)
  • 淘汰實驗性 Material 3 SmallTopAppBar 函式,並引入同等 TopAppBar 函式。請將使用方式遷移至新的函式。(I74404b/226918634)
  • 新增對頂端應用程式列快速滑過和貼齊行為的控制項。(I15c81)
  • 從 Divider 中移除 startIndent,將顏色移至最後一個參數。(If7be2)

修正錯誤

  • 讓對話方塊在顯示時通知字詞 Dialog,便於 TalkBack 使用者辨識對話方塊。(I857ef)

1.0.0-beta01 版

2022 年 8 月 24 日

發布 androidx.compose.material3:material3:1.0.0-beta01androidx.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 搭配使用,這些元件都會為開發人員自動處理插邊。注意:這項變更不會自動處理狀態列圖示以及狀態列和導覽列的透明度。請繼續手動處理,確保提供最佳的無邊框體驗。(I7e4e6b/183161866)
  • 更新了元件預設值以減少 API 介面,藉此提升日後的彈性與效能。(I31820)
  • 重新安排方塊和導覽匣工作表參數的順序,藉此在 API 內維持一致性 (I45d0b)
  • startIndent 從 Divider 中移除,並將顏色移到最後一個參數 (If7be2)。

1.0.0-alpha16 版

2022 年 8 月 10 日

發布 androidx.compose.material3:material3:1.0.0-alpha16androidx.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)
  • 重新安排 NavigationBarNavigationRail 參數的順序,藉此在 API 內維持一致性 (I51cda)
  • 重新安排 Material 3 中的參數順序,藉此在 API 內維持一致性。(If4ae1)
  • 重新安排 Material 3 中 Slider 參數的順序,藉此在 API 內維持一致性 (I62673)
  • 將 icons 參數重新命名為 actions,藉此與頂端應用程式列保持一致 (Id75be)
  • BadgeBadgedBox 標示為實驗性質,因為目前仍可大量使用錨點對齊。(I1712eb/236524516)
  • 將圖示按鈕變化版本的 @ExperimentalMaterial3Api 註解變更為 @OptIn (I070b5)
  • 將導覽匣的內容與自身的可組合項區隔開來,以便支援指定自訂寬度。(Ia7f10)
  • MenuDefaultsTabDefaults 移除 Divider (I4e33c)

1.0.0-alpha15 版

2022 年 7 月 27 日

發布 androidx.compose.material3:material3:1.0.0-alpha15androidx.compose.material3:material3-window-size-class:1.0.0-alpha15查看 1.0.0-alpha15 版的修訂項

新功能

API 變更

  • 更新 FilterChipElevatedFilterChip API 以移除 selectedIcon 運算單元,並推廣重複使用 leadingIcon 以顯示所選狀態。(Ie5dc2)
  • 新增紗罩遮擋和外框變化版本的顏色角色。(Id6d54)
  • 修正可組合項預設值的命名慣例。(I62b27)
  • ListItemDefaultsListItemColors 標示為實驗性質。(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-alpha14androidx.compose.material3:material3-window-size-class:1.0.0-alpha14查看 1.0.0-alpha14 版的修訂項

新功能

  • 新增了 M3 清單實作,請查看說明文件中的使用範例 (Id7a20)

API 變更

  • 將參數名稱從值變更為 RangeSlider 中的值 (I3b79a)
  • API 變更為 InputChip 實作,以便根據 Material Design 規格支援可選取狀態。為特定停用狀態的 FilterChip 顏色提供額外支援 (I55244b/235792432)。
  • 新增 BottomAppBar 預設 FAB (Ida4c8)
  • 已新增 ColorScheme.surfaceColorAtElevation (Id41af)
  • Compose 程式庫中的介面現為使用 jdk8 預設介面方法建構 (I5bcf1)
  • WindowWidthSizeClassWindowHeightSizeClass 現在實作 Comparable,使其得以使用運算子 (<、<=、>=、>) 和其他 API 比較。(I747d0)

修正錯誤

  • 更新標記範例以提供更多實質的內容說明。(I10b9d)
  • 在 Material 3 目錄的主題挑選工具中加入使用系統字型大小的選項。(I10605)
  • 加入標記的程式碼範例和不確定進度指標。(I8fbe0)

1.0.0-alpha13 版

2022 年 6 月 1 日

發布 androidx.compose.material3:material3:1.0.0-alpha13androidx.compose.material3:material3-window-size-class:1.0.0-alpha13查看 1.0.0-alpha13 版的修訂項

API 變更

  • 支援在設定變更時維持最上方的應用程式列位置。(I10459b/216160958)

1.0.0-alpha12 版

2022 年 5 月 18 日

發布 androidx.compose.material3:material3:1.0.0-alpha12androidx.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-alpha11androidx.compose.material3:material3-window-size-class:1.0.0-alpha11查看 1.0.0-alpha11 版的修訂項

新功能

  • RangeSlider 新增至 Material 3 (I18e38)
  • 新增 Material3 AssistChipInputChip 支援 (I0d25a)
  • 新增 Material3 FilterChipSuggestionChip 支援 (I9fdf3)

API 變更

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

修正錯誤

  • 在 material3/Scaffold 新增 Lint 檢查功能,確保使用內部邊框間距 (I72293b/226951418)

1.0.0-alpha10 版

2022 年 4 月 20 日

發布 androidx.compose.material3:material3:1.0.0-alpha10androidx.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 FilledIconButtonFilledTonalIconButtonOutlinedIconButton。(Ib2bda)
  • 更新 Material 3 Snackbar API,接受選擇性動作和關閉動作的顏色值。(Ibe4b4)
  • 已從 PointerInputChange 淘汰部分使用功能 (向下或定位)。可使用 consume() 徹底使用變更。可使用 isConsumed 判斷其他使用者是否曾經使用過該變更。
  • PointerInputChange::copy() 現在會一律建立淺層複本。這表示只要使用一份複本,系統就會使用 PointerInputChange 的複本。如要建立未繫結的 PointerInputChange,請改用建構函式。(Ie6be4b/225669674)
  • 變更 Cards API,透過 CardColors 介面接收容器和內容顏色,並支援已停用的可點擊資訊卡狀態。(I927df)
  • 將 Material 3 文字欄位中的 backgroundColor 參數重新命名為 containerColor,以便改善與其他元件的一致性。(I6fbd9)

修正錯誤

  • 更新標準 IconButton,使其符合 Material3 規格。(I09eab)
  • 將 material3 Scaffold 頂端列高度移至已傳遞到內容的邊框間距,這樣內容就可以在頂端應用程式列下方顯示。如果忽略 PaddingValues,頂端列可能會模糊處理內容。(I83cbcb/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)
  • LazyVerticalGridLazyHorizontalGrid 現已穩定。(I307c0)。
  • LazyVerticalGrid/LazyHorizontalGrid 和所有相關 API 已移至 .grid 子套件。請將匯入項目從 androidx.compose.foundation.lazy 更新為 androidx.compose.foundation.lazy.grid。(I2d446)
  • 還原 WindowInsetsControllerCompat 之前完全依賴 View 的變更,現在管理某些視窗旗標改回需要 Window。淘汰 ViewCompat.getWindowInsetsController 以取代 WindowCompat.getInsetsController,以便確保使用正確的 Window (例如 View 在對話方塊內)。(I660aeb/219572936)
  • 新增用於定義跨軸大小的 LazyVerticalGrid API (I17723)

修正錯誤

  • 更新 Card API,以追蹤 Surface API 的變更 (I3c8b9)

1.0.0-alpha06 版

2022 年 2 月 23 日

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

API 變更

  • 已新增 NavigationDrawerItem,它代表導覽匣中的單一目的地 (Ic396fb/218286829)
  • 已將 PermanentNavigationDrawerDismissibleNavigationDrawer 新增為實驗性 API。這些導覽匣非常適合大螢幕裝置使用。(I5f8abb/218286829)
  • 新增了 Material 3 底部應用程式列支援 (Ic432a)
  • NavigationDrawer 已重新命名為 ModalNavigationDrawer (I1807db/218286829)
  • 新增了 Material 3 Slider 類別和權杖 (I1ccee)
  • 新增了 Tab 實作,請查看說明文件中的使用範例 (Ie0146)

修正錯誤

  • 修正了以下問題:TalkBack 螢幕閱讀器線性導覽選取了空白的頂端應用程式列標題。(Id4690)
  • 已將 IconSize 新增至 FloatingActionButtonDefaults。(Ia71cf)
  • 修正使用 LazyColumn 新增長文字內容時,無法顯示 AlertDialog 按鈕的問題。(Ib2cc9b/216663029)

1.0.0-alpha05 版

2022 年 2 月 9 日

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

新功能

新增了 Material Design 3 元件

API 變更

  • 已淘汰 Surface 函式,該函式會接收 onClick 回呼。應使用 InteractionSourceModifier.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 進度指標 (Iff232b/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-alpha021.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。(I68bbeb/206674345)
  • Text 的通訊埠字串快速路徑從 compose.material 中進行變更 (I30b03)
  • 修正系統一律啟用硬式編碼按鈕的問題。(Iea832b/205335456)

1.0.0-alpha01 版

2021 年 10 月 27 日

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

新功能

Material Design 3 主題設定和 Material You 動態顏色

Material Design 3 元件

詳情請參閱 Compose 指南中 Material 主題設定的 Material Design 3 和 Material You 一節。