angular / angular/components

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

オープン
#26,845 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る
area: theming docs P3
主要言語
TypeScript
スター
25k
フォーク
6.8k
平均マージ
1日 8時間
マージ済み PR(30日)
91

説明

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

コントリビューションガイド

コントリビューションガイドを開く

調査の方向性

material.angular.io/guide/theming にある対象の theming ガイドから始め、パレットとアクセントカラーの例を比較してください。A200、A100、A400 の色相を記載し、アクセント値が個別に宣言される理由を説明し、報告されている color-map と Sass カスタムプロパティの動作を明確にしてください。ガイドは、報告されている曖昧さなしにこれらの疑問に答えられるようにする必要があります。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
angular, sass
領域
documentation, frontend
issue の種類
ドキュメント
難易度
3/5
見積もり時間
1〜2日
活発さ
停滞
明瞭さ
おおむね明確
初心者へのやさしさ
45/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。