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.

6,457 thoughts on “FreeMarker pagination macros”

  16. free pokie spins australia, gousaos quest free spins no deposit and casino dusaes no deposit bonus codes, or las vegas usa casino $100

    My page blackjack gymnastics meet 2021 – Hester -

  20. new zealandn pm blackjack, casino fun usa and casino deposit bonus usa,
    or new zealandn casino guide app

    Here is my page: what iphone games win real money (Mavis)

  22. are there casinos in montreal australia, usa pokies online and best
    united kingdom is miccosukee casino open today; Barbra,,
    or new usa live casino

  25. casinos in canada vancouver, usa new online casino
    and are the top online pokies and casinos in canada free, or
    best australia casino app

    Also visit my webpage no deposit codes 2022 (Nadia)

  26. free spins no deposit casinos nz, free online games to
    win real money no deposit australia and golden pokies united states, or free 50
    pokies canada

    Look at my blog; is olymp trade a gambling site (Dominic)

  27. best usa online jackpot world casino app (Randell) real money,
    best online pokies united kingdom forum and best casinos in central united states,
    or are there casinos in usa

  29. I do agree with all of the ideas you have presented in your post. They are really convincing and will definitely work. Still, the posts are too short for newbies. Could you please extend them a bit from next time? Thanks for the post.

  36. Try to make the most out of the round stages on offer. If the total win during the round reaches 4000x the stake the feature will immediately end. Play this slot at Ladbrokes Online Casino. Big Bass Bonanza uses a fishing theme with the reels floating just below the ocean’s surface. Blue depths are the game’s background scenery filled with fish seaweed and bubbles. The online slot has a nice funky tune as its soundtrack setting a perfect atmosphere for an adventure on the open sea. Graphics are brightly-coloured crisp and well-executed. Bigger Bass Bonanza is available to play online: HERE Our team designed the Big Bass Bonanza slot UK with a fishing theme bright underwater colors and animated fish symbols. The background music has a light folk style creating a calm atmosphere while you play. http://lienket.vn/3xh9t Pixelmator Pro comes with a full set of vector tools for creating resolution-independent designs. It includes easily-customizable smart shapes a large collection of pre-designed shapes and support for vector file formats including PSD SVG PDF Adobe Illustrator and Illustrator EPS. With the right app animating your photos can be both fun and easy. Be it for adding a creative touch to your social media posts or creating professional-grade animations thereu2019s an app out there to fit your needs. Explore these options and start bringing your photos to life today Revive App is thoughtfully designed to be highly intuitive ensuring that users can easily animate their photos with just a few simple taps. Furthermore the app aims to provide a seamless experience making it accessible for everyone. In addition to the focus on emotional wellbeing images the app guides users through the process. Here’s a step-by-step breakdown of how they can quickly and effortlessly transform static images into lively animations using the app

  38. Bigger Bass Bonanza by Pragmatic Play is an excellent addition to the UK online slots market. With its appealing theme‚ ease of play‚ rewarding bonus features‚ and availability on trusted UK licensed sites‚ it offers a thrilling experience for both novice and seasoned players alike. Whether you’re playing for fun or aiming for big wins‚ this slot remains a top choice for UK online casino enthusiasts. Big Bass Bonanza is a 5-reel 3-row video slot featuring 10 fixed paylines. The game’s premise centers around a fishing trip where you hope to catch big wins symbolized by colorful fish fishing rods and cool anglers. Pragmatic Play has used vibrant graphics upbeat audio and a straightforward interface to ensure players of all experience levels feel welcomed. Bigger Bass Bonanza sets sail for a flashier harbor hauling in even bigger wins. This sequel cranks up the excitement with a boosted max win potential and a couple of extra payout lines. While the familiar fishing theme remains there is a visual upgrade with a vibrant harbor scene instead of the original’s underwater world. https://onlinesequencer.net/forum/user-309899.html And to make it super easy to edit and make your videos looking absolutely gorgeous VN Video Editor Maker VlogNow also offers its amazing library of interesting video effects and filters which can even rival the likes of VivaCut PowerDirector and other great apps. Start by customizing the colors and themes with many built-in filters from the app. Or you can import LUT filters from other sources to further diversify your library. Have fun picking up many different transition effects for your video clips to make the merged videos more interesting. And feel free to customize the video speed to enable unique time-lapsed or slow-motion effects on your selected footages. We read every piece of feedback and take your input very seriously. How To Edit Video In VN Video Editor For Windows?Editing videos with VN video editors on Windows is a quite simple and fun activity.  To edit videos efficiently users only need to follow the given steps.

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>