blog actif depuis 774 jours.

retours d'expériences, codes sources, réflexions, humeurs... d'un webmaster

Dim.

Sept.

Classe d'affichage de listes

Voici une classe pour l'affichage de listes à partir de résultats de requêtes sur une base de données.
Elle permet notamment :
- le tri par colonne
- la pagination
Le contenu des cellules est entièrement paramétrable : vous pouvez afficher plusieurs champs dans une même cellule et vous pouvez utiliser des fonctions complexes pour générer le contenu d'une cellule.
Enfin, la liste est mise en forme entièrement par CSS.

Voici donc un exemple d'utilisation de la classe : l'affichage de la liste des départements de France à partir d'infos contenus dans une table 'departements'. La requête exécutée est la suivante :
SELECT SQL_CALC_FOUND_ROWS code_departement, nom_departement,
nom_chef_lieu, nombre_arrondissements, nombre_communes FROM departements

Instantiation et paramètres de la classe :

$obj_liste = new classe_liste();
$obj_liste->setPas(10);                  // nombre de lignes affichées par page
$obj_liste->setNbPagesNavig(5);  // nombre de pages affichées dans la pagination

Passage des données à la classe

Le premier traitement consiste à transformer le résultat de la requête en un tableau exploitable par la classe, grâce à la fonction PHP mysql_fetch_array().
Le tableau ainsi créé est passé à la classe :

$obj_liste->setDatas($datas);

Ajout des colonnes

On ajoute les colonnes une à une à l'aide de la méthode addColonne, qui reçoit comme arguments : le nom du champ, le libellé de l'entête de colonne (<th>) et un troisieme argument optionnel qui est le contenu des cellules (<td>) de chaque ligne de résultat pour cette colonne :
- contenu formaté
- si ce dernier n'est pas précisé, la cellule contiendra le résultat de la requête
- s'il est vide, la cellule sera vide

ainsi pour afficher simplement les 4 colonnes nom_departement, nom_chef_lieu, nombre_arrondissements et nombre_communes :

$obj_liste->addColonne("nom_departement","D&eacute;partement");
$obj_liste->addColonne("nom_chef_lieu","Chef-lieu");
$obj_liste->addColonne("nombre_arrondissements","Nombre d'arrond.");
$obj_liste->addColonne("nombre_communes","Nombre de communes");

Maintenant, on va ajouter le numéro de département et un lien sur le nom du département vers la page wikipedia correspondante sur la colonne nom_departement :

