Compose マテリアル 3

マテリアル デザインの進化版であるマテリアル デザイン 3 コンポーネントで Jetpack Compose UI を構築します。マテリアル 3 には、最新のテーマ設定とコンポーネント、ダイナミック カラーなどの Material You のパーソナライズ機能が含まれており、Android 12 の新しい視覚的スタイルとシステム UI と調和するように設計されています。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2024 年 12 月 12 日 1.3.1 - - 1.4.0-alpha05

構造

Compose は、androidx 内の 7 つの Maven グループ ID を組み合わせたものです。各グループにはそれぞれの目的に応じて Compose の機能のサブセットが含まれており、それぞれに固有のリリースノートがあります。

次の表に、各グループの説明と、それぞれのリリースノートのリンクを示します。

グループ説明
compose.animationJetpack Compose アプリ内でアニメーションを作成して、ユーザー エクスペリエンスを高めます。
compose.compiler@Composable 関数を変換し、Kotlin コンパイラ プラグインで最適化を有効にします。
compose.foundationすぐに使用できるビルディング ブロックで Jetpack Compose アプリを作成し、基盤を拡張して独自のデザイン システム要素を構築します。
compose.materialすぐに使用できるマテリアル デザイン コンポーネントで Jetpack Compose UI を構築します。Compose の上位レベルのエントリ ポイントであり、www.material.io のガイドラインと適合するコンポーネントを提供するように設計されています。
compose.material3マテリアル デザインの進化版であるマテリアル デザイン 3 コンポーネントで Jetpack Compose UI を構築します。マテリアル 3 には、最新のテーマ設定とコンポーネント、ダイナミック カラーなどの Material You のパーソナライズ機能が含まれており、Android 12 の新しい視覚的スタイルとシステム UI と調和するように設計されています。
compose.runtimeCompose のプログラミング モデルと状態管理の基本ビルディング ブロックと、Compose コンパイラ プラグインがターゲットとするコアランタイム。
compose.uiレイアウト、描画、入力などのデバイス操作に必要な Compose UI の基本コンポーネント。

依存関係の宣言

Compose への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.compose.material3:material3:1.3.1"
    implementation "androidx.compose.material3:material3-window-size-class:1.3.1"
    implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.4.0-alpha04"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

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

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.1"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

Compose Material3 共通バージョン 1.0

バージョン 1.0.0-alpha01

2024 年 4 月 17 日

androidx.compose.material3:material3-common:1.0.0-alpha01、androidx.compose.material3:material3-common-android:1.0.0-alpha01、androidx.compose.material3:material3-common-desktop:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 には、これらの commit が含まれています。

新機能

マテリアル デザイン コンポーネントの作成に使用できるテーマレス コンポーネント:

Compose Material3 アダプティブ ナビゲーション スイート バージョン 1.0

バージョン 1.0.0-alpha07

2024 年 5 月 1 日

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07、androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit はこちらをご覧ください。

API の変更

  • ナビゲーション スイート API を試験運用版から正式版に変更（If62af）

バグの修正

  • コンテンツの切り欠きをデフォルトで使用（50266df）

バージョン 1.0.0-alpha06

2024 年 4 月 17 日

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06、androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit はこちらをご覧ください。

API の変更

  • containerColor と contentColor を NavigationSuiteScaffoldDefaults に追加します。（I64e3a、b/331993720）
  • itemColors 関数を NavigationSuiteDefaults に追加。（Idf719、b/328480012）
  • NavigationSuiteScope をシーリングします。（Iefa57）

バージョン 1.0.0-alpha05

2024 年 3 月 6 日

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05、androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 には、これらの commit が含まれています。

API の変更

  • NavigationSuiteItemColors コンストラクタを公開しました。（Ica83a、b/324886877）

バージョン 1.0.0-alpha04

2024 年 2 月 21 日

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04、androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

依存関係の更新

  • Material3 適応型の依存関係を新しいモジュールパスに更新しました。（Ibc421）
  • ウィンドウ マネージャー バージョンのウィンドウ サイズクラスを使用するように移行します。（I3794d）

バージョン 1.0.0-alpha03

2024 年 2 月 7 日

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03、androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

API の変更

  • パッケージ名を navigation-suite から navigationsuite に更新しました。（I7eff7）
  • API で MutableInteractionSource を公開する Material3 コンポーネントが更新され、デフォルトで null になる null 許容型の MutableInteractionSource を公開するようになりました。意味的な変更はありません。null を渡すことは、MutableInteractionSource をホイスティングしないことを意味し、必要に応じてコンポーネント内に作成されます。null に変更すると、一部のコンポーネントでは MutableInteractionSource が割り当てられなくなり、他のコンポーネントでは必要な場合にのみインスタンスを遅延作成できるため、これらのコンポーネント全体のパフォーマンスが向上します。これらのコンポーネントに渡す MutableInteractionSource を使用していない場合は、代わりに null を渡すことをおすすめします。独自のコンポーネントでも同様の変更を行うことをおすすめします。（I41abb、b/298048146）

バージョン 1.0.0-alpha02

2023 年 12 月 13 日

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02、androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02、androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

  • 「None」の NavigationSuiteType を追加しました。（If8cb1、b/313688598）

バグの修正

  • ルート サーフェスに modifier.fillMaxSize がある場合に、ナビゲーション コンポーネントが画面全体に表示される問題を修正。（c9cf250、b/312664933）

バージョン 1.0.0-alpha01

2023 年 11 月 15 日

androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

Compose Material3 アダプティブ バージョン 1.0

バージョン 1.0.0-alpha06

2024 年 2 月 7 日

androidx.compose.material3:material3-adaptive:1.0.0-alpha06、androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06、androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

新機能

  • ThreePaneScaffoldNavigator の「戻る」ナビゲーションの追加の動作オプションを追加しました。（I858aa）
  • ナビゲーション履歴にオプションのデスティネーション コンテンツを追加しました。（Ibd7e6）

バージョン 1.0.0-alpha05

2024 年 1 月 24 日

androidx.compose.material3:material3-adaptive:1.0.0-alpha05、androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05、androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

  • スキャフォールドのナビゲーションと値の計算で履歴認識をサポート（I71d46）

バージョン 1.0.0-alpha04

2024 年 1 月 10 日

androidx.compose.material3:material3-adaptive:1.0.0-alpha04、androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04、androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

新機能

  • ペイン スキャフォールドで端から端までのサポートを追加しました。（I1b462）

API の変更

  • ポーズのヒンジ境界プロパティをヒンジ情報のリストに移動しました。（I24f90）

バグの修正

  • AnimatedPane が再コンポーズされない問題を修正（c3f573d）

バージョン 1.0.0-alpha03

2023 年 12 月 13 日

androidx.compose.material3:material3-adaptive:1.0.0-alpha03、androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03、androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

API の変更

  • スキャフォールドのロールを ThreePaneScaffoldRole のエイリアスに変更します。（I65bd1）
  • スキャフォールド ロールのベースクラスを作成する（I4784d）
  • AnimatedPane のコンテンツから不要なパラメータを削除しました。（Ibc73b）
  • collectWindowSizeAsState の名前を変更し、代わりに未加工の値を返します。（I480f4）

バージョン 1.0.0-alpha02

2023 年 11 月 29 日

androidx.compose.material3:material3-adaptive:1.0.0-alpha02、androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02、androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

  • ナビゲーション API をアダプティブ スキャフォールド API から分離しました。（Ic4045）
  • GutterSize クラスを削除しました。（I785b3）

バグの修正

  • AnimatedPane が使用されていないときにペインが切り替わらない問題を修正（d88f181）

バージョン 1.0.0-alpha01

2023 年 11 月 15 日

androidx.compose.material3:material3-adaptive:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

Material3 アダプティブ条件 API:

Material3 適応ペイン スキャフォールド ディレクティブ API:

Material3 アダプティブペイン スキャフォールド API:

Compose Material3 バージョン 1.4

バージョン 1.4.0-alpha05

2024 年 12 月 12 日

androidx.compose.material3:material3-*:1.4.0-alpha05 がリリースされました。バージョン 1.4.0-alpha05 には、これらの commit が含まれています。

API の変更

  • WideNavigationRailState.current/target 値の型を列挙型に置き換えて読みやすくしました。（I2d6ab）
  • SplitButton バイナリ互換性のために、Shape API をデータクラスからクラスに変更。（I53812）
  • onDismissRequest パラメータを持つツールチップ API を追加しました。これにより、ユーザーがツールチップの外側をクリックしたときに何が起こるかをクリエイターが決定できるようになりました。この新しいパラメータを含まない古い API のサポートを終了しました。（I99aef）
  • opticalCentering の名前を horizontalCenterOptically に変更しました。修飾子を内部用にしました。padding パラメータを最大開始オフセットと最大終了オフセットに置き換えました。（I0b904）
  • WideNavigationRailState を変更して現在の値または目標値を設定できるようにし、列挙型を削除してブール値に置き換えました。（Idfa29、b/356039090）
  • NavigationBarItemComponentOverride を追加しました。（I3a06a）

バグの修正

  • コンテンツが最後までスクロールされたときに、上部と下部のアプリバーの動作が確実に色を変更するように修正しました。（Idc4e8、b/293665988）
  • 上部と下部のアプリバーのスクロール動作関数は、再コンポーズ全体でパフォーマンスを向上させるために、記憶された動作を返すようになりました。（I0fdbe、b/207957336）
  • 修飾子パラメータが、ドラッグ動作やセマンティクスなどの内部修飾子の前に適用されるのではなく、後に適用されるようになりました。これは、修飾子が適用される順序に影響します。（I8d83f）
  • 開いたボトムシートは、サイズを変更しても開いたままになります。（I2870b、b/324934884）
  • ウィンドウ プロパティのステータスとナビゲーション バーのフラグを正しく転送。（Ie674d、b/362539765）
  • ドキュメントに沿って、修飾子パラメータをスキャフォールドのルートに移動します。これにより、実装が M2 と整合するようになります。（I0235e、b/372311595）

外部からの協力

  • DatePickerDialog 関数を共通化しました。（I7dced）

バージョン 1.4.0-alpha04

2024 年 11 月 13 日

androidx.compose.material3:material3-*:1.4.0-alpha04 がリリースされました。バージョン 1.4.0-alpha04 に含まれる commit はこちらをご覧ください。

動作の変更

  • aosp/3212478 で導入された色の変更を iconButtonColors、iconToggleButtonColors、outlinedIconButtonColors、outlinedIconToggleButtonColors、outlinedIconToggleButtonBorder に元に戻しました。元に戻された動作を iconButtonVibrantColors などの新しい関数セットに移動し、返される高コントラスト カラーを強調しました。（Iffd8d）

新機能

  • VerticalDragHandle コンポーネントを導入（I6c770）

API の変更

  • DismissibleModalWideNavigationRailDefaults を ModalWideNavigationRailDefaults に変更しました。（I8e877）
  • NavigationBarComponentOverrides を追加しました。（I8a3f3）
  • NavigationRailComponentOverride を追加しました。（I83e13）
  • WideNavigationRailState を導入してレールの開閉を処理し、ModalWideNavigationRail を閉じられるようにして DismissibleModalWideNavigationRail を削除しました。（I88568）
  • 切り替えボタンのデフォルトに、xSmall、medium、large、xLarge のサイズのデフォルトを追加しました。（Ie95d1）
  • ボタンのデフォルトに xSmall、medium、large、xLarge のサイズのデフォルトを追加しました。（If8b6d）

バグの修正

  • フィルタ チップの末尾のアイコンの色が、仕様に基づいてプライマリから OnSurfaceContainer に更新されました。また、仕様に基づいて、すべてのチップの枠線の色が枠線から枠線バリアントに更新されました。（I68bd4）

バージョン 1.4.0-alpha03

2024 年 10 月 30 日

androidx.compose.material3:material3-*:1.4.0-alpha03 がリリースされました。バージョン 1.4.0-alpha03 には、これらの commit が含まれています。

API の変更

  • 密度を指定する SheetState コンストラクタは非推奨となり、位置と速度のしきい値に置き換えられました。（Ifd16e）
  • 更新された配置ロジックを含む rememberTooltipPositionProvider を追加しました。rememberPlainTooltipPositionProvider と rememberRichTooltipPositionProvider を非推奨にしました。（Ie66e2）
  • 追加の ModalBottomSheetProperties を使用すると、ステータスバーとナビゲーション バーの色をカスタマイズできます。デフォルトでは、これらの要素はシステムのダークモードのステータスではなく、コンテンツの色に基づいて更新されます。（Ib874e、b/362539765）
  • 日付選択ツールの入力操作が改善されました。入力モードでは、日付のテキスト フィールドにフォーカスが当てられ、すぐにテキストを入力できるようになります。この変更により、DatePicker と DateRangePicker に requestFocus パラメータが追加されます。false を渡すことで、フォーカスを回避できます。（I12d09、b/286399710、b/340102743）
  • 図形をキャッシュすると、デフォルトで Shape オブジェクトにキャッシュされます。切り替えボタンの形状のデフォルトを @Composable に変更。バリアントが同じトークン ファイルを参照しているため、図形が 1 つの図形にデフォルトで統合されます。（Iaa014）

バグの修正

  • contentPadding が変更されたときに常に body コンテンツを再コンポーズしないように、Scaffold の contentPadding の動作を最適化しました。（I8c8e2、b/373904168）
  • TextFieldLabelScope progress の名前を labelMinimizedProgress に変更しました
  • TextFieldLabelPosition Default の名前を Attached に変更しました。インターフェース メンバーが削除されました。（If75c6）
  • 入力モードの DatePicker で、検証エラーによりコンポーネントの高さが変更される問題を修正しました。（I2e229、b/280462363）
  • コントロール キーが押されたときに、マテリアル スライダーの値を変更します。（I1c442）

バージョン 1.4.0-alpha02

2024 年 10 月 16 日

androidx.compose.material3:material3-*:1.4.0-alpha02 がリリースされました。バージョン 1.4.0-alpha02 に含まれる commit はこちらをご覧ください。

