O Material 3 Adaptive 1.2.0 está estável

Temos o prazer de anunciar que o Material 3 Adaptive 1.2.0 agora está estável.

Essa versão continua a ser criada com base nas versões anteriores, expandindo o suporte para mais pontos de interrupção para classes de tamanho de janela e novas estratégias para posicionar painéis de exibição automaticamente.

Novidades do Material 3 Adaptive 1.2.0

Essa versão estável é criada com base no suporte do WindowManager 1.5.0 para pontos de interrupção grandes e extragrandes e apresenta as novas estratégias de reflow e levitação para ListDetailPaneScaffold e SupportingPaneScaffold. 

Novas classes de tamanho de janela: grande e extragrande

O WindowManager 1.5.0 introduziu dois novos pontos de interrupção para a classe de tamanho de janela de largura para oferecer suporte a janelas ainda maiores do que a classe de tamanho de janela expandida. Os pontos de interrupção grande (G) e extragrande (XG) podem ser ativados adicionando o seguinte parâmetro à chamada currentWindowAdaptiveInfo() no seu código:

currentWindowAdaptiveInfo(supportLargeAndXLargeWidth = true)

Essa flag permite que a biblioteca também retorne pontos de interrupção G e XG sempre que necessário.

Novas estratégias adaptáveis: reflow e levitação

Organizar conteúdo e painéis de exibição em uma janela é uma tarefa complexa que precisa levar em consideração muitos fatores, começando pelo tamanho da janela. Com a nova biblioteca Material 3 Adaptive, duas novas tecnologias podem ajudar você a criar um layout adaptável com o mínimo de esforço.

Com o reflow, os painéis são reorganizados quando o tamanho ou a proporção da janela muda, colocando um segundo painel ao lado do primeiro quando a janela é larga o suficiente ou refazendo o segundo painel abaixo do primeiro sempre que a janela é mais alta. Essa técnica também é aplicada quando a janela fica menor: o conteúdo é refeito na parte de baixo.

Refazer um painel com base no tamanho da janela

Embora o reflow seja uma opção incrível em muitos casos, pode haver situações em que o conteúdo precise ser ancorado em um lado da janela ou levitado na parte de cima. A estratégia de levitação não apenas ancora o conteúdo, mas também permite personalizar recursos como capacidade de arrastar, redimensionamento e até mesmo a tela de fundo.

Levitar um painel da lateral para o centro com base na proporção

As estratégias de fluxo e levitação podem ser declaradas no construtor Navigator usando o parâmetro adaptStrategies, e ambas podem ser aplicadas a scaffolds de painel de detalhes e de suporte:

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

Para saber mais sobre como aproveitar essas novas estratégias adaptáveis, consulte o site do Material e o código de exemplo completo no GitHub (links em inglês).