angular / angular/components

docs-bug(COMPONENT): Insufficient documentation of MatRecycleRows directive

Đang mở
#29,600 1 bình luận 1 reaction 0 người được giao Xem trên GitHub
area: cdk/table docs P4
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

There is *some* documentation on MatRecycleRows:
- In the api section we find the following description of MatRecycleRows: "Enables the recycle view repeater strategy"
- In the examples we find a "Table that uses the recycle view repeater strategy." example. But in the example we only see the standard example code with the extra directive 'recycleRows'. It is not clear at all what is the impact of the directive.

Nowhere in the docs I find what exactly is the purpose of this directive; in what scenarios I should use this. I have the *impression* you should use this when implementing infinite scroll, but I am not sure at all.

### Affected documentation page

https://material.angular.io/cdk/table/overview

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

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

Hướng nghiên cứu

Bắt đầu từ trang tổng quan về bảng CDK, đọc mô tả API MatRecycleRows và ví dụ về bảng sử dụng directive recycleRows. Cập nhật tài liệu để giải thích mục đích của directive, ảnh hưởng của nó đến hành vi của bảng và khi nào nên sử dụng; công việc được hoàn thành khi một người mới có thể hiểu liệu nó có áp dụng cho trường hợp của họ hay không.

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
Cần làm rõ
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.