Material Design 3
Diese Skill-Anleitung beschreibt die Implementierung von Googles Material Design 3 (MD3) – einem persönlichen, adaptiven und ausdrucksstarken Designsystem. MD3 verwendet dynamische Farben, tonale Oberflächen, abgerundete Formen und federbasierte Bewegungen, um UIs zu schaffen, die sich lebendig und persönlich anfühlen.
Philosophie
MD3 basiert auf drei Prinzipien:
- Persönlich: Dynamische Farben passen die UI an das Hintergrundbild oder den Inhalt des Benutzers an. Theming ist individuell, nicht standardisiert.
- Adaptiv: Layouts passen sich über 5 Fenstergrößenklassen an. Komponenten ändern Größe, Position und Formfaktor responsiv.
- Ausdrucksstark: Formveränderungen, Federphysik und hervorgehobene Typografie schaffen Momente der Freude, ohne die Benutzerfreundlichkeit zu beeinträchtigen.
Aktuelle Updates: Google I/O 2026
Materiels Google I/O 2026 Update bekräftigt einen Compose-first Android-Pfad und erweitert die expressive/adaptive Anleitung:
- Material Android ist Compose-first: Für neue Android-Arbeiten Jetpack Compose Material3 bevorzugen, um die neuesten Komponenten, expressiven APIs, adaptiven Gerüste und die Styles-API-Integration zu nutzen. Android Views können in bestehenden Apps weiterhin notwendig sein, sollten aber nicht als Standardpfad für neue Material 3-Implementierungen betrachtet werden.
- Expressive Layoutsystem: Verwenden Sie ein expressives Layoutgerüst, um Bildschirme über Mobilgeräte, Desktops, Foldables, Uhren, XR und andere räumliche Formfaktoren anzupassen. Beginnen Sie mit adaptiven Gerüsten/Fenstergrößenklassen anstelle von festen, handyzentrierten Layouts.
- 8dp Abstandssystem: Verwenden Sie Abstands-Tokens für Ränder, Abstände und Lücken, damit Layouts und Komponenten programmatisch an Gerätetyp und -dichte angepasst werden können.
- Neue/aktualisierte expressive Komponenten: Listen, Menüs, Suche und Such-App-Leisten haben aktualisierte expressive Anleitungen, mit Jetpack Compose als primärem Implementierungsziel.
- Uhren und XR: Uhren betonen physikbasierte Bewegung, Bogen-Texte und randumschließende Container. XR betont räumliche Panels und tiefenbasierte Höhe.
Wesentliche Unterschiede zu MD2:
- Tonale Oberflächen ersetzen Höhen-Schatten als primäres Tiefenmerkmal
- Dynamische Farben erzeugen vollständige Farbschemata aus einer einzigen Saatfarbe
- Vollständig abgerundete Ecken standardmäßig (nicht leicht abgerundet)
- Federbasierte Bewegungsphysik ersetzt feste Beschleunigungskurven für Komponenten
- 3 Stufen benutzergesteuerten Kontrasts (Standard/Mittel/Hoch)
Beziehung zur Skill-Anleitung für Frontend-Design: Wenn beide Skills aktiv sind, stellt MD3 das Designsystem (Tokens, Komponenten, Layoutregeln) und Frontend-Design liefert die kreative Richtung innerhalb dieser Grenzen. MD3-Regeln haben Vorrang für Komponentenstruktur und Token-Verwendung. Hinweis: Roboto/Roboto Flex IST die korrekte Standardschriftart in MD3 – die Anleitung des Frontend-Designs, Roboto zu vermeiden, gilt bei der Implementierung von MD3 nicht.
Entscheidungsbaum
Was bauen Sie?
Vollständiges App-Gerüst → Siehe „Häufige Muster: App-Shell" + Referenzen/layout-and-responsive.md
Einzelne Komponente → Siehe „Komponenten-Kurzreferenz"-Tabelle → Referenzen/component-catalog.md
Benutzerdefiniertes Theme → Siehe Referenzen/theming-and-dynamic-color.md
Formular-/Eingabelayout → Siehe Referenzen/component-catalog.md § Eingabekomponenten
Navigationsstruktur → Siehe Referenzen/navigation-patterns.md
Datenanzeige → Siehe Referenzen/component-catalog.md § Datenanzeige
Welche Plattform?
Jetpack Compose → Primär: androidx.compose.material3, MaterialTheme, Referenzen/*
Flutter → useMaterial3: true in ThemeData, ColorScheme.fromSeed()
Web (Vanilla JS) → @material/web (eingeschränkt; Wartungsmodus) + CSS-Custom-Properties
Web (React/Vue/Svelte) → CSS-Custom-Properties + Wrapper-Komponenten (keine offizielle React-Bibliothek)
Web (CSS-only) → MD3-Token-Werte als CSS-Custom-Properties (keine <md-*> Elemente)
Design-Token-System
Alle MD3-Tokens verwenden den Namespace md.sys. Jetpack Compose bildet Rollen auf MaterialTheme.colorScheme, MaterialTheme.typography und MaterialTheme.shapes ab (gleiche semantische Rollen wie im Spec). Im Web werden diese auf CSS-Custom-Properties (--md-sys-*) abgebildet:
Farb-Tokens (--md-sys-color-*)
| Token | Zweck |
|---|---|
primary | Hervorgehobene Füllungen, Text, Symbole auf Oberfläche |
on-primary | Text/Symbole auf primary |
primary-container | Auffällige Füllung für Schlüsselkomponenten (FAB usw.) |
on-primary-container | Text/Symbole auf primary-container |
secondary / on-secondary | Weniger auffällige Akzente |
secondary-container / on-secondary-container | Zurückhaltende Komponenten (tonale Buttons) |
tertiary / on-tertiary | Kontrastierende Akzente |
tertiary-container / on-tertiary-container | Komplementäre Container |
error / on-error | Fehlerzustände (statisch – ändert sich nicht mit dynamischer Farbe) |
error-container / on-error-container | Fehlercontainer-Füllungen |
surface | Standardhintergrund |
on-surface | Text/Symbole auf jeder Oberfläche |
on-surface-variant | Weniger hervorgehobener Text/Symbole auf Oberfläche |
surface-container-lowest | Am wenigsten hervorgehobener Container |
surface-container-low | Wenig hervorgehobener Container |
surface-container | Standardcontainer (Navigationsbereiche) |
surface-container-high | Stark hervorgehobener Container |
surface-container-highest | Am stärksten hervorgehobener Container |
surface-dim / surface-bright | Relative Helligkeit über Hell/Dunkel hinweg beibehalten |
inverse-surface / inverse-on-surface / inverse-primary | Kontrastierende Elemente (Snackbars) |
outline | Wichtige Grenzen (Textfeldränder) |
outline-variant | Dekorative Elemente (Trennlinien) |
Vollständige Details: references/color-system.md
Typografie-Tokens (--md-sys-typescale-*)
| Skalierung | Größen | Verwendung |
|---|---|---|
| Display | L / M / S | Hero-Texte, große Zahlen |
| Headline | L / M / S | Abschnittsüberschriften |
| Title | L / M / S | Kleinere Überschriften, Kartentitel |
| Body | L / M / S | Fließtext, Beschreibungen |
| Label | L / M / S | Buttons, Chips, Beschriftungen |
Jeder Stil hat Tokens für: -font, -weight, -size, -line-height, -tracking
Zusätzlich 15 hervorgehobene Varianten (höheres Gewicht) via --md-sys-typescale-emphasized-*
Vollständige Details: references/typography-and-shape.md
Form-Tokens (--md-sys-shape-corner-*)
| Token | Wert | Beispielkomponenten |
|---|---|---|
none | 0dp | — |
extra-small | 4dp | Chips, Snackbars |
small | 8dp | Textfelder, Menüs |
medium | 12dp | Karten |
large | 16dp | FABs, Navigationsschublade |
large-increased | 20dp | (Expressive) |
extra-large | 28dp | Dialoge, Bottom Sheets |
extra-large-increased | 32dp | (Expressive) |
extra-extra-large | 48dp | (Expressive) |
full | 9999px | Buttons, Chips, Badges |
Höhenstufen
| Stufe | DP | Tonale Verschiebung | Verwendung |
|---|---|---|---|
| 0 | 0dp | Keine | Flache Oberflächen, die meisten Komponenten im Ruhezustand |
| 1 | 1dp | +5% primary | Erhöhte Karten, modale Blätter |
| 2 | 3dp | +8% primary | Menüs, Navigationsleiste, gescrollte App-Leiste |
| 3 | 6dp | +11% primary | FAB, Dialoge, Suche, Datums-/Zeitauswahlen |
| 4 | 8dp | +12% primary | (nur bei Hover/Fokus erhöht) |
| 5 | 12dp | +14% primary | (nur bei Hover/Fokus erhöht) |
Höhe wird in MD3 durch tonale Oberflächenfarbe vermittelt, nicht durch Schatten. Schatten werden nur verwendet, wenn zusätzlicher Schutz vor unruhigen Hintergründen erforderlich ist.
Bewegung
MD3 Expressive (Mai 2025) führte federbasierte Bewegungsphysik für Komponenten ein. Das ältere Beschleunigungs-/Dauersystem wird weiterhin für Übergänge verwendet (Ein-/Aus-/Shared-Achse):
| Beschleunigung | Dauer | Übergangstyp |
|---|---|---|
| Emphasized | 500ms | Beginnt und endet auf dem Bildschirm |
| Emphasized decelerate | 400ms | Betritt den Bildschirm |
| Emphasized accelerate | 200ms | Verlässt den Bildschirm |
| Standard | 300ms | Beginnt und endet auf dem Bildschirm (Hilfsmittel) |
| Standard decelerate | 250ms | Betritt den Bildschirm (Hilfsmittel) |
| Standard accelerate | 200ms | Verlässt den Bildschirm (Hilfsmittel) |
CSS-Beschleunigungswerte:
- Emphasized:
cubic-bezier(0.2, 0, 0, 1) - Emphasized decelerate:
cubic-bezier(0.05, 0.7, 0.1, 1) - Emphasized accelerate:
cubic-bezier(0.3, 0, 0.8, 0.15) - Standard:
cubic-bezier(0.2, 0, 0, 1) - Standard decelerate:
cubic-bezier(0, 0, 0, 1) - Standard accelerate:
cubic-bezier(0.3, 0, 1, 1)
Komponenten-Kurzreferenz
| Komponente | Web-Element | Wichtige Varianten | Kategorie |
|---|---|---|---|
| Button | md-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-button | Gefüllt, Umrandet, Text, Erhöht, Tonal; 5 Größen (XS–XL); ein-/ausschaltbar | Aktionen |
| Button-Gruppe | md-button-group | Standard, Verbunden | Aktionen |
| Erweiterter FAB | md-extended-fab | Surface, Primary, Secondary, Tertiary | Aktionen |
| FAB | md-fab | Klein, Mittel, Groß | Aktionen |
| FAB-Menü | — | — | Aktionen |
| Symbol-Button | md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-button | Standard, Gefüllt, Gefüllt Tonal, Umrandet | Aktionen |
| Segmentierter Button | — | Einzelauswahl, Mehrfachauswahl | Aktionen |
| Split-Button | — | — | Aktionen |
| Badge | — | Klein (Punkt), Groß (Zahl) | Kommunikation |
| Ladeanzeige | — | Linear, Kreisförmig | Kommunikation |
| Fortschrittsanzeige | md-linear-progress, md-circular-progress | Linear, Kreisförmig; determiniert/unbestimmt | Kommunikation |
| Snackbar | — | Einzeilig, Zweizeilig, Aktion | Kommunikation |
| Tooltip | — | Einfach, Reichhaltig | Kommunikation |
| Karte | — | Gefüllt, Umrandet, Erhöht | Behälter |
| Karussell | — | Multi-Browse, Ohne Behälter, Hero | Behälter |
| Dialog | md-dialog | Einfach, Vollbild | Behälter |
| Bottom Sheet | — | Standard, Modal | Blätter |
| Side Sheet | — | Standard, Modal | Blätter |
| Trennlinie | md-divider | Vollbreite, Eingelassen | Behälter |
| Checkbox | md-checkbox | — | Eingabe |
| Chips | md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chip | Assist, Filter, Eingabe, Vorschlag | Eingabe |
| Datumsauswahl | — | Angedockt, Modal, Bereich | Eingabe |
| Menü | md-menu, md-menu-item | — | Eingabe |
| Radio-Button | md-radio | — | Eingabe |
| Schieberegler | md-slider | Kontinuierlich, Diskret, Bereich | Eingabe |
| Schalter | md-switch | Mit/ohne Symbol | Eingabe |
| Textfeld | md-filled-text-field, md-outlined-text-field | Gefüllt, Umrandet | Eingabe |
| Zeitauswahl | — | Angedockt, Modal | Eingabe |
| App-Leiste (oben) | — | Zentriert, Klein, Mittel, Groß | Navigation |
| Navigationsleiste | md-navigation-bar | — | Navigation |
| Navigationsschublade | md-navigation-drawer | Standard, Modal | Navigation |
| Navigationsschiene | — | — | Navigation |
| Suche | — | Suchleiste, Suchansicht | Navigation |
| Tabs | md-tabs, md-primary-tab, md-secondary-tab | Primär, Sekundär | Navigation |
| Toolbar | — | — | Navigation |
| Liste | md-list, md-list-item | Einzeilig, Zweizeilig, Dreizeilig | Datenanzeige |
Hinweis: Komponenten, die mit — für das Web-Element markiert sind, haben noch keine @material/web-Implementierungen. Verwenden Sie für diese CSS-Custom-Properties mit Standard-HTML. Compose-Zuordnungen und Beispiele finden Sie in references/component-catalog.md.
Vollständige Komponentendetails mit Codebeispielen: references/component-catalog.md
Jetpack Compose (primär)
Verwenden Sie androidx.compose.material3 mit MaterialTheme und Material 3 Composables (Scaffold, Button, NavigationBar, Top-App-Leisten usw.).
- Theming:
MaterialTheme(colorScheme = …, typography = …, shapes = …). Bevorzugen SiedynamicLightColorScheme/dynamicDarkColorSchemeauf Android 12+ (API 31+), wenn dynamische Farbe gewünscht wird; andernfallslightColorScheme/darkColorSchemeoder generierten Theme-Code aus dem Material Theme Builder. - Adaptive UI: Fenstergrößenklassen, Listendetail- und Stützpaneellayouts, Foldables – siehe
references/layout-and-responsive.mdundreferences/navigation-patterns.md. - Edge-to-edge und Einfügungen: Ordnen Sie Inhalte mit
WindowInsets/ Scaffold-Padding an, sodass Leisten und IME sich korrekt verhalten – siehereferences/layout-and-responsive.md. - Experimentelle APIs: Einige Material 3 APIs erfordern
@OptIn(ExperimentalMaterial3Api::class)oder expressive Opt-Ins; passen Sie Ihre BOM und den Compiler an.
MaterialTheme(
colorScheme = colorScheme, // von dynamicLightColorScheme / lightColorScheme usw.
typography = Typography(),
shapes = Shapes(),
) {
// M3-Inhalt – bevorzugen Sie Referenzen für Scaffold, Navigation, Textfelder
}
Web (eingeschränkt): @material/web
Wichtig: Laut Material Design 3 für Web befinden sich Material Web Components im Wartungsmodus und M3 Expressive ist nicht für das Web implementiert. Verwenden Sie @material/web für token-gestützte Web-UIs, wenn angemessen, aber behandeln Sie es nicht als gleichwertig zu Compose für aktuelle Expressive-Funktionen.
Einrichtung
npm install @material/web
Komponenten einzeln importieren
Importieren Sie immer nur die Komponenten, die Sie verwenden – das gesamte Paket zu importieren, bläht das Bundle auf:
// Gut – einzelne Importe
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';
// Schlecht – niemals so machen
import '@material/web'; // importiert alles
Grundlegende Verwendung
<!DOCTYPE html>
<html lang="de">
<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>Loslegen</md-filled-button>
<md-outlined-text-field label="E-Mail" 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>
…
[Translated content truncated – original was truncated]