Wear Compose Material 3

Wear Compose Material 3

  

API 參考資料
androidx.wear.compose.material3

提供可支援不同裝置大小和瀏覽手勢的功能，使用 Material 3 Expressive 設計系統，為 Wear OS 裝置編寫 Jetpack Compose 應用程式。

最近更新時間	穩定版	候選版	Beta 版	Alpha 版
2025 年 8 月 13 日	-	1.5.0-rc02	-	-

注意： 這個程式庫會取代 androidx.wear.compose:compose-material 程式庫。這個程式庫會為 Wear OS 實作 Material 3 Expressive 設計，建議開發人員使用。請勿將這個程式庫中的物件與 Compose Material 3 行動程式庫中的物件混用。

宣告依附元件

如要為 Wear 新增依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」一節。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

dependencies {
    implementation "androidx.wear.compose:compose-foundation:1.5.0-rc02"

    // For Wear Material Design UX guidelines and specifications
    implementation "androidx.wear.compose:compose-material3:1.5.0-rc02"

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation "androidx.wear.compose:compose-navigation:1.5.0-rc02"

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-rc02")
    
    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

Kotlin

dependencies {
    implementation("androidx.wear.compose:compose-foundation:1.5.0-rc02")

    // For Wear Material Design UX guidelines and specifications
    implementation("androidx.wear.compose:compose-material3:1.5.0-rc02")

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation("androidx.wear.compose:compose-navigation:1.5.0-rc02")
    
    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-rc02")

    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

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

意見回饋

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

建立新問題

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

Wear Compose Material3 1.5 版

1.5.0-rc02 版

2025 年 8 月 13 日

發布 androidx.wear.compose:compose-*:1.5.0-rc02。1.5.0-rc02 版包含這些修訂項目。

修正錯誤

• 修正 TimePicker 的錯誤，解決時間週期 (上午/下午) 的長字串 (國際化) 可能會中斷版面配置的問題。(I0fa81)

1.5.0-rc01 版

2025 年 7 月 30 日

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

修正錯誤

• TimePicker 現在完全由使用者的語言代碼驅動，並使用 DateFormat.getBestDateTimePattern 決定選擇器和分隔符的順序和內容。這項更新修正了中日韓語言的錯誤欄排序，解決阿拉伯文等語言的 RTL 版面配置問題，使用本地化分隔符，並根據語言代碼支援 0-11 和 1-12 小時格式 (I5d543)
• DatePicker 現在會在部分語言代碼 (例如中日韓語言) 中顯示數字月份，避免數字和語言格式混用 (例如 2025 | 07 | 02，而非 2025 | 7 月 | 02)。這項變更會套用啟發式方法，檢查地區設定是否使用年份的語言後置字元，如果是，則會將月份格式從文字 (MMM) 切換為數字 (MM)，以確保一致性。(Ia93fe)
• 現在 Picker 元件中標題的垂直空間是固定的，可避免選取選擇器欄時出現明顯的位移，尤其是在 Talkback 模式下。(I7f8b7)
• 修正了因 HorizontalPageIndicator 和 VerticalPageIndicator 繪製全螢幕而導致的無障礙錯誤。頁面指標不再是全螢幕，搭配 HorizontalPagerScaffold 或 VerticalPagerScaffold 使用時，系統會自動放置指標。未使用分頁器架構時，請使用 modifier = Modifier.align(Alignment.BottomCenter) 明確指定對齊方式，並搭配 HorizontalPageIndicator 和 modifier =Modifier.align(Alignment.CenterEnd) 與 VerticalPageIndicator。(I3a0ad)
• 現在，LTR 和 RTL LayoutDirections 的 SwipeToReveal 滑動方向一致。(I6d427)
• 恢復動作的 SwipeToReveal 垂直置中功能。如果 hasPartiallyRevealedState = true，則在發生捲動時，呼叫端應將 RevealState 重設為 RevealValue.Covered。(I6473d)
• SwipeDismissableNavHost 現在可正確剪輯 API 36 以上的內容。(Ib9a44)

1.5.0-beta06 版

2025 年 7 月 16 日

發布 androidx.wear.compose:compose-*:1.5.0-beta06。1.5.0-beta06 版包含這些修訂版本。

修正錯誤

• 修正 LazyColumn 或 ScalingLazyColumn 含有 reverseLayout = true 時的 EdgeButton 動畫。(I46a1a)
• 修正 ScreenScaffold 中的錯誤：如果提供 ScrollIndicator/PageIndicator，在 Talkback 下無法使用觸控探索功能。(I6dcee)
• TransformingLazyColumn 現在可透過讀取背景繪圖器中 TransformationSpec 提供的 itemHeight 值，自訂 TransformationSpec 的變形效果。(I6a599)
• 為 IconButton 啟用/停用動畫顏色轉場效果，與 IconToggleButton 保持一致。(Ife10a)
• 在 CircularProgressIndicator 中移除了最小區段夾鉗，避免動畫化時明顯跳至最小點大小。這項異動生效後，drawCircularProgressIndicator 中的 targetProgress 參數將不再使用。(I33309)
• Picker 現在具有語意角色 ValuePicker，螢幕閱讀器可使用此角色，讓挑選器更易於存取。挑選器也更新了無障礙點擊標籤，可區分在唯讀模式下調整值，以及選取目前值。(I33309)

1.5.0-beta05 版

2025 年 7 月 2 日

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

修正錯誤

• 更新說明文件，釐清 Modifier.edgeSwipeToDismiss 的用法 (I78cb5)
• 修正錯誤：在延遲清單中，可能會顯示多個以 SwipeToReveal 顯示的項目 (I1d4f6)
• TransformingLazyColumn 中的容器形狀現在會經過縮放，避免內容遭到裁剪。(I9221a)
• 現在，小時/分鐘/秒或年/月/日的 TimePicker 和 DatePicker 標籤會為螢幕閱讀器提供標題語意 (I77d8b)
• 移除不確定 CircularProgressIndicator (Iaf0bb) 中迴圈之間的暫停
• 修正移除項目時，TransformingLazyColumn 中的動畫錯誤。(I73034)
• 修正移除項目時，TransformingLazyColumn 中錨定項目的處理方式。(I841a8)
• 如果開啟自動置中功能，且選取的 (置中) Picker 變更時，PickerGroup 現在會水平動畫顯示 Picker。(Ic82c4)

1.5.0-beta04 版

2025 年 6 月 18 日

發布 androidx.wear.compose:compose-*:1.5.0-beta04。1.5.0-beta04 版包含這些修訂版本。

修正錯誤

• 修正 TransformingLazyColumn 中的版面配置錯誤，現在螢幕內可容納的內容會從螢幕頂端正確對齊 (I80115)
• 修正 TransformingLazyColumn 的問題：捲動至清單最底部時，底部項目會錯誤地縮放 EdgeButton。現在還原版面配置時，捲動進度會遵循梯度下降法。(Iea375)
• TransformingLazyColumn 現在會讀取背景繪圖工具內的項目高度，讓自訂 TransformationSpecs 實作變形效果。(I022f0)
• SwipeToReveal 現在可正確地垂直置中顯示的動作。(I4419b)
• 修正 SwipeToReveal 中的錯誤，如果畫面同時使用檢視區塊和 Compose，即可正確使用滑動手勢關閉檢視區塊。(I5dc0e)
• 修正捲動時，SwipeToReveal 動作會以垂直偏移量繪製的問題。(I29444)
• AlertDialog、ConfirmationDialog、OpenOnPhoneDialog 和 SwipeToReveal 現在會將以螢幕大小百分比計算的邊框間距和大小向上取整。(I76367)
• ButtonDefaults.outlinedButtonBorder 現在會根據啟用/停用狀態變更大小(If2ddd)
• 修正了在含有 Pager 和 ScreenScaffold 的複雜畫面上，EdgeButton 高度出現的錯誤。(I946e3)
• 修正可能導致預留位置動畫停止的競爭狀況。(I53530)
• 透過繪製到 Canvas，提升 HorizontalPageIndicator 和 VerticalPageIndicator 的效能。(Ifae1e)
• 調整 EdgeButton 的形狀，讓構成輪廓的省略號和圓圈之間的轉場效果更平滑。(I7721e)
• 修正 LevelIndicator 中的錯誤，避免動畫因不必要的重組而停止。(I45d08)

1.5.0-beta03 版

2025 年 6 月 4 日

發布 androidx.wear.compose:compose-*:1.5.0-beta03。1.5.0-beta03 版包含這些修訂項目。

API 變更

• OpenOnPhoneDialog 現在只會透過 TalkBack 朗讀訊息文字，並略過圖示語意。OpenOnPhoneDialogDefaults 已更新，可從 icon() 移除 iconContentDescription 和 contentDescription 參數。此外，ConfirmationDialogDefaults 現在在 SuccessIcon 和 FailureIcon 可組合函式上都有修飾符參數。(Id2ae2)

修正錯誤

• 變更套用 SurfaceTransformation 參數效果的順序。先前，套用至 Wear Material3 元件的轉換作業如下：背景繪製器、容器轉換、內容轉換。現在，前 2 個會反轉，我們會在兩者之間套用任何傳入的修飾符，因此會受到容器轉換影響。這項修正可解決使用轉換參數時，在 TLC 中使用預留位置微光效果與元素的問題。(I786cf)
• 新增 RevealState.Saver，用於在重新建立活動或程序時還原 SwipeToReveal 的狀態。rememberRevealState 函式現在預設會使用這項節省功能。(Ie0ecb)
• SwipeToReveal 主要和次要動作按鈕應預設為 ButtonDefault.Height (修正了這些按鈕會填滿較高按鈕最大高度的錯誤)。(Ibfba1)
• 變更 SwipeToReveal，在執行向右滑動手勢時，重設上次互動的元件。(Ia8450)
• 如果滑動結束位置介於顯示和已顯示錨點之間，且較靠近顯示錨點，SwipeToReveal 會變更為 Revealing 狀態。(If4458)
• 現在 ButtonGroup 的內容在 RTL 版面配置中會正確反轉 (Ib378d)
• AnimatedText 現在支援從右到左的文字方向 (I4533c)
• 現在移除底部項目時，TransformingLazyColumn 會正確調整項目大小 (Idacab)
• TransformingLazyColumn 現在只會進行一次測量，減少影格時間，進而提升效能。(I501a1)

1.5.0-beta02 版

2025 年 5 月 20 日

發布 androidx.wear.compose:compose-*:1.5.0-beta02。1.5.0-beta02 版包含這些修訂項目。

修正錯誤

• 更新基礎、Material 和 Material 3 程式庫的基準設定檔。(I53f06)
• 修正 TransformingLazyColumn 中的錯誤，移除底部項目時，項目會調整大小。(Idacab)
• 修正了 TransformingLazyColumn 的錯誤，避免清單卡在頂端或底部。(I49d00)
• TalkBack 應朗讀 OpenOnPhoneDialog 下方的文字，而非圖示內容說明。(I4efe8)
• 修正 SwipeToReveal 中的錯誤，當 hasPartiallyRevealedState 設為 false 時，RevealState.currentValue 會回報錯誤的錨點。(I9c7cf)
• SwipeToReveal 復原按鈕現在預設為 ButtonDefaults.Height。(I1f6c8)
• BasicSwipeToDismissBox 效能：淘汰用於繪製半透明螢幕的 Canvas，藉此提升效能。(I68f2c)
• 修正滑桿的無障礙錯誤，更新後播報的百分比與實際值不符 (I91146)
• 修正 placeholderShimmer 實作中的錯誤。(Iee39b
• TransformingLazyColumn效能已提升，最佳化ScrollProgress計算作業的幅度達 30%。(I4c4cb)

1.5.0-beta01 版

2025 年 5 月 7 日

發布 androidx.wear.compose:compose-*:1.5.0-beta01。1.5.0-beta01 版包含這些修訂項目。

Compose for Wear OS 的 1.5.0-beta01 版本指出，此程式庫版本功能完整且 API 已鎖定 (標示為實驗性的除外)。

Wear Compose 1.5.0-beta01 包含 Wear Compose Material3 程式庫，支援名為 Material 3 Expressive 的全新 UI 設計系統。建議您從 Material 升級至 Material 3，在應用程式中採用全新視覺設計，並使用下列新元件：

• MaterialTheme，提供更新和擴充的色彩配置、字體排版和形狀，讓設計更豐富多元。
• 動態色彩主題設定：自動為應用程式產生與錶面顏色相符的色彩配置。
• 新元件預設會自動配合較大的螢幕尺寸調整
• 形狀變形 - 圓形按鈕元件 (例如 IconButton、TextButton、IconToggleButton 和 TextToggleButton) 支援在按下或勾選時產生動畫的變化。
• EdgeButton：全新貼邊按鈕，採用專為螢幕底部設計的特殊形狀。
• Scaffold - 導入 AppScaffold 和 ScreenScaffold，配置畫面結構並協調 ScrollIndicator 和 TimeText 動畫。
• 按鈕 - 支援多種體育場形狀的按鈕，以及彈性的單一版位容器和多版位變化，適用於含有圖示和標籤的按鈕。需要切換按鈕時，系統會提供 CheckboxButton 和 SwitchButton，而 RadioButton 則是可用的選取按鈕 (系統也會提供切換和選取按鈕的「分割」變體)。
• ButtonGroup - 實作一列可變形的按鈕，觸控時會變形。
• AlertDialog 變化版本支援「確定」/「取消」按鈕或 EdgeButton。
• ConfirmationDialog 可用於顯示附有逾時的訊息，並支援成功、失敗和在手機上開啟的特殊動畫。
• 挑選器 - 支援 TimePicker 和 DatePicker 變化版本，以及 Picker 和 PickerGroup 元件，方便您建構自己的挑選器畫面。
• ProgressIndicators - 支援圓形和線性進度指標 (CircularProgressIndicator 有分段和不確定變化)。
• 資訊卡 - 提供多種資訊卡變化，包括 TitleCard，可為含有標題、時間、副標題或內容運算單元的資訊卡提供特定版面配置。TitleCard 也可以使用圖片做為背景，加強資訊卡中資訊的意義。
• 分頁器 - HorizontalPagerScaffold、VerticalPagerScaffold 和 AnimatedPage 元件會協調 HorizontalPageIndicator 和 VerticalPagerIndicator 動畫。HorizontalPager 和 VerticalPager 已在 Wear Compose Foundation 程式庫中發布。
• 預留位置：在元件上繪製骨架形狀，適用於沒有臨時內容的情況。
• 滑桿和 Stepper - 滑桿和 Stepper 都可讓使用者從多種不同的值中選擇。滑桿較為精簡，可以分段顯示；步進器則是全螢幕元件，通常會搭配 StepperLevelIndicator 使用。
• SwipeToReveal：用於在可組合項從右向左滑動時新增其他動作。

此外，Wear Compose Foundation 1.5.0-beta01 還包含下列新元件：

• TransformingLazyColumn：支援縮放和變形動畫的延遲垂直捲動清單
• 階層式焦點群組 - 用於註解應用程式中的可組合項，追蹤組合的有效部分並協調焦點。
• 呼叫器 - HorizontalPager 和 VerticalPager 元件，以 Compose Foundation 元件為基礎建構，並針對 Wear 進行強化，以提升效能並符合 Wear OS 指南。

API 變更

• 更新了階層式焦點 API - 將 Modifier.hierarchicalFocus 重新命名為 Modifier.hierarchicalFocusGroup，並移除了回呼參數；移除了含有 FocusRequester 參數的 Modifier.hierarchicalFocusRequester 多載；建立了新的 CompositionLocal、LocalScreenIsActive，讓元件可以通知並檢查哪個畫面處於啟用狀態。(I5ff7c)。
• 淘汰 Wear Compose Foundation 中的 SwipeToReveal，改用 Wear Compose Material 和 Wear Compose Material3 中的 SwipeToReveal API。請將 Wear Foundation SwipeToReveal 匯入項目替換為 Wear Compose Material/ Wear Compose Material3 匯入項目，以便繼續使用 API。(Ia147d)。
• Wear Compose Material3 SwipeToReveal 基礎的依附元件已移至 material3 套件，例如 RevealValue、RevealDirection、RevealActionType、RevealState、rememberRevealState。開發人員應將這些類別和函式的匯入項目從 androidx.wear.compose.foundation 變更為 androidx.wear.compose.material3。(I640e6)。
• 更新 Wear Compose Material3 SwipeToReveal API，變更如下：在 SwipeToReveal 可組合函式中新增 primaryAction、onFullSwipe、secondaryAction、undoPrimaryAction、undoSecondaryAction 和 hasPartiallyRevealedState 參數；移除從 RevealState 自訂 positionalThreshold 和 animationSpec 的功能；從 RevealState 移除 lastActionType、revealThreshold 和寬度；變更 RevealState 建構函式，接受 RevealDirection 而非錨點；移除 createRevealAnchors、錨點和 bidirectionalAnchors 函式；將 SwipeToRevealScope 函式 primaryAction、secondaryAction、undoPrimaryAction 和 undoSecondaryAction 重新命名為 PrimaryActionButton、SecondaryActionButton、UndoActionButton，並設為可組合函式；將 RevealActionType 標示為內部函式。(I885d0)。
• 進一步更新 SwipeToReveal API，如下所示：將 onFullSwipe 重新命名為 onSwipePrimaryAction；重新命名 SwipeToRevealNonAnchoredSample，指出使用 hasPartiallyRevealedState 參數；移除 actionButtonHeight，因為預設值是按鈕的預設高度，且可以使用修飾符設定較大的高度；從 SmallActionButtonHeight 移除 SwipeToRevealDefaults；將 RevealValue 和 RevealDirection 建構函式中的值參數設為私有。(I465ce)。

修正錯誤

• 修正 ScreenScaffold 的 EdgeButton 處理方式，移除 TransformingLazyColumn 項目後，EdgeButton 會以動畫效果移至適當位置。(I6d366)。
• 將 Compose 程式庫的 Wear OS Compose 依附元件更新至 1.8.0 版。(I2ef3f)。
• 更新不確定 CircularProgressIndicator 的動作，使其不再暫時回歸。(Ieddb1)。
• 修正 SwipeDismissableNavHost 錯誤：向後滑動後焦點未正確切換，導致旋轉輸入失敗 (適用於使用預測返回手勢的 API 36 以上版本)。(Ieddb1)。
• 修訂 Hierarchical Focus API 的說明文件 (Idf2ff)。
• 更新按鈕和資訊卡的說明文件，說明 containerPainter 和 disabledContainerPainter 如何覆寫 containerColor 和 disabledContainerColor (I4a453)。
• 還原先前版本中對 TimeText 的變更，因為該變更將 BroadcastReceiver 移至工作執行緒，導致在導覽期間管理自身執行緒的應用程式發生問題。(I34d02)。
• 更新 Picker 範例，移除不必要的 remember 呼叫，並改為在 Picker 中使用 rememberUpdatedState 記憶最新的 contentDescription lambda 函式。(Icb5b1)。
• 更新 TimePicker 和 DatePicker 中的文字樣式，讓字型變更不再導致截斷。(I26194)。
• ListHeader 和 ListSubHeader 現在預設會將文字分別置中對齊和靠左對齊。(I78339)。
• 更新 Foundation 和 Material「滑動顯示」範例和示範，以發布自訂無障礙動作 (自訂動作必須新增為內容的語意，而非 SwipeToReveal 可組合函式本身)。(Ie92a3)。
• 根據 EdgeButton 內容的大小更新預設 MaxLines 集，現在特小為 1，小和中為 2，大為 3。(Ie35f6)。
• 簡化 LocalReduceMotion，讓觀察器只註冊一次，以提升效能。(Ib1979)。
• 減少 ScrollIndicator 中的重繪次數，以提升效能。(Ia7a67)。
• 修正 TransformingLazyColumn 中的錯誤：EdgeButton 達到完整高度時，清單中頂端的可見項目不會正確縮放。(I30580)。

Wear Compose Material3 1.0 版

1.0.0-alpha37 版

2025 年 4 月 23 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha37。1.0.0-alpha37 版包含這些修訂項目。

API 變更

• 已從公開 API 介面中移除 scrollTransform。如要取得相同功能，請一併使用 transformedHeight 和 graphicsLayer 修飾符。(Ie181d)
• 將 ImageButton 和 ImageCard 可組合函式分別替換為 Button 和 Card/TitleCard 多載。已將 imageButtonColors 重新命名為 buttonWithContainerPainterColors，並將 imageCardColors 重新命名為 cardWithContainerPainterColors。已新增公開 ButtonDefaults.scrimBrush 和 CardDefaults.scrimBrush。已將按鈕 imageBackgroundGradientStartColor 和 imageBackgroundGradientEndColor 重新命名為 scrimGradientStartColor 和 scrimGradientEndColor。已將 CardDefaults.ImageContentPadding 重新命名為 CardDefaults.CardWithContainerPainterContentPadding (I7b8b6)
• Picker 和 PickerGroup 現在會將 contentDescription 做為 lambda，避免不必要的重組。(I002dd)

修正錯誤

• 修正問題：如果寬度不等於高度，動畫期間不確定的 CircularProgressIndicator 會晃動。(I76bfe)
• 修正無效大小的邊緣按鈕版面配置問題。現在，如果高度為 NaN，系統會防止更新邊緣按鈕的版面配置。(I32b93)
• 在 OpenOnPhoneDialog 中增加最大掃描角度，確保預設的「檢查手機」文字不會在最大字型大小下遭到裁剪。(I90af9)

1.0.0-alpha36 版

2025 年 4 月 9 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha36。1.0.0-alpha36 版包含這些修訂項目。

API 變更

• 已將「ButtonDefaults.imageBackgroundButtonColors」替換成「ImageButton」、「ButtonDefaults.imageButtonColors」、「ButtonDefaults.containerPainter」和「ButtonDefaults.disabledContainerPainter」。並對 Card 進行類似的變更。畫家會從 ButtonColors 和 CardColors 中移除。(I8c6a1)
• 更新預留位置，簡化 API。我們現在提供兩個修飾符：Modifier.placeholderShimmer 可在元件層級套用微光效果，Modifier.placeholder 則可在未載入的內容上套用遮罩 (Iaee7a)

修正錯誤

• 將過度捲動整合至 ScrollIndicator。(Icfb7f)
• 修正啟動 material3 對話方塊時，背景空白和缺少對話方塊的問題。(Ice597)
• 修正 FadingExpandingLabel 中文字跨越多行時的問題。(I04eb7)
• 更新按鈕上主要和次要標籤之間的邊框間距。(I99b7b)
• ArcLarge 已從 20sp 調降為 18sp，且 ArcLarge 和 ArcSmall 的字元間距已更新。ConfirmationDialog/OpenOnPhoneDialog 現在會使用預設的 ArcLarge，而不是將其覆寫為 18sp。(Id39a8)

依附元件更新

• 這個程式庫現在指定 Kotlin 2.0 語言層級，且需要 KGP 2.0.0 以上版本。(Idb6b5)

1.0.0-alpha35 版

2025 年 3 月 26 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha35。1.0.0-alpha35 版包含這些修訂版本。

API 變更

• 提供圖示時，系統現在會預設減少 AlertDialog 頂端邊框間距，充分利用可用螢幕大小。(Ief06c)
• 「PagerScaffoldDefaults.FadeOutAnimation」已重新命名為「PagerScaffoldDefaults.FadeOutAnimationSpec」。AnimatedPage 的頁面參數已重新命名為 pageIndex。(I701f2)
• 更新 TransformingLazyColumn 的命名方式 - applyTransformation 分割為 applyContainerTransformation 和 applyContentTransformation，並將 createBackgroundPainter 重新命名為 createContainerPainter。SurfaceTransformation進一步將 TransformationSpec 和 ResponsiveTransformationSpec 重新命名。(I1c534)
• 「AppScaffold backgroundColor」已重新命名為「containerColor」。(I4e63f)

修正錯誤

• 修正 FadingExpandingLabel 中的問題，文字現在一律會正確展開。(I0e773)
• ArcLarge 已從 20sp 減少至 18sp，且 ArcLarge 和 ArcSmall 的字母間距已更新。ConfirmationDialog/OpenOnPhoneDialog 現在會使用預設的 ArcLarge，而不是將其覆寫為 18sp。(Id39a8)
• 更新 DatePicker 和 TimePicker 的標題動畫，讓淡出和淡入動畫成為一個彈簧動畫。(I68963)
• 最佳化 PagerScaffold，避免在 AnimatedPage 可組合函式中讀取 currentPageOffsetFraction。(I433ef)
• 所有型別比例都已更新為預設使用比例數字，因為這是最常見的用途，且預設使用表格會導致特定數字配對之間間距過大。TimePicker 和 DatePicker 會繼續套用 FontFeatureSetting=tnum 表格數字。(I88929)
• 修正 TimePicker 和 DatePicker 的初始 RSB 輸入焦點。(I1c773)
• 將「OpenOnPhoneDialog」的預設文字更新為「檢查手機」。(I00a3f)
• 將 ArcLarge 和 ArcMedium 的權重從 600 更新為 599，解決權重 600 會視為粗體的問題 (I2a51d)
• 更新內容和動作按鈕之間的 SwipeToReveal 邊框間距，以及動作按鈕圖示和文字之間的邊框間距。(Ic46cb)

1.0.0-alpha34 版

2025 年 3 月 12 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha34。1.0.0-alpha34 版包含這些修訂版本。

API 變更

• PagerScaffold 不再發出 Pager 元件，而是必須透過 content 可組合函式提供。AnimatedPage 和 snapWithSpringFlingBehaviour 現已公開，可與 Wear Foundation Pager 搭配使用，達到先前的 M3 PagerScaffold 行為。(請參閱更新後的範例)。(Ia4724)
• 更新 PagerState，移除做為基礎類別的 Compose Foundation PagerState，並新增 currentPage、currentPageOffsetFraction 和 pageCount 屬性。更新 GestureInclusion 介面，將方法重新命名為 ignoreGestureStart。(I4ae07)
• LevelIndicator 掃掠角度參數現在會加上 FloatRange(0, 360) 註解 (I7e636)
• 我們新增了 CurvedModifier.clearAndSetSemantics，方便您關閉彎曲語意。CurvedText 仍會預設將內容說明設為文字，但 timeTextCurvedText 和 timeTextSeparator 現在不會播報內容。(I4b568)
• 在 AppScaffold 中新增背景和預設內容顏色參數。(I56652)
• HorizontalPager 的預設輕觸手勢處理方式已重新命名為 PagerDefaults.gestureInclusion。現在的預設行為是只忽略從第一頁左側邊緣開始的滑動手勢，且僅限 Talkback 關閉時。在其他情況下，分頁器不會忽略滑動手勢，因此滑動手勢無法用於滑動關閉處理常式。(Iee486)
• 在按鈕、資訊卡和清單標題元件中新增 SurfaceTransformation 參數，以便在容器中使用這些元件時，根據項目位置套用不同的背景和內容轉換，例如 TransformingLazyColumn。(Iabe3f)
• 我們已將 Wear Compose Material3 API 中的「public const val」屬性更新為「public val」，避免值內嵌。(Ib0f32)
• 在 SwipeToReveal 中新增邊緣滑動區域支援。Foundation SwipeToReveal 現在的預設行為是，手勢從邊緣開始時不允許滑動。如果 SwipeDirection 設為單一方向，現在從邊緣開始手勢時，Material3 SwipeToReveal’ 會預設禁止滑動。(I32ef0)
• 新增 FadingExpandingLabel 可組合函式，可逐行以動畫淡入文字。(Ic60fa)
• TransformingLazyColumn 現在預設會使用空白 contentPadding，而不是將第一個和最後一個項目放在中央。(I77ab7)
• 從 Wear Compose Material3 程式庫中移除 SwipeToReveal 的 rememberRevealState。(I8c0e0)

修正錯誤

• Wear Compose 程式庫已更新為 Kotlin 2.0 編譯器。(I2de79)
• Material3 已移除對非圓形 ScrollIndicator 和 PageIndicator 的支援。方形螢幕支援也不再是 Wear OS 的必要條件，詳情請參閱「入門指南」。(I9a852)
• ConfirmationDialogDefaults 和 OpenOnPhoneDialogDefaults 中使用的 CurvedTextStyle 已更新為使用 ArcLarge 字體排版，大小為 18sp，字母間距為 1.8sp。(Ic9ced)
• Card、ListHeader、RadioButton、CheckboxButton、SwitchButton 不再預設限制內容的高度。如有需要，請使用 Modifier.height(IntrinsicSize.Min) 還原先前的行為。(I80bb8)
• 我們已更新預設的 TimeText 和 ScrollIndicator 顏色，加入更多灰色調，因為直接使用 OnBackground (白色) 時，與畫面上的其他內容 (例如標題) 競爭，會造成過多的視覺重量。(I8b36f)
• 我們已將 scaffold 元件中 TimeText 和 ScrollIndicator 的動畫逾時時間縮短為 2 秒。(I52021)
• 我們已更新對話方塊的動作，讓對話方塊背景的縮放比例與滑動關閉動作同步。(I925a9)
• 使用 edgeSwipeToDismiss 修飾符新增 M3 SwipeToReveal 的示範。(I02b07)
• 我們在 TalkBack 的 DatePicker 和 TimePicker 下方新增了標題，讓使用者知道必須捲動才能設定日期/時間。(Id738d)
• AnimatedText 現在會遵循「減少動作」設定。(Ib6578)
• 改善使用 AppScaffold 顯示對話方塊內容的最佳化功能，允許在彼此頂端顯示多個對話方塊 (I1209c)

1.0.0-alpha33 版

2025 年 2 月 26 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha33。1.0.0-alpha33 版包含這些修訂項目。

API 變更

• 我們已從 SwipeToRevealScope 的 primaryAction 和 secondaryAction 中移除標籤參數。開發人員應直接將自訂動作語意新增至 SwipeToReveal 元件的內容。(Ia67f3)
• 我們已從 IconToggleButtonDefaults 和 TextToggleButtonDefaults 的大小、文字樣式和顏色函式中，移除「Button」前置字元 (I5471d)
• 我們已移除實驗性的 LocalMinimumInteractiveComponentEnforcement (I4ad8a)
• 我們已將 PickerGroupScope DSL 替換為可組合函式。因此，我們從 PickerGroupScope 移除了 pickerGroupItem 方法，並新增 @Composable PickerGroupItem，用於將 Picker 新增至 PickerGroup。我們也將 PickerGroup「content」參數的類型更新為 @Composable PickerGroupScope.() -> Unit。(Ic6aec)
• 我們已為分數值新增 LevelIndicator 超載，並為包含範圍參數的超載新增 Stepper 前置字元 (適用於 Stepper 元件)。(If4234)
• 我們在 API 中新增了 TransformingLazyColumn 的 TransformationSpec，可定義項目在 TLC 中捲動時發生的確切轉換。(I21856)
• 我們已更新 IconButtonShapes、IconToggleButtonShapes、TextButtonShapes 和 TextToggleButtonShapes，使其與 compose/material3 類別保持一致 (I5a081)
• 我們已在 ScalingLazyColumn、TransformingLazyColumn 和 ScreenScaffold 中新增 overscrollEffect 參數。(I0cee8)
• 我們已在 rememberRevealState 中將 swipeDirection 參數重新命名為 revealDirection。(I7472f)
• Wear Pager 現在有自己的 PagerScope，而不是使用 Compose PagerScope。(I9195b)
• 我們移除了 LinearProgressIndicatorContent 可組合函式，請直接使用 LinearProgressIndicator，這樣系統預設會為值的變更加上動畫效果。(I2c4ad)
• 我們已移除 CircularProgressIndicatorStatic 可組合函式，並新增具有相同功能的公開 DrawScope 函式 drawCircularProgressIndicator。請直接使用 CircularProgressIndicator，讓系統預設以動畫呈現變更，但如果需要自訂動畫，請從 drawCircularProgressIndicator 建構自己的可組合函式。(Ie762f)
• 我們已將 DrawScope.drawCircularProgressIndicator 中的參數重新排序，將 targetProgress 參數移至較上方的位置。(I8ab92)
• 更新 OpenOnPhoneDialog API，確保內容明確並與其他對話方塊保持一致。show 參數已重新命名為 visible，且 curvedText 現在由呼叫端提供，而非預設值。(Idec2d)
• 我們已將 openOnPhoneCurvedText 重新命名為 openOnPhoneDialogCurvedText (I65bdd)
• 我們新增了 ScrollIndicatorColors，可為 ScrollIndicator 提供自訂顏色。(I9eb8c)
• 允許設定用於在 TimeText 後方繪製背景的顏色。(I9f5d9)
• 已將 ArcLarge、ArcMedium 和 ArcSmall 字體更新為 CurvedTextStyle (Iffc41)
• 我們已移除 ScreenScaffoldDefaults.contentPaddingWithEdgeButton。(Ia923e)
• 我們已在 ColorScheme 中新增 errorDim，用於高優先順序錯誤或緊急動作，例如安全警示、對話方塊疊加層失敗或停止按鈕。(I70998)

修正錯誤

• 我們已將 wear.compose.material3 釘選至 androidx.core.core 的 1.15.0 版 (I132e9)
• 我們使用 AppScaffold 將對話方塊疊加在其他畫面內容上，提升了對話方塊的效能 (I1b9a4)
• 減少 EdgeButton 的內部垂直邊框間距。(I1a5bb)
• 我們已在滑桿按鈕中新增按鈕語意。(I80cc6)

1.0.0-alpha32 版

2025 年 1 月 29 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha32。1.0.0-alpha32 版包含這些修訂項目。

API 變更

• 在 CurvedTextStyle 上，我們將字母間距分成順時針字母間距和逆時針字母間距。這是必要步驟，因為順時針方向的字母會從基準線向外展開，而逆時針方向的字母則會向內展開 (因此需要較大的字母間距) (I4b848)。
• 我們已更新 IconButtonShapes、IconToggleButtonShapes、TextButtonShapes 和 TextToggleButtonShapes，提升 Material3 程式庫的一致性。這項變更也導入形狀快取，可減少分配次數。(I049fc)
• 我們已從 IconToggleButton 和 TextToggleButton 的 variantAnimatedShape 方法中移除 pressedShapeCornerSizeFraction 參數 (I58a65)
• 我們將推出曲面文字算繪功能 (包括 TimeText) 的改良版本，但這項功能與非圓形螢幕不相容。非圓形螢幕支援也不再是 Wear OS 的必要條件，詳情請參閱「入門指南」。(I1cc1c)
• 我們已更新 ButtonGroup 的 ButtonGroupScope，將以 DSL 為基礎的 ButtonGroupItem 替換為 Modifier.weight、Modifier.minWidth 和 Modifier.enlargeOnPress。(I16c3c)
• 在 ButtonGroup API 中，我們更新了以修飾符為基礎的新 ButtonGroupScope：enlargeOnPress 現在稱為 animateWidth，並採用 InteractionSource，而非 MutableInteractionSource，因為不需要突變。我們也新增了公開常數 ButtonGroupDefaults.DefaultMinWidth，這是 ButtonGroup 中按鈕的預設最小寬度。(Ie27ec)
• 我們已更新 ListHeaderDefaults.contentColor，開頭為小寫字母，因為這是可組合的屬性 (I125a5)
• 我們已在 SliderDefaults.DecreaseIcon 和 SliderDefaults.IncreaseIcon 中新增內容說明參數，並提供適當的預設值 (I2e1a7)
• 我們已將 Picker 和 PickerGroup 中的 spacing 參數重新命名為 verticalSpacing (Ib75cc)
• 我們已移除 ConfirmationDialogDefaults.successText 和 failureText，因為 ConfirmationDialog 的呼叫端應會提供更多背景資訊的字串。此外，我們也將「confirmationCurvedText」重新命名為「confirmationDialogCurvedText」。最後，將 Dialog show 參數重新命名為 visible，與對話方塊的近期更新保持一致。(I10074)
• IconButton 將 disabledImageOpacity 重新命名為 DisabledImageOpacity。(I5f94a)

修正錯誤

• 修正 EdgeButton 動畫中的錯誤，確保每個影格都使用正確大小 (Id3b58)
• 修正 animateContentSize 無法與 Button 搭配運作的問題。(Ib18a0)
• 我們已將「特大標題」型別比例的字型大小變更為 18dp (Ic9d52)
• 我們已更新 AlertDialog 間距和圖示大小 (Iac28c)
• 修正大螢幕中斷點的不一致問題 (螢幕尺寸大於或等於 225 dp 即為大螢幕) (I36474)
• 修正按鈕位置的小錯誤 (I952c2)

1.0.0-alpha31 版

2025 年 1 月 15 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha31。1.0.0-alpha31 版包含這些修訂項目。

API 變更

• 我們已將所有 Wear Compose 程式庫更新為「明確 API」模式。(Iebf9f)
• 我們更新了 ScreenScaffold 和 EdgeButton API，方便您在包含 EdgeButton 的畫面上指定內容邊框間距。在新版 API 中，EdgeButton 的 size 只會傳遞至 EdgeButton，而 ScreenScaffold 則會採用 edgeButtonSpacing 參數，設定 EdgeButton 與清單內容之間的間距。(I424fd)
• 在 DatePicker 中，我們已將參數 minDate 重新命名為 maxDate，並將 minValidDate 重新命名為 maxValidDate。在 DatePickerColors 中，我們已將參數 selectedPickerContentColor 重新命名為 activePickerContentColor，並將 unselectedPickerContentColor 重新命名為 inactivePickerContentColor (Iba17b)
• 我們已將 ArcProgressIndicator 預設值更新為 strokeWidth=6dp，並建議使用螢幕高度的 diameter = 81.24% (I6f248)
• 我們已更新 Confirmation API，以反映其對話方塊用法。可組合函式現在稱為 ConfirmationDialog，且相關顏色和預設類別的命名也已更新。此外，為與其他 Compose 動畫 API 相容，我們也將 show 參數重新命名為 visible。此外，我們也提供 ConfirmationDialogContent、SuccessConfirmationDialogContent、FailureConfirmationDialogContent，方便開發人員在需要自訂片頭/片尾對話方塊動畫時使用。(Iaeb33)
• 我們已將 CircularProgressIndicatorContent 更新為 CircularProgressIndicatorStatic (CircularProgressIndicator 的非動畫變體)，現在可用於建構自訂動畫的 CircularProgressIndicator。(I1346f)
• 我們已修正 ArcProgressIndicator 的參數順序，將修飾符參數放在第一位 (I4656a)
• 改良 SwipeToReveal API，可接收動作標籤 (次要動作除外) 的文字插槽參數，並從復原動作 (I5b3db) 移除標籤參數

修正錯誤

• 修正 LongPress 觸覺回饋在 Button、Card、IconButton 和 TextButton 中觸發多次的問題 (Ia8b0f)
• AlertDialog 的使用者體驗有所變更：在大螢幕上，「確認」和「關閉」按鈕現在會縮小。「確認」和「關閉」按鈕下方的間距也變大了。(I4f066)
• 我們變更了 SwipeToReveal 元件動作按鈕標籤的動畫規格。(Ib87fb)
• 變更 SwipeToReveal，在顯示文字的同時展開容器。(I44cf8)
• 改良 SwipeToReveal，在滑動超過門檻並執行主要動作時，提供觸覺回饋。(I23efe)
• 我們已更新 SwipeToReveal，預設會針對主要和復原動作，在文字溢位時顯示省略號。(I71f5a)
• 我們修正了導致 ButtonGroup 動畫抖動的問題。(I63f8f)
• 我們已在 AnimatedText 中新增文字語意 (I6063c)
• 現在從組合中移除對話方塊時，對話方塊會重設背景縮放比例 (如果沒有這項修正，啟動畫面可能會處於縮小狀態) (Id24ac)
• 我們已在 Stepper 元件的按鈕中新增形狀變形動畫 (Id6ed3)

1.0.0-alpha30 版

2024 年 12 月 11 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha30。1.0.0-alpha30 版包含這些修訂版本。

API 變更

• TransformingLazyColumn 的 scrollTransform 修飾符已重構，因此觸發了 API 變更。(I0c6dc)
• 我們已更新 IconToggleButtonShapes 和 TextToggleButtonShapes，現在有兩個不同的形狀參數 uncheckedPressed 和 checkedPressed (I85dbd)
• 使用 minDate 或 maxDate 時，無效的月份/日期選項現在會顯示在 DatePicker 中，並顯示新的 invalidPickerContentColor。(If4541)
• 我們已更新 Stepper API，提供 increaseIcon 和 decreaseIcon 插槽，這些插槽的內容可照常從 Icon 可組合函式建構。(Id35da)
• 我們已更新 dynamicColorScheme，移除選用的 defaultColorScheme 參數，並傳回可為空值的 ColorScheme。也就是說，如果未提供動態色彩配置，呼叫端就必須明確處理備援情況。(I6d62e)
• 我們已更新 ButtonDefaults 中的圖示大小，以便與 CompactButton 搭配使用。如果 CompactButton 只包含圖示，應使用 ButtonDefaults.SmallIconSize = 24.dp；如果 CompactButton 同時包含圖示和文字，則應使用 ButtonDefaults.ExtraSmallIconSize = 20.dp。建議 CompactButton 包裝內容 (而非填滿最大寬度)，且範例已更新，可顯示該內容。(I0582c)
• 我們已新增 EdgeButtonDefaults，其中包含 4 種不同 EdgeButtonSizes 的建議圖示大小。此外，也更新了 EdgeButton 版面配置，使底部邊框間距略大於頂部邊框間距，改善圖示和文字內容的外觀。(Id772a)
• 我們已在 LinearProgressIndicator 中新增動作，並公開 LinearProgressIndicatorContent，提供不含動畫的視覺內容。(Idee99)
• 我們新增了 CircularProgressIndicatorContent 可組合項，可顯示 CircularProgressIndicator 的視覺內容，且不含動畫。(Ie33d4)
• TransformingLazyColumn 現在提供新的組合本機 LocalTransformingLazyColumnItemScope，Card、Button 和 ListHeader 現在會自動變形，放置在 TransformingLazyColumn 內時。來電者可以使用新的 TransformExclusion 包裝函式停用自動變形功能。(I1652f)
• 我們已將 ButtonDefaults.shape 的型別更新為 RoundedCornerShape (Iccdf2)

修正錯誤

• 修正錯誤，讓 TimeText 尊重背景的現有 Alpha 值 (I1eb60)
• 我們已在排版中將 TextMotion 預設設為 Animated，避免在縮放作業期間，因將字母字形對齊像素邊界而導致文字抖動。(I626fa)
• 我們已更新 ScrollIndicator 的外觀，增加寬度和間距，以提升可見度。(Ied7cb)
• 我們已修正 Modifier.scrollTransform 在新增/移除/移動項目時發生的錯誤。(I6830f)
• 我們修正了短按時圓形按鈕的動畫問題 (先前系統不一定會遵守最短動畫時間)。(I757a7)
• 我們已將 LevelIndicator 的掃描角度更新為 20% (即 72 度)。(Idde5c)
• 修正了 ScalingLazyColumn 與 AutoCenteringParams 搭配使用時，ScrollIndicator 的定位問題。(I387dd)
• 我們更新了 ListHeader 和 ListSubHeader 的顏色和字體排版。以及 CheckboxButton 和 SwitchButton 的切換控制項顏色。(I39817)
• 我們已修正 ContentPadding 中的 ScrollIndicator 在 LazyColumn 和 ScalingLazyColumn 中的位置。(I2bc51)
• 我們使用新的 CircularProgressIndicatorContent，修正了 OpenOnPhoneDialog 進度動畫中的錯誤。(I3e443)
• 我們已更新 HorizontalPagerScaffold 和 VerticalPagerScaffold，在啟用「減少動態效果」時停用動畫 (Iaaf68)。
• 我們為圓形進度指標導入了獨立動畫，當進度超過 100% 時，(I47135)
• 修正錯誤：在 Pager 元件中，EdgeButton 可能會以錯誤形狀繪製 (I91db9)

1.0.0-alpha29 版

2024 年 11 月 13 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha29。1.0.0-alpha29 版包含這些修訂項目。

API 變更

• 我們已更新 TimeText，提供顯示時間的預設內容。(Id23b3)
• 我們已簡化 PagerState 的 ScrollInfoProvider，移除不再需要的 orientation 參數。新版行為是讓 TimeText 在水平和垂直分頁時都保持在原位。(I71767)
• 如果 Vibrator API 指出支援觸覺回饋，LocalHapticFeedback 現在會提供預設的 HapticFeedback 實作方式。下列項目已新增至 HapticFeedbackType - Confirm、ContextClick、GestureEnd、GestureThresholdActivate、Reject、SegmentFrequentTick、SegmentTick、ToggleOn、ToggleOff、VirtualKey。 現在，當提供長按點擊處理常式時，Wear OS Compose 長按點擊元件 (例如 Button、IconButton、TextButton 和 Card) 會執行 LONG_PRESS 觸覺回饋。(I5083d)

修正錯誤

• 我們已更新「確認」動作。(I04bff)
• 我們已將 Compose 程式庫的最低 API 依附元件更新為 1.7.4。(I88b46)
• 已為 OpenOnPhone 對話方塊新增動作。(I1e10a)
• 我們已修正 LevelIndicator 的錯誤，現在系統會正確顯示層級為零的項目。(Ie95a4)
• 我們已更新 HorizontalPageIndicator 和 VerticalPageIndicator 動畫。(I5c8f3)
• 我們在不確定的 ArcProgressIndicator 中新增了縮小至點的動畫。(I9fd51)

1.0.0-alpha28 版

2024 年 10 月 30 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha28。1.0.0-alpha28 版包含這些修訂版本。

API 變更

• 我們在未確定的圓形進度指標 (I2efc1) 中新增了弧形變化
• 我們已公開組成 AlertDialog API 的 AlertDialogContent 和 Dialog 可組合函式，方便您視需要新增自訂項目 (例如自訂 AlertDialog 動畫，同時保留建議的內容版面配置)。此外，我們已在 AlertDialogDefaults 的 EdgeButton、ConfirmButton 和 DismissButton 成員中新增 Modifier 和 Color 參數。(I4eb71)
• 我們已更新 Placeholder API，變更如下：將 PlaceholderState.startPlaceholderAnimation 重新命名為 PlaceholderState.animatePlaceholder、PlaceholderState.isShowContent 重新命名為 PlaceholderState.isHidden，以及 PlaceholderDefaults.shape 重新命名為 PlaceholderDefaults.Shape；將 painterWithPlaceholderOverlayBackgroundBrush 中的 painter 參數重新命名為 originalPainter；將 PlaceholderState.placeholderProgression 的可見度從公開變更為內部，並重新命名為 placeholderShimmerProgression；在 PlaceholderDefaults 中新增預留位置動畫時間常數。(Ie5a59)
• 我們已更新 EdgeButton API，具體來說，就是將 ScreenScaffold 上的參數從 bottomButton 重新命名為 edgeButton，並將 EdgeButtonSize 設為值類別。(Ieef15)
• 我們已在 Wear Material 3 顏色類別 (I0287f) 中，將 copy() 的瀏覽權限變更為公開。

修正錯誤

• 點按 IconToggleButton 和 TextToggleButton 時，新增最短動畫時間 (Ieb333)
• 在 IconButton 和 TextButton 形狀動畫中新增最短時間 (Iebcee)
• 修正 DatePicker 的重複選項狀態。(I3587c)
• 為「快訊」和「確認」對話方塊新增動態效果。(I173b1)

1.0.0-alpha27 版

2024 年 10 月 16 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha27。1.0.0-alpha27 版包含這些修訂項目。

API 變更

• 我們已更新 ScreenScaffold 和 ScrollIndicator，配合 Wear Compose Foundation LazyColumn 重新命名為 TransformingLazyColumn。(I0608b)
• EdgeButton's preferredHeight 參數已重新命名為 buttonSize，且其值只能從新導入的 EdgeButtonSize 值類別中的 4 個常數中選擇。(Icdd70)
• 我們已將 ListSubheader 重新命名為 ListSubHeader，並為 ListHeader 和 ListSubHeader 新增可公開存取的預設值。(I96730)
• 我們為 Wear 新增了 HorizontalPagerScaffold 和 VerticalPagerScaffold 元件，提供全新動畫，並協調時間文字和頁面指標元件。(Iff7d0)
• 我們已在 HorizontalPagerScaffold 和 VerticalPagerScaffold 中新增旋轉支援，讓使用者能透過旋轉輸入裝置瀏覽呼叫器。(I9770d)
• 我們已對 MotionScheme API 進行變更，以簡化使用方式並提升一致性。移除了內嵌的 remember 函式，並將內建的 Motion Schemes 移至專屬的 MotionScheme 隨附物件。已將 standardMotionScheme 和 expressiveMotionScheme 重新命名為「標準」和「表情豐富」。(I5fd45)
• 我們新增了以系統顏色為準的動態色彩配置支援。(I073e9)
• 我們已根據最新的使用者體驗規格更新 Stepper。(I622bb)

修正錯誤

• 我們更新了資訊卡元件的字體排版和邊框間距。(I3ae48)
• 根據 UX 規格 (Ie55f0)，我們已將「確認」/「關閉」按鈕與其餘內容之間的 AlertDialog 邊框間距從 8dp 變更為 12dp。
• 我們更新了「滑桿」元件的顏色不透明度。(Idb383)

1.0.0-alpha26 版

2024 年 10 月 2 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha26。1.0.0-alpha26 版包含這些修訂版本。

API 變更

• 我們更新了 HorizontalPageIndicator 的 API 和外觀，並新增 VerticalPageIndicator，可與 VerticalPager 搭配使用 (Ic9309)
• AlertDialog 現在支援從按鈕堆疊變化中省略預設底部按鈕，適用於不需要 EdgeButton 的自訂版面配置。(I34fa9)
• 我們已為 Wear Material 3 新增 SwipeToReveal 元件 (Ic38b2)
• 我們在 SwipeToReveal 中新增了雙向滑動支援功能，適用於目前畫面不支援滑動關閉的罕見情況。預設仍為僅在從右向左滑動時顯示，強烈建議您尊重預設行為，以免與滑動關閉功能發生衝突。(Ifac04)
• 我們已將 EdgeButton 的 buttonHeight 參數重新命名為 preferredHeight。(I4fab3)
• Kotlin 版本已更新至 1.9 (I1a14c)
• 我們已將 OpenOnPhoneDialogDefaults.Icon 重新命名為 OpenOnPhoneDialogDefaults.OpenOnPhoneIcon，避免與 Icon 發生衝突(I0f391)
• 我們已在 LazyColumn 中新增對 ScrollIndicator 的支援。(Ia546a)
• 我們已更新 TextToggleButton 和 IconToggleButton 的預設值。(I7aaa9)
• 我們簡化了 Picker 和 PickerGroup API。(Id0653)
• 我們新增了 CardDefaults.Shape 和 CardDefaults.Height，這些是權杖，否則使用程式庫的開發人員無法存取。(I1594a、b/347649765)
• 我們已將二進位區隔圓形進度指標的進度參數重新命名為 segmentValue。(Ib72d9)
• 我們更新了「滑桿」的顏色和版面配置。(Ic3eec)

修正錯誤

• 我們更新了 openOnPhone 圖示動畫 (I66f85)
• 我們現在在 Slider、TimePicker 和 DatePicker 中使用 Google Symbols 圖示。(I46c7c)
• 我們更新了 Confirmation 和 OpenOnPhoneDialog 中的邊框間距。(Iaa82e)

1.0.0-alpha25 版

2024 年 9 月 18 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha25。1.0.0-alpha25 版包含這些修訂項目。

API 變更

• 我們新增了「未確定的圓形進度指標」。(I427a7)
• 我們已為 CircularProgressIndicator 和 SegmentedCircularProgressIndicator 新增進度溢位 (進度 > 100%) 支援。如果進度超過 1.0，新的 overflowTrack 顏色會顯示這項資訊。(Iaaa3d)
• 圓形 IconToggleButton 和 TextToggleButton 現在支援新的形狀動畫變化，其中不同形狀代表已勾選、未勾選和按下狀態。我們仍會支援先前按下狀態的動畫形狀變化。(I29f03)
• 由於需要在 ScreenScaffold 中明確指定 EdgeButton 高度，因此我們已移除 EdgeButton 與 Column 搭配使用的支援功能。(Ie353d)
• 我們已新增對 Wear Compose LazyColumn 的支援，並提供 ScreenScaffold (以及為 LazyColumnState 新增 ScrollInfoProvider 的實作)。(Ib8d29)
• 我們已將 LocalTextMaxLines、LocalTextAlign、LocalTextOverflow 合併為單一 LocalTextConfiguration 組合區域，以便提供更具擴充性的解決方案。(I5edbc)
• 我們新增了 arc-large 做為額外的型別比例，保留給畫面頂端或底部的簡短標題文字字串，例如確認疊加層。(I60e3e)
• 我們在「按鈕」中新增了預設值，建議使用大型和特大型圖示大小，以及內容邊框間距。(I84675)

修正錯誤

• 我們已更新 IconButton 和 TextButton 的顏色。(I48324)
• 我們已變更基本按鈕多載，使其垂直置中對齊，與其他多載保持一致。如要還原先前的行為，請使用 RowScope 中的 Modifier.align。(I66e57)

1.0.0-alpha24 版本

2024 年 9 月 4 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha24。1.0.0-alpha24 版包含這些修訂項目。

API 變更

• 我們已在 Material 3 主題中新增 Motion 結構。程式庫中的元件會使用這項資訊，套用動畫規格，例如用於表現力豐富的動作的彈簧。(I54ff3)
• 我們在 Material3 程式庫中新增了 AppScaffold 和 ScreenScaffold 元件，包括協調 TimeText 和 ScrollIndicator 圖層和轉場效果的功能。AppScaffold 提供頂層的 Scaffold 元件，位於所有畫面上方。因此，在 AppScaffold 中新增 TimeText 可讓該項目在畫面之間滑動時保持在原位。螢幕本身可以覆寫或隱藏時間文字。ScreenScaffold 提供 ScrollIndicator 的插槽，並在捲動時自動為捲動指標加上動畫效果，包括在閒置後隱藏捲動指標的逾時時間。(I047d6)
• 我們新增了採用全新 Material3 設計的 ScrollIndicator。系統會根據初始清單內容設定固定大小的縮圖，避免在將延遲載入的內容載入清單時，縮圖大小發生變化。(Ic228d)
• 我們已變更 ScrollAway API，讓 ScreenStage 成為值類別，而非列舉類別，以便日後視需要新增其他階段。(I48c93)
• 我們新增了 EdgeButton，這個 Wear 專屬按鈕的形狀會配合螢幕底部的弧度 (I16369)
• 我們在 ScreenScaffold 中新增了底部按鈕 (例如 EdgeButton) 的新版位，系統會根據捲動內容顯示及調整大小 (I032eb)
• 我們已新增 Modifier.scrollTransform 和 Modifier.targetMorphingHeight，可為 LazyColumn 中的項目新增 Material3 動態效果。(Ie229a)
• 我們已新增 SegmentedCircularProgressIndicator 做為 CircularProgressIndicator 的變體。區隔的變體會顯示所有區隔的單一進度值，或顯示每個區隔的開啟/關閉狀態。(I6e059)
• 我們已新增 LinearProgressIndicator，做為現有 CircularProgressIndicator 的替代方案。(I89182)
• 我們新增了 AlertDialog，提供向使用者顯示重要提示的版面配置。變體包括一組確認/取消按鈕，或選項堆疊下方單一的底部按鈕 (通常是 EdgeButton)。這兩種變化版本都有圖示、標題和額外文字的插槽，可提供更多詳細資料。(Ieb873)
• 我們新增了 OpenOnPhoneDialog，這個動作應表示使用者將在手機上繼續進行的動作。OpenOnPhoneDialog 會在指定逾時時間後關閉。(I978fd)
• 我們新增了 Confirmation，這個對話方塊元件提供圖示和曲線或直線文字的版位。系統會提供成功/失敗訊息的特定變體。確認訊息會在逾時後自動關閉。(Ib43e8)
• 我們在 TimeText 中新增了背景，以解決基礎內容與 TimeText 重疊，導致時間遭到遮蔽的問題。(Ia11fd)
• 我們新增了 LevelIndicator，可顯示音量等設定的值，並與現有的 Stepper 元件搭配使用，建構音量畫面。LevelIndicator 與 ScrollIndicator 類似，但會顯示在螢幕的另一側，且預設筆觸寬度較寬，指標顏色也不同。(I8a4ac)
• 我們已新增 TimePicker，可選擇 24 小時制 (含或不含秒數)，或 12 小時制 (含上午/下午選項)。(Ia5124)
• 我們新增了 DatePicker，可設定欄排序 (即日-月-年、月-日-年或年-月-日)，以及選用的最小/最大日期。(Ibf13b)
• 我們已在 TimeText 的 text 函式中新增權重參數。如果 TimeText 由多個文字元素組成，您就能控制空間的分配方式。(I36700)
• 我們新增了 RadioButton 和 SplitRadioButton，這些元件結合了 (Split)SelectableButton 和子項單選控制項 (If7ae8)，簡化了先前的 API
• 我們新增了 CheckboxButton 和 SplitCheckboxButton，這些元件結合了 (Split)ToggleButton 和子項 Checkbox 控制項 (Ia8f70)，簡化了先前的 API。
• 我們新增了 SwitchButton 和 SplitSwitchButton，這些元件結合了 (Split)ToggleButton 和子項 Switch 控制項 (I0d349)，簡化了先前的 API
• 我們已更新 AnimatedText 說明文件，說明過衝行為。(Iff30a)
• 我們新增了 ButtonGroup，可合併 2 或 3 個按鈕，讓按鈕按下時產生協調的動畫。(Ie27db)
• 我們新增了 IconButton 和 TextButton 的選用形狀動畫，可在按下時播放。(Iffca5)
• 我們在 Button、IconButton、TextButton、CompactButton 和 EdgeButton 中新增了額外的顏色變化 FilledVariant (I65fc3)
• 我們已在 ImageWithScrimPainter 中新增 forcedSize 參數，因此按鈕圖片背景現在預設會維持元件大小。設定 forcedSize = null 會改為採用 Painter.instrinsicSize。(Ic57af)
• 我們已在按鈕 (Ib613d) 中新增長按功能
• IconButton 和 TextButton 也新增了長按支援功能。(I38891)
• 現在可以長按「資訊卡」執行操作。(I305d5)
• 我們已新增 LocalTextMaxLines、LocalTextAlign、LocalTextOverflow 做為 CompositionLocals，並將其做為 Text 的參數預設值。現在，CheckboxButton、SwitchButton、RadioButton 等元件可以使用組合區域變數實作 UX 指南，但開發人員可以視需要覆寫參數。(Iab841)
• 我們新增了 Placeholder，有助於遮蓋按鈕和資訊卡等元件的內容，直到資料載入完成為止。(I1a532)
• 我們新增了 IconToggleButtonColors 和 TextToggleButtonColors，取代現已移除的 ToggleButtonColors。(Ie0bf1)

修正錯誤

• 我們已更新 Button、FilledTonalButton、OutlinedButton、ChildButton、CompactButton，使用新的 CompositionLocals LocalTextMaxLines、LocalTextAlign、LocalTextOverflow 實作使用者體驗指引，如有必要，開發人員可直接在 Text 中覆寫這些參數 (Ie51f7)
• 我們已將 LevelIndicator 的預設筆觸寬度變更為 6dp，與筆觸寬度為 4dp 的 ScrollIndicator 做出區別。(If6f63)
• 我們已修正 TimeText 中的問題，現在支援較大的掃描角度。(Ie489f)
• 修正 EdgeButton 重組期間的問題。(I4cdca)
• 修正提供自訂內容邊框間距時，分割切換按鈕的版面配置。(Ia33d3)
• 將小型進度值向上取整，至少要達到進度指標的線寬。(I3bd84)

1.0.0-alpha23 版本

2024 年 5 月 14 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha23。1.0.0-alpha23 版包含這些修訂項目。

API 變更

• 我們已更新 ToggleButton 和 RadioButton API，現在可以設定已停用的顏色。(If13a7)
• 我們已新增 Material3 的 CircularProgressIndicator。(Ib3bd7)

修正錯誤

• 我們修正了可選取按鈕的錯誤，現在已選取按鈕時，不會再重複宣布輕觸兩下即可切換。(I7ed88)

1.0.0-alpha22 版本

2024 年 5 月 1 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha22。1.0.0-alpha22 版包含這些修訂項目。

API 變更

• 我們已更新 Material3 ColorScheme。(I7b2b8)
• 我們已更新 Material3 Switch，除了變更部分顏色外，勾號現在也與 Checkbox 使用的勾號相符。(Icac7b)

修正錯誤

• 更新所有整合示範，使用新的 rotaryScrollable 修飾符。(I25090)

1.0.0-alpha21 版本

2024 年 4 月 17 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha21。1.0.0-alpha21 版包含這些修訂項目。

• 由於先前版本發生技術問題，導致缺少來源 JAR，因此觸發了這個版本。這個版本沒有新的提交。

1.0.0-alpha20 版本

2024 年 4 月 3 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha20。1.0.0-alpha20 版包含這些修訂項目。

修正錯誤

• 我們已調整漣漪按壓和聚焦狀態的 Alpha 值，以提高對比度。(I59f0a)
• 我們已在 Button、ToggleButton 和 RadioButton 中，於主要和次要標籤之間新增間距，以符合字體排版樣式和行高的最新異動。(I2c0ba)

1.0.0-alpha19 版本

2024 年 3 月 6 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha19。1.0.0-alpha19 版包含這些修訂項目。

API 變更

• 我們在 Wear Compose Material3 程式庫中新增了 TimeText。這個元件會在螢幕頂端顯示目前時間 (和其他狀態)。新的簡潔 Material 3 API 可避免線性和彎曲內容重複。(I4d7c3)
• 我們已將 RadioButton 的參數名稱從 onSelected 更新為 onSelect。(I1a971)
• 將 RadioButton 和 SplitRadioButton 權杖化，並重構現有方法，加入顏色的快取執行個體，以及將 RadioButtonColors 和 SplitRadioButtonColors 的方法設為內部，減少 CompositionLocal 查閱量。 (I02b33)

1.0.0-alpha18 版本

2024 年 2 月 21 日

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

API 變更

• 我們已重構 CardColors、ToggleButtonColors 和 SplitToggleButtonColors 的預設模式，在內部建立快取執行個體，並減少 CompositionLocal 的用量。(If3fec)

1.0.0-alpha17 版本

2024 年 2 月 7 日

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

API 變更

• 我們已更新 Button API，預設使用 buttonColors，並移除重複的 filledButtonColors。(I4fe3b)
• 我們已重構 ButtonColors、IconButtonColors 和 TextButtonColors 的預設模式，在內部建立快取執行個體，並減少 CompositionLocal 的用量。(I5f51c)
• 我們已移除元件特定顏色類別中 rememberUpdatedState 的額外負荷，並將顏色類別中的存取子方法標示為內部。(If6571)

修正錯誤

• 我們已更新 Modifier.minimumInteractiveComponentSize，改用 Modifier.node。(Iba6b7)

1.0.0-alpha16 版本

2024 年 1 月 24 日

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

新功能

• 我們新增了 CompactButton，可使用與按鈕相同的填滿、填滿色調和外框顏色。(I05df0)

API 變更

• 我們新增了 RadioButton/SplitRadioButton 做為選取控制項 (例如 Radio 控制項) 的容器。這與現有的 ToggleButton 不同，因為 RadioButton 可選取 (並在選取群組中運作)，而 ToggleButton 可切換 (且獨立運作)。(I61275)
• 為與 Compose Material3 程式庫保持一致，我們將從 Wear Compose Material3 程式庫中移除 LocalContentAlpha。(I49a0a)
• Wear Material 和 Wear Material 3 元件已更新，現在會公開可為空值的 MutableInteractionSource，預設為空值。MutableInteractionSource這裡沒有語意變更：傳遞空值表示您不希望提升 MutableInteractionSource，且系統會在元件內建立 MutableInteractionSource (如有需要)。變更為空值可讓某些元件永遠不會配置 MutableInteractionSource，其他元件則只會在需要時延遲建立執行個體，進而提升這些元件的效能。如果您未使用傳遞至這些元件的 MutableInteractionSource，建議改為傳遞空值。建議您在自己的元件中進行類似變更。 (Ib90fc、b/298048146)
• 在 wear:compose-material 和 wear:compose-material3 程式庫中新增了水波紋 API，取代已淘汰的 rememberRipple。此外，還新增了暫時的 CompositionLocal 和 LocalUseFallbackRippleImplementation，可將 Material 元件還原為使用已淘汰的 rememberRipple/RippleTheme API。這項功能將在下一個穩定版中移除，僅適用於提供自訂 RippleTheme 的情況，做為暫時的遷移輔助工具。如需遷移資訊和這項異動的背景資訊，請前往 developer.android.com。 (af92b21)
• 我們對 HorizontalPageIndicator API 及其說明文件進行了微幅改善。(I60efc)
• 我們已將 ColorScheme 更新為不可變動，雖然個別色彩更新的效率較低，但更常使用的色彩效率較高。這項變更背後的理由是，大多數應用程式不會將更新個別顏色做為主要用途。這仍有可能，但會比以往重組更多次，進而大幅減少所有 Material 程式碼的狀態訂閱量，並影響更多標準用途的初始化和執行階段費用。(Ibc2d6)
• 更新 ToggleButton 和 SplitToggleButton API，允許自訂停用顏色。此外，顏色和字體排版值現在會使用 Material Design 符記。(If087c)
• 更新按鈕圖片背景顏色，以使用 Material Design 符記。(Iba215)
• 我們移除了點擊處理作業，將 Checkbox、Switch 和 RadioButton 元件改為僅供顯示。這些元件預計會用於處理點擊的 (Split)ToggleButton 中，因此現在更清楚地標示為僅供顯示 (不適用於 Wear 獨立使用)。(I2322e)

修正錯誤

• 我們在 Wear Compose Material 3 中新增了時間長度和緩和效果的動態值權杖。(I437cd)
• 我們已修正 ToggleButton、SplitToggleButton、Checkbox、Switch 和 RadioButton 的錯誤，現在不會重複發布無障礙公告 (先前會重複語意角色)。(Ica281)
• 我們已移除 CompactButton 的 materialcore 層，以提升效能。(7902858)

1.0.0-alpha15 版本

2023 年 11 月 15 日

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

API 變更

• 我們已將基礎級別「SwipeToDismissBox」重新命名為「BasicSwipeToDismissBox」。這樣一來，基礎層級元件和 Material 3 層級 SwipeToDismissBox 之間的區別就更清楚了。後者會從 MaterialTheme 中提取顏色，用於半透明遮罩，並將其餘實作項目委派給 BasicSwipeToDismissBox。(Ibecfc)

修正錯誤

• 我們已移除 Material3 按鈕的 material-core 層，以提升效能。(I55555)

1.0.0-alpha14 版本

2023 年 10 月 18 日

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

API 變更

• 我們已從 Material3 HorizontalPageIndicator 移除 indicatorStyle 參數，改為依據裝置螢幕形狀 (直線或圓形) 顯示。(I83728)
• 我們新增了 SplitToggleButtonColors 類別，將 SplitToggleButton 的顏色與 ToggleButton 的顏色分開。(I78bee)

1.0.0-alpha13 版

2023 年 10 月 4 日

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

API 變更

• 我們已在 TitleCard 中新增選填的「副標題」欄位。(Ifc45a)
• 我們已為 TextButton 新增 Material Design 顏色權杖。(I769dc)

1.0.0-alpha12 版

2023 年 9 月 20 日

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

API 變更

• 我們已更新 IconButton，以使用 Material Design 符記。(I3f137)
• 我們已更新 IconToggleButton，以使用 Material Design 符記。(I7d263)
• 我們已公開 CheckboxColors、RadioButtonColors 和 SwitchColors 的建構函式。(I82b73)

1.0.0-alpha11 版本

2023 年 9 月 6 日

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

修正錯誤

• 我們已將 Material 3 資訊卡的排版更新為 TitleMedium。(I597bd)
• 我們更新了 Material3 ListHeader 和 ListSubheader 的字體排版和對齊方式。(Ib5ceb)

1.0.0-alpha10 版本

2023 年 8 月 23 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha10。1.0.0-alpha10 版本包含以下修訂項目。

新功能

• 在 Wear Material3 程式庫中新增 HorizontalPageIndicator。(Ifee99)

API 變更

• 更新按鈕程式碼，使用 Material 3 設計符記。(I92fe4)
• 由於使用者介面的詳細資料仍在最終定案中，因此將 Wear Material 3 Stepper 和 Slider API 宣告為實驗階段。(I84d54)
• 我們已從圓形 TextButton 和 TextToggleButton 中移除 ExtraSmall 大小，因為該大小只適用於 IconButton。(Ibc7d5)

修正錯誤

• 我們更新了 TextToggleButton 的字體排版指南，改為針對 LargeButtonSize 使用 LabelLarge (Ib10fa)
• 我們更新了 TextButton 的排版指南，針對 LargeButtonSize 使用 LabelLarge (I8f3a7)
• 我們已將 Card 的最小觸控目標設為 48dp，以符合無障礙功能需求。(Ieb9b1)
• 新增含圖片的 AppCard 示範應用程式，並移除含背景的 AppCard 示範應用程式 (Id735f)
• 修正圓形按鈕的錯誤，即修飾符未正確串連。(I5e162)

1.0.0-alpha09 版本

2023 年 8 月 9 日

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

新功能

• 我們已為 Material 3 新增 ToggleButton (I6bed6)

API 變更

• 我們已將 FloatRange 註解設為 API 限制，先前已在註解中說明。(Icb401)
• 我們已根據最新的 Material3 指南，更新 Wear Material3 的字體排版。(I1bad6)

修正錯誤

• 我們已根據 Material3 設計，更新 Button、IconButton 和 TextButton 的顏色。(Ib2495)
• 我們修正了停用狀態下核取方塊勾號的顯示問題。(Ib25bf)

1.0.0-alpha08 版本

2023 年 7 月 26 日

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

新功能

• 我們已新增 Material3 的下列選取控制項：Switch、Checkbox、RadioButton。(Ib918c)
• 我們已在 Material 3 中新增 IconToggleButton 和 TextToggleButton，分別是圓形切換按鈕，以及圖示和文字的單一版位。如要使用不同大小的 ToggleButton，建議搭配 Modifier.touchTargetAwareSize，並使用各個切換按鈕提供的大小。(I9f015)
• 我們已在 Material3 元件中新增 ListHeader 和 ListSubheader。(Ibaefe)
• 我們新增了 Material3 SwipeToDismissBox，可呼叫新的 Foundation SwipeToDismissBox，並從其主題提供預設色彩值。(I275fb)
• 我們已在 Wear Compose 中新增 Material3 InlineSlider。可讓使用者從多種不同的值中選擇。選取範圍會以長條形式顯示範圍的最小值和最大值，使用者可以從該範圍選取單一值。InlineSlider 很適合用來調整音量或亮度等設定。(I7085f)

API 變更

• 我們已更新 Wear Material 3 主題中的形狀，改用 RoundedCornerShape 而不是 Shape。(Idb133)
• 我們已公開 Button 的高度常數 (Idbfde)
• 更新 API 檔案，以註解相容性抑制 (I8e87a、b/287516207)
• 我們已更新 Wear Compose Material 3 中的 InlineSliderColors，使其具有公開建構函式和公開屬性。(I6b632)
• 我們已更新 Wear Compose Material 3 中的所有顏色類別，使其具有公開建構函式和公開屬性。(I17702)
• 我們已公開按鈕的水平和垂直邊框間距常數。(Ieeaf7)

修正錯誤

• 現在，如果無障礙設定的字型較大，導致按鈕內容變多，按鈕會視需要調整高度 (Iaf302)
• 我們更新了多個按鈕範例，解決無障礙問題。(I61ce9)
• Stepper 和 InlineSlider 現在支援長按時重複點按，因此按住 + 或 - 按鈕即可快速增加/減少 Stepper 和 InlineSlider 的值 (I27359)

1.0.0-alpha07 版本

2023 年 6 月 21 日

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

新功能

• 我們已將 Stepper 元件新增至 Compose for Wear OS Material 3 程式庫。這與先前的 Material 版本類似，但依預設會省略範圍語意，這是根據開發人員的意見回饋所做的調整。我們提供Modifier.rangeSemantics需要範圍語意的案例。(Ic39fd)
• 我們已在適用於 Wear OS 的 Compose Material 3 程式庫中新增 curvedText。(Ia8ae3)

修正錯誤

• 我們已更新 wear.compose.foundation，使其成為 wear.compose.material3 的 API 依附元件 (I72004、b/285404743)

1.0.0-alpha06 版本

2023 年 6 月 7 日

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

修正錯誤

• 我們已更新 TextButton，使用 toDisabledColor 擴充函式來取得正確的停用 Alpha 值。(I814c8)

1.0.0-alpha05 版本

2023 年 5 月 24 日

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

新功能

• 我們已在 Material3 中新增 TextButton，這是一個圓形按鈕，可容納單一文字。如要使用不同大小的 TextButton，建議使用 TextButtonDefaults 中提供的 Modifier.touchTargetAwareSize 和 ExtraSmallButtonSize、SmallButtonSize、DefaultButtonSize 和 LargeButtonSizeIcon。預設 TextButton 沒有邊框，背景為透明，適用於低強調動作。如要強調動作，請使用 filledTextButtonColors；如要中等程度的強調，請使用外框 TextButton，並將邊框設為 ButtonDefaults.outlinedButtonBorder；如要介於外框和填滿之間，請使用 filledTonalTextButtonColors。(I667e4)
• 我們已將 Card、OutlinedCard、AppCard 和 TitleCard 新增至 Wear Compose Material3 程式庫。AppCard 和 TitleCard 也可以使用 CardDefaults.outlinedCardColors 和 CardDefaults.outlinedCardBorder 顯示外框(I80e72)

API 變更

• 我們已將 Button 標籤參數移至結尾，以支援結尾 lambda 語法，並移除角色參數 (因為可以使用 Modifier.semantics 覆寫此參數)。ButtonColors 建構函式現在是公開函式。(Ie1b6d)

1.0.0-alpha04 版本

2023 年 5 月 10 日

發布 androidx.wear.compose:compose-material3:1.0.0-alpha04。1.0.0-alpha04 版本包含以下修訂項目。

新功能

• 我們已在 Material 3 中新增 IconButton，這是一個圓形按鈕，可放置圖示/圖片。共有四種變化：IconButton、FilledIconButton、FilledTonalIconButton 和 OutlinedIconButton。如要使用不同大小的 IconButton，建議使用 IconButtonDefaults 中提供的 Modifier.touchTargetAwareSize 和 ExtraSmallButtonSize、SmallButtonSize、DefaultButtonSize 和 LargeButtonSizeIcon。我們也提供 IconButtonDefaults.iconSizeFor，可根據指定按鈕大小判斷建議的圖示大小。(I721d4)

1.0.0-alpha03 版本

2023 年 4 月 19 日

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

API 變更

• 我們新增了 Material 3 按鈕元件，這是體育場形狀的按鈕，在 Wear Compose Material 程式庫中原名為「Chip」(為與 Compose Material 3 程式庫保持一致，已重新命名為「Button」)。預設的按鈕會填滿背景，按鈕變化包括「FilledTonal」(背景為靜音)、「Outlined」(透明背景和細邊框) 和「Child」(透明背景且沒有邊框，用於最不顯眼的補充動作)。簡單圖示和文字內容的圓形按鈕將在日後版本中推出。(Ia6942)

1.0.0-alpha02 版

2023 年 4 月 5 日

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

修正錯誤

• 我們已在 Wear Compose Material 3 中新增 DefaultTextStyle，預設會將 PlatformTextStyle.includeFontPadding 設為 true (目前設定)。這樣一來，我們就能在日後與 Compose 程式庫同步處理預設關閉字型邊框間距的問題 (請參閱「修正 Compose 背景中的字型邊框間距」)。(I7e461)

1.0.0-alpha01 版

2023 年 3 月 22 日

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

新功能

• Material 3 是新一代的 Material Design，包含更新的主題設定和重新設計的元件。Wear Compose 的 Material 3 設計與 Android 的 Material 3 Compose 程式庫一致。此第一版 Alpha 版本包含以下內容的初期功能實作：

  • Material Design 主題 - 設定程式庫中各項元件的色彩配置、字體和形狀等設定。Material3 主題已修訂顏色，支援無障礙對比度。(I84005)
  • 文字/圖示 - Wear Compose 應用程式的建構模塊 (I8e06a)

• 我們會繼續同步開發 Wear Material (androidx.wear.compose:compose-material) 和 Wear Material 3 (androidx.wear.compose:compose-material3)。日後推出的 Material 3 版本將擴充小工具組，納入 Compose for Wear OS 的其他常見元件，例如按鈕、挑選器和滑桿。

• Wear Material 和 Wear Material 3 程式庫互斥，不應在同一個應用程式中混用，主要是因為兩者參照的主題不同，可能會導致非預期的不一致。