$obj_liste->addColonne("nom_departement","D&eacute;partement","[code_departement] - <a href="http://fr.wikipedia.org/wiki/[nom_departement]_(d&eacute;partement)" target="_blank">[nom_departement]</a>");

Le troisième argument contient le format de la chaine à retourner. Les valeurs dynamiques remplaceront les champs placés entre crochets. ainsi [nom_departement] sera remplacé à chaque ligne par le résultat de la requête correspondant.

Ajout de contenu

Vous pouvez ajouter du contenu à votre colonne à l'aide de la methode $obj_liste->addContenu();

Traitement du contenu à l'aide de fonctions complexes

Pour ajouter du contenu, utilisez la méthode addContenuFonction(), qui reçoit 2 arguments : le nom de la colonne et la fonction à passer, avec ses arguments.

Par exemple, j'ajoute une colonne blason avec l'image correspondante (le nom de l'image étant de la forme "nom_du_departement.png"). Cette colonne ne doit pas être triée. Un traitement est nécessaire pour récupérer le nom de l'image à partie du nom du département (suppression des accents, remplacement des "-", " " et ' par "_", ...).

Je crée donc un fonction que j'appelle getBlason(nom_departement) qui
s'occupe de ce traitement. Dans la classe liste, cela se traduit par :

$obj_liste->addColonne("blason","Blason","");
$obj_liste->addContenuFonction("blason","getBlason([nom_departement]);");
$obj_liste->noTri();

Mise en forme

Le tableau est entièrement mis en forme par du CSS.
Les différents éléments de la liste sont accessibles par leur id, construit à partir du nom de colonne.
Ainsi, l'entête de la colonne 'nom_département' est nommé th_nom_departement.

Tri et pagination

L'affichage de la navigation se fait par la méthode suivante :

$obj_liste->afficheNavig();

Le tri se fait en cliquant sur les entêtes de colonnes. Les paramètres de tri sont mis en session, dans le tableau $_SESSION['classe liste'](pareil pour les éléments de pagination) :

[classe_liste] => Array
    (
        [pas] => 10
        [min] => 0
        [ord] => nom_departement
        [sens] => Array
            (
                [nom_departement] => ASC
            )
            [page] => 1
    )

Ces valeurs sont donc à prendre en compte dans la construction de la requête SQL.

Pour télécharger la classe et le code source de l'exemple, rendez vous sur l'espace téléchargement

Commentaires

Ce code fonctionne à merveille, Merci !
Une idée pour paramétrer l'affichage par rapport au tableau : au dessus , en dessous ou les deux ?

29/09/2009

C'est fait :
- $obj_liste->afficheNavig() positionne la navigation en haut et en bas
- $obj_liste->afficheNavig("bas") positionne la navigation en bas
- $obj_liste->afficheNavig("haut") positionne la navigation en haut

29/09/2009

Merci beaucoup, très bonne utilisation de la fonction SQL_CALC_FOUND_ROWS, le côté serveur vous dit merci infiniement.

01/10/2009

Tout simplement MAGNIFIQUE !!!
Un grand MERCI pour ce partage, je retourne étudier ton code de suite ;)

07/10/2009

Salut,
Attention dans l'utilisation deSQL_CALC_FOUND_ROWS apparemment tout le monde n'est pas d'accord sur les gains de performance.
lire http://www.mysqlperformanceblog.com/2007/08/28/to-sql_calc_found_rows-or-not-to-sql_calc_found_rows/

Une fois de plus tout dépend du contexte.

25/11/2009

bien vu mrbinr, très intéressant cet article.
va falloir que je teste ça de plus près, avec/sans index, en utilisant les procédures stockées...

25/11/2009

Bonjour , 1* je vous remercie infiniment pour le code ;c'est magnifique .
2* j'ai un souci les numéro de page ne s'affiche pas mais lorsque je tape dans url page=1 ou 2 il par vers 'autre page ??

20/01/2010

Bonjour aaa.
l'affichage des liens de navigation se fait avec la méthode $obj_liste->afficheNavig();

21/01/2010

Bonjour,
Tout d'abord je tenais à te remercier pour ton travail de très grande qualité. Tu m'as fait gagné des heures et des heures de travail et je t'en remercie.
Juste un petit bémol, car ta classe n'est pas totalement compatible avec tous les SGBD qui par exemple n'accepte pas la fonction LIMIT.
Bonne journée.
Cordialement,
robertjul

27/01/2010

Bonjour robertjul
tu as raison, la fonction LIMIT n'est pas une fonction SQL ANSI, elle est propre à MySQL.
Cependant la classe liste est totalement indépendante d'un SGDB. Elle ne fait qu'afficher une liste d'éléments. Dans mon exemple, je récupère les éléments (départements) stockés dans une base MySQL, mais cette sélection se fait en amont. On aurait tout aussi bien pu passer un tableau PHP.

27/01/2010

Bonjour,
Encore merci pour ta réponse.
J'ai encore deux questions si possible :
-es-il possible de mettre le contenu d'une colonne si une condition est vrai ?
-Comment ferais-tu pour faire fonctionner la pagination sans la fonction LIMIT.
Bonne fin de journée.
Cordialement,
robertjul

01/02/2010

1 - oui, en passant par la méthode addContenuFonction : tu crées une fonction qui retourne le champ si ta condition est vérifiée dans cette fonction, sinon un espace
2 - ça dépend de ton SGDB, faut voir dans les fonctions propres au SGDB utilisé

02/02/2010

Bonjour,
Encore merci pour ta réponse rapide, précise et clair. J'en suis ravi!
1-Merci beaucoup pour l'indication, j'ai en effet oublié de regarder de se côté. Néanmoins, j'ai résolu mon souci se qui m'a permis de beaucoup mieux comprendre ton code.
2-Le SGBD que j'utilise est SQLserveur (parce que j'ai pas le choix^^)
Cordialement,
robertjul

02/02/2010

Bonjour,
Comment faut-il que je paramètre pour avoir:
- par page, 20 lignes
- la barre de navigation tient compte de tous les enregistrements
J'ai essayé mais je n'arrive pas car le processus ne prend pas tous les enregistrements.

Merci pour la réponse

10/03/2010

Bonjour Carquois
pour avoir 20 lignes par page, on utilise : $obj_liste->setPas(20);
qui va inialiser les variables de session 'min' et 'pas' que l'on utilisera dans le LIMIT de la requête :
" LIMIT ".$_SESSION['classe_liste']['min'].",".$_SESSION['classe_liste']['pas'];

10/03/2010

salut et merci pour ton code. juste une petite précision, est-ce que systèmatiquement le nom de la première colonne ne permet pas de faire un tri, etc, sur elle (comme le fait blason). Deuxièmement, j'ai un décalage entre les TH et les colonnes est-ce normal? merci

17/03/2010

Bonjour Wad
On peut bien sur faire un tri sur la première colonne. Dans l'exemple le tri est désactivé.
La taille des th et td est réglable dans le CSS.

17/03/2010

Merci. Excellente la classe, c'est pile ce qui me fallait, le seule petit problème que j'ai c'est au niveau validation W3C mais je vais m'en sortir. Sinon tu souhaites que je laisse ton nom dans le code?
PS: il fera parti d'un projet dans un cadre scolaire donc pas de "diffusion" sur internet...
Cordialement et encore merci.

17/03/2010

bonjour wad
effectivement, un peu de pub, ça serait sympa.
merci à toi

17/03/2010

Bonjour.
Je ne sais pas si tu l'as remarqué, mais étant donné que des variables de $_SESSION sont utilisées pour stocker les informations relatives au tri et à la pagination, l'affichage de plusieurs liste sur la même page cause des "bug" (du genre quand on classe un tableau, ils sont tous classés, ou quand on passe sur une page suivante sur un tableau, ça les modifie tous et si certain n'ont pas d'info ça renvoie pas de données)...

20/03/2010

Bonjour wad
Je sais, c'est un problème qui est corrigé dans la prochaine version, qui permettra d'afficher plusieurs listes.
J'essaie de mettre cette version en ligne rapidement, elle intègrera entre autre, la possibilité d'exporter les listes en CSV, XLS...
en intégrant phpExcel.
Et désolé pour le temps de réponse, la semaine a été chargée.

28/03/2010

Bonjour Romualb,
tout d'abord merci pour ce code, c'est vraiment très bon, j'ai simplement un problème:
lorsque j'essaye de faire des requètes sur plusieurs tables cela ne fonctionne plus,
je crois que c'est du aux points, exemple:
SELECT sortie.reference , reassort.date_de_livraison
FROM sortie, reassort

dans ce cas je crois que le point est mal interprété par ton code et fait partie des signes qui servent à différencier les champs de ma table

mes connaissances en php sont trop limitées pour comprendre l'intégralité de ton code

est ce que tu pourrais m'éclairer sur ce sujet, merci de ton aide!

02/04/2010

Bonjour Léo
les résultats retournés par mysql ne contiennent pas les noms des tables, il faut juste indiquer les noms des champs (reference et date_de_livraison). Si tu as des champs de même nom dans les 2 tables, il faut les renommer (SELECT table.champ AS champ1, table2.champ AS champ2 FROM table, table2).

02/04/2010

Merci génial, pour info j'ai modifié ton code en faisant de ta fonction une fonction à plusieurs variables:

tableauRequete ( $table, $champsrequete, $alias, $libeles, $where )
et en sortant le include class... de la fonction

je te le conseille c'est plus rapide à réutiliser, et j'attends avec impatience la version avec plusieurs affichages,
je l'ai fait en faisant (entre autres manipulations) supprimer les variables de session entre les tableaux, du coup seul le premier peut être trié...
Bon courage thx

06/04/2010

Bonjour,
Merci beaucoup pour cette classe, elle fonctionne niquel.
J'ai juste un petit problème j'aimerai mettre une checkbox dans une colonne comme si dessous

Ce qui me retourne une erreur a cause de name="tableau[]"

Aurais-tu une idée de la solution à mon problème ?

Encore merci pour cette classe et bonne continuation.

20/07/2010

@Lowlo : effectivement, c'est pas prévu mais ça peut être intéressant... je regarde ça et je te tiens au courant par mail

21/07/2010

J'ai trouvé la solution pour ce problème.

Il faut juste mettre un espace entre les deux [] et ca passe.

Encore merci pour ce joli code.

21/07/2010

merci à toi pour l'info

21/07/2010

Ajouter un commentaire

Webmaster depuis maintenant plus de 10 ans, j'ai créé ce blog pour publier mes retours d'expérience et parler du Web et du développement Web en général, mais aussi de plein d'autres choses...

romualb.com est sur Facebook

Petitchevalroux - les notes d'un dev php mysql
CERDAN Yohann - Blog d'un développeur PHP/TYPO3 http://www.ycerdan.fr/
LyRiXx Blog
Développeur Web à Grenoble

Paperblog : Les meilleurs actualités issues des blogs

Web Developement Blogs - BlogCatalog Blog Directory