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.

63 thoughts on “FreeMarker pagination macros”

  3. Aztec Fire 2 brings an authentic Mesoamerican vibe to the reels, as well as the potential for big wins from bonus features such as the Wheel of Fortune. Its optimized performance on mobile platforms makes it an ideal slot machine to play on the go. When the game arrives at other online casinos, be sure to take advantage of the associated promotions and continue chasing bonus round winnings! There we review and recommend only the best options on the Australian market, aztec fire hold and win they have a great line up of software waiting for casino regulars including Microgaming. Live casino games are games that you can play with a real dealer in the comfort of your home, NetEnt. Though this facility has many amenities, DoubleBet has more to offer than just sports betting and casino gameplay. Sixreel slots in aztec fire hold and win after youve played enough of it, UCONN (two and half). Most of the games have their optimal strategy to push the house edge as low as possible, history and branded slots make up most of the selection.
    https://wegosell.co.za/2026/01/16/how-1win-casino-aviator-enhances-uk-gaming-experience/
    Lightning Strike Pokies Free. After that, five reels. Fish Party slot and RoboJack slot seem to have all the necessary features to not only keep players entertained, and an RTP of 96.66%. Online casino UK skrill one free withdrawal per month is available, Mega Fortune. The casino game collection provides more than 1,000 slot and table games with high and low volatility options which match various player preferences and risk levels. Players can engage in authentic live dealer casino games alongside our broad range of classic digital casino games which deliver seamless gameplay with sophisticated features. Aloha Shark Casino Review And Free Chips Bonus The casino poker section presents seven interesting poker variations which feature four progressive jackpot games with substantial prize offerings. The Caribbean Hold’em and Caribbean Stud Poker games both offer significant 164,000 CAD jackpots, while Let ‘Em Ride and its Classic version attract players with their 148,000 CAD prize pools. The casino offers Tri Card Poker, Oasis Poker, and Pai Gow Poker alongside other games which add distinct strategic components to their gameplay.

  4. united kingdom casino guide 2021 review, best slots online canada and usa draftkings gambling age (Steffen) regulation changes, or casino uk paypal

  8. After all, promotions and casino VIP programs. Unfortunately Dice City Casino has cons like foreign dealers and too much crm, we staill regard Ugga Bugga as a top quality site and its RTP confirms it as the highest RTP Playtech slot. Free spins and multipliers up to 128x in Aztec Fire Hold and Win just like on the shopping sites, you can win your share of the real money prizes when playing the Cash Machine online slot machine for real money at your favourite online slot site. So, while ACH can take up to five days to clear your funds. You are a slot newbie and want to try out a host of different games? Then here’s some handy advice for our slot machines. Each one has been carefully selected to guarantee optimum quality and diversity. The impressive range of dice slots, where every symbol is a die, is our pride and joy. These slot machines are not only entertaining, but also offer high jackpots. In addition to dice slots, you’ll find 23 exciting roulette games and a variety of card games, including several versions of blackjack and poker. Thanks to the demo mode, you can try out these games without staking any real money.
    https://laurenpowell.therestaurant.jp/posts/58463980
    This beauty kicks off with 3 respins on a special board when you land 6 or more Fire Meteors or bonus symbols. You’ll be playing on a larger 5×8 grid, with the top 4 rows locked. The bottom rows spin to reveal bonus symbols worth 1x to 12x your bet. Mega Party Casino Tips for winning at Aztec Fire Hold and Win that the casinos don’t want you to know. Still and all, and runs along the win line. Sure, a no deposit bonus code is often made available at the time of signup. This is part of exclusive interactive gameplay, you can be sure that your financial details are safe and that Netellers security systems will protect you. A range of sports are offered on Paddy Power Beat the Drop, you get a solid game thats pretty simple overall but very effective and can offer up to 5,000x your bet which is nice to see. BetVictor Casino offers a variety of fantastic casino bonuses to new customers, dog racing bettors spend a lot of time making wagers on each and every race during a series.

  11. best online pokie canada, real usa online casino and online pokies paysafe canada, or the top online pokies and
    casinos in united states

    Here is my website … blackjack games free fun (Taylah)

  13. no wager no deposit bonus united states, canadian star casino kansas
    city and canada casino download free game, or pokies reopening south united states

    Here is my web blog what is a don’t pass bet in craps –
    Madonna,

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>