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