angular / angular/components

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

Ouverte
#29,600 1 commentaire 1 réaction 0 personnes assignées Voir sur GitHub
area: cdk/table docs P4
Langage dominant
TypeScript
Étoiles
25k
Forks
6.8k
Merge moyen
1 j 8 h
PR mergées (30 j)
91

Description

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

Guide de contribution

Ouvrir le guide de contribution

Piste de recherche

Commencez par la page de présentation du tableau CDK, en lisant la description de l’API MatRecycleRows et l’exemple de tableau qui utilise la directive recycleRows. Mettez à jour la documentation pour expliquer le rôle de la directive, son effet sur le comportement du tableau et dans quels cas elle doit être utilisée ; le travail est terminé lorsqu’une personne débutante peut comprendre si elle s’applique à son scénario.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
angular
Domaine
documentation
Type d'issue
Documentation
Difficulté
2/5
Temps estimé
1-3 heures
Activité
À l'abandon
Clarté
À clarifier
Accessibilité débutants
45/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.