Cette contribution est une modification de la pagination
Elle permet, quand on a un nombre important de pages, de ne pas afficher toutes les liens (ce qui peut rapidement devenir encombrant) mais seulement un nombre définit de liens avant et après le numéro de la page courante, et une petite zone de saisie pemettant à l’utilisateur d’entrer directement un numéro de page.
un affichage typique est alors :
4 | 5 | 6 | 7 | 8 __ / 25
vous pouvez la voir fonctionner dans le sommaire de remue.net.
Par rapport à la version originale :
- la possibilité de configurer l’affichage des numéros de page a été allégé (on n’affiche désormais pour chaque lien que le numéro de la page en chiffre arabe) car si on veut que l’utilisateur entre le numéro de la page au clavier on ne va pas par exemple afficher les numéros de page en chiffres romain ou en toutes lettres, par conséquent le troisième paramètre de la fonction ainsi que pagination_item_avant
et pagination_item_apres
sont donc désormais caducs
- j’ai ajouté
- un paramètre à la fonction qui est le nombre de liens à afficher avant et après la page courante (c’est désormais le troisième paramètre qui remplace le nom de fontion), valeur par défaut : 2
- deux paramètres
-
$pagination_separateur_nombre
qui définit la chaine entre la suite de liens et la zone de saisie, valeur par défaut
-
$pagination_separateur_proportion
qui définit la chaine entre la zone de saisie et le nombre total de pages, valeur par défaut /
-
Comme cet ajout contient un formulaire de saisie, il nous faut ajouter un peu de code pour vérifier que la valeur que l’utilisateur a entré est valide, ce qui est réalisé par un peu de javascript, la contribution se compose donc de deux parties :
- une mise à jour de la fonction pagination
- un peu de code javascript : celui-ci doit être ajouté dans le header
du squelette qui intègre la boucle de pagination
La nouvelle fontion :
/*
* +----------------------------------+
* Nom du Filtre : pagination
* +----------------------------------+
* Date : dimanche 22 août 2004
* Auteur : James (klike<at>free.fr)
* Modification : Julien Kirch (j.kirch-ext<at>laposte.net)
* +-------------------------------------+
* Fonctions de ce filtre :
* affiche la liste des pages d'une boucle contenant
* un critère de limite du type {debut_xxx, yyy}
* +-------------------------------------+
*
* Pour toute suggestion, remarque, proposition d'ajout
* reportez-vous au forum de l'article :
* http://www.uzine.net/spip_contrib/article.php3?id_article=663
*/
function pagination_avancee($total, $position=0, $pas=1, $nbLiens=2){
global $clean_link;
global $pagination_separateur, $pagination_separateur_nombre, $pagination_separateur_proportion;
tester_variable('pagination_separateur', ' | ');
tester_variable('pagination_separateur_nombre', ' ');
tester_variable('pagination_separateur_proportion', ' / ');
if (ereg('^debut([-_a-zA-Z0-9]+)$', $position, $match)) {
$debut_lim = "debut".$match[1];
$position = intval($GLOBALS['HTTP_GET_VARS'][$debut_lim]);
}
$nombre_pages = floor( ($total-1)/$pas)+1;
$texte = "<form name='pagination' method='post' action='Javascript:saut()'>";
$texte.="<input name='nombrePages' type='hidden' value='".$nombre_pages."' />";
$texte.="<input name='pas' type='hidden' value='".$pas."' />";
$clean_link->delVar($debut_lim);
$texte.="<input name='prefixeAdresse' type='hidden' value='".$clean_link->getUrl()."?".$debut_lim."='/>";
$indicePageCourante = $position / $pas;
if($nombre_pages > 1) {
$i = 0;
while( $i < $nombre_pages ) {
$clean_link->delVar($debut_lim);
$clean_link->addVar($debut_lim, strval($i*$pas));
$url = $clean_link->getUrl();
if( abs($i - $indicePageCourante) <= $nbLiens ) {
$item = strval($i+1);
if($i != $indicePageCourante) {
$item = "<a href=\"".$url."\">".$item."</a>";
}
$texte.= $item;
if( ( $i < ($nombre_pages-1) ) && ( $i < ($indicePageCourante + $nbLiens ) ) ) {
$texte .= $pagination_separateur;
}
}
$i++;
}
$texte.= $pagination_separateur_nombre;
$texte.= "<input name='noPage' value='".( $indicePageCourante + 1 )."' size=1 onclick='javascript:paginationReset()' />";
$texte.= $pagination_separateur_proportion.$nombre_pages."</form>";
//Correction bug: $clean_link doit revenir à son état initial
$clean_link->delVar($debut_lim);
if($position) $clean_link->addVar($debut_lim, $position);
return $texte;
}
return '';
}
// FIN du Filtre pagination
Le code javascript
<script type="text/javascript" language="JavaScript">
/*
* Code pour le filtrage
*/
var paginationReseted = false;
function paginationReset() {
if( ! paginationReseted ) {
document.pagination.noPage.value = "";
paginationReseted = true;
}
}
function saut() {
var indiceString = document.pagination.noPage.value;
var indice = parseInt(indiceString);
var indiceMaximum = document.pagination.nombrePages.value;
if( (indice != ""[->NaN]"") && ( indice >= 1 ) && ( indice <= indiceMaximum ) ){
var pas = parseInt(document.pagination.pas.value);
var prefixeAdresse = document.pagination.prefixeAdresse.value
var adresse=prefixeAdresse + ( pas * ( indice - 1 ) );
window.location.href = adresse;
}
}
// fin code pour le filtrage
</script>
Les utilisateurs de la 1.8 peuvent ensuite faire un tour sur BalisePagination.
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |