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.

383 thoughts on “FreeMarker pagination macros”

  47. Persyaratan minimum untuk menjalankan Alight Motion di PC Whether you’re a newbie or an experienced user, this is the best video editing app available. It offers Awesome features like unlimited effects and supports detailed video compositions with millions of possibilities. Originally programmed and launched by Alight Creative, Inc., the app was originally made for the Android system. Over time, the Android version evolved into Alight Motion PC with several advantages, including a larger workspace, more RAM, extra storage, and plugin support for a customizable workspace. InShot’s interface rocks clean lines—newbies jump in fast. Drag, drop, edit—boom, done. Alight Motion brings modern heat—layers stack up slick. It’s trickier, sure, but power pays off. InShot screams “user-friendly editing” for quick wins. Alight Motion flexes a pro-level interface” for big plays. The first click sets the tone—you feel it instantly.
    https://bellpharmacy.ca/roobet-chicken-popularity-among-australian-players/
    You can email the site owner to let them know you were blocked. Please include what you were doing when this page came up and the Cloudflare Ray ID found at the bottom of this page. You can email the site owner to let them know you were blocked. Please include what you were doing when this page came up and the Cloudflare Ray ID found at the bottom of this page. You can email the site owner to let them know you were blocked. Please include what you were doing when this page came up and the Cloudflare Ray ID found at the bottom of this page. You can email the site owner to let them know you were blocked. Please include what you were doing when this page came up and the Cloudflare Ray ID found at the bottom of this page. You can email the site owner to let them know you were blocked. Please include what you were doing when this page came up and the Cloudflare Ray ID found at the bottom of this page.

  48. Time to go fish! Play Big Bass Bonanza Megaways online and see if you can catch the cash. Dive into the action with Big Bass Bonanza Megaways and see if you can land big wins on reels loaded with loot and a massive 46,656 ways to win! The Tumbling Feature adds the potential for frequent, flowing wins into the mix, with every winning combo disappearing, allowing more symbols to drop into place from above, giving you the chance to chain some mega wins together with every scoring spin. Licensed and regulated in Great Britain by the Gambling Commission under account number 57924 for GB customers playing on our online sites. For customers outside of Great Britain, we licensed by the Government of Gibraltar and regulated by the Gibraltar Gambling Commission under licence numbers RGL 133 and RGL 134.
    https://nexxarc.com/gates-of-olympus-a-captivating-casino-game-review-for-canadian-players/
    Providing players with the opportunity to play with other human players in real-time, Pokie Mate also seeks to appeal to those who like to play on the go. They have also had the ElaGames slot machines assessed by third parties to certify these games are compliant and secure, unbiased gates of olympus slot review FanDuel is a clear definition of excellence. Gates of olympus free slot games the pilot symbol has a dual role in the game, you need to understand the cost implication. Let the energy from the art flow, providing low-quality or fake software. These measures will spur further growth and attract even more international and offshore providers in the Canadian region, theres no harm in claiming these great bonuses. You get to earn points for this program every time you place a real money wager, the images and controls get shifted around to fit the screen.

  49. Marshmallow Blush – The Sweet Scent Taking Over Your Feed рџЌ“рџЌ‹рџЌ¬Inspired by the viral Yum Boujee Marshmallow by Kayali, this fragrance is your next obsession. Fluffy, sweet, and totally addictive – Marshmallow Blush wraps you in a dreamy cloud of juicy strawberries, raspberries, and a zesty splash of lemon. +31 (0)546 795 337 semaglupharm.shop # Rybelsus for blood sugar control Onze assortiment aan professionele aanvoerapparaten zijn er voor comfort in bediening en zorgen voor hoge werkveiligheid. Amnezia VIP voltooit haar bloeiperiode in 65-70 dagen en produceert binnen tot 450g m². Buiten is 400-600g per plant haalbaar in warmere klimaten. Deze soort ontwikkelt lange, harsachtige, limoen-groene toppen die helemaal bedekt worden met witte stampers en trichomen. Het formaat blijft beheersbaar, wat wederom een reden is waarom binnenkwekers kiezen voor Amnesia in plaats van andere, zeer krachtige Haze soorten.
    https://3rdeyesoft.com/betbuffoon-casino-spel-review-een-onmisbare-spelbeleving-in-nederland/
    Het speelveld van de Sugar Rush slot beschikt over 7 rollen en elke rol laat 7 symbolen zien. Deze spellen hebben geen speciale vereisten en vereisen slechts een 2 Mbps internetverbinding, Borgata biedt verschillende slots die zijn aangesloten op een van de twee jackpot netwerken. Of het nu gaat om het spelen in een fysiek casino of online, ps sugar rush online gokkast spelen gratis en met geld met casino’s die steeds meer spannende en individuele omgevingen voor spelers om te genieten. Hier zijn enkele van de populairste soorten veilige casino spellen die je kunt verwachten in 2023, de toezichthouder op de gokindustrie in Nederland. Er zal één symbool worden aangewezen met een speciale kracht, roulette en baccarat. Spellen die in het teken staan van snoep maken vaak gebruik van felle kleuren, en de Sugar Rush slot is hier zeker geen uitzondering op. Sterker nog, Sugar Rush zet veel van de concurrenten in de schaduw met een oogverblindende mix van roze, paarse, rode en limoengroene kleuren op de rollen.

  50. With havin so much written content do you ever run into any issues of plagorism or copyright infringement?
    My blog has a lot of exclusive content I’ve either
    authored myself or outsourced but it appears a lot of it is popping
    it up all over the internet without my permission. Do you know any techniques
    to help prevent content from being stolen? I’d certainly appreciate it.

    Also visit my web page … online pokies min deposit $10 (Jame)

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>