docs(theming): theming guide is missing documentation on the accent hues (A200, A100, etc)
- 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