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,725 thoughts on “FreeMarker pagination macros”

  11. online pokies canada real, best paying pokies united kingdom and online casino uk
    pay by mobile, or in united statesn roulette the wheel
    has 38 numbers

    Also visit my site :: how do you win blackjack card game; Scott,

  17. работа в пункт за залагания

    Feel free to surf to my page … стейк залог (Royce)

  19. best online slot usa, best united kingdom online casino paypal and united
    statesn poker 95 download, or no deposit casino real money usa

    Also visit my website gambling roulette game – Ian
    -

  20. canadian poker stars, online casinos canada no deposit bonus can you be 18 and go to
    the casino in vegas (Charlotte) online pokies united states no deposit signup bonus,
    or all united kingdom bingo lantana

  32. how to win on pokie machines australia, online pokies free spins on sign up australia
    and are the top online pokies and casinos in canada free, or new
    zealandn mister james casino bonus code; Everett,
    guide app

  35. Freee animate 3d adult fantasyCzesch girl ssex outsidrAmateur gifl runningBombay modfel
    nudeHow ddo yoou cean late paintHoww too reach nal orgasmsFt worfh adultFawnn hadcore piperBiig coxk suckkng fictionHagerty marriska
    nudeMareiah carey hott phoito nudeBiikini disasterLesbian swxTalkung a gorl ijto haviing sexGaybusters
    swingersBesst moovie nuce scenjes mmr skinFreee eony porn pixsCoujples escoprt busty maturee torontoBeend backweards
    fuckOerorming oral sexMilff fuc hotyel pornNaked ppictures oof farm boysQsshare sex forumTraampoline girls brewasts exposedFucking brunette missionary position picturesDanhce sexy stripBreast cancer papillomaGrannny mewga
    cuntAateur redhaeds nudeProfessional one-step sttrip
    pegnancy testAss poppin shhaking tubesNuude spyy thumbnailsJustt shale that aass bitchFrree
    bbww faat pornWhy i like anall sexTgpp mixget spankCretyu nude sandraSexxy ccollege woen gone
    wildWhat a norma vagina looks likeCreawm interracial pieYoyng meen blo
    jobsFitst lesbian expirenceBankls black pornstarEbbaa
    hultkvist nudeDukee blue devijls vintage alarm clockYoung harry pusxy fuckingBeccaa andrson model
    nudeSquyiting puzsy lesbianImagevenue een titsMarilyn chambrrs ssex tapeShhow mee picturds off adies nakedFreee bet moms handjobs videosFreee
    hardcoore cumshot pornVaginal esttriol creamOnline seex dating listUnwanted
    sprm mmy unprotectedC t esorts newcastleSeex discrimimation federal attorneysSisxters uunderware sexPanties iinside asss videoPornogrzphy videks guage kell klineFree
    strteaming rral amazteur postsSimpson pkrn online freeGranddpa simpson sexMarie wilon nudeDicck frymoee weatheer manPolicewoman stripperPorn siite teenagerI lkve puzsy wetFree gayy hasrd
    fuck ubes https://redwap.cc/ Nudee midget ictures
    freeAmmateur review siteAsan weddeing fairCondim sayingNudkst coliny photosSelena gomez nudxe bathhroom photoLesbian navel lickingJaane middllemiss nudeMilf ganbanged2001 forfd escort
    zx2 websitesNutiv cconut ooil orvanic exttra virginChea eescort floridaCliip hollyywood seex videoEtiene gaay cartoonItaqlian teaccher pornAerican indian gayFree young videoss pornHenta gytoza spiritFreee sexx videoos webcamsHeer first biig cick
    and deep throatStripper platinum pluss coumbia ssc zoeySeex
    disscrimination 2008Moods condim websiteSexxy chija girl storiesHiry tteens iin pantiesLaady
    carole erotiuc illusionsMcdoalds nuxe spankingFree love mzking vikdeos xxxEmmo teen slutsPerfect 10 slutInternet camera sex clipsOvgyuide public sexCoock naturall suckjing teenThee
    difference bertween ssex aand sexualityJizz eatijng milfCaemen luvana sucking a
    dick mpegAnnne hathaways breastYou tbe ddad kennedy’s fuyck offNeew cybertech pornGay booys latinosFreee
    juicy weet asss picsReall nujde celebrit pictureListerning iin onn sexFuck thais now

  36. canadian original free slots, online is the grey eagle casino open today [Dorris] uk top 10 and united statesn poker 95 download, or gambling
    commission usa

  39. are there casinos in saskatchewan united states, united statesn biggest pokies operator
    and online casino uk free bonus no deposit, or online gambling
    site affiliate programs [Boris] united states banned

  42. free poker sites uk, united statesn online casinos and deposit 5 get 100 free spins uk, or free money online
    casino united kingdom

    My blog … counting cards blackjack when to bet big (Arnette)

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>