Material Design 3
Esta skill orienta a implementação do Material Design 3 (MD3) do Google — um sistema de design pessoal, adaptável e expressivo. O MD3 usa cor dinâmica, superfícies tonais, formas arredondadas e movimento baseado em molas para criar UIs que parecem vivas e pessoais.
Filosofia
O MD3 é construído sobre três princípios:
- Pessoal: A cor dinâmica adapta a UI ao papel de parede ou conteúdo do usuário. A tematização é individual, não serve para todos.
- Adaptável: Os layouts se transformam em 5 classes de tamanho de janela. Os componentes redimensionam, reposicionam e mudam de fator de forma de forma responsiva.
- Expressivo: A morfologia de formas, a física de molas e a tipografia enfatizada criam momentos de deleite sem sacrificar a usabilidade.
Atualizações Atuais: Google I/O 2026
A atualização do Google I/O 2026 do Material reforça um caminho Compose-first para Android e expande a orientação expressiva/adaptativa:
- Material Android é Compose-first: Para novos trabalhos em Android, prefira Jetpack Compose Material3 para os componentes mais recentes, APIs expressivas, scaffolds adaptativos e integração com Styles API. As Android Views podem permanecer necessárias em aplicativos existentes, mas não devem ser tratadas como o caminho padrão para novas implementações do Material 3.
- Sistema de layout expressivo: Use um scaffold de layout expressivo para adaptar telas em dispositivos móveis, desktop, dobráveis, relógios, XR e outros fatores de forma espaciais. Comece a partir de scaffolds adaptativos/classes de tamanho de janela em vez de layouts fixos focados em telefone.
- Sistema de espaçamento de 8dp: Aplique tokens de espaçamento para margens, preenchimento e lacunas para que layouts e componentes possam se adaptar programaticamente ao tipo de dispositivo e densidade.
- Componentes expressivos novos/atualizados: Listas, menus, pesquisa e barras de aplicativo de pesquisa têm orientação expressiva renovada, com Jetpack Compose como o principal alvo de implementação.
- Relógios e XR: Relógios enfatizam movimento baseado em física, texto em arco e contêineres que tocam as bordas. XR enfatiza painéis espaciais e elevação baseada em profundidade.
Principais diferenças do MD2:
- Superfícies tonais substituem sombras de elevação como a principal dica de profundidade
- A cor dinâmica gera esquemas completos a partir de uma única cor semente
- Cantos completamente arredondados por padrão (não ligeiramente arredondados)
- Física de movimento baseada em molas substitui curvas de suavização fixas para componentes
- 3 níveis de contraste controlado pelo usuário (padrão/médio/alto)
Relação com a skill de design frontend: Quando ambas as skills estão ativas, o MD3 fornece o sistema de design (tokens, componentes, regras de layout) e o design frontend fornece direção criativa dentro dessas restrições. As regras do MD3 têm precedência para estrutura de componentes e uso de tokens. Nota: Roboto/Roboto Flex É a typeface padrão correta no MD3 — a orientação do design frontend para evitar Roboto não se aplica ao implementar MD3.
Árvore de Decisão
O que você está construindo?
Scaffold completo do app → Veja "Padrões Comuns: App Shell" + referências/layout-and-responsive.md
Componente único → Veja "Referência Rápida de Componentes" tabela → referências/component-catalog.md
Tema personalizado → Veja referências/theming-and-dynamic-color.md
Layout de formulário / entrada → Veja referências/component-catalog.md § Input Components
Estrutura de navegação → Veja referências/navigation-patterns.md
Exibição de dados → Veja referências/component-catalog.md § Data Display
Qual plataforma?
Jetpack Compose → Primário: androidx.compose.material3, MaterialTheme, referências/*
Flutter → useMaterial3: true in ThemeData, ColorScheme.fromSeed()
Web (vanilla JS) → @material/web (limitado; modo de manutenção) + propriedades CSS customizadas
Web (React/Vue/Svelte) → Propriedades CSS customizadas + componentes wrapper (sem biblioteca React oficial)
Web (CSS-only) → Valores de token MD3 como propriedades CSS customizadas (sem elementos <md-*>)
Sistema de Tokens de Design
Todos os tokens MD3 usam o namespace md.sys. Jetpack Compose mapeia papéis para MaterialTheme.colorScheme, MaterialTheme.typography e MaterialTheme.shapes (mesmos papéis semânticos da especificação). Na web, estes mapeiam para propriedades CSS customizadas (--md-sys-*):
Tokens de Cor (--md-sys-color-*)
| Token | Propósito |
|---|---|
primary | Preenchimentos, texto, ícones de alta ênfase contra a superfície |
on-primary | Texto/ícones em primary |
primary-container | Preenchimento de destaque para componentes-chave (FAB, etc.) |
on-primary-container | Texto/ícones em primary-container |
secondary / on-secondary | Destaques menos proeminentes |
secondary-container / on-secondary-container | Componentes recessivos (botões tonais) |
tertiary / on-tertiary | Destaques contrastantes |
tertiary-container / on-tertiary-container | Contêineres complementares |
error / on-error | Estados de erro (estático — não muda com a cor dinâmica) |
error-container / on-error-container | Preenchimentos de contêiner de erro |
surface | Fundo padrão |
on-surface | Texto/ícones em qualquer superfície |
on-surface-variant | Texto/ícones de menor ênfase na superfície |
surface-container-lowest | Contêiner de menor ênfase |
surface-container-low | Contêiner de baixa ênfase |
surface-container | Contêiner padrão (áreas de navegação) |
surface-container-high | Contêiner de alta ênfase |
surface-container-highest | Contêiner de ênfase mais alta |
surface-dim / surface-bright | Mantém o brilho relativo entre claro e escuro |
inverse-surface / inverse-on-surface / inverse-primary | Elementos contrastantes (snackbars) |
outline | Limites importantes (bordas de campos de texto) |
outline-variant | Elementos decorativos (divisores) |
Detalhes completos: references/color-system.md
Tokens de Tipografia (--md-sys-typescale-*)
| Escala | Tamanhos | Uso |
|---|---|---|
| Display | G / M / P | Texto hero, números grandes |
| Headline | G / M / P | Cabeçalhos de seção |
| Title | G / M / P | Cabeçalhos menores, títulos de cartão |
| Body | G / M / P | Texto de parágrafo, descrições |
| Label | G / M / P | Botões, chips, legendas |
Cada estilo tem tokens para: -font, -weight, -size, -line-height, -tracking
Além de 15 variantes enfatizadas (peso maior) via --md-sys-typescale-emphasized-*
Detalhes completos: references/typography-and-shape.md
Tokens de Forma (--md-sys-shape-corner-*)
| Token | Valor | Componentes de exemplo |
|---|---|---|
none | 0dp | — |
extra-small | 4dp | Chips, snackbars |
small | 8dp | Campos de texto, menus |
medium | 12dp | Cartões |
large | 16dp | FABs, gaveta de navegação |
large-increased | 20dp | (Expressivo) |
extra-large | 28dp | Diálogos, bottom sheets |
extra-large-increased | 32dp | (Expressivo) |
extra-extra-large | 48dp | (Expressivo) |
full | 9999px | Botões, chips, emblemas |
Níveis de Elevação
| Nível | DP | Deslocamento tonal | Uso |
|---|---|---|---|
| 0 | 0dp | Nenhum | Superfícies planas, a maioria dos componentes em repouso |
| 1 | 1dp | +5% primary | Cartões elevados, folhas modais |
| 2 | 3dp | +8% primary | Menus, barra de navegação, app bar rolada |
| 3 | 6dp | +11% primary | FAB, diálogos, pesquisa, seletores de data/hora |
| 4 | 8dp | +12% primary | (aumento apenas em hover/foco) |
| 5 | 12dp | +14% primary | (aumento apenas em hover/foco) |
A elevação no MD3 é comunicada através da cor de superfície tonal, não de sombras. As sombras são usadas apenas quando necessário para proteção adicional contra fundos ocupados.
Movimento
O MD3 Expressivo (maio de 2025) introduziu física de movimento baseada em molas para componentes. O sistema legado de suavização/duração ainda é usado para transições (entrada/saída/eixo compartilhado):
| Suavização | Duração | Tipo de transição |
|---|---|---|
| Enfatizada | 500ms | Iniciar e terminar na tela |
| Enfatizada desacelerar | 400ms | Entrar na tela |
| Enfatizada acelerar | 200ms | Sair da tela |
| Padrão | 300ms | Iniciar e terminar na tela (utilitário) |
| Padrão desacelerar | 250ms | Entrar na tela (utilitário) |
| Padrão acelerar | 200ms | Sair da tela (utilitário) |
Valores CSS de suavização:
- Enfatizada:
cubic-bezier(0.2, 0, 0, 1) - Enfatizada desacelerar:
cubic-bezier(0.05, 0.7, 0.1, 1) - Enfatizada acelerar:
cubic-bezier(0.3, 0, 0.8, 0.15) - Padrão:
cubic-bezier(0.2, 0, 0, 1) - Padrão desacelerar:
cubic-bezier(0, 0, 0, 1) - Padrão acelerar:
cubic-bezier(0.3, 0, 1, 1)
Referência Rápida de Componentes
| Componente | Elemento Web | Variantes Principais | Categoria |
|---|---|---|---|
| Botão | md-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-button | Preenchido, Delineado, Texto, Elevado, Tonal; 5 tamanhos (PP–GG); alternar | Ações |
| Grupo de botões | md-button-group | Padrão, conectado | Ações |
| FAB estendido | md-extended-fab | Superfície, Primário, Secundário, Terciário | Ações |
| FAB | md-fab | Pequeno, Médio, Grande | Ações |
| Menu FAB | — | — | Ações |
| Botão de ícone | md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-button | Padrão, Preenchido, Preenchido Tonal, Delineado | Ações |
| Botão segmentado | — | Seleção única, Seleção múltipla | Ações |
| Botão dividido | — | — | Ações |
| Emblema | — | Pequeno (ponto), Grande (contagem) | Comunicação |
| Indicador de carregamento | — | Linear, Circular | Comunicação |
| Indicador de progresso | md-linear-progress, md-circular-progress | Linear, Circular; determinado/indeterminado | Comunicação |
| Snackbar | — | Única linha, Duas linhas, Ação | Comunicação |
| Tooltip | — | Simples, Rico | Comunicação |
| Cartão | — | Preenchido, Delineado, Elevado | Contenção |
| Carrossel | — | Navegação múltipla, Não contido, Hero | Contenção |
| Diálogo | md-dialog | Básico, Tela cheia | Contenção |
| Bottom sheet | — | Padrão, Modal | Folhas |
| Side sheet | — | Padrão, Modal | Folhas |
| Divisor | md-divider | Largura total, Recuado | Contenção |
| Caixa de seleção | md-checkbox | — | Entrada |
| Chips | md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chip | Assistir, Filtrar, Entrada, Sugestão | Entrada |
| Seletor de data | — | Acoplado, Modal, Intervalo | Entrada |
| Menu | md-menu, md-menu-item | — | Entrada |
| Botão de opção | md-radio | — | Entrada |
| Controle deslizante | md-slider | Contínuo, Discreto, Intervalo | Entrada |
| Interruptor | md-switch | Com/sem ícone | Entrada |
| Campo de texto | md-filled-text-field, md-outlined-text-field | Preenchido, Delineado | Entrada |
| Seletor de hora | — | Acoplado, Modal | Entrada |
| App bar (superior) | — | Alinhado ao centro, Pequeno, Médio, Grande | Navegação |
| Barra de navegação | md-navigation-bar | — | Navegação |
| Gaveta de navegação | md-navigation-drawer | Padrão, Modal | Navegação |
| Trilho de navegação | — | — | Navegação |
| Pesquisa | — | Barra de pesquisa, Visualização de pesquisa | Navegação |
| Abas | md-tabs, md-primary-tab, md-secondary-tab | Primário, Secundário | Navegação |
| Barra de ferramentas | — | — | Navegação |
| Lista | md-list, md-list-item | Uma linha, Duas linhas, Três linhas | Exibição de Dados |
Nota: Componentes marcados com — para o elemento web ainda não têm implementações @material/web. Use propriedades CSS customizadas com HTML padrão para estes. Os mapeamentos e exemplos Compose estão em references/component-catalog.md.
Detalhes completos dos componentes com exemplos de código: references/component-catalog.md
Jetpack Compose (primário)
Use androidx.compose.material3 com MaterialTheme e composables do Material 3 (Scaffold, Button, NavigationBar, barras de aplicativo superiores, etc.).
- Tematização:
MaterialTheme(colorScheme = …, typography = …, shapes = …). PrefiradynamicLightColorScheme/dynamicDarkColorSchemeno Android 12+ (API 31+) quando a cor dinâmica for desejada; caso contrário, uselightColorScheme/darkColorSchemeou código de tema gerado pelo Material Theme Builder. - UI Adaptativa: Classes de tamanho de janela, layouts lista-detalhe e painel de suporte, dobráveis — veja
references/layout-and-responsive.mdereferences/navigation-patterns.md. - Borda a borda e insets: Disponha o conteúdo com
WindowInsets/ preenchimento do scaffold para que as barras e o IME se comportem corretamente — vejareferences/layout-and-responsive.md. - APIs Experimentais: Algumas APIs do Material 3 exigem
@OptIn(ExperimentalMaterial3Api::class)ou opt-ins expressivos; corresponda ao seu BOM e compilador.
MaterialTheme(
colorScheme = colorScheme, // de dynamicLightColorScheme / lightColorScheme / etc.
typography = Typography(),
shapes = Shapes(),
) {
// Conteúdo M3 — prefira referências para Scaffold, navegação, campos de texto
}
Web (limitado): @material/web
Importante: De acordo com o Material Design 3 para Web, os Componentes Web do Material estão em modo de manutenção e o M3 Expressive não está implementado na Web. Use @material/web para UIs web baseadas em tokens quando apropriado, mas não o trate como equivalente ao Compose para os recursos Expressivos atuais.
Configuração
npm install @material/web
Importar Componentes Individualmente
Sempre importe apenas os componentes que você usa — importar todo o pacote incha o bundle:
// Bom — importações individuais
import '@material/web/button/filled-button.js';
import '@material/web/button/outlined-button.js';
import '@material/web/textfield/outlined-text-field.js';
import '@material/web/icon/icon.js';
// Ruim — nunca faça isso
import '@material/web'; // importa tudo
Uso Básico
<!DOCTYPE html>
<html lang="pt">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="https://fonts.googleapis.com/css2?family=Roboto+Flex:wght@400;500;700&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/icon?family=Material+Symbols+Outlined" rel="stylesheet">
</head>
<body>
<md-filled-button>Começar</md-filled-button>
<md-outlined-text-field label="Email" type="email"></md-outlined-text-field>
<script type="module">
import '@material/web/button/filled-button.js';
import '@material/web/textfield/outlined-text-field.js';
</script>
</body>
</html>