(Quick Reference)

paginate

Purpose

Creates next/previous buttons and a breadcrumb trail for pagination of results

Examples

Example domain class:

class Book {
    String title
    String author
}

Example controller:

class BookController {
    def list() {
        [books: Book.list(params), bookCount: Book.count()]
    }
}

Paginate code:

<g:paginate controller="book" action="list" total="${bookCount}" />

or

<g:paginate next="Forward" prev="Back"
            maxsteps="0" controller="book"
            action="list" total="${bookCount}" />

Description

Attributes

  • total (required) - The total number of results to paginate

  • action (optional) - the name of the action to use in the link; if not specified the default action will be linked

  • controller (optional) - the name of the controller to use in the link; if not specified the current controller will be linked

  • id (optional) - The id to use in the link

  • params (optional) - A Map of request parameters

  • prev (optional) - The text to display for the previous link (defaults to "Previous" as defined by default.paginate.prev property in the i18n messages.properties file)

  • next (optional) - The text to display for the next link (defaults to "Next" as defined by default.paginate.next property in the i18n messages.properties file)

  • omitPrev (optional) - If set to true, the previous link will never be shown

  • omitNext (optional) - If set to true, the next link will never be shown

  • omitFirst (optional) - If set to true, the first page link will only be shown when the first page is within the offset

  • omitLast (optional) - If set to true, the last page link will only be shown when the last page is within the offset

  • max (optional) - The number of records to display per page (defaults to 10). Used ONLY if params.max is empty

  • maxsteps (optional) - The number of steps displayed for pagination (defaults to 10). Used ONLY if params.maxsteps is empty

  • mapping (optional) - The named URL mapping to use to rewrite the link

  • offset (optional) - Used ONLY if params.offset is empty