Skip to content

1 indexing #13

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

1 indexing #13

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
bd927a7
Add oneIndexed option, allowing page counting to optionally start at 1
treyhunner May 23, 2011
123537c
Change one-index option name to conform to current naming convention
treyhunner May 26, 2011
ab206af
Add one-indexed option to README
treyhunner May 27, 2011
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -112,6 +112,10 @@ ellipse_text
displayed number interval, this text will be inserted into the gap (inside a
span tag). Can be left blank to avoid the additional tag. Default: ``...``

one_indexed
Start page numbering at 1 instead of 0 for referencing page numbers
internally. For example when using ``__id__`` in the `link_to` option.


Triggering pagination with custom events
----------------------------------------
Expand Down
66 changes: 47 additions & 19 deletions src/jquery.pagination.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,22 @@
numPages:function() {
return Math.ceil(this.maxentries/this.opts.items_per_page);
},
/**
* Return 1 if page numbers are 1 indexed and 0 otherwise
* @method
* @returns {Number}
*/
firstPage:function() {
return this.opts.one_indexed ? 1 : 0;
},
/**
* Calculate the index of the last page
* @method
* @returns {Number}
*/
lastPage:function() {
return this.opts.one_indexed ? this.numPages() : this.numPages()-1;
},
/**
* Calculate start and end point of pagination links depending on
* current_page and num_display_entries.
Expand All @@ -35,9 +51,11 @@
getInterval:function(current_page) {
var ne_half = Math.floor(this.opts.num_display_entries/2);
var np = this.numPages();
var fp = this.firstPage();
var lp = this.lastPage();
var upper_limit = np - this.opts.num_display_entries;
var start = current_page > ne_half ? Math.max( Math.min(current_page - ne_half, upper_limit), 0 ) : 0;
var end = current_page > ne_half?Math.min(current_page+ne_half + (this.opts.num_display_entries % 2), np):Math.min(this.opts.num_display_entries, np);
var start = current_page > ne_half ? Math.max( Math.min(current_page - ne_half, upper_limit + fp), fp ) : fp;
var end = current_page > ne_half?Math.min(current_page+ne_half + (this.opts.num_display_entries % 2), lp):Math.min(this.opts.num_display_entries, lp) + fp;
return {start:start, end:end};
}
});
Expand All @@ -62,9 +80,15 @@
* @returns {jQuery} jQuery object containing the link
*/
createLink:function(page_id, current_page, appendopts){
var lnk, np = this.pc.numPages();
page_id = page_id<0?0:(page_id<np?page_id:np-1); // Normalize page id to sane value
appendopts = $.extend({text:page_id+1, classes:""}, appendopts||{});
var lnk, lp = this.pc.lastPage(), fp = this.pc.firstPage();
page_id = page_id<fp?fp:(page_id<=lp?page_id:lp); // Normalize page id to sane value
if (this.opts.one_indexed) {
page_id_text = page_id;
}
else {
page_id_text = page_id+1;
}
appendopts = $.extend({text:page_id_text, classes:""}, appendopts||{});
if(page_id == current_page){
lnk = $("<span class='current'>" + appendopts.text + "</span>");
}
Expand All @@ -88,37 +112,39 @@
var begin, end,
interval = this.pc.getInterval(current_page),
np = this.pc.numPages(),
lp = this.pc.lastPage(),
fp = this.pc.firstPage(),
fragment = $("<div class='pagination'></div>");

// Generate "Previous"-Link
if(this.opts.prev_text && (current_page > 0 || this.opts.prev_show_always)){
if(this.opts.prev_text && (current_page > fp || this.opts.prev_show_always)){
fragment.append(this.createLink(current_page-1, current_page, {text:this.opts.prev_text, classes:"prev"}));
}
// Generate starting points
if (interval.start > 0 && this.opts.num_edge_entries > 0)
if (interval.start > fp && this.opts.num_edge_entries > 0)
{
end = Math.min(this.opts.num_edge_entries, interval.start);
this.appendRange(fragment, current_page, 0, end, {classes:'sp'});
if(this.opts.num_edge_entries < interval.start && this.opts.ellipse_text)
if(this.opts.num_edge_entries < interval.start - fp && this.opts.ellipse_text)
{
jQuery("<span>"+this.opts.ellipse_text+"</span>").appendTo(fragment);
}
}
// Generate interval links
this.appendRange(fragment, current_page, interval.start, interval.end);
// Generate ending points
if (interval.end < np && this.opts.num_edge_entries > 0)
if (interval.end <= lp && this.opts.num_edge_entries > 0)
{
if(np-this.opts.num_edge_entries > interval.end && this.opts.ellipse_text)
if(lp+1-this.opts.num_edge_entries > interval.end && this.opts.ellipse_text)
{
jQuery("<span>"+this.opts.ellipse_text+"</span>").appendTo(fragment);
}
begin = Math.max(np-this.opts.num_edge_entries, interval.end);
this.appendRange(fragment, current_page, begin, np, {classes:'ep'});
begin = Math.max(lp+1-this.opts.num_edge_entries, interval.end);
this.appendRange(fragment, current_page, begin, lp+1, {classes:'ep'});

}
// Generate "Next"-Link
if(this.opts.next_text && (current_page < np-1 || this.opts.next_show_always)){
if(this.opts.next_text && (current_page < lp || this.opts.next_show_always)){
fragment.append(this.createLink(current_page+1, current_page, {text:this.opts.next_text, classes:"next"}));
}
$('a', fragment).click(eventHandler);
Expand All @@ -142,6 +168,7 @@
prev_show_always:true,
next_show_always:true,
renderer:"defaultRenderer",
one_indexed: false,
callback:function(){return false;}
},opts||{});

Expand Down Expand Up @@ -196,22 +223,23 @@

// Attach control events to the DOM elements
var pc = new $.PaginationCalculator(maxentries, opts);
var np = pc.numPages();
containers.bind('setPage', {numPages:np}, function(evt, page_id) {
if(page_id >= 0 && page_id < evt.data.numPages) {
var lp = pc.lastPage();
var fp = pc.firstPage();
containers.bind('setPage', {lastPage:lp}, function(evt, page_id) {
if(page_id >= fp && page_id <= evt.data.lastPage) {
selectPage(page_id); return false;
}
});
containers.bind('prevPage', function(evt){
var current_page = $(this).data('current_page');
if (current_page > 0) {
if (current_page > fp) {
selectPage(current_page - 1);
}
return false;
});
containers.bind('nextPage', {numPages:np}, function(evt){
containers.bind('nextPage', {lastPage:lp}, function(evt){
var current_page = $(this).data('current_page');
if(current_page < evt.data.numPages - 1) {
if(current_page <= evt.data.lastPage - 1) {
selectPage(current_page + 1);
}
return false;
Expand Down