Compose Material 3

Estrutura

O Compose é uma combinação de sete IDs de grupos do Maven no androidx. Cada grupo contém um subconjunto direcionado de funcionalidades, cada um com um conjunto próprio de notas da versão.

Esta tabela explica os grupos e contém links para cada conjunto de notas da versão.

Declarar dependências

Para adicionar uma dependência ao Compose, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários no arquivo build.gradle para seu app ou módulo:

dependencies {
    implementation "androidx.compose.material3:material3:1.0.0-beta03"
    implementation "androidx.compose.material3:material3-window-size-class:1.0.0-beta03"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.2.0-alpha08"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation("androidx.compose.material3:material3:1.0.0-beta03")
    implementation("androidx.compose.material3:material3-window-size-class:1.0.0-beta03")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.2.0-alpha08"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Para ver mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Versão 1.0

Versão 1.0.0-beta03

21 de setembro de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-beta03 e androidx.compose.material3:material3-window-size-class:1.0.0-beta03. A versão 1.0.0-beta03 contém estas confirmações.

Mudanças na API

• ExposedDropdownMenuDefaults agora expõe um valor de padding para itens de menu (I34ee1).
• ExposedDropdownMenuBoxScope agora tem um modificador Modifier.menuAnchor() que precisa ser transmitido para o campo de texto para um comportamento de acessibilidade adequado (I27fa3).
• Adição de dois métodos sobrecarregados para a API Slider atual que permitem que os usuários passem um polegar ou uma faixa para preencher o controle deslizante (I21c00).

Correções de bugs

• Atualização do mapeamento de cores do tema escuro para On Error Container para o tom 90 (Ic5612).
• Correção para permitir a configuração de um segundo plano transparente para pequenas barras de apps do Material 3 (I645e2, b/245575782).

Versão 1.0.0-beta02

7 de setembro de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-beta02 e androidx.compose.material3:material3-window-size-class:1.0.0-beta02. A versão 1.0.0-beta02 contém estas confirmações.

Mudanças na API

• Os encartes de componentes padrão introduzidos nos componentes m3 na versão beta01 não consideram mais encartes do IME (editor de método de entrada, na sigla em inglês).
• O componente Scaffold do Material3 agora tem um parâmetro contentWindowInsets, que permite especificar a quantidade de encartes a serem processados no slot de conteúdo (Icf11a, b/243713323).
• A função SmallTopAppBar experimental do Material 3 foi descontinuada e introduzimos uma função TopAppBar equivalente. Em vez disso, use a função nova (I74404, b/226918634).
• Foi adicionado controle sobre os principais comportamentos de deslizar rapidamente e de ajuste da barra de apps (I15c81).
• O startIndent do foi removido do divisor e a cor foi movida para ser o último parâmetro (If7be2).

Correções de bugs

• As caixas de diálogo agora são identificadas para usuários do TalkBack com um aviso usando as palavras "caixa de diálogo" quando uma aparece (I857ef).

Versão 1.0.0-beta01

24 de agosto de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-beta01 e androidx.compose.material3:material3-window-size-class:1.0.0-beta01. A versão 1.0.0-beta01 contém estas confirmações.

Referência da API

Para conferir os temas, componentes e outros elementos de composição mais recentes disponíveis, consulte a Visão geral de referência da API Compose Material 3.

Mudanças na API

• A barra de cima do app do Material 3 foi atualizada para poder ser fechada totalmente de um estado completamente aberto. Além disso, a função TopAppBarDefaults foi atualizada para ser de composição e fornecer valores padrão para o estado principal da barra de apps e a especificação da animação (I642b3).
• As assinaturas de componentes do FAB foram atualizadas para corresponder à API da plataforma (I3afaa).
• Foi adicionado suporte integrado a encartes para as principais barras de apps, gavetas, barra de navegação e colunas. Quando esses componentes são usados separadamente ou com o Scaffold, eles processam de forma automática os encartes dos desenvolvedores. Observação: essa mudança não adiciona processamento automático dos ícones da barra de status e transparência das barras de status e de navegação. Continue fazendo isso manualmente para garantir a melhor experiência de ponta a ponta (I7e4e6, b/183161866).
• O padrão do componente foi atualizado para reduzir a superfície da API e melhorar a flexibilidade e a performance no futuro (I31820).
• Os parâmetros de página da gaveta de navegação e de ícones foram reorganizados para manter a consistência dentro da API (I45d0b).
• O elemento startIndent foi removido do divisor e a cor foi movida para ser o último parâmetro (If7be2).

Versão 1.0.0-alpha16

10 de agosto de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha16 e androidx.compose.material3:material3-window-size-class:1.0.0-alpha16. A versão 1.0.0-alpha16 contém estas confirmações.

Novos recursos

• Suporte para a especificação de uma largura personalizada em gavetas de navegação (Ia7f10).

Mudanças na API

• Os parâmetros da guia e da guia de ícones principais foram reordenados para manter a consistência na API (Ie2637).
• BadgeDefaults foi marcado como experimental (I98ef3).
• A função de gaveta de navegação descontinuada foi removida (I4f2db).
• Os parâmetros do controle deslizante do Material 3 foram reordenados para manter a consistência na API (I0aee7).
• Os parâmetros NavigationBar e NavigationRail foram reordenados para manter a consistência na API (I51cda).
• Os parâmetros do Material 3 foram reordenados para manter a consistência na API (If4ae1).
• Os parâmetros do controle deslizante no Material 3 foram reordenados para manter a consistência dentro da API (I62673).
• O parâmetro de ícones foi renomeado como uma ação para consistência com a barra de apps superior (Id75be).
• Badge e BadgedBox foram marcados como experimentais, porque o alinhamento da âncora ainda está em fluxo (I1712e, b/236524516).
• Foram feitas mudanças nas anotações @ExperimentalMaterial3Api nas variantes do botão de ícone para @OptIn (I070b5).
• O conteúdo da gaveta de navegação foi separado em uma função de composição para oferecer suporte à especificação de uma largura personalizada (Ia7f10).
• O Divider foi removido de MenuDefaults e TabDefaults (I4e33c).

Versão 1.0.0-alpha15

27 de julho de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha15 e androidx.compose.material3:material3-window-size-class:1.0.0-alpha15. A versão 1.0.0-alpha15 contém estas confirmações.

Novos recursos

• Agora é possível arrastar a barra de apps superior usando a própria barra (I65c00, b/205873416).

Mudanças na API

• As APIs FilterChip e ElevatedFilterChip foram atualizadas para remover o slot selectedIcon e promover a reutilização do leadingIcon para exibir um estado selecionado (Ie5dc2).
• Foram adicionados papéis de cor de variante scrim e contorno (Id6d54).
• Foram corrigidas as convenções de nomenclatura para padrões de composição (I62b27).
• ListItemDefaults e ListItemColors foram marcados como experimentais (I1f3ec).
• A API da barra de apps superior passou por mudanças para refletir melhor o significado das propriedades de estado. Além disso, ela foi marcada como experimental (Ic0ad8).
• As cores de seleção de texto foram adicionadas a TextFieldColors para melhorar a detecção do dispositivo (Iba1b8).
• ButtonDefault.ButtonWithIconContentPadding foi adicionado para ser usado com botões que contêm um ícone (I2bf9c).
• Os campos de texto foram marcados como experimentais para permitir mais flexibilidade em futuras mudanças na API (I127b5).
• A anotação @ExperimentalMaterial3Api foi removida da função Checkbox (I5eefc).
• A anotação @ExperimentalMaterial3Api foi removida da função RadioButton (I17e2a).
• A anotação @ExperimentalMaterial3Api foi removida dos cards não interativos (I9bd49).
• Vários objetos padrão dos componentes foram atualizados para incluir cores, formas etc. (I96e11).

Correções de bugs

• Os ícones finais não funcionais foram removidos de exemplos de ícone de entrada para evitar confusão dos usuários no app de catálogo (I9846a).

Versão 1.0.0-alpha14

29 de junho de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha14 e androidx.compose.material3:material3-window-size-class:1.0.0-alpha14. A versão 1.0.0-alpha14 contém estas confirmações.

Novos recursos

• A implementação de lista M3 foi adicionada. Consulte a documentação para ver um exemplo de uso (Id7a20).

Mudanças na API

• Mudança do nome do parâmetro de valores para valor em RangeSlider (I3b79a).
• A API passou por mudanças na implementação de InputChip a fim de oferecer suporte a um estado selecionável de acordo com a especificação do Material Design. Foi adicionado suporte extra às cores de FilterChip para o estado desativado selecionado (I55244, b/235792432).
• Adição do FAB padrão BottomAppBar (Ida4c8).
• Adição de ColorScheme.surfaceColorAtElevation (Id41af).
• As interfaces em bibliotecas de composição agora são criadas usando métodos de interface padrão do jdk8 (I5bcf1).
• WindowWidthSizeClass e WindowHeightSizeClass agora implementam elementos Comparable para que possam ser comparados usando operadores (<, <=, >=, >) e outras APIs (I747d0).

Correções de bugs

• Atualizada a amostra do ícone para fornecer uma descrição de conteúdo mais significativa (I10b9d).
• Adicionada a opção de usar o tamanho da fonte do sistema no seletor de temas do catálogo do Material 3 (I10605).
• Adicionado um exemplo de código para indicadores de progresso indeterminado e do ícone (I8fbe0).

Versão 1.0.0-alpha13

1º de junho de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha13 e androidx.compose.material3:material3-window-size-class:1.0.0-alpha13. A versão 1.0.0-alpha13 contém estas confirmações.

Mudanças na API

• Permite manter a posição superior da barra de apps na mudança de configuração (I10459, b/216160958).

Versão 1.0.0-alpha12

18 de maio de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha12 e androidx.compose.material3:material3-window-size-class:1.0.0-alpha12. A versão 1.0.0-alpha12 contém estas confirmações.

Correções de bugs

• O controle deslizante pai agora pode ter 0 largura (b/231707291).

Versão 1.0.0-alpha11

11 de maio de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha11 e androidx.compose.material3:material3-window-size-class:1.0.0-alpha11. A versão 1.0.0-alpha11 contém estas confirmações.

Novos recursos

• O RangeSlider foi adicionado ao Material 3 (I18e38).
• Foi adicionado suporte para AssistChip e InputChip no Material3 (I0d25a).
• Foi adicionado suporte para FilterChip e SuggestionChip no Material3 (I9fdf3).

Mudanças na API

• O elemento de composição TextFieldDefaults.BorderStroke que desenha um traço de borda em OutlinedTextField foi renomeado como TextFieldDefaults.BorderBox (I5f295).
• Mudanças visuais no m3 (Iab30e).
• Permissão para transmitir cores aos botões de ícone padrão (Ia2445).

Correções de bugs

• Foi adicionada a verificação de lint a material3/Scaffold para garantir que o padding interno seja usado (I72293, b/226951418).

Versão 1.0.0-alpha10

20 de abril de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha10 e androidx.compose.material3:material3-window-size-class:1.0.0-alpha10. A versão 1.0.0-alpha10 contém estas confirmações.

Novos recursos

• material3-window-size-class é uma nova biblioteca que oferece suporte a classes de tamanho de janela: um conjunto de pontos de interrupção opinativos de janela de visualização para você projetar, desenvolver e testar layouts redimensionáveis de aplicativos. Você pode usar a calculateWindowSizeClass para extrair uma instância de classe de tamanho de janela, que pode ser usada para determinar como a IU vai ser exibida. Por exemplo, mostrar uma coluna de navegação em vez da navegação inferior para tamanhos de janela maiores. Veja mais informações e exemplos de uso na documentação de referência da API de WindowSizeClass. Para mais informações sobre definições de classe de tamanho de janela, consulte a orientação pública sobre como oferecer suporte a diferentes tamanhos de tela.

Mudanças na API

• Foi adicionada uma elevação padrão do FAB para a BottomAppBar e a lambda final de BottomAppBar com o FAB foi removida (I92c47).
• Foram adicionados os elementos FilledIconButton, FilledTonalIconButton e OutlinedIconButton do Material3 (Ib2bda).
• A API Snackbar do Material 3 foi atualizada para aceitar valores de cor para a ação opcional e a de dispensa (Ibe4b4).
• O consumo parcial (para baixo OU na posição) foi descontinuado em PointerInputChange. Use consume() para consumir a mudança completamente. Você pode usar isConsumed para determinar se outra pessoa já consumiu a mudança.
• Agora, o PointerInputChange::copy() sempre faz uma cópia superficial. Isso significa que se uma cópia de PointerInputChange é consumida, todas as outras também são. Para criar uma PointerInputChange desvinculada, use o construtor (Ie6be4, b/225669674).
• Mudanças na API Cards para receber as cores do contêiner e do conteúdo por uma interface CardColors e oferecer suporte a um estado desativado para cards clicáveis (I927df).
• O parâmetro backgroundColor foi renomeado como containerColor nos campos de texto do Material 3 para melhorar a consistência com outros componentes (I6fbd9).

Correções de bugs

• O IconButton padrão foi atualizado para ficar alinhado à especificação do Material3 (I09eab).
• A altura da barra de cima do Scaffold do Material3 foi movida para o padding transmitido ao conteúdo, permitindo que o conteúdo seja renderizado abaixo da barra de apps de cima. Se os PaddingValues forem ignorados, o conteúdo vai poder ser coberto pela barra de cima (I83cbc, b/217776202).

Versão 1.0.0-alpha09

6 de abril de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estas confirmações.

Novos recursos

• A API Material 3 Switch foi adicionada (I2c3ad).

Mudanças na API

• Foi adicionado suporte a menus suspensos com campos de texto (também conhecidos como "menus suspensos expostos" ou "caixas de combinação") (I1b832).
• Foi adicionado um parâmetro de forma aos subsistemas MaterialTheme e Shape (I37426).
• Foi adicionado um parâmetro expandido a ExtendedFloatingActionButton para controlar se o FAB é expandido ou recolhido, com animações entre cada estado. Uma sobrecarga foi adicionada para FABs estendidos com texto à direita para ExtendedFABs sem ícone (Iba7f1).

Versão 1.0.0-alpha08

23 de março de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estas confirmações.

Novos recursos

• Foi adicionado suporte aos campos de texto do Material 3 (I795cc, b/199377790).

Mudanças na API

• O divisor padrão foi incluído no menu (I01374).
• O parâmetro de cor surfaceTint foi adicionado à classe ColorScheme (I2f558).

Correções de bugs

• Correção no botão do Material3 para ler o valor do estilo de texto padrão do MaterialTheme (Ie62fc).

Versão 1.0.0-alpha07

9 de março de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estas confirmações.

Mudanças na API

• Atualizações na API Surface da biblioteca Material 3, que traz as funções sobrecarregadas para superfícies clicáveis, além de adicionar uma função para oferecer suporte a superfícies selecionáveis e alternáveis (I4bf18).
• As APIs LazyVerticalGrid e LazyHorizontalGrid agora estão na versão estável (I307c0).
• LazyVerticalGrid/LazyHorizontalGrid e todas as APIs relacionadas foram movidas para o subpacote .grid. Atualize as importações de androidx.compose.foundation.lazy para androidx.compose.foundation.lazy.grid (I2d446).
• A mudança anterior foi revertida para depender apenas de uma visualização para WindowInsetsControllerCompat e voltou a exigir uma janela necessária para gerenciar algumas sinalizações de janela. O uso de ViewCompat.getWindowInsetsController foi descontinuado e substituído por WindowCompat.getInsetsController para garantir que a janela correta seja usada. Por exemplo, se a visualização estiver em uma caixa de diálogo (I660ae, b/219572936).
• Uma nova API LazyVerticalGrid foi adicionada para definir o tamanho de eixos cruzados (I17723).

Correções de bugs

• Atualizações na API Card para acompanhar as mudanças na API Surface (I3c8b9).

Versão 1.0.0-alpha06

23 de fevereiro de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estas confirmações.

Mudanças na API

• A NavigationDrawerItem que representa um único destino nas gavetas foi adicionada (Ic396f, b/218286829).
• PermanentNavigationDrawer e DismissibleNavigationDrawer foram adicionadas como APIs experimentais. Essas são as gavetas adequadas para dispositivos de tela grande (I5f8ab, b/218286829).
• Foi adicionado suporte à barra de baixo de apps do Material 3 (Ic432a).
• A interface NavigationDrawer foi renomeada como ModalNavigationDrawer (I1807d, b/218286829).
• Foram adicionados tokens e a classe de Slider do Material 3 (I1ccee).
• A implementação de guia foi adicionada. Consulte a documentação para ver um exemplo de uso (Ie0146).

Correções de bugs

• Corrigido um problema em que a navegação linear do leitor de tela TalkBack selecionava um título vazio para a barra de apps da parte de cima (Id4690).
• O IconSize foi adicionado a FloatingActionButtonDefaults (Ia71cf).
• Um bug em que botões da AlertDialog ficavam ocultos quando um texto longo era adicionado com uma LazyColumn foi corrigido (Ib2cc9, b/216663029).

Versão 1.0.0-alpha05

9 de fevereiro de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estas confirmações.

Novos recursos

Inclusão de componentes do Material Design 3

• Menu suspenso
  • DropdownMenu, DropdownMenuItem
• Cards
  • Card, OutlinedCard, ElevatedCard

Mudanças na API

• A função Surface, que recebe um callback onClick, foi descontinuada. As superfícies clicáveis precisam ser criadas com uma InteractionSource e um Modifier.clickable() (I211c6).
• Inclusão de suporte para elevação pressionada e em foco para FAB (Ibb584).
• Mudança na API Surface para que receba uma InteractionSource, que permite controlar a aparência em estados diferentes (Iafbc8).

Correções de bugs

• Foram incluídas cores terciárias ausentes em esquemas de cores dinâmicas (I456c4, b/214588434).

Versão 1.0.0-alpha04

26 de janeiro de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estas confirmações.

Mudanças na API

• Adicionada a anotação NonRestartableComposable a métodos que são sobrecargas de métodos já existentes sem lógica complexa. Isso reduz as verificações de memorização geradas pelo compilador (igual a) para todos os parâmetros repetidos na função interna chamada (I90490).
• Adição do divisor do Material 3 (Ica5fc).
• Marcação da caixa de seleção e RadioButton com uma anotação de API experimental (Ie44bb).
• Inclusão de suporte para indicadores de progresso do Material 3 (Iff232, b/205023841).

Correções de bugs

• Atualização da cor de um contêiner TextButton's desativado para que ele fique transparente (I6b248, b/213339737).

Versão 1.0.0-alpha03

12 de janeiro de 2022

Lançamento de androidx.compose.material3:material3:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estas confirmações.

Correções de bugs

• Adição da LocalIndication ao MaterialTheme do Material 3 (I7ce4e).
• Correção do raio dos cantos aplicado às caixas de seleção (I38b03, b/175198975, b/202309440).

Atualizações de dependência

• Agora depende do Kotlin 1.6.10.

Versão 1.0.0-alpha02

1.º de dezembro de 2021

Lançamento de androidx.compose.material3:material3:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estas confirmações.

Novos recursos

• Foi adicionado suporte a caixas de seleção e botões de opção.
• Atualização para ser compatível com o Kotlin 1.6.0.

Mudanças na API

• A gaveta do scaffold foi removida do Material 3 (I04f51).
• Adicionado suporte ao Checkbox do Material 3 (Id5542).
• Adicionado suporte ao RadioButton do Material 3 (I20334).

Correções de bugs

• O raio da ondulação do IconButton foi removido de 40dp para 20dp (I68bbe, b/206674345).
• Caminho rápido da string de porta para mudanças de Text de compose.material (I30b03).
• O botão fixado no código foi corrigido para que ele fique sempre ativado (Iea832, b/205335456).

Versão 1.0.0-alpha01

27 de outubro de 2021

Lançamento de androidx.compose.material3:material3:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estas confirmações.

Novos recursos

Temas do Material Design 3 e cores dinâmicas do Material You

• MaterialTheme
• Cores
  • ColorScheme
  • lightColorScheme, darkColorScheme
• Cores dinâmicas
  • dynamicLightColorScheme, dynamicDarkColorScheme
• Tipografia
  • Typography

Componentes do Material Design 3

• Botões
  • Button, ElevatedButton, FilledTonalButton, OutlinedButton, TextButton
• FAB e FAB estendido
  • SmallFloatingActionButton, FloatingActionButton, LargeFloatingActionButton, ExtendedFloatingActionButton
• Caixas de diálogo
  • AlertDialog
• Barra de navegação
  • NavigationBar
• Gaveta de navegação
  • NavigationDrawer
• Coluna de navegação
  • NavigationRail
• Barra de apps de cima
  • SmallTopAppBar, CenterAlignedTopAppBar, MediumTopAppBar, LargeTopAppBar
• Ícone
  • Badge, BadgedBox
• Ícone
  • Icon, IconButton
• Texto
  • Text
• Superfície
  • Surface
• Layout
  • Scaffold
• Cor do conteúdo
  • LocalContentColor

Para ver mais informações, consulte a seção Material Design 3 e Material You no guia Temas do Material Design no Compose.