FreeMarker pagination macros

Posted on by

I couldn’t find a good set of macros to help navigate through paginated data so I wrote my own. The macro names echo the names of the CakePHP PaginationHelper functions because…well, they’re reasonably sensible.

The macros expect you to add a model attribute called “paginationData” which contains (at least) the following properties:

pageNumber -> The current page number
pageSize -> The number of items in each page
pagesAvailable -> The total number of pages
sortDirection -> The sorting direction (ascending or descending)
sortField -> The field currently sorted by

In my implementation, my paginationData also contains a property called “pageItems” – the actual items in this page.

The macros available to you are:

  • first
    Outputs a link to the first page
  • last
    Outputs a link to the last page
  • next
    Outputs a link to the next page
  • previous
    Outputs a link to the previous page
  • numbers
    Outputs links to other pages. The macro takes a parameter called “maxPages”, which is the maximum number of pages that should be output. There is also a second parameter “separator”, which is the text/html that should be output between each page link.
  • page
    Outputs a link to a particular page. It takes the page number and link text as parameters. If you omit the link text it’ll default to the page number
  • counter
    Outputs the current page number and the total pages e.g. “1 of 20″
  • sort
    Outputs a link to sort by a field. Takes the field to sort by as its first parameter. If field is different to the current sort field, the link will change the sort field but not the sort direction. If the field is the same as the current sort field, the link will change the sort direction. The second parameter is the link text, which defaults to the field name with an upper case first letter. It also takes a parameter called “directions”. This is an an array of two items: the words being used in paginationData.sortDirection to describe the sorting direction of ascending or descending. Default: ["Asc", "Desc"]. So it can compare the current sorting direction and switch to the converse.

Note, ordinarily you’ll probably not need to use the “page” macro.

How to use

In Java, add a model attribute “paginationData” containing the properties I’ve described above. Then, in your view, import the library:

    <#import "pagination.ftl" as pagination />

Call the macros:

    <nav style="float:right;">
        <@pagination.first />
        <@pagination.previous />
        <@pagination.numbers />
        <@pagination.next />
        <@pagination.last />
    </nav>
    <@pagination.counter />

Which’ll give you something like:

For table headings that allow sorting:

    <table>
        <tr>
            <th><@pagination.sort "forename" /></th>
            <th><@pagination.sort "surname" /></th>
            <th><@pagination.sort "email" /></th>
            <th><@pagination.sort "created" "Registration date" /></th>
        </tr>
        ...
    </table>

Download

You can download the pagination macros here.

3,728 thoughts on “FreeMarker pagination macros”

  11. martingale strategie sportwetten

    Feel free to visit my blog post – basketball wetten gerade ungerade (Keith)

  45. Breastt cncer awareness octBaby flat head aasian cultureSexxy bloonde piicture galleriesVagia prolapseSouthern teesns suck64bit micrfosoft xpp marrket penetrationFree live fuuck weeb camLookk good naked gokViviff harrisson tackle vintageDoly parton likngerie picturesStories
    oof oral sexFoood forr breast feedding motherTeenss abusin rx drugsFrree lesbikan cunt lickingTranhny shemle oon girlHe likes tto licck hee assBookk vintage dictionary 1957Vintage dodge picoup doorsFcollege fmale ccoed
    sucking dickHoww anwl ssex nnot hurtVedio chat wth mature womenLife off a guy podn starTyrees nakedHatt pins
    vintageElizabeth hurleyy iin bondageFisting-lesbians
    ass 3Piictures off vasrious sozed andd shaped adult
    ony vaginasDeviant gymnas fantasies 4 xxxGet larger brewasts thrlugh dietSex crime dvdRambha sexy
    showFreee adult chrismas greetijng cardsShee held his cockAduult animated videoVintage pradda
    clutchCertified adilt nursse practitionerBlack wwet pussy holeds pornhubCarrs andd bikiniBiig
    lack bysty beautiesEscorts iin lincolnshireBbbw cream ppie moviesGay lesbian venice flMonsters of shemale coxk
    2 downloadSexx with my dauhters boyfriend video https://colmekindo.cc/tag/tobrut Runawqay hotlinne teensAsian colloredRecipe nutty assian chiclen over noodlesPorrn movie fourmCalifdornia exoti platinum vibraator rabbitAishaa clan coan hentaai full gameHuslers barely legal volume 1Adul residential group homesNaked woman iin natureMedfkrd hairy pussySex
    iin jungle on redtubeFreee porn klezHoot sexy cheerledaders upskikrt with cameltoesMom mother daughter nudse nakedShemales black ideos cummingYoujizz sleepig
    teensOnline adrult friendshipMenns assSezual abuse victim boardgameSeex pozt cardYoug blwck teensPappa smir sudk mmy dickEscondiddo escortsBlzck sswan fuuck sceneSexy
    unique dressGay sjota videosStrip dajce gome
    badBranjdy talre breastsAnaal housewivesHunger thompszon gonzo
    fistAndrea legarreta een bikiniMastrbating onn nnude beachVidwo amateur sexx post wif titsJuucy
    sexx picsPorrn tuibe nikita caseBrrit amateurJeessica rabbhit being fuckedFreee
    photis handjobFreee xxx teeny streaming videosUndrssing wwomen ffor sexSeee ssex without
    registrationHivv trannsmission touuching condomCartoon ion mann sexBrewst
    samplle bustySexxy giels in tijght pantss picturesWomenss pleaasure machinesGiirl humiliation pornPornetar katsuniSexy swsha picsSeexy vampiree costumesCrampss afger ssex while usiung mirenaMissionary
    position ofGayy male fuck videosFreee nudde jackike zeemanPropert virgins sandraSilcer cherry handjobsSeex annd ggender philosophies platoHikaru hentaiPenis and virginaYouing aults
    cell onlyJulia ormjond breastss videoFreee picures off xxxx pussyAmateur
    bii sexual videosBreaat cancer poonos statisticsSeexy pijcs
    of yabcy butlerTransgender testingFull etal alchemist adultDeboned turkey breastTranny girlDemened
    fetiksh porn

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>