angular / angular/components

docs-bug(Typography): It isn't clear how to customise Material 3 typography

Offen
#29,214 19 Kommentare 34 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
area: theming docs P3
Vorherrschende Sprache
TypeScript
Sterne
25k
Forks
6.8k
Ø Merge
1 T. 8 Std.
Gemergte PRs (30 T.)
91

Beschreibung

### Documentation Feedback

Material 2 docs were pretty clear about how to customise typography.

```
@use '@angular/material' as mat;

$my-custom-level: mat.m2-define-typography-level(
$font-family: Roboto,
$font-weight: 400,
$font-size: 1rem,
$line-height: 1,
$letter-spacing: normal,
);

$my-custom-typography-config: mat.m2-define-typography-config(
$headline-1: mat.m2-define-typography-level(112px, 112px, 300, $letter-spacing: -0.05em),
$headline-2: mat.m2-define-typography-level(56px, 56px, 400, $letter-spacing: -0.02em),
$headline-3: mat.m2-define-typography-level(45px, 48px, 400, $letter-spacing: -0.005em),
$headline-4: mat.m2-define-typography-level(34px, 40px, 400),
$headline-5: mat.m2-define-typography-level(24px, 32px, 400),
// ...
);
```

The current page called "Customizing Typography" doesn't have an information on how to customise it at all. It describes the usage only.

Migration guide isn't answering this question as well (https://material.angular.io/guide/material-2-theming#how-to-migrate-an-app-from-material-2-to-material-3).

### Affected documentation page

https://material.angular.io/guide/theming#customizing-your-typography

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginne mit dem betroffenen Abschnitt „Customizing Your Typography“ im Theming-Leitfaden und vergleiche ihn mit dem im Issue verlinkten Migrationsleitfaden für Material 2. Dokumentiere, wie die Typografie von Material 3 angepasst werden kann, einschließlich des im Bericht gezeigten Sass-Konfigurationsansatzes, und stelle sicher, dass die Seite die Frage zur Anpassung beantwortet, anstatt nur die Verwendung zu beschreiben.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
sass
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
38/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.