API の変更

  • 日付選択ツールを更新し、DatePickerState または DateRangePickerState で言語 / 地域を直接設定するときに、DatePicker と DateRangePicker 全体で言語 / 地域が常に使用されるようにしました。ロケールを州に直接設定する場合、タイトルとヘッドラインのテキストはデフォルトのプラットフォームのロケールに従って適用されるため、それに合わせてローカライズする必要があります。（I37073、b/326490763、b/321657276）
  • SheetState.isAnimationRunning が公開されました。（I9a3d7）
  • DatePickerColors が、テーマのタイポグラフィ テキスト スタイルで定義された競合する色よりも正しく優先されるようになりました。また、この更新により、日付選択ツール関数での color パラメータの位置が調整され、ヘッダーとタイトルのテキスト色をカスタマイズするための contentColor パラメータが導入されました。（I30d03、b/347031394）
  • SplitButton の名前を SplitButtonLayout に変更し、SplitButton カラーバリエーション API を削除します。バリエーションは、SplitButtonDefaults によって提供されるボタンのバリエーションを再利用することで実現されます。（I44c36）
  • ModalBottomSheet に sheetGestureEnabled パラメータが追加されました。（I856cb、b/288211587）
  • standardMotionScheme と expressiveMotionScheme の名前を標準と表現力に変更しました。MotionScheme.standard() と MotionScheme.expressive() を呼び出すことで、MotionScheme コンパニオン オブジェクトから両方の関数にアクセスできるようになりました。（Iceccf）
  • シンプルなツールチップとリッチなツールチップに maxWidth パラメータを追加しました。デフォルトでは、シンプルなツールチップの場合は 200 dp、リッチなツールチップの場合は 320 dp のデザイン仕様になっています。（I30ce9）

バグの修正

  • DatePicker と DateRangePicker は、状態の displayedMonthMillis を介して設定された場合に、表示される月が正しく更新されるようになりました。（If9e47、b/333414302）
  • ModalBottomSheet コンテンツがステータスバーから移動されるようになりました。（I5114c、b/321877275、b/336962418、b/342093067）
  • [ボトムシート] バックコールの優先度を PRIORITY_DEFAULT に変更し、IME キーボードを先に閉じられるようにしました。（I447fb）
  • 選択可能な最小年が将来年に設定されている場合に、DatePicker と DateRangePicker で発生するクラッシュを修正。（I78656、b/319395747）
  • 更新された SelectableDates インスタンスが適用されたときに UI を更新するように、日付選択ツールの問題を修正しました。（Iad59a、b/290135807、b/339898760）

バージョン 1.4.0-alpha01

2024 年 10 月 2 日

androidx.compose.material3:material3-*:1.4.0-alpha01 がリリースされました。バージョン 1.4.0-alpha01 には、これらの commit が含まれています。

動作の変更

  • ライブラリは material-icons-core に依存関係を追加しなくなったため、プロジェクトが material-icons-core に依存している場合は、build.gradle[.kts] ファイルにその依存関係を明示的に追加する必要があります。（I735ff、b/349894318）
  • NavigationBarItem と NavigationRailItem のアクティブ ラベルの色を onSurface から secondary に変更し、ユーザビリティ、色のコントラスト、システム内の整合性を改善しました（Ibc297）。以前の動作に戻すには、デフォルトの色をコピーして selectedTextColor を MaterialTheme.colorScheme.onSurface に変更します。
  • マテリアル 3 コンポーネントは、新しい MotionScheme を使用してモーションを定義するようになりました。（Ie0f93）
  • 不確定形式の円形進行状況インジケーターの動きを変更しました（I3c07e）
  • OutlinedIconButtonColors と OutlinedIconToggleButtonColors を更新して、色のコントラストを改善しました。（I2743d）
  • FilledIconToggleButtonColors と FilledTonalIconToggleButtonColors のコンテナとコンテンツの色を更新しました。（Ic5d0f）
  • OutlinedButton の枠線の色を outline から outlineVariant に更新しました。（057f00）

API の変更

  • reverseLayout で設定されたコンテンツをより適切にサポートするため、TopAppBar の enterAlwaysScrollBehavior 関数に省略可能な reverseLayout パラメータを追加しました。（I4e0e5）
  • SegmentedButton が contentPadding 引数をサポートするようになりました。（I5ad91、b/358414376）
  • PullToRefreshState に isAnimating のデフォルト実装がなくなった（I6a593）
  • TextFieldState を使用するマテリアル TextField と OutlinedTextField のオーバーロードを追加しました。TextFieldDecorator と互換性のある装飾ボックス API を追加しました。（If13a1）
  • テキスト フィールドの labelPosition を制御するパラメータを追加しました。alwaysMinimize を使用すると、フィールドのフォーカスが外れている場合でも、テキスト フィールドにラベルとプレースホルダを同時に表示する UI パターンを実現できます。（I1ef2c）
  • パスワード入力フィールドにマテリアル SecureTextField と OutlinedSecureTextField を追加しました。（I7e22d）
  • アニメーションの進行状況をクエリするテキスト フィールドのラベルにスコープを追加しました。（If5ec8）
  • ツールチップに MotionEvent.CLASSIFICATION_DEEP_PRESS のサポートを追加しました。（I62e6a）
  • TimePickerState の isAfternoon がインターフェースの var ではなく拡張 val になり、isPm に名前が変更されました。（I89a97）
  • 強調表示されたタイプスケールをサポートするようにタイポグラフィ クラスを更新しました。（Ifa13c）
  • ModalWideNavigationRail API を追加し、ModalExpandedNavigationRail API の名前を DismissibleModalWideNavigationRail に変更しました。（Ic9118）
  • screenOffset を自動的に計算し、@Composable を必要としないよう FloatingAppBarScrollBehavior を更新しました。（Idf349）
  • LoadingIndicator API を更新して、デフォルト オブジェクトの命名を修正しました。PullToRefresh に LoadingIndicatorElevation 定数を追加しました。（I1d72b）
  • LoadingIndicator API を更新して、デフォルト オブジェクトの命名を修正しました。PullToRefresh に LoadingIndicatorElevation 定数を追加しました。（I1d72b）
  • LinearWavyProgressIndicator と CircularWavyProgressIndicator の不確定なバリエーションに amplitude パラメータと waveSpeed パラメータを追加しました。（I2a0c5）
  • アイコン切り替えボタンの形状を、押された状態またはチェックされた状態に基づいて変更できるようになりました。（Ibc781）
  • 強調表示されたタイプスケールをサポートするようにタイポグラフィ クラスを更新しました。（Ifa13c）
  • SplitButton は、デフォルト状態と押下状態に基づいてシェイプをモーフィングします。TrailingButton API で同じカスタマイズが提供されるため、AnimatedTrailingButton API を削除しました。（I95066）
  • コンテンツのスクロール時などに、FAB の表示と非表示をアニメーション化する修飾子を追加しました。（I8338d）
  • サンプルで使用するために、接続されたボタン グループの形状と間隔を ButtonGroupDefaults に追加しました。（I68e30）
  • 分割ボタンに後続のボタンの水平方向のパディングを追加し、開始角と終了角の差から計算された光学的な中央揃えを有効化（I122e2）
  • コンポーネントのモーションのスキームを設定できる新しいマテリアル MotionScheme を導入しました。スキームは MaterialTheme で設定します。（Id50c2）

バグの修正

  • Scaffold の子コンポーザブルに正しいフォーカス トラバース インデックスを適用。順序は topBar、bottomBar、FAB、コンテンツ、スナックバーです。（I5936b）
  • DatePicker と DateRangePicker で、特定の言語 / 地域と形式スケルトンにおいて、一部の日付要素（月名など）が大文字で始まらない問題を修正しました。（I1430f）
  • FAB と FAB メニュー コンポーネントのトークンを統合しました（パディングとテキストの視覚的な更新が軽微です）（Ib57f3）
  • ModalBottomSheet がセマンティック トラバース順の先頭になり、次に scrim が続くようになりました。（I436f9、b/358594665）
  • エッジツーエッジ モードでナビゲーション ピルの下をスクロールしたときに、ボトム アプリバーが完全に消えない問題を修正（I3ee21）

Compose Material3 バージョン 1.3

バージョン 1.3.1

2024 年 10 月 30 日

androidx.compose.material3:material3-*:1.3.1 がリリースされました。バージョン 1.3.1 には、これらの commit が含まれています。

バグの修正

  • DatePicker と DateRangePicker は、状態の displayedMonthMillis を介して設定された場合に、表示される月が正しく更新されるようになりました。（If9e47、b/333414302）
  • 選択可能な最小年が将来年に設定されている場合に、DatePicker と DateRangePicker で発生するクラッシュを修正。（I78656、b/319395747）
  • 更新された SelectableDates インスタンスが適用されたときに UI を更新するように、日付選択ツールの問題を修正しました。（Iad59a、b/290135807、b/339898760）
  • ボトムシートで使用されるバックコールの優先度を PRIORITY_DEFAULT に変更し、IME キーボードを先に閉じられるようにしました。（I447fb）

バージョン 1.3.0

2024 年 9 月 4 日

androidx.compose.material3:material3-*:1.3.0 がリリースされました。バージョン 1.3.0 に含まれる commit は次のとおりです。

1.2.0 以降の重要な変更

1.3.0 の主な機能

新しいマテリアル デザイン 3 コンポーネント

  • カルーセル
  • [ModalBottomSheet] U+ での予測型「戻る」をサポートするようになりました（Iccf32、b/281967264、b/304850357）
  • [SearchBar] U+ で予測型「戻る」をサポートするようになりました（I657f8）
  • ナビゲーション ドロワー（ModalDrawerSheet と DismissibleDrawerSheet）で、U+ の予測型「戻る」をオプトインとしてサポートするようになりました。（Ie5b0b）
  • DropdownMenu で、カスタムカラー、シェイプ、高度、境界線がサポートされるようになりました。（I8e981、b/289554448、b/301887035、b/283654243）
  • スライダーを更新し、ギャップと停止インジケーターを追加してアクセシビリティを改善しました。（I3058e）
  • ProgressIndicator を更新し、ギャップと停留所のインジケーターを追加してユーザー補助を改善しました。（I21451）
  • リッチ ツールチップにデフォルトのカーソルを追加し、アンカー LayoutCoordinates を指定してカスタム カーソルを描画できるようにしました。（Ifd42c） 互換性を破る変更
  • 新しいプルトゥ リフレッシュ API:
    • PullToRefreshState を簡素化し、Dp 単位ではなく小数値を使用するようにしました。
    • isRefreshing の状態は、PullToRefreshState ではなくユーザーによって制御されます。
    • ネストされたスクロール接続を PullToRefreshState から分離しました。これは、新しい PullToRefreshBox または Modifier.pullToRefresh によって処理されます。
    • 今回の更新は、以前の試験運用版 API に対する互換性を破る変更です。（I0adeb、b/314496282、b/317177684、b/323787138、b/324573502、b/317177683） ビジュアルに関する破壊的変更
  • フォーカス状態のオーバーレイを 0.1f に更新し、十分な色のコントラストを確保しました。（I7ea77）
  • lightColorScheme と darkColorScheme のサーフェスと背景のデフォルトの色を少し調整しました。（I9db52）
  • 新しいテキスト以外のコントラスト仕様に準拠するように、スライダーと ProgressIndicator の色を更新しました。（I26807）
  • コンポーネントで SurfaceContainer バリアントが使用されるようになりました。Surface と TonalElevation で色を正式に計算するコンポーネントは、デフォルトで SurfaceContainer ロールを使用します。これは色調の明るさの影響を受けません。（b/304584161）
  • サーフェスとサーフェス コンテナのベースライン ロールがわずかに調整され、ライトモードとダークモードで色合いが強化されました。（I677a5）
  • 試験運用版の API を安定版に昇格しました
  • パフォーマンスの改善

バージョン 1.3.0-rc01

2024 年 8 月 21 日

androidx.compose.material3:material3-*:1.3.0-rc01 がリリースされました。バージョン 1.3.0-rc01 に含まれる commit はこちらをご覧ください。

バグの修正

  • ModalBottomSheet がセマンティック トラバース順の先頭になり、次に scrim が続くようになりました。（I436f9、b/358594665）

バージョン 1.3.0-beta05

2024 年 7 月 24 日

androidx.compose.material3:material3-*:1.3.0-beta05 がリリースされました。バージョン 1.3.0-beta05 に含まれる commit はこちらをご覧ください。

  • Android N と O で BottomSheet のコンテンツが欠落または切り捨てられる問題を修正しました（a10a2d）
  • TalkBack がサムネイルの周囲にフォーカス インジケーターを適切に表示できるように、スライダーのセマンティクス境界を拡大しました。（0b5a1d）

バージョン 1.3.0-beta04

2024 年 6 月 26 日

androidx.compose.material3:material3-*:1.3.0-beta04 がリリースされました。バージョン 1.3.0-beta04 に含まれる commit はこちらをご覧ください。

バージョン 1.3.0-beta03

2024 年 6 月 12 日

androidx.compose.material3:material3-*:1.3.0-beta03 がリリースされました。バージョン 1.3.0-beta03 に含まれる commit はこちらをご覧ください。

外部からの協力

  • androidx.compose.material3.DropdownMenu を共通ソースセットから利用できるようにしました。（If62c0）

バージョン 1.3.0-beta02

2024 年 5 月 29 日

androidx.compose.material3:material3-*:1.3.0-beta02 がリリースされました。バージョン 1.3.0-beta02 に含まれる commit はこちらをご覧ください。

API の変更

  • Modifier.pullToRefreshIndicator がエレベーションをサポートするようにし、Pull To Refresh API を更新して、有効化をラムダではなくブール値にするようにしました。PullToRefreshBox でコンテンツの配置をサポートしました。（I75679）
  • TooltipScope をシーリングされたインターフェースにし、TooltipBox と Label で使用する内部実装を作成しました。（I3833e）
  • カルーセル アイテムにシェイプと枠線を簡単に追加できるように、CarouselItemScope に 2 つの新しい修飾子（maskClip と maskBorder）を追加しました。（Id67a1）
  • TimePickerState がインターフェースになり、時刻を設定できるようになりました。（I88546）
  • リンクのスタイル設定用の API を更新しました。TextLinkStyles を TextStyle に移動し、マテリアルから TextDefaults を削除しました。（I5477b）

