PaginationAvancee

All contributions published for previous SPIP versions

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', '&nbsp;| ');
  tester_variable('pagination_separateur_nombre', '&nbsp;&nbsp;&nbsp;&nbsp; ');
  tester_variable('pagination_separateur_proportion', '&nbsp;/&nbsp; ');
  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.

updated on 4 March 2007

Discussion

Aucune discussion

Comment on this article

Who are you?
  • [Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom