Pager Overview

The Kendo UI Pager widget enables splitting a set of data into pages with flexible and intuitive UI.

The user interface of the Pager is useful for paging data-bound components that have a data source and do not have a built-in UI for paging such as the ListView or scenarios that require paging options—for example, Kendo Templates with a data source.

You can customize the page number templates or use an input for navigation to a specific page, toggle the visibility of previous and next buttons, include a pagesize dropdown and alter the information messages. The pager API also offers the ability to localize its messages.

Initializing the Pager

To use the Pager, use an empty <div> element and supply its settings in the initialization script.

The following example demonstrates how to tie a pager to a data source and enable the pageSizes option.

  • You can use a remote data source instead of an array of local data. The local array is used for brevity in this example.
        <div id="pager"></div>

        <script>
            var dataSource = new kendo.data.DataSource({
              data: [
                { productName: "Tea", category: "Beverages" },
                { productName: "Coffee", category: "Beverages" },
                { productName: "Ham", category: "Food" },
                { productName: "Bread", category: "Food" }
              ],
              pageSize: 2
            });

            $("#pager").kendoPager({
              dataSource: dataSource,
              pageSizes: [2, 3, 4, "all"]
            });

            dataSource.read();
        </script>
        <style>
          #pager {
           margin-top: 100px;
          }
        </style>

Functionality and Features

Events

You can subscribe to the Pager events.

Referencing Existing Instances

To refer to an existing Pager instance use the jQuery.data() method. Once a reference is established, use the Pager API to control its behavior.

var pager = $("#pager").data("kendoPager");

See Also

In this article
Not finding the help you need? Improve this article