angular / angular/components

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

Ouverte
#29,214 19 commentaires 34 réactions 0 personnes assignées Voir sur GitHub
area: theming docs P3
Langage dominant
TypeScript
Étoiles
25k
Forks
6.8k
Merge moyen
1 j 8 h
PR mergées (30 j)
91

Description

### 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

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Commencez par la section concernée « Customizing Your Typography » du guide de theming et comparez-la avec le guide de migration Material 2 vers lequel l’issue contient un lien. Documentez comment la typographie de Material 3 peut être personnalisée, y compris l’approche de configuration Sass présentée dans le rapport, et assurez-vous que la page répond à la question de la personnalisation au lieu de se contenter de décrire l’utilisation.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
sass
Domaine
documentation
Type d'issue
Documentation
Difficulté
3/5
Temps estimé
1-2 jours
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
38/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.