27/11/2006 |
Pour gérer l'affichage de listes d'enregistrements contenus dans une base de données, Joomla propose la classe mosPageNav. Celle-ci permet de définir des bornes, les limites entre lesquelles les résultats d'une requête sur la base de données seront affichés.
Les attributs :
Un objet de la classe mosPageNav est défini par 3 valeurs :
* $total : le nombre total d'enregistrements retournés par la requête,
* $limitstart : le nombre d'enregistrements à partir duquel commencer l'affichage,
* $limit : le nombre d'enregistrements à afficher.
Les méthodes :
La fonction writeLimitBox va permettre de modifier le nombre de lignes à afficher. A l'écran, on disposera d'une selectlist dans laquelle il suffira de choisir une nouvelle valeur. On modifiera ainsi le contenu de la variable $limit.
La fonction writePagesCounter permet d'afficher les numéros des enregistrements alors à l'écran.
ex : Résultats 1 - 10 de 54
La fonction writeLeafsCounter ressemble beaucoup à la méthode précédente, sauf qu'elle ne permet plus d'indiquer les numéros d'enregistrements, mais les numéros de page.
La fonction writePagesLinks affiche la liste des numéros de page, sous forme de liens, mais aussi des liens vers les pages précédente et suivante, ainsi que vers la première et la dernière page.
Remarque :
La longueur par défaut des listes se définit dans la configuration globale du site. On récupère ensuite cette valeur avec la variable globale $mosConfig_list_limit. |