Contrôleur de liste
-
class ITRocks\Framework\Widget\Data_List\Data_List_ControllerDescription
Il s’agit du contrôleur par défaut pour la fonctionnalité dataList,
il retourne une vue représentant la liste des objets accessibles à l’utilisateur connecté stockés dans le lien de données par défaut pour la classe à laquelle il s’applique.Usage
Exemples d’URI retournant l’affichage de la liste des utilisateurs :- /ITRocks/Framework/Users (conseillé pour respecter les conventions)
- /ITRocks/Framework/Users/dataList (version explicite)
- /ITRocks/Framework/User/dataList (déconseillé)
Le nom de la classe à indiquer pour l’appel à ce contrôleur peut être au pluriel (voir annotation de classe @set, pluriel du nom de la classe) ou au singulier.
Fonctionnalités par défaut
Le contrôleur par défaut propose de nombreuses fonctionnalités pour que l’ergonomie de votre liste soit la plus complète possible sans programmation supplémentaire :- recherche multi-colonnes,
- tri multi-colonnes,
- personnalisation par ajout/suppression de colonnes,
- personnalisation par modification du nombre de lignes de résultats : 20, 100, 200, etc. jusqu’à 1000 possibles,
- personnalisation des entêtes de colonne (double-click),
- personnalisation du nom de la liste (double-click sur l’entête de la fenêtre liste),
- liens vers les fonctionnalité usuelles sur les objets de la classe,
- liens vers des fonctionnalités sur collection d’objets de la classe,
- pagination par clic page précédente / suivante ou en utilisant la liste déroulante,
- enregistrement-rechargement de votre paramétrage de liste pour facilitation de l’accès ultérieur (disquette).
Ajouter vos fonctionnalités
Pour personnaliser une liste en bénéficiant des fonctionnalités de la liste par défaut :- créez votre classe contrôleur héritée de la classe contrôleur par défaut,
- surchargez les méthodes dont vous voulez modifier le comportement,
un cas fréquent par exemple est de surcharger getGeneralButtons ou getSelectionButtons pour rajouter vos boutons vers de nouvelles fonctionnalités.