Grails - GSP Tag - paginate

Tag - paginate

Description

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

Parameters

• 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 containing request parameters
• prev (optional) - The text to display for the previous link (defaults to "Previous" as defined by default.paginate.prev property in I18n messages.properties)
• next (optional) - The text to display for the next link (defaults to "Next" as defined by default.paginate.next property in I18n messages.properties)
• max (optional) - The number of records displayed 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
• offset (optional) - Used ONLY if params.offset is empty

Examples

Example domain class:

class Book {
     String title
     String author
}

Example controller:

class BookController {
  def list = {
     [books: Book.list(params)]
  }
}

Paginate code:

<g:paginate controller="book" action="list" total="${Book.count()}" />

or

<g:paginate next="Forward" prev="Back"
            maxsteps="0" controller="book"
            action="list" total="${Book.count()}" />