Version: v1.12.3 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Nov 3, 2020 License: Apache-2.0 Imports: 7 Imported by: 145



Package pagination provides utilities to setup a paginator within the context of a http request.


In your beego.Controller:

package controllers

import ""

type PostsController struct {

func (this *PostsController) ListAllPosts() {
    // sets this.Data["paginator"] with the current offset (from the url query param)
    postsPerPage := 20
    paginator := pagination.SetPaginator(this.Ctx, postsPerPage, CountPosts())

    // fetch the next 20 posts
    this.Data["posts"] = ListPostsByOffsetAndLimit(paginator.Offset(), postsPerPage)

In your view templates:

{{if .paginator.HasPages}}
<ul class="pagination pagination">
    {{if .paginator.HasPrev}}
        <li><a href="{{.paginator.PageLinkFirst}}">{{ i18n .Lang "paginator.first_page"}}</a></li>
        <li><a href="{{.paginator.PageLinkPrev}}">&laquo;</a></li>
        <li class="disabled"><a>{{ i18n .Lang "paginator.first_page"}}</a></li>
        <li class="disabled"><a>&laquo;</a></li>
    {{range $index, $page := .paginator.Pages}}
        <li{{if $.paginator.IsActive .}} class="active"{{end}}>
            <a href="{{$.paginator.PageLink $page}}">{{$page}}</a>
    {{if .paginator.HasNext}}
        <li><a href="{{.paginator.PageLinkNext}}">&raquo;</a></li>
        <li><a href="{{.paginator.PageLinkLast}}">{{ i18n .Lang "paginator.last_page"}}</a></li>
        <li class="disabled"><a>&raquo;</a></li>
        <li class="disabled"><a>{{ i18n .Lang "paginator.last_page"}}</a></li>

See also



This section is empty.


This section is empty.


This section is empty.


type Paginator

type Paginator struct {
	Request     *http.Request
	PerPageNums int
	MaxPages    int
	// contains filtered or unexported fields

Paginator within the state of a http request.

func NewPaginator

func NewPaginator(req *http.Request, per int, nums interface{}) *Paginator

NewPaginator Instantiates a paginator struct for the current http request.

func SetPaginator

func SetPaginator(context *context.Context, per int, nums int64) (paginator *Paginator)

SetPaginator Instantiates a Paginator and assigns it to context.Input.Data("paginator").

func (*Paginator) HasNext

func (p *Paginator) HasNext() bool

HasNext Returns true if the current page has a successor.

func (*Paginator) HasPages

func (p *Paginator) HasPages() bool

HasPages Returns true if there is more than one page.

func (*Paginator) HasPrev

func (p *Paginator) HasPrev() bool

HasPrev Returns true if the current page has a predecessor.

func (*Paginator) IsActive

func (p *Paginator) IsActive(page int) bool

IsActive Returns true if the given page index points to the current page.

func (*Paginator) Nums

func (p *Paginator) Nums() int64

Nums Returns the total number of items (e.g. from doing SQL count).

func (*Paginator) Offset

func (p *Paginator) Offset() int

Offset Returns the current offset.

func (*Paginator) Page

func (p *Paginator) Page() int

Page Returns the current page.

func (p *Paginator) PageLink(page int) string

PageLink Returns URL for a given page index.

func (*Paginator) PageLinkFirst

func (p *Paginator) PageLinkFirst() (link string)

PageLinkFirst Returns URL to the first page.

func (*Paginator) PageLinkLast

func (p *Paginator) PageLinkLast() (link string)

PageLinkLast Returns URL to the last page.

func (*Paginator) PageLinkNext

func (p *Paginator) PageLinkNext() (link string)

PageLinkNext Returns URL to the next page.

func (*Paginator) PageLinkPrev

func (p *Paginator) PageLinkPrev() (link string)

PageLinkPrev Returns URL to the previous page.

func (*Paginator) PageNums

func (p *Paginator) PageNums() int

PageNums Returns the total number of pages.

func (*Paginator) Pages

func (p *Paginator) Pages() []int

Pages Returns a list of all pages.

Usage (in a view template):

{{range $index, $page := .paginator.Pages}}
  <li{{if $.paginator.IsActive .}} class="active"{{end}}>
    <a href="{{$.paginator.PageLink $page}}">{{$page}}</a>

func (*Paginator) SetNums

func (p *Paginator) SetNums(nums interface{})

SetNums Sets the total number of items.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL