Ce widget ajoute une pagination. Il est utilisé en parralèle avec un widgettable
Hérite de WidgetBase.
Fonction
Rendu
Utilisation
Ce composant sert à afficher une pagination, généralement sous un widget Table.
Il y a deux façons de gérer la pagination :
- Côté serveur : La pagination est faite dès la requête en base de données. A chaque changement de page, une nouvelle requête est lancée pour obtenir le contenu de la page suivante. C’est le choix conseillé dans la pluspart des cas.
- Côté client : La première requête va chercher tous les résultats. A chaque changement de page, il n’y a pas de nouvelle requête. C’est le navigateur de l’utilisateur qui fait le travail. Ce choix est généralement déconseillé parce que la première requête peut être longue en cas de forte volumétrie.
La pagination côté serveur
Le dataquery doit utiliser les attributs begin
et range
:
- Le
begin
doit être égal à0
sous peine de dysfonctionnement. - Le
range
détermine le nombre de résultat par page.
Dans le paginator, on se contente alors de cibler le dataquery concerné :
La pagination côté client
Le dataquery ne doit pas utiliser les attributs begin
et range
puisque la requête doit récupérer tous les résultats.
Dans ce cas, il faut :
- ajouter les options
begin
etrange
dans le widget Table. - utiliser l’option
widgetTable
dans le paginator pour cibler le widget Table par sonid
.
Attributs
Les attributs nécessaires au bon fonctionnement du widget sont signalés par un astérisque.
Ce widget hérite de fonctionnalités issues d’un autre widget. Consultez la documentation dédiée au WidgetBase pour vérifier si d’autres attributs sont disponibles.
data_set*
Indique quel dataset paginer
-
Version : >=2.15
-
Valeurs possibles : String
Options
Les options nécessaires au bon fonctionnement du widget sont signalées par un astérisque.
Ce widget hérite de fonctionnalités issues d’un autre widget. Consultez la documentation dédiée au WidgetBase pour vérifier si d’autres options sont disponibles.