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

  1. Get Alight Motion Mod APK to enjoy Ads-free Premium features free of cost. Alight Motion Pro APK Latest version available now! No watermark, Time remapping, no lagging, ad-free experience, Batch editing, all effects are accessible, Zoom Out, Blur background, Zoom in, Motion Control, Blending modes, and many more. To enjoy all these features, download the modded version of Alight Motion from a trusted website. This is a brand-new application. Alight Motion Pro (Mod) is the first pro Motion graphics app for your smartphone, bringing you professional-quality animation, video editing, motion graphics, visual effects, and video compositing. The Alight Motion Mod APK is the modified and advanced version of the Standard app. It has gained the title of best free video editing app and has opened the gate of a world where incredible editing possibilities wait for you. It offers an ad-free experience with unlocked premium filters, unique effects, audio integration, advanced motion design features, and 100% security.
    https://www.mksecrets.net/forums/eng/viewtopic.php?p=161872#p161872
    Copyright © Bally’s Corporation and or its affiliates and licensors 2025. All rights reserved. Q: What is the RTP of Bigger Bass Bonanza? Gameplay revolves around four different collector variants that can be unlocked through the progression trail, with each bringing its own impact when active. The Big Catch Net can also randomly trigger to award one of seven extra features. Free spins are the main bonus, activated with three or more scatters, and can be upgraded if you’ve reached the super bonus stage on the trail. During free spins, landing collectors not only gathers all cash values on screen but also advances you along the meter for extra spins and multipliers, gradually building the potential as the round develops. In Bigger Bass Bonanza, every detail matters. The graphics are bright and cartoonish, creating an inviting atmosphere reminiscent of summer fishing trips. The symbols—fishing rods, tackle boxes, and the prized bass fish—are creatively designed, enhancing the overall theme.

  3. Best Video Editing Apps for iPad! We’ve tested all the top options & narrowed it down to the best iPad video editing apps we recommend so you can edit video on iPad in no time. The privacy evaluations have been designed with the help and support of a consortium of schools and districts across the United States. These evaluations are designed to help educators make informed decisions about the potential privacy implications of educational technology used to support teaching and learning. Say more by seamlessly including video within your publication. The IOS devices like iPhones are especially known for their Camera, powerful performance, and stable software. You should record the videos on your iPhone and edit them through the VN Video Editor, and then you will get the shocking results. This video will look like it was recorded with a professional camera and edited with a premium editor like Adobe Premier Pro. Download the VN editor and enjoy seamless editing.
    https://nsr.livenetstudios.co.za/index.php/2026/05/01/midnight-wins-casino-review-for-uk-players/
    You are probably wondering how to use TikTok effects, in this case you are in the right place, we will explain how to use them, by using a TikTok edit app. You don’t need to be a video editor to make great content. Our AI TikTok video editor handles the complicated design parts, so all you need to is simply type your idea, pick a style and voice, and let the AI build your TikTok video. Renderforest is for anyone that wants to create top quality videos without the learning curve. Yes, TikTok has a built-in video-making channel. However, its editing features are fairly basic, which can be limiting to your creative expression, especially given the short length of the videos. With CapCut’s robust video editing tools, you can take your TikTok videos to new creative heights. One of the last things people might expect to go viral on the app was a genealogy site, but thanks to an interesting feature from MyHeritage, users have been flocking to the site to try it out for themselves.

  4. In Big Bass Bonanza, our studio set the RTP at 96.71%, which is higher than many classic fishing slots. The volatility is rated as high, meaning wins do not appear often, but when they do, payouts can reach up to 2,100x your bet. This balance makes BigBassBonanza attractive for players in the UK who prefer larger but less frequent rewards. Keep an eye out for our deals and offers to see how you can make the most of Big Bass Bonanza and other slot or casino games to win real money prizes. If you’re a fan of online slots, there’s a good chance you’ve come across Big Bass Bonanza. It’s become something of a flagship title for Pragmatic Play, thanks to its relaxing theme and straightforward yet effective design—it nails the fundamentals. Choose your stake and start fishing for winning combos across these reels. There are ten paylines on the Big Bass Bonanza slot, with wins paid out from left to right across them.
    https://www.gabitos.com/DESENMASCARANDO_LAS_FALSAS_DOCTRINAS/template.php?nm=1777989670
    Automatically remove silent sections to streamline your video content. Flixier is a free text to speech video maker app that allows you to create videos easily and collaboratively. It is a cloud-powered video editing product that can be accessed through any computer browser, making the video creation process faster and more efficient. In this initial release, AI narration is available in video storyboards in the desktop app. Launch ScreenPal and open an existing storyboard or create a new storyboard. Add your recordings and videos, type in your script or import a script from a document. Audio files are securely stored in your browser’s local storage for privacy and quick access. They remain available until you clear your browser data or manually delete them. For permanent storage, we recommend downloading your audio files to your device.

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>