NAME
    Data.Page - Autogenerate useful information for pagination

SYNOPSIS
      var p = new Data.Page(
          120, // total entries
          10,  // entries per page
          1    // current page
      );

      // get pagination info
      p.total_entries()        // 120
      p.entries_per_page()     // 10
      p.current_page()         // 1
      p.entries_on_this_page() // 10
      p.first_page()           // 1
      p.last_page()            // 12
      p.first()                // 1
      p.last()                 // 10
      p.previous_page()        // undefined
      p.next_page()            // 2

      // get items that are included in this page
      var items = [ 'item1' .. 'item99' ];
      items = p.splice( items );  // [ 'item1' .. 'item10' ]

DESCRIPTION
    By giving minimum parameters, this module auto-calculates all the
    neccessary information needed to display pagination, which we see (and
    program) alot in a search result page.

    Especially useful for client-side AJAX applications.

  Constructor
      var page = new Data.Page(
          99,  // total entries
          15,  // entries displayed per page
          2    // current page number
      );

    Or, you can set those parameter later:

      var page = new Data.Page();
      page.total_entries( 99 );
      page.entries_per_page( 15 );
      page.current_page( 2 );

  Methods
   total_entries()
      page.total_entries( 130 );  // setter
      page.total_entries();       // getter

    Sets/gets the total number of entries in your result set. Ignored if
    passed a negative value.

   entries_per_page()
      page.entries_per_page( 10 );  // setter
      page.entries_per_page();      // getter

    Sets/gets the total number of entries displayed per page. Ignored if
    passed a negative value.

   current_page()
      page.current_page( 10 );  // setter
      page.current_page();      // getter

    Sets/gets the total number of entries displayed per page. Ignored if
    passed a negative value.

   entries_on_this_page()
      page.entries_on_this_page();  // 10

      // might be different on last page
      page.current_page( page.last_page() );
      page.entries_on_this_page();  // 7

    Gets the number of items displayed in current page. It's usually same as
    page.entries_per_page(), but might differ on the last page.

   last_page()
      page.last_page();  // 5

    Gets the last page number. It's also the "total page count".

   first_page()
      page.first_page(); // 1

    Gets the first page number, which will always return 1. Counter-part for
    page.last_page() method.

   first()
      page.first();  // 21

    Gets the item number of the first item in current page.

   last()
      page.last();  // 30

    Gets the item number of the last item in current page.

   previous_page()
      page.previous_page();  // 1

    Gets the page number of the previous page. Returns "undefined" if called
    at first page.

   next_page()
      page.next_page();  // 2

    Gets the page number of the next page. Returns "undefined" if called at
    last page.

   splice()
      var items = [ 'item1' .. 'item99' ];
      items = p.splice( items );  // [ 'item1' .. 'item10' ]

    By passing an array with items/records for all pages, it will return an
    array containing only the items for the current page.

   skipped()
      var page = new Data.Page( 50, 10, 3 ); // we're at page 3
      page.skipped();  // 20

    Returns how many items are skipped as for the current page.

SEE ALSO
    Perl CPAN - Data::Page module <http://search.cpan.org/dist/Data-Page/>

AUTHOR
    Leon Brocard <acme@astray.com> Toshimasa Ishibashi <iandeth99@ybb.ne.jp>

    Translated from Perl to JavaScript by Leon but with help from
    Toshimasa's previous translation.

COPYRIGHT
    Copyright (c) 2011 Leon Brocard and Toshimasa Ishibashi. All rights
    reserved. This module is free software; you can redistribute it and/or
    modify it under the terms of the Artistic license. Or whatever license I
    choose, which I will do instead of keeping this documentation like it
    is.