バグの修正

  • ModalBottomSheet ステータスとナビゲーション バーのアイコンがダークモードのステータスに応答するようになりました。（Ie1fe7、b/338342149）
  • ModalBottomSheet スクリムにシートの閉じるセマンティクスを追加しました。（0e61cb、b/328801864）

外部からの協力

  • androidx.compose.material3.AlertDialog を共通ソースセットから利用できるようにしました。（Ia33f5）
  • ModalBottomSheet を共通ソースセットから利用できるようにします（Id7cc7）

バージョン 1.3.0-beta01

2024 年 5 月 14 日

androidx.compose.material3:material3-*:1.3.0-beta01 がリリースされました。バージョン 1.3.0-beta01 には、これらの commit が含まれています。

API の変更

  • CaretProperties ではなく DpSize を使用します。CaretProperties を削除しました。CaretScope の名前を TooltipScope に変更しました。（Id9a76）
  • テキスト内のマテリアル テーマのリンクを取得する API を更新しました。具体的には、テーマ設定された LinkAnnotations の作成と、テーマ設定されたリンクを含む HTML の解析を行うメソッドを TextDefaults から削除しました。代わりに、Text コンポーザブルにパラメータとしてリンクのスタイルを設定できる TextLinkStyles クラスを追加しました。（I31b93）

バージョン 1.3.0-alpha06

2024 年 5 月 1 日

androidx.compose.material3:material3-*:1.3.0-alpha06 がリリースされました。バージョン 1.3.0-alpha06 に含まれる commit はこちらをご覧ください。

互換性を破る変更

  • 新しいプルトゥ リフレッシュ API:

    • PullToRefreshState を簡素化し、Dp 単位ではなく小数値を使用するようにしました。
    • isRefreshing の状態は、PullToRefreshState ではなくユーザーによって制御されます。
    • ネストされたスクロール接続を PullToRefreshState から分離しました。これは、新しい PullToRefreshBox または Modifier.pullToRefresh によって処理されます。
    • 今回の更新は、以前の試験運用版 API に対する互換性を破る変更です。（I0adeb、b/314496282、b/317177684、b/323787138、b/324573502、b/317177683）

API の変更

  • RippleConfiguration#isEnabled が削除され、LocalRippleConfiguration が null 可能になりました。リップルを無効にするには、isEnabled = false で RippleConfiguration を指定する代わりに、LocalRippleConfiguration に null を指定します。（I22725）
  • ModalBottomSheet エッジツーエッジが有効になっている場合に、ステータスバーの上にスクリームをより正確に描画します。モーダル ボトムシートのコンテンツでウィンドウの切り欠きを使用できるようになりました。これにより、ナビゲーション バーの上にコンテンツを表示できるようになります。ModalBottomSheet パラメータ windowInsets の名前を contentWindowInsets に変更し、インセットを適用する場所を指定できるようにしました。インセットはウィンドウ ロジックに関連付けられなくなりました。contentWindowInsets 型が、新しいウィンドウ内で解決できるように、WindowInsets を返す関数に変更されました。（I39630、b/274872542、b/300280229、b/290893168）
  • PrimaryScrollableTabRow と SecondaryScrollableTabRow でサブコンポジションではなくカスタム レイアウトが使用されるようになりました。これにより、パフォーマンスが向上します。（I991e0）
  • テキストリンクに、通常のスタイル、ホバー、フォーカスに加えて、押下状態のスタイル設定オプションが追加されました。TextDefaults メソッドには、これをサポートする pressedStyle 引数がそれぞれ追加されました。（Ic473f、b/139312671）

バグの修正

  • ナビゲーション ドロワーのドラッグ アンカーが drawerContent の幅と一致するようになりました。（Ibc72f、b/245355396）
  • ラベルの OutlinedTextField 上部パディングにシステム フォントサイズが考慮されるようになりました。（Idc781）
  • CalendarLocale のパッケージ ロケーションを修正しました。（Ifa235）
  • [予測型「戻る」] 予測型「戻る」アニメーションを更新し、(0.1, 0.1, 0, 1) の補間カーブを使用するようにしました。（I2591a）

バージョン 1.3.0-alpha05

2024 年 4 月 17 日

androidx.compose.material3:material3-*:1.3.0-alpha05 がリリースされました。バージョン 1.3.0-alpha05 に含まれる commit はこちらをご覧ください。

新機能

  • SearchBar と DockedSearchBar に、テキスト フィールド パラメータを受け取る新しいオーバーロードを追加しました。これにより、検索バーの他の部分とは別にテキスト フィールドのスタイル設定を行ったり、カスタム テキスト フィールドを渡したりできます。現在の実装のテキスト フィールドは SearchBarDefaults.InputField として利用可能になりました。（I50c73、b/275074248、b/278773336、b/326627700）
  • 必要に応じて目盛りをカスタマイズできるように、ラムダ drawTick を公開 API に追加しました。（I0c048）

API の変更

  • テキストリンクに、通常のスタイル設定、ホバー、フォーカスに加えて、押下状態のスタイル設定オプションが追加されました。（I5f864、b/139312671）
  • アイテムがクリップされているマスク レクタを公開するように CarouselItemInfo を更新しました。（I785d8）
  • マテリアル 3 公開 API から BasicTooltipState を削除しました。Foundation の BasicTooltip が安定するまで、その機能は TooltipState と統合されます。（Icda29）
  • LinkAnnotation を構築し、リンクに MaterialTheme を適用する HTML タグ付き文字列を解析するメソッドを含む TextDefaults オブジェクトを追加しました。（I98532、b/139312671）
  • ExposedDropdownMenuBoxScope でサブクラスが許可されなくなりました。公開されたプルダウン メニューに MenuAnchorType が追加され、a11y をより適切にサポートするために menuAnchor に渡す必要があります。これは、focusable を ExposedDropdownMenu に渡す代わりに使用する必要があります。ExposedDropdownMenu は非推奨です。menuAnchor に、enabled の状態を制御する新しいパラメータが追加されました。（I55ee6、b/257209915、b/308840226）
  • 無効な場合の OutlinedButton の枠線の色を修正しました。有効な状態を受け入れる ButtonDefaults.outlinedButtonBorder("enabled") オーバーロードを追加しました。（Ie650b、b/318461363）
  • クライアントが商品サイズに関する情報を取得できるように、新しい CarouselItemInfo クラスを追加しました。（I9070c）
  • サーフェス コンテナのない ColorScheme コンストラクタのサポートが終了しました。サーフェス コンテナを含むコンストラクタに移行してください。（I35c11）
  • [概要]TextFieldDefaults ContainerBox の名前を Container に変更しました。（Ie8d3b）

バグの修正

  • sheetSwipeEnabled が false の場合、BottomSheetScaffold がネストされたスクロールからスクロールしなくなりました。（I5e1c1、b/306464779）
  • IconButtonSamples.kt の一部のオプトイン ExperimentalMaterial3Api アノテーションを削除しました。（I111d1）

バージョン 1.3.0-alpha04

2024 年 4 月 3 日

androidx.compose.material3:material3-*:1.3.0-alpha04 がリリースされました。バージョン 1.3.0-alpha04 に含まれる commit はこちらをご覧ください。

新機能

  • マテリアル 3 カルーセルの試験運用版を 2 つ追加しました（HorizontalMultiBrowseCarousel、HorizontalUncontainedCarousel）。（I88d64）
  • Compose M3 ナビゲーション ドロワー（ModalDrawerSheet と DismissibleDrawerSheet）を更新し、U+ での予測型「戻る」をオプトインとしてサポートしました。（Ie5b0b）
  • 再コンポーズを回避するために、色合いをラムダとして渡せるようにする新しい API を Icon に追加しました。（I5b5a2）
  • トップ アプリバー API で、固定セクションと折りたたみセクションの両方でカスタム高さがサポートされるようになりました。（Ib8b0c、b/323403446）

API の変更

  • トップ アプリバー API で、固定セクションと折りたたみセクションの両方のカスタム高さがサポートされるようになりました。コンテンツをスクロールする際に、1 行の上部アプリバーが過度に再コンポーズされる問題を修正しました。フォント/ディスプレイの設定が大きいデバイスで、MediumTopAppBar がタイトルを切り捨てる問題を解決しました。（Ib8b0c、b/323403446、b/300953236、b/286296147、b/330410290、b/308540676）
  • SegmentedButton と関連 API が安定版になりました（I8a158）
  • SwipeToDismissBox、SwipeToDismissBoxDefaults、SwipeToDismissBoxState、SwipeToDismissBoxValue が安定版になりました。（I5f000）
  • 非推奨の DismissDirection と DismissValue の列挙型と API を削除しました。（I89ccd）
  • カルーセルの CarouselState コンパニオン オブジェクトに試験運用版のタグを追加しました。（I94154）
  • LocalMinimumInteractiveComponentEnforcement を非推奨にし、代わりに LocalMinimumInteractiveComponentSize を導入しました。（I7a7ac）
  • SearchBarColors コンストラクタが公開されました。（I769ca）
  • gesturesEnabled パラメータを SwipeToDismissBox に追加しました。（Idc59f、b/324170119）
  • 非推奨および試験運用版としてマークされたテキスト フィールド API を削除しました。（I1305f）

バージョン 1.3.0-alpha03

2024 年 3 月 20 日

androidx.compose.material3:material3-*:1.3.0-alpha03 がリリースされました。バージョン 1.3.0-alpha03 には、これらの commit が含まれています。

視覚的な互換性を破る変更

  • フォーカス状態のオーバーレイを 0.1f に更新し、十分な色のコントラストを確保しました。（I7ea77）
  • lightColorScheme と darkColorScheme のサーフェスと背景のデフォルトの色を少し調整しました。（I9db52）

新機能

  • ExposedDropdownMenu をカスタマイズするパラメータを追加しました。特に、メニューに focusable パラメータ（デフォルト true）が追加され、編集可能なテキスト フィールドを操作する際には false に設定する必要があります。（I4184c、b/323694447、b/278609042）

API の変更

  • ScaffoldSubcomposeInMeasureFix フラグが削除されました。（Ie2a4b）
  • NavigationRailItemColors が @Immutable としてマークされるようになりました。（If6112、b/327660613）
  • NavigationBarItemColors が @Immutable としてマークされるようになりました。（I42a30、b/298064514）
  • スライダー トラック コンポーザブルのパラメータを並べ替えました。（I9f315）
  • ExposedDropdownMenu は Popup を使用して実装されるようになりました。編集可能なテキスト フィールドを含むフォーカス可能なメニューが、キーボードで入力したときに閉じられる可能性がありますが、動作は同じです。

バグの修正

  • サーフェスとサーフェス コンテナのベースライン ロールがわずかに調整され、ライトモードとダークモードで色合いが強化されました。（I677a5）
  • 新しいテキスト以外のコントラスト仕様に準拠するように、スライダーと ProgressIndicator の色を更新しました。（I26807）
  • フォーカス状態のオーバーレイを 0.1f に更新し、十分な色のコントラストを確保しました。（I7ea77）
  • lightColorScheme と darkColorScheme のサーフェスと背景のデフォルトの色を少し調整しました。（I9db52）

バージョン 1.3.0-alpha02

2024 年 3 月 6 日

androidx.compose.material3:material3-*:1.3.0-alpha02 がリリースされました。バージョン 1.3.0-alpha02 に含まれる commit はこちらをご覧ください。

API の変更

  • スライダーの状態を安定させました。State.onValueChangeFinished を再度 val にします。onValueChangeFinished を rememberUpdatedState でラップします。（I82ab2、b/322269951）
  • Navigation コンポーネントは、新しい SurfaceContainer ロールを使用するようになりました。DrawerDefaults に、明確に区別できる standardContainerColor 属性と modalContainerColor 属性が用意されました。DrawerDefaults.ModalDrawerElevation を 0.dp に変更（I7fbac）
  • state.onValueChangeFinished を var に変更するため、Slider の状態から @Stable を削除しました。（Ied34a、b/322269951）
  • ModalBottomSheet と StandardBottomSheet のアニメーション仕様が TweenSpec になり、スプリング アニメーションから更新されました。これにより、オーバーシュートが目立つ問題が解決します。非推奨の密度なしの SheetState コンストラクタが削除されました。（I7babc、b/285847707）

バグの修正

  • コンポーネントで SurfaceContainer バリアントが使用されるようになりました。以前は Surface と TonalElevation で色を計算していたコンポーネントは、デフォルトで SurfaceContainer ロールを使用するようになりました。このロールは色調の高度の影響を受けません。（b/304584161）
  • ElevatedFilterChip の選択されていない無効なコンテナの色が黒くなるバグを修正しました。（I400e6、b/322407043）
  • 進行状況が 0 の場合の不確定形式の進行状況インジケーターを修正（Id6582）
  • RTL レイアウトでの Slider と RangeSlider に関する問題を修正しました。（Iab0e1）
  • 浮動小数点数の丸めが不正確になる可能性があるため、スライダー範囲の計算に SliderRangeTolerance を追加しました。（Ic918a、b/324934900）
  • DateRangePicker をネストする場合や、大きなフォントを使用して小さい画面に任意のタイプの日付選択ツールを表示する場合に、DatePickerDialog のボタンが表示されるようにしました。（Ie4758、b/325107799、b/277768544）
  • Menu で、コンテナの色に SurfaceContainer ロールが使用されるようになりました。MenuDefaults.TonalElevation を 0.dp に変更（I135b7）
  • TextField で、コンテナの色に SurfaceContainerHighest ロールが使用されるようになりました。（I4dced）
  • エレベートされたチップで SurfaceContainerLow ロールが利用されるようになりました。（I7cd2f）
  • DatePicker コンテナの色が SurfaceContainerHigh になりました。DatePickerDefaults.TonalElevation を 0.dp に変更（Ida753）
  • ボトムシートのコンテナの色とドラッグハンドルの色を更新しました。（I72a0a）
  • RichTooltip コンテナの色が SurfaceContainer になりました。（Ia8b45）
  • SearchBar コンテナの色が SurfaceContainerHighest になりました。SearchBarDefaults.TonalElevation を 0.dp に変更（I88604）
  • 無効なトラックや選択されていないトラック/アイコンのスイッチを更新し、SurfaceContainerHighest 色ロールを活用できるようにしました。（I7687a）
  • AlertDialog コンテナの色が SurfaceContainerHigh になりました。（Ie0433）
  • BottomAppBar コンテナの色が SurfaceContainer になりました。TopAppBar onScroll の色を SurfaceContainer に変更しました。（I41630）
  • ElevatedCard コンテナの色が SurfaceContainerLow になりました。FilledCard のコンテナの色は SurfaceContainerHighest です。（I35141）
  • ElevatedButton コンテナの色が SurfaceContainerLow になりました。選択されていない FilledIconButton のコンテナの色が SurfaceContainerHighest になりました。（I792c9）
  • TimePicker コンテナの色と時計の文字盤の色のロールを SurfaceContainerHighest に更新しました。（I43b93）

