Wear Compose マテリアル 3
最新の更新 | 安定版リリース | リリース候補版 | ベータ版リリース | アルファ版リリース |
---|---|---|---|---|
2025 年 6 月 4 日 | - | - | 1.5.0-beta03 | - |
依存関係の宣言
Wear への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。
アプリまたはモジュールの build.gradle
ファイルに、必要なアーティファクトの依存関係を追加します。
Groovy
dependencies { implementation "androidx.wear.compose:compose-foundation:1.5.0-beta03" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0-beta03" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0-beta03" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03") // 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-beta03") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0-beta03") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0-beta03") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03") // 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-beta03
2025 年 6 月 4 日
androidx.wear.compose:compose-*:1.5.0-beta03
がリリースされました。バージョン 1.5.0-beta03 に含まれる commit はこちらをご覧ください。
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)- RTL レイアウトで
ButtonGroup
のコンテンツが正しく反転されるようになりました。(Ib378d) AnimatedText
で RTL テキスト方向をサポートしました。(I4533c)TransformingLazyColumn
で、一番下のアイテムを削除したときにアイテムのサイズが正しく調整されるようになりました。(Idacab)TransformingLazyColumn
が測定パスを 1 回だけ行うようになりました。これにより、フレーム時間が短縮され、パフォーマンスが向上します。(I501a1)
バージョン 1.5.0-beta02
2025 年 5 月 20 日
androidx.wear.compose:compose-*:1.5.0-beta02
がリリースされました。バージョン 1.5.0-beta02 には、これらの commit が含まれています。
バグの修正
- foundation、material、material3 ライブラリのベースライン プロファイルを更新しました。(I53f06)
- 下部アイテムが削除されたときにアイテムのサイズが変更される
TransformingLazyColumn
のバグを修正しました。(Idacab) - リストの一番上または一番下にリストが固定される
TransformingLazyColumn
のバグを修正しました。(I49d00) OpenOnPhoneDialog
で、TalkBack がアイコンの内容説明ではなく、湾曲したテキストを読み上げるようにする必要があります。(I4efe8)hasPartiallyRevealedState
が false に設定されている場合にRevealState.currentValue
で誤ったアンカーを報告するSwipeToReveal
のバグを修正しました。(I9c7cf)SwipeToReveal
元に戻すボタンがデフォルトでButtonDefaults.Height
になりました。(I1f6c8)BasicSwipeToDismissBox
のパフォーマンスを改善しました。スクリムの描画に Canvas を使用しなくなりました。(I68f2c)- スライダーのユーザー補助バグを修正しました。更新後に読み上げられる割合が値と一致しませんでした。(I91146)
placeholderShimmer
の実装に関するバグを修正しました。(Iee39b)ScrollProgress
の計算を 30% 最適化することで、TransformingLazyColumn
のパフォーマンスが向上しました。(I4c4cb)
バージョン 1.5.0-beta01
2025 年 5 月 7 日
androidx.wear.compose:compose-*:1.5.0-beta01
がリリースされました。バージョン 1.5.0-beta01 には、これらの commit が含まれています。
Wear OS 向け Compose 1.5.0-beta01 リリースでは、ライブラリのこのリリースは機能が完成し、API がロックされていることが表明されました(試験運用版としてマークされている場合を除く)。
Wear Compose 1.5.0-beta01 には、Wear Compose Material3 ライブラリが含まれています。このライブラリは、Material 3 Expressive という新しい UI デザイン システムをサポートしています。アプリに新しいビジュアル デザインを導入し、次のような新しいコンポーネントを活用するには、マテリアルから Material3 にアップグレードすることをおすすめします。
MaterialTheme
: 更新および拡張されたカラーパターン、タイポグラフィ、シェイプにより、デザインに深みと多様性をもたらします。- ダイナミック カラー テーマ設定: ウォッチフェイスの色に合わせてアプリのカラーパターンを自動的に生成します。
- 新しいコンポーネントは、デフォルトで大きな画面サイズに自動的に適応
- シェイプ モーフィング -
IconButton
、TextButton
、IconToggleButton
、TextToggleButton
などの丸いボタン コンポーネントは、押されたときやチェックされたときにアニメーション化するバリエーションをサポートしています。 EdgeButton
- 画面の下部用に特別な形状で設計された、新しいエッジを覆うボタン。- スキャフォールディング -
AppScaffold
とScreenScaffold
を導入して画面の構造をレイアウトし、ScrollIndicator
とTimeText
のアニメーションを調整します。 - ボタン - さまざまなスタジアム型のボタンがサポートされています。柔軟なシングルスロット コンテナと、アイコンとラベル付きのボタン用のマルチスロット バリエーションがあります。
CheckboxButton
とSwitchButton
は切り替えボタンが必要な場合に使用され、RadioButton
は選択ボタンとして使用されます(切り替えボタンと選択ボタンの「分割」バリエーションも用意されています)。 ButtonGroup
- タップしたときにシェイプモーフィングする、行に並んだ表現力豊かなボタンのグループを実装します。AlertDialog
のバリエーションは、OK ボタンまたはキャンセル ボタン、またはEdgeButton
をサポートしています。ConfirmationDialog
を使用すると、タイムアウト付きのメッセージを表示できます。成功、失敗、スマートフォンでの開く場合の特別なアニメーションがサポートされています。- 選択ツール -
TimePicker
とDatePicker
のバリエーションがサポートされています。また、独自の選択ツール画面を構築するための Picker コンポーネントとPickerGroup
コンポーネントもサポートされています。 ProgressIndicators
- 円形と線形の進行状況インジケーターがサポートされています(CircularProgressIndicator
にはセグメント化された進行状況インジケーターと不確定な進行状況インジケーターがあります)。- カード - タイトル、時刻、サブタイトル、コンテンツ スロットを含むカードの特定のレイアウトを提供する
TitleCard
など、さまざまなカードバリエーションを使用できます。TitleCard
に画像の背景を指定すると、カード内の情報を強調できます。 - ページャー -
HorizontalPagerScaffold
、VerticalPagerScaffold
、AnimatedPage
コンポーネントは、HorizontalPageIndicator
アニメーションとVerticalPagerIndicator
アニメーションを調整します。HorizontalPager
とVerticalPager
は Wear Compose Foundation ライブラリでリリースされています。 - プレースホルダ - 暫定的なコンテンツが使用できない場合に、コンポーネントの上にスケルトン シェイプを描画します。
- スライダーとステッパー - スライダーとステッパーの両方を使用すると、ユーザーは値の範囲から選択できます。スライダーはよりコンパクトで、セグメント化できます。一方、ステップバーは通常
StepperLevelIndicator
とペアになるフルスクリーン コンポーネントです。 SwipeToReveal
- 右から左にスワイプしたときに、コンポーザブルに追加のアクションを追加するために使用されます。
Wear Compose Foundation 1.5.0-beta01 には、次の新しいコンポーネントも含まれています。
TransformingLazyColumn
- スケーリングとモーフィング アニメーションをサポートする、遅延ありの縦方向にスクロールするリスト- 階層型フォーカス グループ - アプリケーション内のコンポーザブルにアノテーションを付け、コンポジションのアクティブな部分を追跡してフォーカスを調整するために使用されます。
- ページャー -
HorizontalPager
コンポーネントとVerticalPager
コンポーネント。Compose Foundation コンポーネントをベースに、Wear 固有の機能強化を施し、パフォーマンスと Wear OS ガイドラインへの準拠を改善しています。
API の変更
- Hierarchical Focus API を更新 -
Modifier.hierarchicalFocus
の名前をModifier.hierarchicalFocusGroup
に変更し、コールバック パラメータを削除。FocusRequester
パラメータを持つModifier.hierarchicalFocusRequester
のオーバーロードを削除。コンポーネントがアクティブな画面を通知および確認できるように、新しいCompositionLocal
LocalScreenIsActive
を作成。(I5ff7c)。 - Wear Compose Foundation の
SwipeToReveal
を非推奨とし、Wear Compose Material と Wear Compose Material3 のSwipeToReveal
API に置き換えました。API を引き続き使用するには、Wear FoundationSwipeToReveal
のインポートを Wear Compose Material または Wear Compose Material3 のインポートに置き換えてください。(Ia147d)。 - Wear Compose の Material3 の
SwipeToReveal
が Foundation に依存している場合、その依存関係は 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
に変更しました。hasPartiallyRevealedState
パラメータの使用を示すためにSwipeToRevealNonAnchoredSample
の名前を変更しました。デフォルトはボタンのデフォルトの高さであり、より大きな高さは修飾子を使用して設定できるため、actionButtonHeight
を削除しました。SwipeToRevealDefaults
からSmallActionButtonHeight
を削除しました。RevealValue
コンストラクタとRevealDirection
コンストラクタの value パラメータを非公開にしました。(I465ce)。
バグの修正
TransformingLazyColumn
アイテムが削除された後にEdgeButton
がアニメーションで配置されるように、ScreenScaffold
のEdgeButton
の処理を修正しました。(I6d366)。- Compose ライブラリに対する Wear Compose の依存関係をバージョン 1.8.0 に更新しました。(I2ef3f)。
- 未確定の
CircularProgressIndicator
の動きが更新され、一時的に後退しないようにしました。(Ieddb1)。 SwipeDismissableNavHost
のバグを修正しました。後方にスワイプした後にフォーカスが正しく切り替わらず、ロータリー入力が失敗する問題を修正しました(これは、予測型「戻る」を使用する API 36 以降に該当します)。(Ieddb1)。- Hierarchical Focus API(Idf2ff)のドキュメントを修正しました。
- Button と Card のドキュメントを更新し、
containerPainter
とdisabledContainerPainter
がcontainerColor
とdisabledContainerColor
をオーバーライドする方法について説明しました。(I4a453) - ナビゲーション中に独自のスレッドを管理するアプリで問題が発生するため、
BroadcastReceiver
をワーカー スレッドに移動した、前回のリリースのTimeText
の変更を元に戻しました。(I34d02)。 - Picker のサンプルを更新し、不要な remember 呼び出しを削除し、代わりに Picker で
rememberUpdatedState
を使用して最新のcontentDescription
ラムダ関数を記憶するようにしました。(Icb5b1)。 TimePicker
とDatePicker
のテキスト スタイルを更新し、フォント変更によるテキストの切り捨てを防ぎました。(I26194)。ListHeader
とListSubHeader
のデフォルトのテキスト配置が、それぞれ中央揃えと先頭揃えになりました。(I78339)。- カスタム ユーザー補助アクションを通知するように、Foundation とマテリアルの「スワイプして表示」のサンプルとデモを更新しました(カスタム アクションは、
SwipeToReveal
コンポーザブル自体ではなく、コンテンツのセマンティクスとして追加する必要があります)。(Ie92a3)。 - サイズに応じて
EdgeButton
コンテンツに設定されるデフォルトのMaxLines
を更新しました。超小サイズは 1、小サイズと中サイズは 2、大サイズは 3 になりました。(Ie35f6)。 - パフォーマンスを向上させるため、オブザーバーが 1 回だけ登録されるように
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 に含まれる commit はこちらをご覧ください。
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
をラムダとして受け取るようになり、不要な再コンポーズを回避できるようになりました。(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 には、これらの commit が含まれています。
API の変更
ButtonDefaults.imageBackgroundButtonColors
をImageButton
、ButtonDefaults.imageButtonColors
、ButtonDefaults.containerPainter
、ButtonDefaults.disabledContainerPainter
に置き換えました。カードにも同様の変更が加えられます。ペインターはButtonColors
とCardColors
から削除されました。(I8c6a1)- API を簡素化するためにプレースホルダを更新しました。2 つの修飾子(コンポーネント レベルでシマー効果を適用する
Modifier.placeholderShimmer
と、読み込まれていないコンテンツの上にマスクを適用するModifier.placeholder
)が追加されました(Iaee7a)
バグの修正
ScrollIndicator
にオーバースクロールを統合しました。(Icfb7f)- マテリアル 3 ダイアログを起動すると背景が空白になる、ダイアログが表示されない問題に対処しました。(Ice597)
- テキストが複数行にまたがる場合に
FadingExpandingLabel
で発生する問題を修正しました。(I04eb7) - ボタンのプライマリ ラベルとセカンダリ ラベル間のパディングを更新しました。(I99b7b)
ArcLarge
を20sp
から18sp
に引き下げ、ArcLarge
とArcSmall
の文字間隔を更新しました。ConfirmationDialog
/OpenOnPhoneDialog
で、18sp
にオーバーライドするのではなく、デフォルトのArcLarge
が使用されるようになりました。(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 に含まれる commit はこちらをご覧ください。
API の変更
AlertDialog
の上部パディングが、アイコンが指定されている場合にデフォルトで縮小されるようになりました。これにより、利用可能な画面サイズを最大限に活用できます。(Ief06c)PagerScaffoldDefaults.FadeOutAnimation
の名前をPagerScaffoldDefaults.FadeOutAnimationSpec
に変更しました。AnimatedPage
の page パラメータの名前がpageIndex
に変更されました。(I701f2)TransformingLazyColumn
のSurfaceTransformation
の命名を更新 -applyTransformation
をapplyContainerTransformation
とapplyContentTransformation
に分割し、createBackgroundPainter
の名前をcreateContainerPainter
に変更しました。TransformationSpec
とResponsiveTransformationSpec
の命名をさらに更新しました。(I1c534)AppScaffold backgroundColor
の名前がcontainerColor
に変更されました。(I4e63f)
バグの修正
FadingExpandingLabel
で、テキストが正しく拡大されない問題を修正しました。(I0e773)ArcLarge
は 20sp から 18sp に縮小され、ArcLarge
とArcSmall
の文字間隔が更新されました。ConfirmationDialog/OpenOnPhoneDialog
で、18sp にオーバーライドするのではなく、デフォルトのArcLarge
を使用するようになりました。(Id39a8)DatePicker
とTimePicker
ベースのヘディング アニメーションを更新し、フェードアウト アニメーションとフェードイン アニメーションが 1 つのスプリング アニメーションとして機能するようにしました。(I68963)AnimatedPage
コンポーズ可能関数でcurrentPageOffsetFraction
の読み取りを回避することで、PagerScaffold
を最適化しました。(I433ef)- すべての種類のスケールが更新され、デフォルトで比例数値が使用されるようになりました。これは、比例数値が最も一般的なユースケースと見なされ、デフォルトで表形式が使用されていると、特定の数値のペアの間にスペースが多すぎるためです。
TimePicker
とDatePicker
では、表形式の数字に引き続きFontFeatureSetting=tnum
が適用されます。(I88929) TimePicker
とDatePicker
の RSB 入力の初期フォーカスを修正しました。(I1c773)OpenOnPhoneDialog
のデフォルトのテキストを「スマートフォンを確認してください」に更新しました。(I00a3f)- 重み 600 が太字として扱われる問題を回避するため、
ArcLarge
とArcMedium
の重みを 600 から 599 に更新しました(I2a51d) - コンテンツとアクション ボタンの間、およびアクション ボタンのアイコンとテキストの間のパディングを
SwipeToReveal
に更新しました。(Ic46cb)
バージョン 1.0.0-alpha34
2025 年 3 月 12 日
androidx.wear.compose:compose-material3:1.0.0-alpha34
がリリースされました。バージョン 1.0.0-alpha34 に含まれる commit はこちらをご覧ください。
API の変更
PagerScaffold
はPager
コンポーネントをエミットしなくなりました。代わりに、content
コンポーザブルを介して提供する必要があります。AnimatedPage
とsnapWithSpringFlingBehaviour
が公開され、Wear FoundationPager
とともに使用して、以前の M3PagerScaffold
の動作を実現できるようになりました。(更新されたサンプルをご覧ください)。(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
にエッジスワイプ ゾーンのサポートを追加しました。FoundationSwipeToReveal
のデフォルトの動作が変更され、操作が端から始まった場合にスワイプが禁止されるようになりました。Material3 のSwipeToReveal’
のデフォルトの動作が変更され、SwipeDirection
が単一方向に設定されている場合に、ジェスチャーがエッジから開始されたときにスワイプが禁止されるようになりました。(I32ef0)FadingExpandingLabel
コンポーザブルを追加しました。これにより、アニメーションでテキストを 1 行ずつフェードインできます。(Ic60fa)TransformingLazyColumn
が、最初のアイテムと最後のアイテムを中央に配置するのではなく、デフォルトで空のcontentPadding
を使用するようになりました。(I77ab7)- Wear Compose マテリアル 3 ライブラリから
SwipeToReveal
のrememberRevealState
を削除しました。(I8c0e0)
バグの修正
- Wear Compose ライブラリが Kotlin 2.0 コンパイラに更新されました。(I2de79)
- 丸以外の
ScrollIndicator
とPageIndicator
のサポートは、Material3 から削除されました。また、Wear OS の要件から正方形の画面のサポートが削除されました。詳しくは、スタートガイドをご覧ください。(I9a852) ConfirmationDialogDefaults
とOpenOnPhoneDialogDefaults
で使用されるCurvedTextStyle
が更新され、サイズ18sp
と文字間隔1.8sp
のArcLarge
タイポグラフィが使用されるようになりました。(Ic9ced)Card
、ListHeader
、RadioButton
、CheckboxButton
、SwitchButton
で、デフォルトでコンテンツの高さが制限されなくなりました。必要に応じて、Modifier.height(IntrinsicSize.Min)
を使用して以前の動作を復元します。(I80bb8)- デフォルトの
TimeText
とScrollIndicator
の色を更新し、グレーの色調を追加しました。これは、OnBackground
(白)を使用すると、画面上の他のコンテンツ(タイトルなど)と競合する際に視覚的な重みが過度に大きくなるためです。(I8b36f) - スキャフォールド コンポーネントの
TimeText
とScrollIndicator
のアニメーション化のタイムアウトを 2 秒に短縮しました。(I52021) - ダイアログの背景のスケールが、スワイプして閉じる操作と同期されるように、ダイアログのモーションが更新されました。(I925a9)
edgeSwipeToDismiss
修飾子を使用した M3SwipeToReveal
のデモを追加しました。(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 に含まれる commit はこちらをご覧ください。
API の変更
SwipeToRevealScope
のprimaryAction
とsecondaryAction
からラベル パラメータを削除しました。カスタム アクションのセマンティクスは、デベロッパーがSwipeToReveal
コンポーネントの内容に直接追加する必要があります。(Ia67f3)IconToggleButtonDefaults
とTextToggleButtonDefaults
のサイズ、テキスト スタイル、色関数から「Button」接頭辞を削除しました(I5471d)- 試験運用版の
LocalMinimumInteractiveComponentEnforcement
を削除しました。(I4ad8a) PickerGroupScope
DSL がコンポーザブルに置き換えられました。そのため、PickerGroupScope
からpickerGroupItem
メソッドを削除し、代わりに@Composable PickerGroupItem
を追加しました。これは、PickerGroup
に Picker を追加するために使用する必要があります。また、PickerGroup
の「content」パラメータの型を@Composable PickerGroupScope.() -> Unit
に更新しました。(Ic6aec)- 小数値の
LevelIndicator
オーバーロードを追加し、範囲パラメータを含むオーバーロード(Stepper コンポーネントでの使用に適している)に Stepper 接頭辞を追加しました。(If4234) TransformingLazyColumn
のTransformationSpec
を API に追加しました。これにより、TLC をスクロールするときにアイテムに対して行われる正確な変換を定義できるようになりました。(I21856)IconButtonShapes
、IconToggleButtonShapes
、TextButtonShapes
、TextToggleButtonShapes
を更新し、compose/material3 クラスと整合性を持たせました。(I5a081)overscrollEffect
パラメータをScalingLazyColumn
、TransformingLazyColumn
、ScreenScaffold
に追加しました。(I0cee8)rememberRevealState
のswipeDirection
パラメータの名前をrevealDirection
に変更しました。(I7472f)- Wear Pager は、Compose
PagerScope
を使用する代わりに、独自のPagerScope
を使用できるようになりました。(I9195b) LinearProgressIndicatorContent
コンポーザブルは削除されました。値の変更がデフォルトでアニメーション化されるように、LinearProgressIndicator
を直接使用してください。(I2c4ad)CircularProgressIndicatorStatic
コンポーザブルを削除し、同じ機能を備えた公開DrawScope
関数drawCircularProgressIndicator
を追加しました。変更がデフォルトでアニメーション化されるようにCircularProgressIndicator
を直接使用してください。カスタム アニメーションが必要な場合は、drawCircularProgressIndicator
から独自の Compose を作成してください。(Ie762f)DrawScope.drawCircularProgressIndicator
のパラメータの順序を変更し、targetProgress
パラメータを上に移動しました。(I8ab92)OpenOnPhoneDialog
API が更新され、明確性が高まり、他のダイアログとの整合性が向上しました。show
パラメータの名前がvisible
に変更され、curvedText
はデフォルト値ではなく呼び出し元から提供されるようになりました。(Idec2d)openOnPhoneCurvedText
の名前をopenOnPhoneDialogCurvedText
に変更しました。(I65bdd)ScrollIndicator
にカスタム色を指定するためのScrollIndicatorColors
を追加しました。(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 に含まれる commit はこちらをご覧ください。
API の変更
CurvedTextStyle
では、文字間隔を時計回りの文字間隔と反時計回りの文字間隔に分割しました。これは、時計回りの文字はベースラインから外側に広がりますが、反時計回りの文字は内側に広がるため(文字間隔を大きくする必要があります)、必要となります(I4b848)- Material3 ライブラリ間の一貫性を改善するため、
IconButtonShapes
、IconToggleButtonShapes
、TextButtonShapes
、TextToggleButtonShapes
を更新しました。また、この変更によりシェイプ キャッシュが導入され、割り当て回数が削減されます。(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
に改名され、変更する必要がないためMutableInteractionSource
ではなくInteractionSource
を受け取ります。また、ButtonGroup
内のボタンのデフォルトの最小幅である公開定数ButtonGroupDefaults.DefaultMinWidth
も追加しました。(Ie27ec)ListHeaderDefaults.contentColor
はコンポーザブル プロパティであるため、先頭を小文字にするように更新しました。(I125a5)SliderDefaults.DecreaseIcon
とSliderDefaults.IncreaseIcon
にコンテンツ説明パラメータを追加し、適切なデフォルト値を設定しました。(I2e1a7)Picker
とPickerGroup
のspacing
パラメータの名前をverticalSpacing
に変更しました。(Ib75cc)ConfirmationDialog
の呼び出し元は、よりコンテキストのある文字列を提供する必要があるため、ConfirmationDialogDefaults.successText
とfailureText
を削除しました。また、confirmationCurvedText
の名前をconfirmationDialogCurvedText
に変更しました。最後に、ダイアログの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 に含まれる commit はこちらをご覧ください。
API の変更
- すべての Wear Compose ライブラリが「明示的な API」モードに更新されました。(Iebf9f)
ScreenScaffold
API とEdgeButton
API が更新され、EdgeButton
を含む画面でコンテンツの余白を簡単に指定できるようになりました。新しい API では、EdgeButton
のsize
はEdgeButton
にのみ渡され、ScreenScaffold
はEdgeButton
とリスト コンテンツ間のスペースにedgeButtonSpacing
パラメータを受け取ります。(I424fd)DatePicker
で、パラメータminDate
の名前をmaxDate
に、minValidDate
の名前をmaxValidDate
に変更しました。DatePickerColors
で、パラメータselectedPickerContentColor
の名前をactivePickerContentColor
に、unselectedPickerContentColor
の名前をinactivePickerContentColor
に変更しました。(Iba17b)ArcProgressIndicator
のデフォルトをstrokeWidth=6dp
に更新し、画面の高さのdiameter = 81.24%
を推奨しました。(I6f248)- ダイアログとしての使用を反映するように Confirmation API を更新しました。composable の名前が
ConfirmationDialog
に変更され、それに伴い、色とデフォルト クラスの名前が更新されました。また、他の Compose アニメーション API との互換性を確保するため、show
パラメータの名前をvisible
に変更しました。また、デベロッパーが導入/終了ダイアログのアニメーションをカスタマイズする必要がある状況に備えて、ConfirmationDialogContent
、SuccessConfirmationDialogContent
、FailureConfirmationDialogContent
も利用可能になりました。(Iaeb33) CircularProgressIndicatorContent
をCircularProgressIndicatorStatic
(CircularProgressIndicator
のアニメーションなしのバリエーション)に更新し、カスタム アニメーションを使用してCircularProgressIndicator
を作成できるようにしました。(I1346f)ArcProgressIndicator
のパラメータの順序を修正し、修飾子パラメータを先頭に配置しました(I4656a)SwipeToReveal
API を改善し、アクションのラベル(セカンダリ アクションを除く)のテキスト スロット パラメータを受け取るようにし、元に戻すアクションからラベル パラメータを削除しました。(I5b3db)
バグの修正
Button
、Card
、IconButton
、TextButton
でLongPress
ハプティクスが複数回トリガーされるバグを修正しました。(Ia8b0f)AlertDialog
の UX の変更 - 大画面では、確認ボタンと閉じるボタンが小さくなりました。また、[確認] ボタンと [閉じる] ボタンの下のスペースも広がりました。(I4f066)SwipeToReveal
コンポーネントのアクション ボタン ラベルのアニメーション仕様を変更しました。(Ib87fb)SwipeToReveal
を変更し、テキストの表示と同時にコンテナを展開するようにしました。(I44cf8)SwipeToReveal
を改善し、プライマリ アクションが commit されるしきい値を超えるスワイプ時にハプティクス フィードバックを実行するようにしました。(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 に含まれる commit はこちらをご覧ください。
API の変更
TransformingLazyColumn
のscrollTransform
修飾子がリファクタリングされ、API の変更がトリガーされました。(I0c6dc)IconToggleButtonShapes
とTextToggleButtonShapes
を更新し、2 つの異なるシェイプ パラメータuncheckedPressed
とcheckedPressed
を追加しました。(I85dbd)minDate
またはmaxDate
を使用している場合、無効な月/日のオプションがDatePicker
に新しいinvalidPickerContentColor
とともに表示されるようになります。(If4541)Stepper
API を更新して、increaseIcon
スロットとdecreaseIcon
スロットを提供しました。これらのコンテンツは、通常どおり Icon コンポーザブルから作成できます。(Id35da)dynamicColorScheme
を更新し、オプションのdefaultColorScheme
パラメータを削除して、null 許容のColorScheme
を返すようにしました。つまり、ダイナミック カラーパターンが指定されていない場合は、呼び出し元がフォールバック ケースを明示的に処理する必要があります。(I6d62e)CompactButton
で使用するために、ButtonDefaults
のアイコンサイズを更新しました。アイコンのみを含むCompactButton
にはButtonDefaults.SmallIconSize = 24.dp
を使用し、アイコンとテキストの両方を含むCompactButton
にはButtonDefaults.ExtraSmallIconSize = 20.dp
を使用します。CompactButton
は、最大幅に収めるのではなく、コンテンツを折り返すことをおすすめします。サンプルは、この点が反映されるように更新されています。(I0582c)- 4 種類の
EdgeButtonSizes
の推奨アイコンサイズを示すEdgeButtonDefaults
を追加しました。また、EdgeButton
のレイアウトを更新し、上部パディングよりも下部パディングを少し大きくしました。これにより、アイコンとテキストの両方のコンテンツの外観が改善されます。(Id772a) LinearProgressIndicator
にモーションを追加し、アニメーションのないビジュアル コンテンツを提供するLinearProgressIndicatorContent
を公開しました。(Idee99)- アニメーションなしで
CircularProgressIndicator
のビジュアル コンテンツを表示する新しいCircularProgressIndicatorContent
コンポーザブルを追加しました。(Ie33d4) TransformingLazyColumn
にコンポジション ローカルLocalTransformingLazyColumnItemScope
が新たに提供されました。Card
、Button
、ListHeader
は、TransformingLazyColumn
内に配置されたときに自動的にモーフィングするために、このLocalTransformingLazyColumnItemScope
を使用します。呼び出し元は、新しいTransformExclusion
ラッパーを使用して自動モーフィングを無効にできます。(I1652f)ButtonDefaults.shape
の型をRoundedCornerShape
に更新しました。(Iccdf2)
バグの修正
TimeText
の背景の既存のアルファを尊重するバグを修正しました。(I1eb60)- タイポグラフィでは、スケーリング オペレーション中に文字グリフがピクセル境界にスナップされることによるテキストのジッターを回避するため、デフォルトで
TextMotion
をAnimated
に設定しています。(I626fa) - 視認性を高めるために、
ScrollIndicator
の幅と隙間サイズを大きくして外観を更新しました。(Ied7cb) - アイテムの追加、削除、移動時に
Modifier.scrollTransform
で発生するバグを修正しました。(I6830f) - 短いタップによる丸いボタンのアニメーションの問題を修正しました(以前は、アニメーションの最小時間が常に守られていませんでした)。(I757a7)
LevelIndicator
のスウィープ角度を 20%(72 度)に更新しました。(Idde5c)ScalingLazyColumn
がAutoCenteringParams
で使用されている場合のScrollIndicator
の配置を修正しました。(I387dd)ListHeader
とListSubHeader
の色とタイポグラフィを更新しました。また、CheckboxButton
とSwitchButton
の切り替えコントロールの色も変更できます。(I39817)LazyColumn
とScalingLazyColumn
のScrollIndicator
の位置をContentPadding
で修正しました。(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 に含まれる commit は次のとおりです。
API の変更
TimeText
を更新して、時刻を表示するデフォルト コンテンツを提供しました。(Id23b3)orientation
パラメータが不要になったため、PagerState
のScrollInfoProvider
を簡素化しました。新しい動作では、TimeText
は水平方向と垂直方向の両方のページングで同じ位置に留まります。(I71767)LocalHapticFeedback
で、Vibrator API がハプティクスがサポートされていることを示す場合に、デフォルトのHapticFeedback
実装が提供されるようになりました。HapticFeedbackType
にConfirm
、ContextClick
、GestureEnd
、GestureThresholdActivate
、Reject
、SegmentFrequentTick
、SegmentTick
、ToggleOn
、ToggleOff
、VirtualKey
が追加されました。Wear 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 に含まれる commit はこちらをご覧ください。
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 material3 Colors クラスで
copy()
の公開設定を public に変更しました(I0287f)
バグの修正
- クリック時の
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 に含まれる commit はこちらをご覧ください。
API の変更
- Wear Compose Foundation
LazyColumn
の名前をTransformingLazyColumn
に変更したため、ScreenScaffold
とScrollIndicator
を更新しました。(I0608b) EdgeButton
の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)
- 最新の UX 仕様に沿って Stepper を更新しました。(I622bb)
バグの修正
- カード コンポーネントのタイポグラフィとパディングが更新されました。(I3ae48)
- UX 仕様(Ie55f0)に従い、
AlertDialog
の [確認] ボタンと [閉じる] ボタンと残りのコンテンツの間のパディングを 8 dp から 12 dp に変更しました。 - スライダー コンポーネントの色の不透明度を更新しました。(Idb383)
バージョン 1.0.0-alpha26
2024 年 10 月 2 日
androidx.wear.compose:compose-material3:1.0.0-alpha26
がリリースされました。バージョン 1.0.0-alpha26 に含まれる commit はこちらをご覧ください。
API の変更
HorizontalPageIndicator
の API と外観を更新し、VerticalPager
で使用するためのVerticalPageIndicator
を追加しました。(Ic9309)AlertDialog
で、EdgeButton が不要なカスタム レイアウトの場合に、ボタンスタック バリエーションからデフォルトの下部ボタンを省略できるようになりました。(I34fa9)- Wear マテリアル 3 の
SwipeToReveal
コンポーネントを追加しました。(Ic38b2) SwipeToReveal
で双方向スワイプのサポートを追加しました。現在の画面でスワイプして閉じることができないまれなケースに対応します。デフォルトでは、引き続き右から左へのスワイプのみでスワイプして表示する動作になります。スワイプして閉じる操作との競合を避けるため、デフォルトの動作を尊重することを強くおすすめします。(Ifac04)EdgeButton
のbuttonHeight
パラメータの名前をpreferredHeight
に変更しました。(I4fab3)- Kotlin のバージョンが 1.9(I1a14c)に更新されました
Icon
との競合を回避するため、OpenOnPhoneDialogDefaults.Icon
の名前をOpenOnPhoneDialogDefaults.OpenOnPhoneIcon
に変更しました。(I0f391)LazyColumn
でScrollIndicator
のサポートを追加しました。(Ia546a)TextToggleButton
とIconToggleButton
のデフォルト値を更新しました。(I7aaa9)Picker
API とPickerGroup
API を簡素化しました。(Id0653)CardDefaults.Shape
とCardDefaults.Height
を追加しました。これらはトークンであるため、ライブラリを使用するデベロッパーに限定されていました。(I1594a、b/347649765)- バイナリ セグメント化された円形の進行状況インジケーターの進行状況パラメータの名前を
segmentValue
に変更しました。(Ib72d9) - スライダーの色とレイアウトを更新しました。(Ic3eec)
バグの修正
openOnPhone
アイコンのアニメーションを更新しました。(I66f85)Slider
、TimePicker
、DatePicker
で Google シンボル アイコンが使用されるようになりました。(I46c7c)Confirmation
とOpenOnPhoneDialog
のパディングを更新しました。(Iaa82e)
バージョン 1.0.0-alpha25
2024 年 9 月 18 日
androidx.wear.compose:compose-material3:1.0.0-alpha25
がリリースされました。バージョン 1.0.0-alpha25 に含まれる commit はこちらをご覧ください。
API の変更
- 不確定形式の円形進行状況インジケーターを追加しました。(I427a7)
CircularProgressIndicator
とSegmentedCircularProgressIndicator
の両方で、進行状況のオーバーフロー(進行状況が 100% を超える)のサポートを追加しました。進行状況が 1.0 を超えると、新しいoverflowTrack
の色で示されます。(Iaaa3d)- 丸い
IconToggleButton
とTextToggleButton
で、新しい形状アニメーションのバリエーションをサポートするようになりました。このアニメーションでは、チェック状態、未チェック状態、押下状態を異なる形状で表します。押下直後の状態の以前のアニメーション化されたシェイプのバリエーションは引き続きサポートされます。(I29f03) ScreenScaffold
でEdgeButton
の高さを明示的に指定する必要があるため、Column
でEdgeButton
を使用するサポートを削除しました。(Ie353d)ScreenScaffold
で Wear Compose のLazyColumn
のサポートを追加しました(LazyColumnState
のScrollInfoProvider
の実装も追加しました)。(Ib8d29)- 今後、よりスケーラブルなソリューションを提供するために、
LocalTextMaxLines
、LocalTextAlign
、LocalTextOverflow
を 1 つのローカルLocalTextConfiguration
コンポジションに統合しました。(I5edbc) - 追加のタイプスケールとして arc-large を追加しました。これは、確認オーバーレイなど、画面の一番上または一番下の短いヘッダー テキスト文字列用に予約されています。(I60e3e)
- 推奨される大サイズと特大サイズのアイコンサイズとコンテンツの余白について、Button にデフォルトを追加しました。(I84675)
バグの修正
IconButton
とTextButton
の色を更新しました。(I48324)- 他のオーバーロードとの整合性を保つため、ベースの Button のオーバーロードを垂直方向に中央揃えに変更しました。以前の動作を復元するには、
RowScope
のModifier.align
を使用します。(I66e57)
バージョン 1.0.0-alpha24
2024 年 9 月 4 日
androidx.wear.compose:compose-material3:1.0.0-alpha24
がリリースされました。バージョン 1.0.0-alpha24 に含まれる commit はこちらをご覧ください。
API の変更
- Material3 テーマにモーション スキームを追加しました。これは、ライブラリ全体のコンポーネントで使用され、表現力豊かなモーションのスプリングなどのアニメーション仕様を適用します。(I54ff3)
- Material3 ライブラリに
AppScaffold
コンポーネントとScreenScaffold
コンポーネントが追加されました。これには、TimeText
とScrollIndicator
のレイヤリングと遷移を調整する機能が含まれています。AppScaffold
は、すべての画面の上に配置される最上位のスキャフォールド コンポーネントを提供します。そのため、AppScaffold
にTimeText
を追加すると、画面をスワイプしてもその位置を維持できます。画面自体で時刻のテキストをオーバーライドまたは非表示にできます。ScreenScaffold
はScrollIndicator
のスロットを提供します。スクロール時にスクロール インジケーターを自動的にアニメーション化します。また、無操作状態が続くとスクロール インジケーターを非表示にするタイムアウトも設定できます。(I047d6) - 新しい Material3 デザインの
ScrollIndicator
を追加しました。遅延読み込みコンテンツがリストに読み込まれたときにサイズが変化しないように、サムネイルのサイズは初期リストの内容に基づいて固定されています。(Ic228d) - 今後必要に応じてステージを追加できるように、
ScreenStage
が列挙型クラスではなく値クラスになるようにScrollAway
API を変更しました。(I48c93) EdgeButton
を追加しました。これは、画面下部の湾曲に沿った形状の Wear 固有のボタンです(I16369)ScreenScaffold
に、スクロール コンテンツに応じて表示とサイズ変更が行われる、下部ボタン(EdgeButton
など)の新しいスロットを追加しました。(I032eb)Modifier.scrollTransform
とModifier.targetMorphingHeight
を追加して、LazyColumn
のアイテムに Material3 モーション効果を追加しました。(Ie229a)CircularProgressIndicator
のバリエーションとしてSegmentedCircularProgressIndicator
を追加しました。セグメント化されたバリエーションでは、すべてのセグメントにわたる単一の進行状況値が表示されるか、各セグメントがオンまたはオフとして表示されます。(I6e059)- 既存の
CircularProgressIndicator
の代替としてLinearProgressIndicator
を追加しました。(I89182) AlertDialog
を追加し、ユーザーに重要なプロンプトを表示するためのレイアウトを提供しました。バリエーションには、確認/閉じるボタンのペア、またはオプションのスタックの下にある単一の下部ボタン(通常は EdgeButton)が含まれています。どちらのバリエーションにも、アイコン、タイトル、追加のテキスト用のスロットがあり、詳細情報を提供できます。(Ieb873)OpenOnPhoneDialog
が追加されました。これは、ユーザーのスマートフォンで続行されるアクションを示すために使用します。OpenOnPhoneDialog
は、指定したタイムアウト後に閉じられます。(I978fd)- アイコンと曲線または直線のテキスト用のスロットがあるダイアログ コンポーネント
Confirmation
を追加しました。成功/失敗メッセージには、特定のバリエーションが用意されています。確認メッセージはタイムアウト後に自動的に閉じられます。(Ib43e8) TimeText
に背景を追加し、基盤となるコンテンツとTimeText
が重なって時間が見えづらくなる問題を軽減しました。(Ia11fd)LevelIndicator
を追加しました。これは、音量などの設定の値を表示し、既存のStepper
コンポーネントと組み合わせて音量画面を作成できます。LevelIndicator
はScrollIndicator
に似ていますが、画面の反対側に表示され、ストロークの太さが広く、デフォルトでインジケーターの色が異なります。(I8a4ac)TimePicker
を追加しました。24 時間表記(秒ありまたは秒なし)または 12 時間表記(AM/PM 選択可)のレイアウトがあります。(Ia5124)DatePicker
を追加しました。列の順序(日-月-年、月-日-年、年-月-日)と最小日付と最大日付(省略可)を構成できます。(Ibf13b)TimeText
のtext
関数に重みパラメータを追加しました。TimeText が複数のテキスト要素で構成されている場合は、スペースの分割方法を制御できます。(I36700)RadioButton
とSplitRadioButton
を追加しました。これらのコンポーネントは、(分割)SelectableButton
と子ラジオ コントロール(If7ae8)の両方を組み合わせることで、以前の API を簡素化します。CheckboxButton
とSplitCheckboxButton
を追加しました。これらのコンポーネントは、(分割)ToggleButton
と子チェックボックス コントロール(Ia8f70)の両方を組み合わせることで、以前の API を簡素化します。SwitchButton
とSplitSwitchButton
を追加しました。これらのコンポーネントは、(Split)ToggleButton
と子スイッチ コントロールの両方を組み合わせることで、以前の API を簡素化します(I0d349)AnimatedText
のドキュメントを更新し、オーバーシューティングの動作について説明しました。(Iff30a)ButtonGroup
を追加して、2 つまたは 3 つのボタンを組み合わせ、ボタンを押すと連動したアニメーションが表示されるようにしました。(Ie27db)IconButton
とTextButton
の押下時にオプションのシェイプ アニメーションを追加しました。(Iffca5)Button
、IconButton
、TextButton
、CompactButton
、EdgeButton
に色のバリエーションFilledVariant
を追加しました。(I65fc3)forcedSize
パラメータをImageWithScrimPainter
に追加しました。これにより、ボタン画像の背景はデフォルトでコンポーネントのサイズを維持するようになりました。forcedSize = null
を設定すると、代わりにPainter.instrinsicSize
が採用されます。(Ic57af)- ボタンに長押しを追加しました(Ib613d)
IconButton
とTextButton
にも長押しのサポートが追加されました。(I38891)- カードに長押しに対応しました。(I305d5)
LocalTextMaxLines
、LocalTextAlign
、LocalTextOverflow
をCompositionLocals
として追加し、Text
のパラメータのデフォルトとして使用しました。コンポジションのローカル変数をCheckboxButton
、SwitchButton
、RadioButton
などのコンポーネントで使用して UX ガイダンスを実装できるようになりました。ただし、必要に応じてデベロッパーがパラメータをオーバーライドできます。(Iab841)- データが読み込まれるまで、ボタンやカードなどのコンポーネントのコンテンツをマスクするのに役立つ
Placeholder
が追加されました。(I1a532) - 削除された
ToggleButtonColors
に代わるIconToggleButtonColors
とTextToggleButtonColors
を追加しました。(Ie0bf1)
バグの修正
Button
、FilledTonalButton
、OutlinedButton
、ChildButton
、CompactButton
を更新し、新しいCompositionLocals
LocalTextMaxLines
、LocalTextAlign
、LocalTextOverflow
を使用して UX ガイダンスを実装できるようにしました。これらのパラメータは、必要に応じてデベロッパーが 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 に含まれる commit はこちらをご覧ください。
API の変更
- 無効な色を構成できるように
ToggleButton
API と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 に含まれる commit はこちらをご覧ください。
API の変更
- Material3 の
ColorScheme
を更新しました。(I7b2b8) - Material3 Switch を更新しました。色を変更し、チェックボックスで使用されているものと一致するチェックマークを追加しました。(Icac7b)
バグの修正
- 新しい
rotaryScrollable
修飾子を使用するように、すべての統合デモを更新しました。(I25090)
バージョン 1.0.0-alpha21
2024 年 4 月 17 日
androidx.wear.compose:compose-material3:1.0.0-alpha21
がリリースされました。バージョン 1.0.0-alpha21 に含まれる commit はこちらをご覧ください。
- このリリースは、ソース JAR が欠落するという技術的な問題が原因で、以前のリリースでトリガーされました。このリリースには新しい commit はありません。
バージョン 1.0.0-alpha20
2024 年 4 月 3 日
androidx.wear.compose:compose-material3:1.0.0-alpha20
がリリースされました。バージョン 1.0.0-alpha20 に含まれる commit はこちらをご覧ください。
バグの修正
- 押下状態とフォーカス状態の Ripple のアルカを調整し、コントラストを改善しました。(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 に含まれる commit はこちらをご覧ください。
API の変更
- Wear Compose Material3 ライブラリに
TimeText
を追加しました。このコンポーネントは、画面上部に現在時刻(および追加のステータス)を表示します。新しい簡潔な Material3 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 に含まれる commit については、こちらをご覧ください。
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 に含まれる commit については、こちらをご覧ください。
API の変更
- デフォルトで
buttonColors
を使用するように Button API を更新し、重複するfilledButtonColors
を削除しました。(I4fe3b) ButtonColors
、IconButtonColors
、TextButtonColors
のデフォルト パターンをリファクタリングし、内部でキャッシュに保存されたインスタンスを作成してCompositionLocal
の使用を削減しました。(I5f51c)- コンポーネント固有のカラークラスの
rememberUpdatedState
のオーバーヘッドを削除し、カラークラス内のアクセサラ メソッドを内部としてマークしました。(If6571)
バグの修正
Modifier.node
を使用するようにModifier.minimumInteractiveComponentSize
を更新しました。(Iba6b7)
バージョン 1.0.0-alpha16
2024 年 1 月 24 日
androidx.wear.compose:compose-material3:1.0.0-alpha16
がリリースされました。バージョン 1.0.0-alpha16 に含まれる commit については、こちらをご覧ください。
新機能
CompactButton
が追加されました。これは、Button と同じ塗りつぶし、塗りつぶしトーン、枠線の色を使用できます。(I05df0)
API の変更
- ラジオ コントロールなどの選択コントロールのコンテナとして
RadioButton
/SplitRadioButton
を追加しました。これは、RadioButton
は選択可能(選択グループ内で動作)であるのに対し、ToggleButton
は切り替え可能(独立)であるという点で、既存のToggleButton
とは異なります。(I61275) - Compose マテリアル 3 ライブラリとの整合性を確保するため、Wear Compose マテリアル 3 ライブラリから
LocalContentAlpha
を削除します。(I49a0a) - API で
MutableInteractionSource
を公開する Wear material コンポーネントと Wear material3 コンポーネントが更新され、デフォルトで null になる null 許容型のMutableInteractionSource
を公開するようになりました。意味的な変更はありません。null を渡すことは、MutableInteractionSource
をホイスティングしないことを意味し、必要に応じてコンポーネント内に作成されます。null に変更すると、一部のコンポーネントではMutableInteractionSource
が割り当てられなくなり、他のコンポーネントでは必要な場合にのみインスタンスを遅延作成できるため、これらのコンポーネントのパフォーマンスが向上します。これらのコンポーネントに渡すMutableInteractionSource
を使用していない場合は、代わりに null を渡すことをおすすめします。独自のコンポーネントでも同様の変更を行うことをおすすめします。(Ib90fc、b/298048146) - 非推奨の
rememberRipple
に代わる新しいリップル API をwear:compose-material
ライブラリとwear:compose-material3
ライブラリに追加しました。また、一時的なCompositionLocal
とLocalUseFallbackRippleImplementation
を追加して、非推奨のrememberRipple/RippleTheme
API を使用するようにマテリアル コンポーネントを元に戻します。これは次の安定版リリースで削除される予定です。これは、カスタムRippleTheme
を提供するケースの一時的な移行支援のみを目的としています。移行情報とこの変更の背景情報については、developer.android.com をご覧ください。(af92b21) HorizontalPageIndicator
API とそのドキュメントを若干改善しました。(I60efc)ColorScheme
を変更不可に更新しました。これにより、個々の色の更新は効率が低下しますが、色の一般的な使用は効率化されます。この変更の背景には、ほとんどのアプリで個々の色の更新が主なユースケースではないという理由があります。引き続き可能ですが、以前よりも再コンポーズが増えます。これにより、マテリアル コード全体で状態サブスクリプションの量が大幅に減り、より標準的なユースケースの初期化とランタイム コストに影響します。(Ibc2d6)- 無効な色をカスタマイズできるように
ToggleButton
API とSplitToggleButton
API を更新しました。また、色とタイポグラフィの値にマテリアル デザイン トークンが使用されるようになりました。(If087c) - マテリアル デザイン トークンを使用するように、ボタン画像の背景色を更新しました。(Iba215)
- クリック処理を削除して、
Checkbox
、Switch
、RadioButton
コンポーネントを表示専用に変更しました。これらのコンポーネントはクリックを処理する(Split)ToggleButton
で使用されることが想定されているため、コンポーネントがディスプレイ専用であることが明確に示されるようになりました(Wear でのスタンドアロンでの使用は想定されていません)。(I2322e)
バグの修正
- Wear Compose マテリアル 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 に含まれる commit については、こちらをご覧ください。
API の変更
- 基盤レベルの
SwipeToDismissBox
の名前をBasicSwipeToDismissBox
に変更しました。これにより、Foundation レベルのコンポーネントと Material3 レベルのSwipeToDismissBox
の違いが明確になります。後者は、スクリムで使用される色をMaterialTheme
から取得し、残りの実装をBasicSwipeToDismissBox
に委任します。(Ibecfc)
バグの修正
- パフォーマンスを改善するため、マテリアル 3 ボタンの material-core レイヤを削除しました。(I55555)
バージョン 1.0.0-alpha14
2023 年 10 月 18 日
androidx.wear.compose:compose-material3:1.0.0-alpha14
がリリースされました。バージョン 1.0.0-alpha14 に含まれる commit については、こちらをご覧ください。
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 に含まれる commit については、こちらをご覧ください。
API の変更
バージョン 1.0.0-alpha12
2023 年 9 月 20 日
androidx.wear.compose:compose-material3:1.0.0-alpha12
がリリースされました。バージョン 1.0.0-alpha12 に含まれる commit については、こちらをご覧ください。
API の変更
- マテリアル デザイン トークンを使用するように
IconButton
を更新しました。(I3f137) - マテリアル デザイン トークンを使用するように
IconToggleButton
を更新しました。(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 に含まれる commit については、こちらをご覧ください。
バグの修正
- Material3 カードのタイポグラフィを
TitleMedium
に更新しました。(I597bd) - マテリアル 3 の
ListHeader
とListSubheader
のタイポグラフィと配置を更新しました。(Ib5ceb)
バージョン 1.0.0-alpha10
2023 年 8 月 23 日
androidx.wear.compose:compose-material3:1.0.0-alpha10
がリリースされました。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。
新機能
- Wear Material3 ライブラリに
HorizontalPageIndicator
を追加。(Ifee99)
API の変更
- マテリアル 3 デザイン トークンを使用するようにボタンのコードが更新されました。(I92fe4)
- Wear マテリアル 3 の Stepper API と Slider API を試験運用版として宣言します。ユーザー インターフェースの詳細はまだ確定していません。(I84d54)
ExtraSmall
サイズはIconButton
にのみ適用されるため、丸いTextButton
とTextToggleButton
から削除しました。(Ibc7d5)
バグの修正
- TextToggleButton のタイポグラフィに関するガイダンスを更新し、LargeButtonSize に LabelLarge を使用するようにしました。(Ib10fa)
- TextButton のタイポグラフィに関するガイダンスを更新し、LargeButtonSize に LabelLarge を使用するようにしました。(I8f3a7)
- ユーザー補助のため、カードのタップ ターゲットの最小サイズは 48 dp に設定されています。(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 に含まれる commit については、こちらをご覧ください。
新機能
- マテリアル 3 に
ToggleButton
を追加しました。(I6bed6)
API の変更
- 以前コメントで述べたように、API 制約として
FloatRange
アノテーションを有効にしました。(Icb401) - 最新の Material3 ガイドラインに準拠するよう、Wear Material3 のタイポグラフィを更新しました。(I1bad6)
バグの修正
Button
、IconButton
、TextButton
の色を、マテリアル 3 のデザインに合わせて更新しました。(Ib2495)- 無効な状態のチェックボックスのチェックマークの可視性を修正しました。(Ib25bf)
バージョン 1.0.0-alpha08
2023 年 7 月 26 日
androidx.wear.compose:compose-material3:1.0.0-alpha08
がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。
新機能
- マテリアル 3 に、
Switch
、Checkbox
、RadioButton
の選択コントロールを追加しました。(Ib918c) - Material3 に
IconToggleButton
とTextToggleButton
を追加しました。これは、アイコンとテキスト用にそれぞれ 1 つのスロットを備えた円形の切り替えボタンです。ToggleButton
のサイズが異なる場合は、それぞれの切り替えボタンで指定されたサイズのModifier.touchTargetAwareSize
を使用することをおすすめします。(I9f015) - Material3 コンポーネントに
ListHeader
とListSubheader
を追加しました。(Ibaefe) - Material3
SwipeToDismissBox
が追加されました。これは、新しい FoundationSwipeToDismissBox
を呼び出し、そのテーマのデフォルトのカラー値を指定します。(I275fb) - Wear Compose にマテリアル 3 の
InlineSlider
を追加しました。ユーザーは値の範囲から選択できます。選択範囲は、範囲の最小値と最大値の間にバーとして表示され、ユーザーはそこから値を 1 つ選択できます。InlineSlider
は、音量や明るさなどの設定を調整するのに最適です。(I7085f)
API の変更
- Wear マテリアル 3 テーマのシェイプを更新し、Shape ではなく
RoundedCornerShape
ベースを使用するようにしました。(Idb133) - Button の高さ定数を公開しました(Idbfde)
- 互換性抑制のアノテーションを付けるように API ファイルを更新しました。(I8e87a、b/287516207)
- Wear Compose Material 3 の
InlineSliderColors
を更新し、パブリック コンストラクタとパブリック プロパティを追加しました。(I6b632) - Wear Compose マテリアル 3 のすべてのカラークラスを更新し、パブリック コンストラクタとパブリック プロパティを追加しました。(I17702)
- Button の水平方向と垂直方向のパディング定数を公開しました。(Ieeaf7)
バグの修正
- 必要に応じて、ユーザー補助用の大きなフォントによってコンテンツが拡大した場合に、ボタンの高さが調整されるようになりました。(Iaf302)
- ユーザー補助に関する問題に対処するため、いくつかの Button デモを更新しました。(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 に含まれる commit については、こちらをご覧ください。
新機能
Stepper
コンポーネントを Wear OS 向け Compose マテリアル 3 ライブラリに追加しました。これは以前のマテリアル バージョンと似ていますが、デベロッパーからのフィードバックに基づき、デフォルトで範囲のセマンティクスが省略されています。範囲セマンティクスが必要な場合は、Modifier.rangeSemantics
を使用します。(Ic39fd)- Compose for Wear OS マテリアル 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 に含まれる commit については、こちらをご覧ください。
バグの修正
TextButton
を更新し、無効なアルファ値を修正するためにtoDisabledColor
拡張関数を使用するようにしました。(I814c8)
バージョン 1.0.0-alpha05
2023 年 5 月 24 日
androidx.wear.compose:compose-material3:1.0.0-alpha05
がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。
新機能
- Material3 に
TextButton
を追加しました。これは、テキスト用の 1 つのスロットを備えた円形のボタンです。TextButton
のサイズが異なる場合は、TextButtonDefaults
で提供されているModifier.touchTargetAwareSize
、ExtraSmallButtonSize
、SmallButtonSize
、DefaultButtonSize
、LargeButtonSizeIcon
を使用することをおすすめします。デフォルトのTextButton
には枠線がなく、強調度が低いアクションの背景は透明です。高強調が必要なアクションにはfilledTextButtonColors
を使用します。中程度の強調が必要なアクションには、枠線付きのTextButton
を使用し、枠線をButtonDefaults.outlinedButtonBorder
に設定します。枠線と塗りつぶしの中間の場合は、filledTonalTextButtonColors
を使用します。(I667e4) - Wear Compose マテリアル 3 ライブラリに
Card
、OutlinedCard
、AppCard
、TitleCard
が追加されました。AppCard
とTitleCard
には、CardDefaults.outlinedCardColors
とCardDefaults.outlinedCardBorder
を使用して枠線を付けることもできます。(I80e72)
API の変更
- 後置ラムダ構文をサポートするため、ボタンのラベル パラメータを最後に移動し、ロール パラメータを削除しました(これは
Modifier.semantics
を使用してオーバーライドできるため)。ButtonColors
コンストラクタが公開されました。(Ie1b6d)
バージョン 1.0.0-alpha04
2023 年 5 月 10 日
androidx.wear.compose:compose-material3:1.0.0-alpha04
がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。
新機能
- Material3 に
IconButton
を追加しました。これは、アイコン/画像用の 1 つのスロットを備えた円形のボタンです。バリエーションはIconButton
、FilledIconButton
、FilledTonalIconButton
、OutlinedIconButton
の 4 つです。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 に含まれる commit については、こちらをご覧ください。
API の変更
- マテリアル 3 のボタン コンポーネントが追加されました。これはスタジアム型のボタンで、以前は Wear Compose マテリアル ライブラリで Chip という名前でしたが、Compose マテリアル 3 ライブラリとの整合性を確保するため、Button に名前が変更されました。デフォルトの 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 に含まれる commit については、こちらをご覧ください。
バグの修正
- 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 に含まれる commit については、こちらをご覧ください。
新機能
マテリアル 3 はマテリアル デザインの進化版であり、テーマ設定の更新とコンポーネントの再設計が含まれています。Wear Compose のマテリアル 3 は、Android のマテリアル 3 Compose ライブラリと連携するように設計されています。この最初のアルファ版リリースには、次のものを備えた初期段階の機能実装が含まれています。
Wear マテリアル(
androidx.wear.compose:compose-material
)と Wear マテリアル 3(androidx.wear.compose:compose-material3
)は引き続き並行して開発されます。今後の material3 リリースでは、ウィジェット セットが拡張され、ボタン、選択ツール、スライダーなど、Wear OS 向け Compose の使い慣れた他のコンポーネントが追加される予定です。Wear Material ライブラリと Wear Material 3 ライブラリは互いに排他的であり、同じアプリで混在させることはできません。主な理由は、異なるテーマを参照するため、予期しない不整合が生じる可能性があるためです。