angular / angular/components

docs-bug(core): Missing documentation about elevation since v19.1

Đang mở
#30,918 3 bình luận 2 reaction 0 người được giao Xem trên GitHub
area: material/core 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 v18, we had https://v18.material.angular.io/guide/elevation that documented in depth what is, and how to use, elevations in Material.

Since 5753ce24a3e3bf743a9fc9f471eff46b85a7817b, and v19.1 that content is declared to have been moved to https://material.angular.io/guide/theming. However that new page does not even include the term "elevation" at all. So we cannot even know whether classes such as `mat-elevation-z2` are still supported, and even less how to make them work (via `@include mat.elevation-classes();`).

If this is something that has been deprecated (which does not seems to be the case when reading code), then it should at least be mentioned as such. Otherwise the original documentation should be restored.

Would you accept a PR that restore previous documentation, but included on the new https://material.angular.io/guide/theming ?

### Affected documentation page

https://v18.material.angular.io/guide/elevation

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

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

Hướng nghiên cứu

Bắt đầu bằng cách so sánh hướng dẫn về elevation của v18 với trang theming hiện tại, sau đó kiểm tra thay đổi tài liệu được tham chiếu và các đường dẫn mã cho các lớp elevation cũng như mixin mat.elevation-classes(). Công việc được xem là hoàn tất khi tài liệu theming giải thích hỗ trợ elevation hiện tại và cách sử dụng, hoặc ghi rõ việc tính năng này đã bị deprecated, đồng thời cập nhật trang bị ảnh hưởng cho phù hợp.

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
Lĩnh vực
documentation
Loại issue
Tài liệu
Độ khó
2/5
Thời gian dự kiến
1-3 giờ
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
35/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.