バージョン 1.3.0-alpha01

2024 年 2 月 21 日

androidx.compose.material3:material3-*:1.3.0-alpha01 がリリースされました。バージョン 1.3.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • Compose M3 ModalBottomSheet を更新し、U+ での予測型「戻る」をサポートしました。（Iccf32、b/281967264、b/304850357）
  • U+ での予測型「戻る」をサポートするように Compose M3 SearchBar を更新しました。（I657f8）
  • スライダーを更新し、ギャップと停止インジケーターを追加してアクセシビリティを改善しました。（I3058e）
  • ProgressIndicator を更新し、ギャップと停留所のインジケーターを追加してユーザー補助を改善しました。（I21451）
  • リッチ ツールチップにデフォルトのカーソルを追加しました。新しいリッチ ツールチップ API では、アンカー LayoutCoordinates を指定してカスタム カーソルを描画できるようになりました。（Ifd42c）

動作の変更

  • Material コンポーネントは、新しいリップル API を使用するように移行され、RippleTheme をクエリしなくなりました。

API の変更

  • 楽しい drawStopIndicator が一般公開されました。（I3f59f）
  • DatePicker の formatWithSkeleton 関数を内部としてマークしました。（Ic65dc）
  • DropdownMenu で、カスタムカラー、シェイプ、高度、境界線がサポートされるようになりました。（I8e981、b/289554448、b/301887035、b/283654243）
  • API で MutableInteractionSource を公開する Material3 コンポーネントが更新され、デフォルトで null になる null 許容型の MutableInteractionSource を公開するようになりました。意味的な変更はありません。null を渡すことは、MutableInteractionSource をホイスティングしないことを意味し、必要に応じてコンポーネント内に作成されます。null に変更すると、一部のコンポーネントでは MutableInteractionSource が割り当てられなくなり、他のコンポーネントでは必要な場合にのみインスタンスを遅延作成できるため、これらのコンポーネント全体のパフォーマンスが向上します。これらのコンポーネントに渡す MutableInteractionSource を使用していない場合は、代わりに null を渡すことをおすすめします。独自のコンポーネントでも同様の変更を行うことをおすすめします。（I41abb、b/298048146）
  • RippleConfiguration と LocalRippleConfiguration を追加し、固定値を使用してコンポーネントごとまたはサブツリーごとにリップルをカスタマイズできるようにしました。たとえば、制御していないコンポーネントの色を変更したり、コンポーネントのリップルを無効にしたりできます。ほとんどの場合、デフォルト値を使用する必要があります。これらの API は、個々のコンポーネントや限定されたサブツリーのカスタマイズのためのエスケープ ハッチです。より広範な変更やカスタム デザイン システムの場合は、代わりに createRippleModifierNode を使用して独自のリップルを作成する必要があります。（I7b5d6、b/298048146）
  • 非推奨の rememberRipple に代わる新しいリップル API を material3 に追加しました。また、一時的な CompositionLocal と LocalUseFallbackRippleImplementation を追加して、material3 コンポーネントを非推奨の rememberRipple / RippleTheme API を使用するように元に戻します。これは次の安定版リリースで削除される予定です。これは、カスタム RippleTheme を提供するケースの一時的な移行支援のみを目的としています。（I34cbc、b/298048146）

バグの修正

  • パフォーマンスを改善するため、ModalBottomSheet 内のサブコンポジションを削除しました。特定のシナリオで LookaheadScope と組み合わせて ModalBottomSheet がクラッシュする問題を修正しました。（I2a198）
  • パフォーマンスを改善するため、BottomSheetScaffold 内のサブコンポジションを削除しました。特定のシナリオで LookaheadScope と組み合わせて BottomSheetScaffold がクラッシュする問題を修正しました。（Ie6401）
  • バッジの配置は、右上隅に対してアンカー コンテンツの中央に近づけるように調整されています。（I18a28）
  • スクリーン リーダー、スイッチ アクセス、音声アクセスのユーザーに対して、月と年のテキスト タイトルが操作可能なものとして伝えられる DateRangePicker のユーザー補助に関する問題を修正しました。（I2ac55）
  • mediumTopAppBarColors パラメータの順序のバグを修正しました。（Ibe64a）

バージョン 1.2

バージョン 1.2.1

2024 年 3 月 6 日

androidx.compose.material3:material3-*:1.2.1 がリリースされました。バージョン 1.2.1 には、これらの commit が含まれています。

バグの修正

  • スライダーの状態を安定させます。State.onValueChangeFinished を再度 val にします。onValueChangeFinished を rememberUpdatedState でラップします。（Ie8fd0、b/322269951）
  • state.onValueChangeFinished を var に変更するため、Slider の状態から @Stable を削除しました。（I82ba1、b/322269951）
  • デフォルトからコピーされる NavigationBar カスタム色を修正。（80a779、b/326894020）
  • ExposedDropdownMenu の回帰を修正し、再びフォーカスできるようにしました。（3fcec1、b/323694447）
  • ボタンの色のキャッシュに関する問題を修正しました。（3e5bbcb/327371655）

バージョン 1.2.0

2024 年 2 月 7 日

androidx.compose.material3:material3-*:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください。

既知の問題

  • パフォーマンス改善の変更の一環として、PrimaryTabRow で View-Compose 相互運用レンダリングのバグが導入されました。回避策として、TabRowDefaults.PrimaryIndicator で TabRow を使用します。

1.1.0 以降の重要な変更

新しいマテリアル デザイン 3 コンポーネント

既存のマテリアル デザイン 3 コンポーネントの機能強化。

試験運用版の API を安定版に昇格しました。

パフォーマンスの改善

バージョン 1.2.0-rc01

2024 年 1 月 24 日

androidx.compose.material3:material3-*:1.2.0-rc01 がリリースされました。バージョン 1.2.0-rc01 に含まれる commit については、こちらをご覧ください。

バグの修正

  • mediumTopAppBarColors パラメータの順序のバグを修正しました。（Ibe64a）
  • CardDefaults.cardColors の 1.2.0-beta02 で導入されたバグを修正しました。このバグにより、containerColor パラメータの値に基づいて contentColor が更新されませんでした。（Iee041、b/319671246）
  • 1.2.0-beta02 で導入された disabledContentColor のバグを修正し、小さな最適化を追加しました。（I6dda1、b/318428829）

バージョン 1.2.0-beta02

2024 年 1 月 10 日

androidx.compose.material3:material3-*:1.2.0-beta02 がリリースされました。バージョン 1.2.0-beta02 に含まれる commit については、こちらをご覧ください。

既知のバグ

  • IconButtonColors のバグにより、デフォルトでは、ユーザー指定の contentColor ではなく、LocalContentColor のアルファ（0.38f）に disabledContentColor が割り当てられます。回避策として、disabledContentColor を明示的に設定します。この問題は次のリリースで修正される予定です。

API の変更

  • Plain Tooltip API のツールチップ カーソルを有効にする機能を追加しました。（Ibf767）
  • SwipeToDismissState、rememberSwipeToDismiss、SwipeToDismissValue の名前がすべて _SwipeToDismissBox_ に変更されました。（I68d6d）

バグの修正

  • 仕様に沿って ListItem の末尾のパッディング値を修正しました。（Ibd68b、b/305342674）
  • 枠線付きカードの枠線の色が OutlineVariant に正しくマッピングされるようになりました。（I75480、b/310979715）
  • ダイナミック カラーが、システム定義のカラーロールから取得されるようになりました。これにより、ユーザー補助対象のコンテンツのコントラストが改善され、動的な色がマテリアルの仕様により近づきました。（I1de96）
  • android:enableOnBackInvokedCallback="true" の場合の Android T/13 以降での ModalBottomSheet の戻る処理を修正しました。（I728dc、b/306196110）

バージョン 1.2.0-beta01

2023 年 12 月 13 日

androidx.compose.material3:material3-*:1.2.0-beta01 がリリースされました。バージョン 1.2.0-beta01 に含まれる commit については、こちらをご覧ください。

API の変更

  • TabIndicatorScope を試験運用としてマークしました。（I45c88）
  • ツールチップ用の非推奨の試験運用版 API を削除しました。（I438cb）
  • サブコンポジションを使用しない新しい TabRow オーバーロードを変更。これにより、カスタム修飾子を指定して TabRow 指標を構築する方法が異なります。（Ife741）
  • DismissDirection API と DismissValue API を非推奨にしました。これらは SwipeToDismissValue に統合され、その値は SwipeToDismissBox の位置と方向の両方を指定します。DismissState.progress が 0.0 と 1.0 の間に FloatRange としてマークされるようになりました。DismissState の非推奨の Saver と Constructor が削除されました。SwipeToDismiss コンポーネント、状態、デフォルト オブジェクトを試験運用として再マークしました。（Ib54f2）

バグの修正

  • PullToRefresh のデフォルトのインジケーターが、塗りつぶされた三角形ではなく、開いた矢印になりました。（I67be3）

バージョン 1.2.0-alpha12

2023 年 11 月 29 日

androidx.compose.material3:material3-*:1.2.0-alpha12 がリリースされました。バージョン 1.2.0-alpha12 に含まれる commit については、こちらをご覧ください。

API の変更

  • RangeSlider が Kotlin 範囲（0f..1f）を使用します。FloatRangeSnapFlingBehavior.kt で Kotlin 範囲も使用されるようになりました。（I025cb）
  • 修飾子の工場出荷時の関数を @Stable としてマークします。（Ib109f）

バージョン 1.2.0-alpha11

2023 年 11 月 15 日

androidx.compose.material3:material3-*:1.2.0-alpha11 がリリースされました。バージョン 1.2.0-alpha11 に含まれる commit については、こちらをご覧ください。

新機能

  • PullToRefreshContainer と PullToRefreshState を実装します。これらを組み合わせることで、マテリアル 3 でプルして更新を実装できます。（I16456、b/261760718）

API の変更

  • SwipeToDismissBox DismissDirection と DismissValue を試験運用版としてマークしました。（I517b0）
  • SwipeToDismiss を SwipeToDismissBox に変更しました。background の名前を backgroundContent に、dismissContent の名前を末尾の content ラムダに変更しました。（I7f4d3）
  • ChipElevation と SelectableChipElevation のコンストラクタを公開にしました。（Ie0c48、b/308432421）
  • ModalBottomSheetProperties を追加しました。securePolicy を ModalBottomSheetProperties に移動します。isFocusable と shouldDismissOnBackPress を ModalBottomSheetProperties に追加しました。これらの新しいブール値は、モーダル ボトムシートが IME イベントを処理する方法の決定に役立ちます。（Iea56f、b/278216859）
  • RangeSlider と Slider の状態を更新し、initialOnValueChange、初期接頭辞、適切な kdoc を削除しました。（I57d30）
  • ChipBorder クラスとそれに関連する関数呼び出しを非推奨とし、代わりに BorderStroke を直接使用することをおすすめします。（I89cc2）
  • Foundation Tooltip API が @ExperimentalFoundationApi になりました。（I30b0b）
  • TabRow と ScrollableTabRow の非推奨が解除されました。新しいプライマリ バリエーションとセカンダリ バリエーションは試験運用版です。（I0def6）
  • フィルタチップと入力チップで BorderStroke が直接使用されるようになりました。（I07a8d）
  • SegmentedButton は BorderStroke を直接使用できるようになりました。（I89b9b）
  • 汎用 AlertDialog 関数の名前を BasicAlertDialog に変更し、以前の関数を非推奨にしました。（Idbe52）
  • SwipeToDismiss API の名前を SwipeDismiss に変更し、新しい SwipeDismiss API を安定版に昇格させました。（I14cbe）
  • ツールチップ API に tonalElevation と shadowElevation を追加しました。また、TooltipBox、PlainTooltip、RichTooltip の API が誤って安定版としてリリースされたため、試験運用版に戻しました。（If0f66、b/293939035）
  • 試験運用版のチップ API を安定版に昇格しました。（Iea2c3）
  • マテリアル 3 のクリック可能なカードから @ExperimentalMaterial3Api アノテーションを削除しました。（I88dbf）

バグの修正

  • ネストされた先読みレイアウトと遅延レイアウトがある特定のシナリオで SwipeToDismiss がクラッシュする問題を修正しました。（Ica8d1、b/297226562）

バージョン 1.2.0-alpha10

2023 年 10 月 18 日

androidx.compose.material3:material3-*:1.2.0-alpha10 がリリースされました。バージョン 1.2.0-alpha10 に含まれる commit については、こちらをご覧ください。

API の変更

  • Badge と BadgedBox を安定版に昇格しました。（I67f16、b/261565132）
  • securePolicy をパラメータとして ModalBottomSheet に追加し、ユーザーが WindowManager.LayoutParams.FLAG_SECURE の動作を定義できるようにしました。（Icdac8、b/296250262）
  • progress をラムダとして受け取る LinearProgressIndicator と CircularProgressIndicator の新しいオーバーロードを追加しました。これらのバージョンは、以前のバージョンよりもパフォーマンスが向上しています。（I824e6、b/295616656）
  • StandardSizeClasses の名前を AllSizeClasses に変更しました。（I8cb07）
  • ウィンドウサイズ クラスの計算関数を組み合わせます。（Iad935）

バグの修正

  • 表示されている月が許容される年数の範囲の端にあるときに、ナビゲーション矢印ボタンをすばやくクリックすると DatePicker がクラッシュする問題を修正しました。（I46f36、b/290954897、b/297002119）
  • [ナビゲーション レール/バー] インジケーターの透明色をサポート。（Ie0a9b、b/267289987）

バージョン 1.2.0-alpha09

2023 年 10 月 4 日

androidx.compose.material3:material3-*:1.2.0-alpha09 がリリースされました。バージョン 1.2.0-alpha09 に含まれるコミットについては、こちらをご覧ください。

API の変更

  • ModalNavigationDrawer と DismissibleNavigationDrawer を移行して、新しい AnchoredDraggable API を使用できるようにしました。DrawerState の animateTo が open メソッドと close メソッドに置き換えられ、オフセットが状態オブジェクトではなく浮動小数点数として公開されるようになりました。オフセットには currentOffset から直接アクセスできます。（I0a72c）
  • DatePickerState と DateRangePickerState を直接作成するためのコンポーズ可能ではない関数が追加されました。必要に応じて、コンポーザブルの rememberDatePickerState 関数と rememberDateRangePickerState 関数の代わりにこれらの関数を使用できます。（I70326、b/291524052）
  • 固定とスクロール可能な TabRows に、プライマリとセカンダリのバリエーションがあります。これらは、Material3 で定義されている色とインジケーターの動作に正しくマッピングされます。
  • PrimaryScrollableTabRow と SecondaryScrollableTabRow でスクロール状態が公開されるようになりました。（Iec8f5、b/260572337）
  • デベロッパーが設定してシートがまたぐ最大幅を指定できる新しい sheetMaxWidth パラメータを追加しました。画面の幅全体にまたがるシートが必要な場合は、パラメータに Dp.Unspecified を渡すことができます。（Ifb7c9、b/266697696）
  • PlainTooltipBox API と RichTooltipBox API を非推奨のメソッドとして再度追加しました。（I246fa）

バグの修正

  • 日付パターン（YY など）に変換しても同じままになる特定の日付スケルトンを備えた DatePickerFormatter で DatePicker が初期化されたときのクラッシュを修正。（I01f29）

バージョン 1.2.0-alpha08

2023 年 9 月 20 日

androidx.compose.material3:material3-*:1.2.0-alpha08 がリリースされました。バージョン 1.2.0-alpha08 に含まれる commit については、こちらをご覧ください。

互換性を破る動作変更

  • ColorScheme が Immutable になりました。これにより、個々の色の更新は効率が低下しますが、色の一般的な使用は効率的になります。この変更の背景には、ほとんどのアプリで個々の色の更新が主なユースケースではないという理由があります。引き続き可能ですが、以前よりも再コンポーズが増えます。これにより、マテリアル コード全体で状態サブスクリプションの量が大幅に減り、より標準的なユースケースの初期化とランタイム コストに影響します。（Ic447d、b/297212873）
  • 仕様に沿って、トーンのエレベーションがさまざまなインタラクション ステータスでアニメーション化されなくなりました。（Icdd12）

API の変更

  • コンテンツのスクロール時に自動的に非表示にするために、パラメータとして BottomAppBarScrollBehavior を受け取る新しい BottomAppBar を追加しました。また、FabPosition.EndOverlay を追加し、FAB をスキャフォールドの下部アプリバーの上にオーバーレイできるようにしました。（Iecb47）
  • BasicTooltipBox 上に構築され、ラベルの境界外をタップしても閉じないシンプルなラベル コンポーネントを追加しました。（I821f9）

バグの修正

  • ツールチップでの rememberSaveable の使用を削除しました。（Icc131、b/299500338）
  • Scaffold が子を測定するタイミング（測定時か配置時か）を制御する一時的なフラグを導入しました。デフォルトでは、測定単位は測定単位です。新しい動作で問題が発生した場合は、問題を報告してください。（I0b354）
  • デバイスの画面幅の正しい測定値を使用して、BottomSheet の横方向の Edge to Edge を修正しました。（I1df0c、b/299058752）
  • シートを下にスワイプして閉じるときに ModalBottomSheet が onDismissedRequest を呼び出さないバグを修正しました。（Idfdd8）

バージョン 1.2.0-alpha07

2023 年 9 月 6 日

androidx.compose.material3:material3-*:1.2.0-alpha07 がリリースされました。バージョン 1.2.0-alpha07 に含まれる commit については、こちらをご覧ください。

新機能

  • compose material 1.6.0-alpha05 でアイコンの自動ミラーリングのサポートが追加されました。アイコンの自動ミラーリングの詳細については、リリースノートをご覧ください。

API の変更

  • SliderState が DraggableState を実装（I9b116）
  • シェイプを必須パラメータに変更。シェイプ ヘルパー関数で position の名前を index に変更しました。（I34941）
  • DatePicker formatWithSkeleton を更新し、パフォーマンス向上のためのキャッシュとして使用されるマップを追加しました。（I3195f）
  • BasicTooltipBox を compose.foundation に追加し、PlainTooltipBox と RichTooltipBox を更新して、新しい PlainTooltip と RichTooltip コンポーザブルで TooltipBox を使用できるようにしました。（I79e1d）

バグの修正

  • dynamicLightColorScheme と dynamicDarkColorScheme が、サーフェスと surfaceContainer ロールの彩度の高い色を返すようになりました。（I5e901）
  • LookaheadScope 内の Scaffold 内でサブコンポジションを使用している一部のコンポーネント（BottomSheetScaffold など）が、サイズの読み取りを早すぎるタイミングで試行していた問題を修正しました。（I297b4、I871f1、b/295536718）

バージョン 1.2.0-alpha06

2023 年 8 月 23 日

androidx.compose.material3:material3-*:1.2.0-alpha06 がリリースされました。バージョン 1.2.0-alpha06 に含まれる commit については、こちらをご覧ください。

バグの修正

  • DropdownMenu の offset の計算を修正し、x オフセットがローカル レイアウトの向きにのみ依存するようにしました。これにより、メニューが画面の下部付近にある場合でも、y オフセットが反転しなくなります。（Iccc74、b/294103942）
  • DropdownMenu の offset の計算を修正し、x オフセットがローカル レイアウトの向きにのみ依存するようにしました。これにより、メニューが画面の下部付近にある場合でも、y オフセットが反転しなくなります。（Ib87a2、b/294103942）

バージョン 1.2.0-alpha05

2023 年 8 月 9 日

androidx.compose.material3:material3-*:1.2.0-alpha05 がリリースされました。バージョン 1.2.0-alpha05 に含まれる commit については、こちらをご覧ください。

API の変更

  • チェックボックスと TriStateCheckbox の色を更新しました。CheckboxDefaults.colors() disabledUncheckedColor はチェックボックスの枠線にのみ影響するようになりました。無効にしてチェックボックスをオフにしたときに内部ボックスの色を設定しなければならない特殊なケースでは、目的の色値を持つ CheckboxColors のカスタム作成インスタンスが必要です。（I77d17、b/291943198）

バージョン 1.2.0-alpha04

2023 年 7 月 26 日

androidx.compose.material3:material3-*:1.2.0-alpha04 がリリースされました。バージョン 1.2.0-alpha04 に含まれる commit については、こちらをご覧ください。

新機能

  • 試験運用版の Segmented Button API（Ifc8fb）
  • 分割線に、垂直分割線をサポートするように向きを制御するパラメータが追加されました。（I4c899、b/288438593）

API の変更

  • 密度の依存関係をコンポーネント レベルに移動します。これは、SwipeToDismiss とシートベースのコンポーネントに適用されます。密度がパラメータである新しいオーバーロードを使用してください。（I1846e）
  • コンポーザブルへの許可された入力を指定する追加のアノテーション（Ief234）
  • セグメント化されたボタンにアイコン パラメータを追加し、セマンティクスを分割して、セグメント化されたボタンをそれぞれ SelectableSegmentedButtonRow と ToggelableSegmentedButtonRow で選択可能にして単一選択を実装し、切り替え可能にして複数選択を実装できるようにしました。（I38740）
  • ディバイダの名前が HorizontalDivider に変更されました。VerticalDivider 機能を追加しました。（I5975c）
  • 試験運用版の Material3 API で ClosedFloatingPointRange の使用を軽量な FloatRange に変更し、自動ボックス化を最小限に抑えました。（I4aab5）
  • FabPosition の新しい開始位置の配置を追加しました。（Ib7aea、b/170592777）

バグの修正

  • ModalBottomSheet はローカルのレイアウト方向を尊重します。（Ib4f44、b/285628622）

バージョン 1.2.0-alpha03

2023 年 6 月 21 日

androidx.compose.material3:material3-*:1.2.0-alpha03 がリリースされました。バージョン 1.2.0-alpha03 に含まれる commit については、こちらをご覧ください。

動作の変更

  • マテリアル 3 タイポグラフィで、includeFontPadding がデフォルトで false になりました。デフォルトの行の高さのスタイルも Trim.None と Alignment.Center に変更され、Typography の TextStyle に明示的な lineHeight（sp 単位）が追加されました。これらの値をカスタマイズする場合は、API のドキュメントをご覧ください。また、これらの変更について詳しくは、ブログ投稿をご覧ください。（I6266f、Icabc3）

新機能

  • コンポーネントのステートフル バージョンである RangeSlider のオーバーロードを追加しました。現在のアクティブなトラックに関するすべての情報、RangeSlider のコンポーネントの測定値、ドラッグとジェスチャーのロジックを保持する RangeSliderState を作成しました。（I8c270）
  • 検索バーで、新しく追加された shadowElevation パラメータを使用してシャドウをサポートできるようになりました。（Ia5369、b/271040353）
  • ColorScheme で新しい SurfaceContainer ロールがサポートされるようになりました。
  • サーフェスの色調の高度オーバーレイを、LocalTonalElevationEnabled コンポジション ローカルで無効にできるようになりました。（Ic203c、b/277774590）

API の変更

  • コンポーネントの色のコンストラクタを開きます。（I8c4a6）
  • 両方のツールチップ API に focusable パラメータを追加し、デベロッパーがツールチップでタップイベントを消費するかどうかを指定できるようにしました。ただし、この場合、ユーザー補助のフォーカスの自動移動が中断される可能性があります。（Ie32d8）
  • パフォーマンスとメモリ割り当てを最適化するために、ユーザー補助機能を最適化しました。（Iede48）
  • DefaultSizeClasses を公開し、WindowSizeClasses の StandardSizeClasses を作成しました。（I91838）
  • WindowWidth/HeightSizeClass を浮動小数点値クラスに変更しました。（Ie686e）

バグの修正

  • スキャフォールドの contentWindowInsets パラメータが、消費されたウィンドウの切り欠きを考慮するようになりました。topBar と bottomBar に基づくコンテンツのパッディングの動作は、これらのパラメータが指定されても変わりません。（I08b73、b/264601542）
  • 長いタイトルがアクション アイコンやナビゲーション アイコンの上にレンダリングされないように、中央上部のアプリバーの配置を修正しました。（I4369f、b/236994621）
  • タブの位置で、コンテンツの最小幅が 24.dp に強制されるようになりました。これにより、タブ インジケータにアクセス可能なタップ ターゲットが提供されます。（Id8861）
  • dynamicLightColorScheme と dynamicDarkColorScheme のダイナミック カラーパレットで、新しいサーフェスロールがサポートされるようになりました。（I1252e）
  • 祖父母と衝突したときにクリップされないように、バッジ通知の配置を更新しました。（Idf75a）

バージョン 1.2.0-alpha02

2023 年 5 月 24 日

androidx.compose.material3:material3-*:1.2.0-alpha02 がリリースされました。バージョン 1.2.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

  • ModalBottomSheet にウィンドウの切れ込みパラメータを追加しました。
    • windowInsets をゼロに設定して、ステータスバーの背後に ModalBottomSheet のスクリムを描画できるようになりました
    • デフォルトの ModalBottomSheet 機能を更新し、ナビゲーションを含むシステムバーの外側に配置されるようにしました
    • ステータスバーの切り欠きの処理は、エッジ ツー エッジ モードのドラッグハンドルによって提供されます。
    • BottomSheetDefaults には、BottomSheetWindow のウィンドウ インセットが含まれています。（I31200、b/274872542、b/272973615、b/272334475、b/268432129、b/275849044、b/275486106、b/268433162）
  • Indicator を非推奨にし、M3 の仕様に合うように Primary/SecondaryIndicator を追加しました。PrimaryIndicator はタブのコンテンツの幅と一致しますが、SecondaryIndicator は使用可能な幅全体に広がります。SecondaryIndicator は、非推奨となった Indicator と同等であり、直接置き換えることができます。（I27604）
  • 表示されるメニュー項目の垂直スクロール状態を制御するために、DropdownMenu または ExposedDropdownMenu を作成時に ScrollState を渡すオプションを追加しました。（Ia0734、b/185304441）
  • コンポーネントのステートフル バージョンである Slider のオーバーロードを追加しました。現在のアクティブなトラックに関するすべての情報、Slider のコンポーネントの測定値、ドラッグとジェスチャーのロジックを保持する SliderState を作成しました。（I124a5）
  • セマンティクス プロパティ isContainer の名前を isTraversalGroup に変更しました。（I121f6）
  • 完全なパラメータリストを含む最適化された TextStyle.merge(...) を追加しました。（Iad234、b/246961787）
  • TooltipState、RichTooltipState、PlainTooltipState を公開インターフェースにしました。デフォルト状態の RichTooltipStateImpl と PlainTooltipStateImpl を追加しました。実装された状態を取得する remember*State 関数を追加しました。TooltipSync を削除し、TooltipDefault.GlobalMutatorMutex に置き換えました。（I7813d）
  • DatePickerColors を更新し、日付選択ツールの分割線、ナビゲーション、テキスト入力フィールドの色のカスタマイズ オプションを追加しました。（I1a685、b/274626815）
  • DatePickerState と DateRangePickerState が公開インターフェースになり、rememberDatePickerState と rememberDateRangePickerState によって取得できるデフォルトの実装が追加されました。（I71c52）
  • DatePicker と DateRangePicker から dateValidator を削除し、UI で選択可能な日付または年を制御するために状態に設定できる SelectableDates インターフェースを導入しました。（Ic2fc6）
  • TimePicker を安定版 API から削除しました。state API でさらに変更が予定されています（I3f39a）
  • ModalBottomSheet を Android のみに移動しました。ModalBottomSheet はパソコンでの使用は推奨されず、この機能は積極的にメンテナンスされていません。（Ib3778）

