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.

2,455 thoughts on “FreeMarker pagination macros”

  2. crash spiele online um geld spielen

    Feel free to surf to my blog post … no deposit
    bonus ohne rollover (Lauri)

  27. Big Bass Bonanza also offers players the chance to win free spins. Landing three or more scatter symbols will trigger the free spins round, where players can win up to 20 free spins. During the free spins round, players can also trigger the Bonus Round, which can lead to even more potential winnings. This free spins round is a great way to increase players’ chances of winning big prizes while also giving them the opportunity to enjoy the game without risking any of their own money. For example, Alaskan Fishing transports you to the U.S.’s northernmost state to play for a wide range of cash prizes and a free spins bonus. Fishing Floats Connectify Pays offers a top win of 5,000x your bet (or $250K) and a Pick Bonus and Free Spins feature. Bigger Bass Bonanza includes a variety of symbols that each bring something unique to the game. Recognizing these symbols will help players understand their significance and potential payouts. The fish symbols, which appear throughout, are crucial in this slot as they represent different values during the game.
    https://paper.wf/snobnordperti1973/any-enquiries-or-to-confirm-availability-please-call-a-casino-shift-manager-at
    1. Added sound effects2. Introduced AI templates3. Bug fixes and performance optimizations.If you have any questions, please contact us via the following methods.Instagram: @vnvideoeditorYoutube丨Telegram: @vnvideoeditorappEmail: vn.support+ios@uiOfficial website: vlognow.me Deciding on the best mobile video editor comes down to your creative ambitions, device, and how much time you want to dedicate to learning new tools. CapCut is a great choice for anyone who desires straightforward editing with minimal effort or prior experience. VN provides a stepping stone, combining simplicity with the resources you need to advance your skills through community support and hands-on examples. If you’re seeking powerful, professional features and you own an iOS device, LumaFusion stands out as the premium choice. Whatever you decide, be assured that all three apps can help you build skills and produce videos you’ll be proud to share.

  28. Here are some of the best New Jersey casino apps on the market, check out what other slots I reviewed and find your new favourite. However, but the mechanics and features make it a spectacular title. There are also plenty of table games and a well-stocked up live casino, slot big bass bonanza megaways by pragmatic play demo free play tournaments and quests provided by 62 creative designers. Not all of the games are available through the app, it gives a profitable Bitcoin promotion to members who make their first deposit with this payment type. What’s new in new online casinos. The White King online slot is one of the most enjoyable slots that we have played for a while, which once stretched from western Oklahoma to parts of Colorado. At its core, Bigger Bass Bonanza is a fishing-themed slot that features stunning graphics and engaging sound effects, immersing players in a fishermen’s paradise. Here are some of the key gameplay features:
    https://moumtaz.ma/unlocking-the-best-tombola-promo-code-for-uk-players-at-tombolapromocode-uk-com/
    Only players above the age of 18 are permitted to play our games. Underage gambling is an offence. рџ‘ЋLimited Bonus Features: Lacks diverse bonus rounds Big Bass Boxing Bonus Round Slot Whether trying to land the big one or just spending time relaxing, fishing has been one of humanity’s preferred pastimes for generations. This 4 x 5 slot game from developer Pragmatic Play puts a spin on this idea. Dive into the world of Big Bass slots from Pragmatic Play with the most complete and up-to-date guide you’ll find. Whether you’re curious about each game or want to find the best UK slot sites to play for real money, my guide has you covered. I break down: Big Bass Bonanza online slots is the catch of the day at 888casino. $ €1000 bonus Big Bass Boxing Bonus Round Slot

  46. Although it may seem that fishing and slots have nothing in common, the two activities get along quite well. Fishin’ Frenzy showed that fishing-themed releases can be exciting and have solid win potential. Many slot games online offer players the chance to cast out a fishing line without getting their hands dirty. Big Bass Bonanza is a proposal you don’t want to miss out on. We enjoyed spinning the reels of Big Bass Bonanza and it is easy to see why this slot is so popular amongst online slot fans. While it is not a new slot, it offers many of the exciting features that you would find in new games. What makes it great is that its not overcomplicated. There is more to this slot than just a wild symbol and free spins bonus round but it remains easy to spin. Highlights for us include the 10x multiplier up for grabs in the free spins feature, the Big Bass scatter symbols and the chance to get more fish symbols with cash values attached via the fisherman wild.
    https://md.darmstadt.ccc.de/s/M5jiHvx-v1
    Bigger Bass Bonanza, developed by Pragmatic Play, is the upgraded and more premium version of the classic slot game Big Bass Bonanza. With higher betting options, it’s designed to cater to high rollers looking for big prizes and a more engaging fishing-themed experience in online casinos. Each Wild that lands during the Free Spins feature accumulates the values of the available Money symbols. Players accumulate all the Wild symbols until the end of the Free Spins feature. We enjoyed spinning the reels of Big Bass Bonanza and it is easy to see why this slot is so popular amongst online slot fans. While it is not a new slot, it offers many of the exciting features that you would find in new games. What makes it great is that its not overcomplicated. There is more to this slot than just a wild symbol and free spins bonus round but it remains easy to spin. Highlights for us include the 10x multiplier up for grabs in the free spins feature, the Big Bass scatter symbols and the chance to get more fish symbols with cash values attached via the fisherman wild.

  48. When it comes to the paytable, expect to encounter symbols that perfectly match the theme. As usual, playing cards are the lower-paying icons. Fish, Tackle Boxes, Fishing Rods, Dragonflies, and Floaters follow. Fish are the Money symbol, taking a random money value on every spin. The Fisherman serves as the game’s Wild, although in Big Bass Bonanza, it won’t appear during the base game. However, it can land anywhere on the reels during Free Spins to replace all other symbols except the Scatter. Unlike Wilds, Scatters don’t award payouts but have the power to trigger the Free Spins round. Playing Big Bass Bonanza in the UK is easy and exciting, whether you’re a beginner or a seasoned player. Knowing how the money game works and how to place your bets will help you enjoy the full experience and maximise your chances of winning. This section explains everything you need to get started with this popular online slot!
    https://toro7.co/lucky-block-bonus-uk-review-unlock-top-wins-now/
    Whether you’re an aspiring creator or a seasoned editor, Alight Motion offers a powerful yet accessible platform to craft stunning motion graphics, dynamic video edits, and layered compositions—all without the need for expensive desktop software. In this comprehensive review, we’ll explore its key features, performance, pros and cons, and its alternative. Create professional-looking videos with Alight Motion, a very handy mobile video editor featuring different templates and tons of creative tools… There is however a way to run Alight Motion MOD APK on macOS devices. Android Emulators are used to run APK files on macOS devices but iPhone is off limits. Alight Motion Mod APK provides a compelling platform for motion graphics and animation. While the normal version delivers excellent core tools, the pro mod APK unlocks unlimited creative potential. Changelog

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>