Contrairement à ce que l'on peut trouver dans esup-commons V1 les tags <e: développés spécifiquement pour esup-commons ont été supprimé au profit de l'utilisation de librairies standard.

La pagination des données (e:paginator)

Image Added

Exemple d'utilisation de la balise e:paginator.

<h:panelGroup>
  <e:paginator id="thingPaginator"
    paginator="#{thingsController.paginator}"
    itemsName="#{msgs['THINGS']}"
    onchange="javascript:{simulateLinkClick('thingsForm:submitPageSize');}" />
 <e:commandButton id="submitPageSize"
	action="#{thingsController.paginator.forceReload}" />
</h:panelGroup>

Définition des attributs :

• id : Permet de définir l'identifiant du paginator.
• paginator : Attribut obligatoire, une epression EL qui pointe le paginateur (objet implémentant l'interface Paginator).
• itemsName : Indique le nom des items affichés. Correspond à 'Choses' dans l'image ci-dessus.
• styleClass : Permet de définir la classe CSS. Par défaut, la classe CSS est positionnée par le bean tagsConfigurator.
• visibleBlocks : Le paginateur est composé de 3 blocs : itemsNumbers, navigation, itemsPerPage. Cette attribut permet de définir quels blocks doivent être visible. Il faut indiquer le nom des blocs séparés par un virgules sans espace (L'ordre d'écriture des blocs est important). Par défaut les 3 blocs sont visibles.
• onchange : Le blocks itemsPerPage contient une liste déroulante permettant de définir la taille des pages. Cette attribut surcharge l'attribut onChange de cette liste déroulante. Dans l'exemple ci-dessus, à chaque changement de la taille de page, on simule un clique du bouton submitPageSize qui recharge le paginateur.

La balise e:paginator ne gère pas l'affichage des données. Elle s'occupe de la gestion des pages (voir la page 04 Pagination pour l'utilisation d'un paginateur dans une page JSF).

Configuration dynamique des balises

Le fichier /properties/tags/tags.xml doit déclarer un bean nommé tagsConfigurator, qui doit implémenter l'interface TagsConfigurator.

Les valeurs par défaut de ce bean suivent les recommandations de http://www.ja-sig.org/wiki/display/UPC/JSR-168+PLT.C+CSS+Style+Definitions+section. On se réfèrera au fichier d'exemple /properties/tags/tags-example.xml pour plus de détails.

...