バグの修正

  • アクションが重ねて表示されてダイアログの幅に収まる場合、AlertDialog 閉じるアクションが確認アクションの下に表示されるようにしました。この修正により、実装がマテリアル デザインの仕様に準拠するようになりました。（I029de、b/235454277）
  • 3 行アイテムに間違ったパディングを使用していた ListItem のバグを修正しました。（I6e235）
  • ModalBottomSheet で IME キーボードを表示できるようになりました。（Idc508、b/262140644、b/268380384、b/272483584）

バージョン 1.2.0-alpha01

2023 年 5 月 10 日

androidx.compose.material3:material3:1.2.0-alpha01 と androidx.compose.material3:material3-window-size-class:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれる commit については、こちらをご覧ください。

バージョン 1.1

バージョン 1.1.2

2023 年 9 月 20 日

androidx.compose.material3:material3:1.1.2 と androidx.compose.material3:material3-window-size-class:1.1.2 がリリースされました。バージョン 1.1.2 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 2 つのコンポーザブルにモディファイアが誤って渡される問題を修正しました。（b/282761472）
  • 23 時間で初期化されたときに TimePickerState が間違った時間を返す問題を修正しました。（b/278242122）
  • 正午と分数の検証の初期切り替え状態を修正しました。（b/269768197、b/282790635）
  • state.hour が午後 11 時に誤った値を返す問題を修正しました。（b/282761472、b/278242122）

バージョン 1.1.1

2023 年 6 月 21 日

androidx.compose.material3:material3:1.1.1 と androidx.compose.material3:material3-window-size-class:1.1.1 がリリースされました。バージョン 1.1.1 に含まれる commit については、こちらをご覧ください。

バグの修正

  • バイナリの互換性のために、windowInset パラメータのない ModalBottomSheet の呼び出しを追加しました。（Ib7959）
  • ModalBottomSheet にウィンドウの切れ込みパラメータを追加しました。
    • windowInsets をゼロに設定して、ステータスバーの背後に ModalBottomSheet のスクリムを描画できるようになりました
    • デフォルトの ModalBottomSheet 機能を更新し、ナビゲーションを含むシステムバーの外側に配置されるようにしました
    • ステータスバーの切り欠きの処理は、エッジ ツー エッジ モードのドラッグハンドルによって提供されます。
    • BottomSheetDefaults には、BottomSheetWindow のウィンドウ インセットが含まれています。（I31200、b/274872542、b/272973615、b/272334475、b/268432129、b/275849044、b/275486106、b/268433162）

バージョン 1.1.0

2023 年 5 月 10 日

androidx.compose.material3:material3:1.1.0 と androidx.compose.material3:material3-window-size-class:1.1.0 がリリースされました。バージョン 1.1.0 に含まれる commit については、こちらをご覧ください。

1.1.0 の主な機能

新しいマテリアル デザイン 3 コンポーネント

既存のマテリアル デザイン 3 コンポーネントの機能強化。

試験運用版の API を安定版に昇格しました。

詳しくは、こちらのブログ投稿をご覧ください。

バージョン 1.1.0-rc01

2023 年 4 月 19 日

androidx.compose.material3:material3:1.1.0-rc01 と androidx.compose.material3:material3-window-size-class:1.1.0-rc01 がリリースされました。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください。

API の変更

  • TimePicker を安定版 API から削除しました。state API でさらに変更が予定されています（I3f39a）
  • ModalBottomSheet を Android のみに移動しました。ModalBottomSheet はパソコンでの使用は推奨されず、この機能は積極的にメンテナンスされていません。（Ib3778）

バージョン 1.1.0-beta02

2023 年 4 月 5 日

androidx.compose.material3:material3:1.1.0-beta02 と androidx.compose.material3:material3-window-size-class:1.1.0-beta02 がリリースされました。バージョン 1.1.0-beta02 に含まれる commit については、こちらをご覧ください。

API の変更

  • SheetState にオプションの skipHiddenState パラメータが追加されました
  • rememberStandardBottomSheetState にオプションの skipHiddenState パラメータが追加されました
  • BottomSheetScaffold に非表示アンカーが定義されました（デフォルトでは無効）
  • SheetState.requireOffset のドキュメントが更新されました
  • BottomSheetDefaults.MinimizedShape の名前を BottomSheetDefaults.HiddenShape に変更しました。（I839f4、b/273870234）

バグの修正

  • タッチ操作による探索が有効になっているときに、文字盤を時間から分に切り替えないでください。（I717d0）
  • ModalBottomSheet と BottomSheetScaffold のドラッグハンドル セマンティクスが統合されました。（I05afb）
  • BottomSheetScaffold 修飾子、containerColor パラメータ、contentColor パラメータはコンテンツにのみ影響するようになりました。（I992cb）
  • シート コンテンツの BottomSheetScaffold nestedScroll に、フリングが実装されました。（I992cb）

バージョン 1.1.0-beta01

2023 年 3 月 22 日

androidx.compose.material3:material3:1.1.0-beta01 と androidx.compose.material3:material3-window-size-class:1.1.0-beta01 がリリースされました。バージョン 1.1.0-beta01 に含まれる commit については、こちらをご覧ください。

API の変更

  • レイアウト タイプ パラメータを TimePicker コンポーザブルに追加。画面構成に応じて異なるレイアウトを使用できます（Ia0e16）
  • SearchBarDefaults は試験運用版としてマークされています。（I65561）
  • BottomSheetScaffold にシャドウの高度を追加しました。（I94e0f）
  • ヘッダー部分のない日付選択ツールの表示のサポートを追加しました。API を変更し、日付選択ツールの作成時に null ヘッドラインを渡せるようにしました。ヘッドレス ピッカーを表示するために、null の広告見出し、タイトル、showToggleMode = false を渡せるようになりました。（Id3f3a、b/266132421、b/267194809）

バグの修正

  • 検索バーが非アクティブになると、フォーカスが自動的に解除されるようになりました。（I22a7c、b/261444487）
  • DateRangePicker を更新し、開始日と終了日が同じ期間を選択できるようにしました。（I16529、b/272882497）
  • フォントサイズが想定よりも小さい場合、テキスト フィールドのテキスト要素が適切に配置されるようになりました。これにより、フォント設定やスクリプトに基づいてアプリの表示が数ピクセル変わる可能性があります。（I8b8d0）
  • ボトムシートのセマンティック アクションにラベルが追加されました。（I277b0）

バージョン 1.1.0-alpha08

2023 年 3 月 8 日

androidx.compose.material3:material3:1.1.0-alpha08 と androidx.compose.material3:material3-window-size-class:1.1.0-alpha08 がリリースされました。バージョン 1.1.0-alpha08 に含まれる commit については、こちらをご覧ください。

新機能

  • BottomSheetScaffold と BottomSheetScaffoldState のサポートを追加しました。（I063d4）

API の変更

  • DatePickerState と DateRangePickerState に機能を追加し、状態の初期作成後に日付を設定できるようにしました。また、タイムスタンプを null に設定して選択をリセットできるようにしました。日付を手動で設定する場合は注意が必要です。指定した日付が前提条件を満たさない場合、新しい setSelection 関数は例外をスローします（ドキュメントを参照）。（Ifa645、b/268609314、b/270427389）
  • 閉じた状態の SheetValue の名前を PartiallyExpanded に変更し、この状態の動作をより正確かつ柔軟に表現できるようにしました。（Ia1491）
  • ListItem パラメータ名を _text から _content に更新しました。デフォルトのゲッターが、必要に応じて ReadOnlyComposables になりました。（I69a25）
  • インタラクティブ サーフェス API を試験運用版から正式版に昇格させました。（I90d59、b/261561812）

バグの修正

  • ModalBottomSheet の HalfExpanded 状態が正しく計算されず、シートがフローティングに見える問題を修正しました。（I45e84、b/268411386）
  • ModalBottomSheet のスクリーミング タップへの confirmValueChange チェックを追加。（I2311a、b/270425759）
  • セマンティック BottomSheet アクションをドラッグハンドルに移動しました。（I158ba）
  • ModalBottomSheet は起動時にフォーカスを設定するように指示し、戻るボタンを処理するようになりました。（I4d2ab）
  • ネストされたスクロールのフリングでも ModalBottomSheet onDismissRequest が処理されるようになりました。（I655c5、b/268433166）

バージョン 1.1.0-alpha07

2023 年 2 月 22 日

androidx.compose.material3:material3:1.1.0-alpha07 と androidx.compose.material3:material3-window-size-class:1.1.0-alpha07 がリリースされました。バージョン 1.1.0-alpha07 に含まれる commit については、こちらをご覧ください。

新機能

  • rememberTimePickerState() に対応する時間入力のコンポーザブルを追加しました。これは、時間の入力に関するマテリアル 3 の仕様に従うものです。（Ia4fab）
  • 期間を選択するための Material 3 DateRangePicker API を追加しました。（I7a6c3、b/267194809）
  • マテリアル 3 の入力モードに対応し、DateRangePicker API で期間を選択できるようになりました。（Ifdbc4）
  • テキスト フィールドの色について、次のようなものをカスタマイズできるようになりました。
    • フォーカスやエラーの状態に基づいた、入力フィールドやプレースホルダのテキストの色。textColor パラメータの名前が unfocusedTextColor に変更され、placeholderColor の名前が unfocusedPlaceholderColor になりました。
    • 新しい errorContainerColor パラメータによるエラー状態に基づいた、塗りつぶしテキスト フィールドのコンテナの色。
  • 表示されるプルダウン メニューのテキスト フィールドの色が、接頭辞と接尾辞の新しい API に対応できるようパラメータで更新されました。（I9c8b4、b/254284181、b/264766350）

API の変更

  • Slider API の一部のバージョンを元に戻し、カスタムのサムネイルとトラックを含む新しい試験運用版の Slider の対象となっている不要な Slider オーバーロードを削除しました。RangeSlider の安定性が向上しました。（Ie8fbd）
  • チップのエレベーションの関数において、defaultElevation の名前を elevation に変更しました。（I0f872）
  • マテリアル 3 のテキスト フィールドの API である TextField、OutlinedTextField、textFieldWithLabelPadding、textFieldWithoutLabelPadding、outlinedTextFieldPadding は、試験運用版ではなくなりました。（Ieb5c0、b/261561819）
  • TimePickers is24Hour ではシステム設定を使用します。（I18856）
  • スキャフォールディングの API から試験運用版のアノテーションを削除しました。（Ibb51e、b/261565765、b/261436953）

バグの修正

  • ModalBottomSheet のデフォルトの形状が常に SheetDefaults.ExpandedShape となりました。（I0dfca）
  • マテリアル 3 の DatePicker と DateRangePicker について、ユーザー補助機能を改善しました。（I5087e）
  • 最大の高さの制約が伝播されてクラッシュが発生する可能性があるバグを修正しました。（I30d8c）
  • クリック可能かつ選択可能なサーフェスからセマンティック ロールを削除しました。そのロールを使用していたコンポーネントを更新し、modifier.semantics を使ってロールを設定できるようになりました。（I793d9）

バージョン 1.1.0-alpha06

2023 年 2 月 8 日

androidx.compose.material3:material3:1.1.0-alpha06 と androidx.compose.material3:material3-window-size-class:1.1.0-alpha06 がリリースされました。バージョン 1.1.0-alpha06 に含まれる commit については、こちらをご覧ください。

新機能

  • テキスト フィールドで接頭辞と接尾辞のテキストがサポートされるようになりました。（Ia8578、b/179884561）
  • マテリアル 3 の仕様に沿って時間選択ツールを表示する TimePicker 関数を追加しました。この関数は TimePickerState とコンビニエンス メソッド rememberTimePickerState と組み合わせて使用します。（I71910）
  • 日付入力が DatePicker で表示モードになりました。日付選択ツールと日付入力モードとの切り替えのサポートを追加しました。（Ieeff7）
  • RichTextTooltips の API を追加しました。（I58ef3）
  • ModalBottomSheet、ModalBottomSheetDefaults など、マテリアル 3 用モーダル ボトムシートを実装しました。また、将来的なシート コンポーネントに使用できる SheetState と rememberSheetState も導入しました。（I0853a、b/244189383）

API の変更

  • API showSnackbar を安定化しました。（I195c2、b/261424370）
  • アシストチップと候補ワードの API を安定化しました。（Ibb67b、b/261424370）
  • ListItem、ListItemDefaults、ListItemColors の API を非試験運用版にしました。（I7e7fa、b/261438882）
  • SliderPositions、SliderDefaults.Thumb、SliderDefaults.Track を安定化し、カスタム サムネイルとトラックを含む非試験運用版の Slider、RangeSlider の API を追加しました。以前の Slider、RangeSlider の API を非推奨にしました。（Ie5ea6、b/261566890）
  • Modifier.tooltipAnchor() を公開し、デベロッパーがアンカーに渡して、長押しでツールチップを表示することを示すことができるようにしました。PlainTooltipBox の API を更新し、TooltipState を null 許容型にせずにデフォルトを設定できるようにしました。（Ie2fb7）
  • 整合性のため ProgressIndicatorDefaults.circularTrackColor に @Composable のマークを付けました。（Id29cc）
  • プロパティ ゲッター LocalMinimuTouchTargetEnforcement を復元し、非推奨のマークを付けて LocalMinimumInteractiveComponentEnforcement にリダイレクトするようにしました。（I60dd5）

バージョン 1.1.0-alpha05

2023 年 1 月 26 日

androidx.compose.material3:material3:1.1.0-alpha05 と androidx.compose.material3:material3-window-size-class:1.1.0-alpha05 がリリースされました。バージョン 1.1.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

  • DatePickerDialog とユーザー補助のサポート。
  • カスタムのサムネイルとトラックを RangeSlider に追加しました。

