Fork me on GitHub


The pagination with Jaxon is different from the pagination with a classic web application, because where the application generates a list of links to different pages, Jaxon must generate a list of calls to a javascript function with different parameters.
For Jaxon, the parameters in pagination links are not named, and their position is important.

Here is an example of pagination links in a classic web application.

<ul class="pagination">
    <li><span class="page-numbers current">1</span></li>
    <li><a class="page-numbers" href="/items?page=2">2</a></li>
    <li><a class="page-numbers" href="/items?page=3">3</a></li>
    <li><a class="page-numbers" href="/items?page=4">4</a></li>
    <li><a class="page-numbers" href="/items?page=5">5</a></li>

With Jaxon, we should have links more like this.

<ul class="pagination">
    <li><span class="page-numbers current">1</span></li>
    <li><a class="page-numbers" href="javascript:;" onclick="MyClass.showPage(2)">2</a></li>
    <li><a class="page-numbers" href="javascript:;" onclick="MyClass.showPage(3)">3</a></li>
    <li><a class="page-numbers" href="javascript:;" onclick="MyClass.showPage(4)">4</a></li>
    <li><a class="page-numbers" href="javascript:;" onclick="MyClass.showPage(5)">5</a></li>

The paginate() method of the \Jaxon\Request\Factory class is used to implement pagination with Jaxon.

public function paginate($itemsTotal, $itemsPerPage, $currentPage, $method, ...)

Its first 3 parameters indicate the pagination options. Its fourth parameter indicates the method (with the name of the class) to call, and the following are the request parameters.

The position of the page number is indicated by the rq()->page() function. If it is not present in the call, it will be automatically added to the end of the parameter list.

$pagination = rq()->paginate(25, 10, 1, 'MyClass.showPage', rq()->select('colorselect'), rq()->page());
<div class="content">
    <div id="color">
        <select class="form-control" id="colorselect" name="colorselect">
            <option value="black" selected="selected">Black</option>
            <option value="red">Red</option>
            <option value="green">Green</option>
            <option value="blue">Blue</option>
    <div id="pagination-wrapper"><?php echo $pagination ?></div>

In a Jaxon class, the \Jaxon\Request\Traits\Factory trait provides a paginate() method which creates pagination links from the method name, but without the name of the class.

class MyClass
    use \Jaxon\Request\Traits\Factory;

    public function showPage($color, $currentPage)
        $pagination = $this->paginate(25, 10, $currentPage, 'showPage', rq()->select('colorselect'), rq()->page());
        $response->assign('pagination-wrapper', 'innerHTML', $pagination);
        return $response;

Customizing the pagination

The pagination links are generated from templates, which by default are provided by the library:

At the root of the directory, there is the wrapper template which wraps pagination links with the required HTML tags. The links template variable contains the pagination links list, while the prev and next template variables respectively contain the link to the previous and the next pages. The prev and next variables are empty if the corresponding link is not present.

In the links sub-directory, there is a template for each type of link.

  • The current template prints the link to the current page.
  • The enabled template prints the link to an active page.
  • The disabled template prints the link to an inactive page.
  • The prev template prints the link to the previous page.
  • The next template prints the link to the next page.

In each template, the text variable contains the text to be printed, while the call variable contains the Jaxon call which shows the corresponding page. The call variable is not available in the disabled template.

In order to customize the pagination, copy the templates to another directory and edit them. Then, make the following call to setup the new directory.