Material 3 Adaptive 1.2.0 が安定版になりました

このたび、Material 3 Adaptive 1.2.0 の安定版がリリースされました。

このリリースは、以前のバージョンの基盤をさらに発展させたもので、ウィンドウ サイズクラスのブレークポイントのサポートを拡大し、表示ペインを自動的に配置する新しい戦略を導入しています。

Material 3 Adaptive 1.2.0 の新機能

この安定版リリースは、大および特大のブレークポイントをサポートする WindowManager 1.5.0 をベースに構築されており、ListDetailPaneScaffold と SupportingPaneScaffold の新しいリフロー戦略とリビテート戦略が導入されています。 

新しいウィンドウ サイズクラス: 大と特大

WindowManager 1.5.0 では、幅のウィンドウ サイズクラスに 2 つの新しいブレークポイントが導入され、Expanded ウィンドウ サイズクラスよりもさらに大きなウィンドウがサポートされるようになりました。コードベースの currentWindowAdaptiveInfo() 呼び出しに次のパラメータを追加することで、大（L）と特大（XL）のブレークポイントを有効にできます。

currentWindowAdaptiveInfo(supportLargeAndXLargeWidth = true)

このフラグを使用すると、ライブラリは必要に応じて L と XL のブレークポイントも返すことができます。

新しいアダプティブ戦略: リフローと浮遊

ウィンドウ内のコンテンツと表示ペインの配置は、ウィンドウ サイズをはじめとする多くの要素を考慮する必要がある複雑なタスクです。新しい Material 3 Adaptive ライブラリでは、2 つの新しいテクノロジーにより、最小限の労力でアダプティブ レイアウトを実現できます。

リフローでは、ウィンドウのサイズやアスペクト比が変更されるとペインが再配置されます。ウィンドウの幅が十分にある場合は、最初のペインの横に 2 番目のペインが配置されます。ウィンドウの高さが十分にある場合は、最初のペインの下に 2 番目のペインがリフローされます。この手法は、ウィンドウが小さくなった場合にも適用されます。コンテンツは下部にリフローされます。

ウィンドウ サイズに基づいてペインをリフローする

リフローは多くの場合に優れたオプションですが、コンテンツをウィンドウの側面にドッキングするか、ウィンドウの上に浮遊させる必要がある場合もあります。浮遊戦略では、コンテンツをドッキングするだけでなく、ドラッグ可能、サイズ変更可能、背景スクリムなどの機能をカスタマイズすることもできます。

アスペクト比に基づいて、ペインを横から中央に浮遊させる

フロー戦略と浮遊戦略はどちらも、adaptStrategies パラメータを使用して Navigator コンストラクタ内で宣言できます。また、どちらの戦略も、リストと詳細ペインと補助ペインの scaffolds に適用できます。

val navigator = rememberListDetailPaneScaffoldNavigator<Nothing>(
        adaptStrategies = ListDetailPaneScaffoldDefaults.adaptStrategies(
            detailPaneAdaptStrategy = AdaptStrategy.Reflow(
                reflowUnder = ListDetailPaneScaffoldRole.List
            ),
            extraPaneAdaptStrategy = AdaptStrategy.Levitate(
                alignment = Alignment.Center
            )
        )
    )

これらの新しいアダプティブ戦略を活用する方法について詳しくは、マテリアルのウェブサイトと GitHub の完全なサンプルコードをご覧ください。