依存関係の更新

  • Compose UI と Compose Material は Lifecycle 2.6.0 に依存するようになりました。

バージョン 1.1.0-alpha04

2023 年 1 月 11 日

androidx.compose.material3:material3:1.1.0-alpha04 と androidx.compose.material3:material3-window-size-class:1.1.0-alpha04 がリリースされました。バージョン 1.1.0-alpha04 に含まれる commit については、こちらをご覧ください。

新機能

  • カレンダー UI を介して単一の日付を選択するための初期 DatePicker API。この API には引き続き変更が加えられています。（I722b9）
  • PlainTooltipBox を介してプレーン ツールチップのサポートを追加しました。（I0cdfb）
  • 検索バー。（Iad128）
  • SwipeToDismiss。（I458a8、b/242889540）

API の変更

  • Surface に IsContainer セマンティクス プロパティを追加しました。後で変更する際にこのプロパティを使って、サーフェスなど要素の意味論的意味に基づいて移動順序を決定します。（I63379）
  • ナビゲーション ドロワー関連の API を安定版としてマークしました。（Iab01e、b/261439597）
  • 円形の進行状況インジケーターにトラックの色パラメータを追加し、円形と線形の両方の進行状況インジケーターにストロークの上限パラメータを追加しました。（Ie668c、b/216325962、b/222964817）
  • 非推奨になった非表示関数の戻り値の型の null 可能性を拡大しました。（Ibf7b0）
  • Modifier.minimumInteractiveComponentSize を追加しました。これを使用すると、要素のサイズが小さい場合のタップ操作の曖昧さを解消するために、48 dp 以上のサイズを予約することができます。（I33f58、b/258495559）
  • コンテンツ スロットのある AlertDialog コンポーザブル用の試験運用版 API を追加しました。（Iec4a2）

バグの修正

  • 進行状況インジケーターの進捗が予想範囲に適切にバインドされるようになりました。（I8a7eb、b/262262727）

既知の問題

  • androidx.compose.foundation:1.4.0-alpha03 から androidx.compose.foundation:1.4.0-alpha04 に更新するときに、java.lang.NoSuchFieldError エラーが発生することがあります。この問題はこちらで最初に報告されました。修正はすでに送信されており、次回の Compose アップデートで利用できるようになります。回避策として、androidx.compose.material ライブラリと androidx.compose.material3 ライブラリを最新バージョン（1.1.0-alpha04）に更新するか、androidx.compose.foundation を 1.4.0-alpha03 にダウングレードしてください。

バージョン 1.1.0-alpha03

2022 年 12 月 7 日

androidx.compose.material3:material3:1.1.0-alpha03 と androidx.compose.material3:material3-window-size-class:1.1.0-alpha03 がリリースされました。バージョン 1.1.0-alpha03 に含まれる commit については、こちらをご覧ください。

API の変更

  • consumedWindowInsets() の名前を consumeWindowInsets() に、withConsumedWindowInsets() の名前を onConsumedWindowInsetsChanged() に変更し、Modifiers を公開しました。（Ie44e1）
  • アイコン付きのテキスト ボタンで使用するための新しいデフォルトのコンテンツ パディングを追加しました。（I8f662）
  • ナビゲーション バーとレールの無効な色を追加しました。（Ia7892、b/258867034）
  • 祖先のスクロール情報をクエリするための Modifier API を追加しました。（I2ba9d、b/203141462）
  • ジェスチャーがスクロール イベントになる可能性がある場合にタップ操作を正しく遅延させるために Clickable で使用します。
  • Scrollable ViewGroup 内で使用する場合に Clickables がリップルを正しく遅延しない問題を修正しました。
  • ジェスチャーがスクロール イベントになる可能性がある場合にタップを正しく遅延するように Drawers と Sheets を更新しました。

依存関係の更新

  • Compose UI と Compose Material は Lifecycle 2.5.1 に依存するようになりました。（I05ab0、b/258038814）

バージョン 1.1.0-alpha02

2022 年 11 月 9 日

androidx.compose.material3:material3:1.1.0-alpha02 と androidx.compose.material3:material3-window-size-class:1.1.0-alpha02 がリリースされました。バージョン 1.1.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

  • 柔軟性を高めるため、awaitFirstDown と waitForUpOrCancellation が PointerEventPass を受け取るようになりました（さらに ExposedDropdownMenuBox も修正しました（スクロール中もメニューが表示される））。（I7579a、b/212091796）
  • material と material3 の Text である TextField と OutlinedTextField に minLines パラメータを追加し、コンポーネントの最小の高さを行数で設定できるようになりました。（I4af1d）
  • TopAppBar の作成時に使用する新しい topAppBarColors 関数のために、TopAppBarDefaults smallTopAppBarColors 関数を非推奨にしました。（Ie6cb9）
  • minLines パラメータを BasicText と BasicTextField に追加しました。これにより、これらのコンポーザブルの最小の高さを行数で設定できるようになりました。（I24294、b/122476634）

バグの修正

  • マテリアル 3 の IconButton および IconToggleBotton のコンテンツを、コンポーネントの状態レイヤの図形（円形など）にクリップしました。（I9da8f）
  • マテリアル 3 の Medium および Large の上部アプリバーを更新し、サーフェス全体で同じ背景色が適用できるようにするとともに、デフォルトの色を透明色の値でオーバーライドできるようにしました。（I67659、b/249688556、b/250838918）

バージョン 1.1.0-alpha01

2022 年 10 月 24 日

androidx.compose.material3:material3:1.1.0-alpha01 と androidx.compose.material3:material3-window-size-class:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください。

バグの修正

  • タイトルが TextStyle と Brush で適用される場合のトップ アプリバーの修正。（If667e）

バージョン 1.0

バージョン 1.0.1

2022 年 11 月 9 日

androidx.compose.material3:material3:1.0.1 と androidx.compose.material3:material3-window-size-class:1.0.1 がリリースされました。バージョン 1.0.1 に含まれる commit については、こちらをご覧ください。

バグの修正

  • マテリアル 3 の Medium および Large の上部アプリバーを更新し、サーフェス全体で同じ背景色が適用できるようにするとともに、デフォルトの色を透明色の値でオーバーライドできるようにしました。（I67659、b/249688556、b/250838918）

バージョン 1.0.0

2022 年 10 月 24 日

androidx.compose.material3:material3:1.0.0 と androidx.compose.material3:material3-window-size-class:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください。

1.0.0 の主な機能

これは、Compose マテリアル 3 の最初の安定版リリースです。

マテリアル デザイン 3 のテーマ設定と Material You のダイナミック カラー

マテリアル デザイン 3 のコンポーネント

ウィンドウ サイズクラス

  • material3-window-size-class は、ウィンドウ サイズ クラス（サイズ変更可能なアプリ レイアウトを設計、開発、テストするための、独自のビューポート ブレークポイントのセット）をサポートする、新しいライブラリです。calculateWindowSizeClass を使用してウィンドウ サイズ クラスのインスタンスを取得し、UI の表示の仕方を決定するのに使用できます。たとえば、ウィンドウ サイズが大きい場合にはボトム ナビゲーションではなくナビゲーション レールを表示するといった指定が可能です。詳細と使用例については、WindowSizeClass の API リファレンス ドキュメントをご覧ください。

  • 詳しくは、こちらのブログ投稿をご覧ください。

バージョン 1.0.0-rc01

2022 年 10 月 5 日

androidx.compose.material3:material3:1.0.0-rc01 と androidx.compose.material3:material3-window-size-class:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください。

API の変更

  • テキスト フィールド API に、テキストをサポートするためのスロット パラメータを追加しました。（Iaac0d、b/227146125）

バージョン 1.0.0-beta03

2022 年 9 月 21 日

androidx.compose.material3:material3:1.0.0-beta03 と androidx.compose.material3:material3-window-size-class:1.0.0-beta03 がリリースされました。バージョン 1.0.0-beta03 に含まれる commit については、こちらをご覧ください。

API の変更

  • ExposedDropdownMenuDefaults がメニュー項目のパディング値をエクスポーズするようになりました。（I34ee1）
  • ExposedDropdownMenuBoxScope に、テキスト フィールドに渡される Modifier.menuAnchor() 修飾子が追加され、a11y の動作が正しくなりました。（I27fa3）
  • ユーザーが評価やトラックを渡してスライダーを生成できる現在の Slider API に 2 つのオーバーロードされたメソッドが追加されました。（I21c00）

バグの修正

  • On Error Container のダークモード カラー マッピングをトーン 90 に更新しました。（Ic5612）
  • 小さいマテリアル 3 の上部アプリバーに透明な背景を設定できるよう修正しました。（I645e2、b/245575782）

バージョン 1.0.0-beta02

2022 年 9 月 7 日

androidx.compose.material3:material3:1.0.0-beta02 と androidx.compose.material3:material3-window-size-class:1.0.0-beta02 がリリースされました。バージョン 1.0.0-beta02 に含まれる commit については、こちらをご覧ください。

API の変更

  • beta01 バージョンの m3 コンポーネントで導入されたデフォルトのコンポーネント インセットに、IME インセットは含まれなくなりました。
  • Material3 Scaffold コンポーネントに contentWindowInsets パラメータを追加し、コンテンツ スロットに対して処理するインセットの量を指定できるようにしました。（Icf11a、b/243713323）
  • 試験運用版マテリアル 3 の SmallTopAppBar 関数を非推奨とし、同等の TopAppBar 関数を導入しました。使用している場合は、新しい関数に移行してください。（I74404、b/226918634）
  • トップ アプリバーのフリングとスナップの動作をコントロールできるようにしました。（I15c81）
  • Divider から startIndent を削除し、色を最後のパラメータに移動しました。（If7be2）

バグの修正

  • ダイアログが表示されたら「ダイアログ」という単語を読み上げて、TalkBack ユーザーがダイアログを識別できるようにします。（I857ef）

バージョン 1.0.0-beta01

2022 年 8 月 24 日

androidx.compose.material3:material3:1.0.0-beta01 と androidx.compose.material3:material3-window-size-class:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください。

API リファレンス

最新のテーマ設定、コンポーネント、その他の利用可能なコンポーザブルについては、Compose Material 3 API リファレンスの概要をご覧ください。

API の変更

  • マテリアル 3 のトップ アプリバーを更新し、完全に閉じた状態と完全に開いた状態がすばやく切り替わるようにしました。また、TopAppBarDefaults 動作関数をコンポーザブルに更新し、トップ アプリバーの状態とアニメーション仕様のデフォルト値を指定しました。（I642b3）
  • Surface API に合わせて FAB コンポーネントのシグネチャを更新しました。（I3afaa）
  • トップ アプリバー、ドロワー、ナビゲーション バー、レールの、インセットでの組み込みサポートを追加しました。これらのコンポーネントを単独で、または Scaffold とともに使用すると、デベロッパーのインセットが自動的に処理されます。注: この変更によって、ステータスバー アイコンや、ステータスバーとナビゲーション バーの透明度に対して自動処理が追加されるわけではありません。今後も引き続きこれらを手動で処理して、画面いっぱいに広がる最高のエクスペリエンスを提供できるようにしてください。（I7e4e6、b/183161866）
  • コンポーネントのデフォルトを更新して、今後の柔軟性とパフォーマンスの改善のために API サーフェスを削減しました。（I31820）
  • API 内の整合性を保つために、チップとナビゲーション ドロワーのシート パラメータの順序を変更しました。（I45d0b）
  • Divider から startIndent を削除し、色を最後のパラメータに移動しました。（If7be2）

バージョン 1.0.0-alpha16

2022 年 8 月 10 日

androidx.compose.material3:material3:1.0.0-alpha16 と androidx.compose.material3:material3-window-size-class:1.0.0-alpha16 がリリースされました。バージョン 1.0.0-alpha16 に含まれる commit については、こちらをご覧ください。

新機能

  • ナビゲーション ドロワーでカスタムの幅を指定できるようになりました。（Ia7f10）

API の変更

  • API 内の整合性を保つために、Tab と先頭のアイコンタブのパラメータを並べ替えました。（Ie2637）
  • BadgeDefaults を試験運用としてマークしました。（I98ef3）
  • 非推奨となったナビゲーション ドロワー関数を削除しました。（I4f2db）
  • API 内の整合性を保つために、マテリアル 3 のスライダー パラメータを並べ替えました。（I0aee7）
  • API 内の整合性を保つために、NavigationBar および NavigationRail パラメータを並べ替えました。（I51cda）
  • API 全体の整合性を保つために、マテリアル 3 のパラメータを並べ替えました。（If4ae1）
  • API 内の整合性を保つために、マテリアル 3 のスライダー パラメータを並べ替えました。（I62673）
  • トップ アプリバーとの整合性を保つために、アイコン パラメータの名前をアクションに変更しました。（Id75be）
  • アンカーの配置はまだ流動的であるため、Badge と BadgedBox を試験運用版としてマークしました。（I1712e、b/236524516）
  • アイコンボタン バリアントの @ExperimentalMaterial3Api アノテーションを @OptIn に変更しました。（I070b5）
  • ナビゲーション ドロワーのコンテンツを独自のコンポーザブルに分離し、カスタムの幅を指定できるようにしました。（Ia7f10）
  • MenuDefaults と TabDefaults から Divider を削除しました。（I4e33c）

バージョン 1.0.0-alpha15

2022 年 7 月 27 日

androidx.compose.material3:material3:1.0.0-alpha15 と androidx.compose.material3:material3-window-size-class:1.0.0-alpha15 がリリースされました。バージョン 1.0.0-alpha15 に含まれる commit については、こちらをご覧ください。

新機能

  • トップ アプリバーをバー自体からドラッグできるようにしました。（I65c00、b/205873416）

