angular / angular/components

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

Đang mở
#26,845 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
area: theming docs P3
Ngôn ngữ chính
TypeScript
Star
25k
Fork
6.8k
Merge trung bình
1 ngày 8 giờ
Pull request đã merge (30 ngày)
91

Mô tả

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

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Hướng nghiên cứu

Bắt đầu với hướng dẫn theming bị ảnh hưởng tại material.angular.io/guide/theming và so sánh các ví dụ về palette và màu nhấn trong đó. Ghi lại các sắc độ A200, A100 và A400, giải thích lý do các giá trị màu nhấn được khai báo riêng biệt, đồng thời làm rõ hành vi được báo cáo của color-map và custom property của Sass; hướng dẫn phải trả lời được các câu hỏi này mà không còn sự mơ hồ đã được báo cáo.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
angular, sass
Lĩnh vực
documentation, frontend
Loại issue
Tài liệu
Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức độ hoạt động
Đình trệ
Độ rõ ràng
Khá rõ ràng
Mức phù hợp với người mới
45/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.