angular / angular/components

docs(theming): theming guide is missing documentation on the accent hues (A200, A100, etc)

Ouverte
#26,845 0 commentaires 0 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

In your documentation when you talk about "palette" you say "These identifier numbers include 50, and then each 100 value between 100 and 900" and you give an example.
50: #e8eaf6,
100: #c5cae9,
200: #9fa8da,
300: #7986cb,
// ... continues to 900
contrast: (
50: rgba(black, 0.87),
100: rgba(black, 0.87),
200: rgba(black, 0.87),
300: white,
// ... continues to 900
)
);

But later when you talk about theme when you define the primary color OK no problem because you are using a value consistent with your declaration in the palette ($my-primary: mat.define-palette(mat.$indigo-palette, 500)).
But for the accent color there is a problem because the values ​​no longer match your palette declaration (define-palette(mat.$pink-palette, A200, A100, A400)) -> what about A200, A100, A400 ?

Moreover why you need to declare in each palette "accent" values if in you theme you declare an accent color with all the hues from 50 to 900 ?

This problem has consequences in the code if you want to manage the light and dark theme with the "new" declaration model (with color in the map).
If you declare a palette without Axxx and try to inject it in the map at the 'color'/'background'
level you obtain "color: null is not a color" error.
Moreover you can't use SASS custom properties "var(--xxxxxx)" in the palette to manage foreground and bacground !!

### Affected documentation page

https://material.angular.io/guide/theming

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Commencez par le guide de theming concerné à l’adresse material.angular.io/guide/theming et comparez ses exemples de palettes et de couleurs d’accentuation. Documentez les teintes A200, A100 et A400, expliquez pourquoi les valeurs d’accentuation sont déclarées séparément et clarifiez le comportement signalé des mappages de couleurs et des propriétés personnalisées Sass ; le guide devrait répondre à ces questions sans l’ambiguïté signalée.

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

Évaluation

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

Recevez les nouvelles issues par e-mail

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