API の変更

  • FilterChip API と ElevatedFilterChip API を更新し、selectedIcon スロットを削除するとともに、選択された状態を表示するための leadingIcon の再利用を促進しました。（Ie5dc2）
  • カラーロールのスクリムおよびアウトライン バリアントを追加しました。（Id6d54）
  • コンポーザブルのデフォルトの命名規則を修正しました。（I62b27）
  • ListItemDefaults と ListItemColors を試験運用版としてマークしました。（I1f3ec）
  • トップ アプリバー API に変更を加えて、その状態プロパティの意味をより適切に反映するようにしました。また、トップ アプリバー API を試験運用版としてマークしました。（Ic0ad8）
  • テキスト選択の色を TextFieldColors に追加して、見つけやすくしました。（Iba1b8）
  • アイコンを含むボタンで使用できる ButtonDefault.ButtonWithIconContentPadding を追加しました。（I2bf9c）
  • 将来の API の変更における柔軟性を高めるため、テキスト フィールドを試験運用版としてマークしました。（I127b5）
  • Checkbox 関数から @ExperimentalMaterial3Api アノテーションを削除しました。（I5eefc）
  • RadioButton 関数から @ExperimentalMaterial3Api アノテーションを削除しました。（I17e2a）
  • 非インタラクティブなカードから @ExperimentalMaterial3Api アノテーションを削除しました。（I9bd49）
  • さまざまなコンポーネント デフォルトのオブジェクトを更新して、色や形状などを含むようにしました。（I96e11）

バグの修正

  • カタログアプリでユーザーが混乱しないように、入力チップのサンプルから機能していない末尾のアイコンを削除しました。（I9846a）

バージョン 1.0.0-alpha14

2022 年 6 月 29 日

androidx.compose.material3:material3:1.0.0-alpha14 と androidx.compose.material3:material3-window-size-class:1.0.0-alpha14 がリリースされました。バージョン 1.0.0-alpha14 に含まれる commit については、こちらをご覧ください。

新機能

  • M3 リストの実装を追加しました。使用例については、ドキュメントをご覧ください。（Id7a20）

API の変更

  • RangeSlider のパラメータ名を values から value に変更しました。（I3b79a）
  • マテリアル デザインの仕様に基づく選択可能な状態をサポートできるよう、API の InputChip の実装に対する変更を行いました。 FilterChip の色について、無効な状態が選択された場合のサポートを追加しました。（I55244、b/235792432）
  • BottomAppBar のデフォルトの FAB を追加しました。（Ida4c8）
  • ColorScheme.surfaceColorAtElevation が追加されました。（Id41af）
  • compose ライブラリのインターフェースが jdk8 デフォルト インターフェース メソッドを使ってビルドされるようになりました。（I5bcf1）
  • WindowWidthSizeClass と WindowHeightSizeClass に Comparable が実装され、演算子（<、<=、>=、>）とその他の API を使用して比較できるようになりました。（I747d0）

バグの修正

  • バッジのサンプルが更新されて、コンテンツの説明がよりわかりやすくなりました。（I10b9d）
  • Material 3 カタログのテーマ選択ツールに、システムのフォントサイズを使用するオプションを追加しました。（I10605）
  • バッジと不確定形式の進捗状況インジケーターのサンプルコードを追加しました。（I8fbe0）

バージョン 1.0.0-alpha13

2022 年 6 月 1 日

androidx.compose.material3:material3:1.0.0-alpha13 と androidx.compose.material3:material3-window-size-class:1.0.0-alpha13 がリリースされました。バージョン 1.0.0-alpha13 に含まれる commit については、こちらをご覧ください。

API の変更

  • 構成変更時のトップ アプリバーの位置の維持がサポートされます。（I10459、b/216160958）

バージョン 1.0.0-alpha12

2022 年 5 月 18 日

androidx.compose.material3:material3:1.0.0-alpha12 と androidx.compose.material3:material3-window-size-class:1.0.0-alpha12 がリリースされました。バージョン 1.0.0-alpha12 に含まれる commit については、こちらをご覧ください。

バグの修正

  • スライダーの親の幅を 0 に設定できるようになりました。（b/231707291）

バージョン 1.0.0-alpha11

2022 年 5 月 11 日

androidx.compose.material3:material3:1.0.0-alpha11 と androidx.compose.material3:material3-window-size-class:1.0.0-alpha11 がリリースされました。バージョン 1.0.0-alpha11 に含まれる commit については、こちらをご覧ください。

新機能

  • マテリアル 3 に RangeSlider を追加しました。（I18e38）
  • マテリアル 3 の AssistChip および InputChip のサポートを追加しました。（I0d25a）
  • マテリアル 3 の FilterChip および SuggestionChip のサポートを追加しました。（I9fdf3）

API の変更

  • OutlinedTextField に境界の破線を描画する TextFieldDefaults.BorderStroke コンポーザブルの名前を TextFieldDefaults.BorderBox に変更しました。（I5f295）
  • M3 Switch の視覚的な変更（Iab30e）
  • 標準のアイコンボタンに色を渡すことが可能になりました。（Ia2445）

バグの修正

  • 内部パディングの使用を保証するため、material3 / Scaffold に lint チェックを追加しました。（I72293、b/226951418）

バージョン 1.0.0-alpha10

2022 年 4 月 20 日

androidx.compose.material3:material3:1.0.0-alpha10 と androidx.compose.material3:material3-window-size-class:1.0.0-alpha10 がリリースされました。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。

新機能

  • material3-window-size-class は、ウィンドウ サイズ クラス（サイズ変更可能なアプリ レイアウトを設計、開発、テストするための、独自のビューポート ブレークポイントのセット）をサポートする、新しいライブラリです。calculateWindowSizeClass を使用してウィンドウ サイズ クラスのインスタンスを取得し、UI の表示の仕方を決定するのに使用できます。たとえば、ウィンドウ サイズが大きい場合にはボトム ナビゲーションではなくナビゲーション レールを表示するといった指定が可能です。詳細と使用例については、WindowSizeClass の API リファレンス ドキュメントをご覧ください。ウィンドウ サイズ クラスの定義について詳しくは、各種の画面サイズのサポートに関する公開ガイダンスをご覧ください。

API の変更

  • BottomAppBar にデフォルトの FAB の高度を追加し、FAB がある BottomAppBar から後置ラムダを削除しました。（I92c47）
  • マテリアル 3 の FilledIconButton、FilledTonalIconButton、OutlinedIconButton を追加しました。（Ib2bda）
  • Material 3 Snackbar API を更新し、オプションのアクションと閉じるアクションの色の値を受け入れるようにしました。（Ibe4b4）
  • PointerInputChange での部分的な消費（down または position）が非推奨になりました。consume() を使用すると、変更を完全に使用できます。isConsumed を使用すると、以前にその変更が他のユーザーに使われたかどうかを確認できます。
  • PointerInputChange::copy() が常にシャローコピーを作成するようになりました。つまり、PointerInputChange のコピーのいずれか 1 つが使用されると、以降はそれらのコピーが使用されます。バインドされていない PointerInputChange を作成するには、代わりにコンストラクタを使用します。（Ie6be4、b/225669674）
  • Cards API を変更し、CardColors インターフェースでコンテナとコンテンツの色を受け取るように、また、クリック可能なカードの無効状態をサポートするようにしました。（I927df）
  • 他のコンポーネントとの一貫性を高めるために、マテリアル 3 のテキスト フィールドのパラメータ backgroundColor の名前を containerColor に変更しました。（I6fbd9）

バグの修正

  • マテリアル 3 の仕様に合わせて標準の IconButton を更新しました。（I09eab）
  • マテリアル 3 Scaffold のトップバーの高さをコンテンツに渡されるパディングに移動し、上部のアプリバーの下にコンテンツをレンダリングできるようにしました。PaddingValues が無視されると、コンテンツがトップバーによって隠れる可能性があります。（I83cbc、b/217776202）

バージョン 1.0.0-alpha09

2022 年 4 月 6 日

androidx.compose.material3:material3:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

新機能

  • Material 3 Switch API を追加しました（I2c3ad）

API の変更

  • テキスト フィールドを含むプルダウン メニュー（「露出したプルダウン メニュー」または「コンボボックス」）のサポートを追加しました。（I1b832）
  • MaterialTheme および Shape サブシステムに shape パラメータを追加しました。（I37426）
  • ExtendedFloatingActionButton に拡張パラメータを追加しました。これにより、FAB を開くか閉じるかを制御し、各状態の間にアニメーションを表示できます。アイコンのない ExtendedFAB の末尾のテキストを含む拡張 FAB に拡張 FAB オーバーロードを追加しました。（Iba7f1）

バージョン 1.0.0-alpha08

2022 年 3 月 23 日

androidx.compose.material3:material3:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

新機能

  • マテリアル 3 のテキスト フィールドのサポートを追加しました。（I795cc、b/199377790）

API の変更

  • メニューにデフォルトのディバイダを追加しました。（I01374）
  • surfaceTint カラー パラメータを ColorScheme クラスに追加しました。（I2f558）

バグの修正

  • MaterialTheme からデフォルトのテキスト スタイル値が読み取られるように、Material3 Button を修正しました。（Ie62fc）

バージョン 1.0.0-alpha07

2022 年 3 月 9 日

androidx.compose.material3:material3:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

API の変更

  • Material 3 Surface API を更新し、クリック可能なサーフェスのオーバーロード関数を復活させるとともに、選択と切り替えが可能なサーフェスをサポートする関数を追加しました。（I4bf18）
  • LazyVerticalGrid と LazyHorizontalGrid が安定版になりました。（I307c0）
  • LazyVerticalGrid/LazyHorizontalGrid とすべての関連 API を .grid サブパッケージに移動しました。インポートを androidx.compose.foundation.lazy から androidx.compose.foundation.lazy.grid に更新してください。（I2d446）
  • WindowInsetsControllerCompat の View のみに依存する以前の変更を元に戻し、一部のウィンドウ フラグの管理に必要な Window が改めて必須になりました。適切な Window が使用されるように（View がダイアログ内にある場合など）、ViewCompat.getWindowInsetsController が非推奨になり、WindowCompat.getInsetsController に置き換えられました。（I660ae、b/219572936）
  • 交差軸のサイズを定義する LazyVerticalGrid API を新たに追加しました。（I17723）

バグの修正

  • Surface API での変更にあわせて Card API を更新しました（I3c8b9）

バージョン 1.0.0-alpha06

2022 年 2 月 23 日

androidx.compose.material3:material3:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

API の変更

  • ドロワー内の単一のデスティネーションを表す NavigationDrawerItem を追加しました（Ic396f、b/218286829）
  • PermanentNavigationDrawer と DismissibleNavigationDrawer を試験運用版 API として追加しました。これらは大画面のデバイスに適したドロワーです。（I5f8ab、b/218286829）
  • マテリアル 3 の下部のアプリバーのサポートを追加しました（Ic432a）
  • NavigationDrawer の名前を ModalNavigationDrawer に変更しました（I1807d、b/218286829）
  • マテリアル 3 の Slider クラスとトークンを追加しました（I1ccee）
  • Tab の実装を追加しました。使用例については、ドキュメントをご覧ください（Ie0146）

バグの修正

  • TalkBack スクリーン リーダーの直線的なナビゲーションで上部のアプリバーの空のタイトルが選択された場合の問題を修正しました。（Id4690）
  • IconSize を FloatingActionButtonDefaults に追加しました。（Ia71cf）
  • LazyColumn で長いテキストが追加されたときに非表示になる AlertDialog ボタンに関するバグを修正しました。（Ib2cc9、b/216663029）

バージョン 1.0.0-alpha05

2022 年 2 月 9 日

androidx.compose.material3:material3:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

マテリアル デザイン 3 のコンポーネントを追加しました。

API の変更

  • onClick コールバックを受け取る Surface 関数を非推奨にしました。クリック可能なサーフェスは、InteractionSource と Modifier.clickable() を使用して作成する必要があります。（I211c6）
  • FAB の押下とフォーカスでの高さのサポートを追加しました。（Ibb584）
  • InteractionSource を受け取るように Surface API を変更しました。さまざまな状態での外観を制御できます。（Iafbc8）

バグの修正

  • 動的なカラーパターンに欠落していた第 3 の色を追加しました（I456c4、b/214588434）

バージョン 1.0.0-alpha04

2022 年 1 月 26 日

androidx.compose.material3:material3:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

API の変更

  • 複雑なロジックのない既存メソッドのオーバーロードであるメソッドに、NonRestartableComposable を追加しました。これにより、呼び出し先の内部関数で繰り返される、すべてのパラメータに対するコンパイラ生成のメモ化チェック（equals）を減らすことができます。（I90490）
  • マテリアル 3 のディバイダを追加しました。（Ica5fc）
  • Checkbox と RadioButton に試験運用版の API アノテーションを付けられるようにしました。（Ie44bb）
  • マテリアル 3 の進行状況インジケーターのサポートを追加しました。（Iff232、b/205023841）

バグの修正

  • 無効な TextButton's コンテナの色が透明になるよう更新しました。（I6b248、b/213339737）

バージョン 1.0.0-alpha03

2022 年 1 月 12 日

androidx.compose.material3:material3:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

バグの修正

  • マテリアル 3 の MaterialTheme に LocalIndication を追加しました。（I7ce4e）
  • チェックボックスに適用される角の丸みを修正しました。（I38b03、b/175198975、b/202309440）

依存関係の更新

  • Kotlin 1.6.10 に依存するようになりました。

バージョン 1.0.0-alpha02

2021 年 12 月 1 日

androidx.compose.material3:material3:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

  • チェックボックスとラジオボタンのサポートを追加しました。
  • Kotlin 1.6.0 との互換性を確保するために更新しました。

API の変更

  • マテリアル 3 のスキャフォールディングからドロワーを削除しました。（I04f51）
  • マテリアル 3 の Checkbox のサポートを追加しました。（Id5542）
  • マテリアル 3 の RadioButton のサポートを追加しました。（I20334）

バグの修正

  • IconButton の波紋半径を 40dp から 20dp に縮小しました。（I68bbe、b/206674345）
  • Text のポート文字列高速パスを compose.material から変更しました。（I30b03）
  • ハードコードされたボタンが常に有効になるよう修正しました。（Iea832、b/205335456）

バージョン 1.0.0-alpha01

2021 年 10 月 27 日

androidx.compose.material3:material3:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

マテリアル デザイン 3 のテーマ設定と Material You のダイナミック カラー

マテリアル デザイン 3 のコンポーネント

詳しくは、Compose のマテリアル テーマ設定ガイドのマテリアル デザイン 3 と Material You をご確認ください。