mirror of
https://github.com/Mottie/tablesorter.git
synced 2024-11-15 23:54:22 +00:00
471 lines
15 KiB
JavaScript
471 lines
15 KiB
JavaScript
/*!
|
|
* tablesorter pager plugin
|
|
* updated 9/27/2012
|
|
*/
|
|
/*jshint browser:true, jquery:true */
|
|
;(function($) {
|
|
"use strict";
|
|
$.extend({tablesorterPager: new function() {
|
|
|
|
this.defaults = {
|
|
// target the pager markup
|
|
container: null,
|
|
|
|
// use this format: "http:/mydatabase.com?page={page}&size={size}"
|
|
// where {page} is replaced by the page number and {size} is replaced by the number of records to show
|
|
ajaxUrl: null,
|
|
|
|
// process ajax so that the following information is returned:
|
|
// [ total_rows (number), rows (array of arrays), headers (array; optional) ]
|
|
// example:
|
|
// [
|
|
// 100, // total rows
|
|
// [
|
|
// [ "row1cell1", "row1cell2", ... "row1cellN" ],
|
|
// [ "row2cell1", "row2cell2", ... "row2cellN" ],
|
|
// ...
|
|
// [ "rowNcell1", "rowNcell2", ... "rowNcellN" ]
|
|
// ],
|
|
// [ "header1", "header2", ... "headerN" ] // optional
|
|
// ]
|
|
ajaxProcessing: function(ajax){ return [ 0, [], null ]; },
|
|
|
|
// output default: '{page}/{totalPages}'
|
|
// possible variables: {page}, {totalPages}, {filteredPages}, {startRow}, {endRow}, {filteredRows} and {totalRows}
|
|
output: '{startRow} to {endRow} of {totalRows} rows', // '{page}/{totalPages}'
|
|
|
|
// apply disabled classname to the pager arrows when the rows at either extreme is visible
|
|
updateArrows: true,
|
|
|
|
// starting page of the pager (zero based index)
|
|
page: 0,
|
|
|
|
// Number of visible rows
|
|
size: 10,
|
|
|
|
// if true, the table will remain the same height no matter how many records are displayed. The space is made up by an empty
|
|
// table row set to a height to compensate; default is false
|
|
fixedHeight: false,
|
|
|
|
// remove rows from the table to speed up the sort of large tables.
|
|
// setting this to false, only hides the non-visible rows; needed if you plan to add/remove rows with the pager enabled.
|
|
removeRows: false, // removing rows in larger tables speeds up the sort
|
|
|
|
// css class names of pager arrows
|
|
cssFirst: '.first', // go to first page arrow
|
|
cssPrev: '.prev', // previous page arrow
|
|
cssNext: '.next', // next page arrow
|
|
cssLast: '.last', // go to last page arrow
|
|
cssGoto: '.gotoPage', // go to page selector - select dropdown that sets the current page
|
|
cssPageDisplay: '.pagedisplay', // location of where the "output" is displayed
|
|
cssPageSize: '.pagesize', // page size selector - select dropdown that sets the "size" option
|
|
|
|
// class added to arrows when at the extremes (i.e. prev/first arrows are "disabled" when on the first page)
|
|
cssDisabled: 'disabled', // Note there is no period "." in front of this class name
|
|
|
|
// stuff not set by the user
|
|
totalRows: 0,
|
|
totalPages: 0,
|
|
filteredRows: 0,
|
|
filteredPages : 0
|
|
|
|
};
|
|
|
|
var $this = this,
|
|
|
|
// hide arrows at extremes
|
|
pagerArrows = function(c, disable) {
|
|
var a = 'addClass',
|
|
r = 'removeClass',
|
|
d = c.cssDisabled,
|
|
dis = !!disable,
|
|
// tr = Math.min( c.totalRows, c.filteredRows ),
|
|
tp = Math.min( c.totalPages, c.filteredPages );
|
|
if ( c.updateArrows ) {
|
|
$(c.cssFirst + ',' + c.cssPrev, c.container)[ ( dis || c.page === 0 ) ? a : r ](d);
|
|
$(c.cssNext + ',' + c.cssLast, c.container)[ ( dis || c.page === tp - 1 ) ? a : r ](d);
|
|
}
|
|
},
|
|
|
|
updatePageDisplay = function(table, c) {
|
|
var i, p, s, t, out, f = $(table).hasClass('hasFilters');
|
|
c.filteredRows = (f) ? $(table).find('tbody tr:not(.filtered)').length : c.totalRows;
|
|
c.filteredPages = (f) ? Math.ceil( c.filteredRows / c.size ) : c.totalPages;
|
|
if ( Math.min( c.totalPages, c.filteredPages ) > 0 ) {
|
|
t = (c.size * c.page > c.filteredRows);
|
|
c.startRow = (t) ? 1 : ( c.size * c.page ) + 1;
|
|
c.page = (t) ? 0 : c.page;
|
|
c.endRow = Math.min( c.filteredRows, c.totalRows, c.size * ( c.page + 1 ) );
|
|
out = $(c.cssPageDisplay, c.container);
|
|
// form the output string
|
|
s = c.output.replace(/\{(page|filteredRows|filteredPages|totalPages|startRow|endRow|totalRows)\}/gi, function(m){
|
|
return {
|
|
'{page}' : c.page + 1,
|
|
'{filteredRows}' : c.filteredRows,
|
|
'{filteredPages}' : c.filteredPages,
|
|
'{totalPages}' : c.totalPages,
|
|
'{startRow}' : c.startRow,
|
|
'{endRow}' : c.endRow,
|
|
'{totalRows}' : c.totalRows
|
|
}[m];
|
|
});
|
|
if (out[0]) {
|
|
out[ (out[0].tagName === 'INPUT') ? 'val' : 'html' ](s);
|
|
if ( $(c.cssGoto, c.container).length ) {
|
|
t = '';
|
|
p = Math.min( c.totalPages, c.filteredPages );
|
|
for ( i = 1; i <= p; i++ ) {
|
|
t += '<option>' + i + '</option>';
|
|
}
|
|
$(c.cssGoto, c.container).html(t).val(c.page + 1);
|
|
}
|
|
}
|
|
}
|
|
pagerArrows(c);
|
|
$(table).trigger('pagerComplete', c);
|
|
},
|
|
|
|
fixHeight = function(table, c) {
|
|
var d, h, $b = $(table.tBodies[0]);
|
|
if (c.fixedHeight) {
|
|
$b.find('tr.pagerSavedHeightSpacer').remove();
|
|
h = $.data(table, 'pagerSavedHeight');
|
|
if (h) {
|
|
d = h - $b.height();
|
|
if ( d > 5 && $.data(table, 'pagerLastSize') === c.size && $b.find('tr:visible').length < c.size ) {
|
|
$b.append('<tr class="pagerSavedHeightSpacer remove-me" style="height:' + d + 'px;"></tr>');
|
|
}
|
|
}
|
|
}
|
|
},
|
|
|
|
changeHeight = function(table, c) {
|
|
var $b = $(table.tBodies[0]);
|
|
$b.find('tr.pagerSavedHeightSpacer').remove();
|
|
$.data(table, 'pagerSavedHeight', $b.height());
|
|
fixHeight(table, c);
|
|
$.data(table, 'pagerLastSize', c.size);
|
|
},
|
|
|
|
hideRows = function(table, c){
|
|
var i,
|
|
rows = $('tr:not(.' + table.config.cssChildRow + ')', table.tBodies),
|
|
l = rows.length,
|
|
s = ( c.page * c.size ),
|
|
e = s + c.size,
|
|
j = 0; // size counter
|
|
for ( i = 0; i < l; i++ ){
|
|
if (!/filtered/.test(rows[i].className)) {
|
|
rows[i].style.display = ( j >= s && j < e ) ? '' : 'none';
|
|
j++;
|
|
}
|
|
}
|
|
},
|
|
|
|
hideRowsSetup = function(table, c){
|
|
c.size = parseInt( $(c.cssPageSize, c.container).val(), 10 ) || c.size;
|
|
$.data(table, 'pagerLastSize', c.size);
|
|
pagerArrows(c);
|
|
if ( !c.removeRows ) {
|
|
hideRows(table, c);
|
|
$(table).bind('sortEnd.pager filterEnd.pager', function(){
|
|
hideRows(table, c);
|
|
});
|
|
}
|
|
},
|
|
|
|
renderAjax = function(data, table, c, exception){
|
|
// process data
|
|
if ( typeof(c.ajaxProcessing) === "function" ) {
|
|
// ajaxProcessing result: [ total, rows, headers ]
|
|
var i, j, hsh, $f, $sh,
|
|
$t = $(table),
|
|
$b = $(table.tBodies).filter(':not(.' + table.config.cssInfoBlock + ')'),
|
|
hl = $t.find('thead th').length, tds = '',
|
|
err = '<tr class="remove-me"><td style="text-align: center;" colspan="' + hl + '">' +
|
|
(exception ? exception.message + ' (' + exception.name + ')' : 'No rows found') + '</td></tr>',
|
|
result = c.ajaxProcessing(data) || [ 0, [] ],
|
|
d = result[1] || [],
|
|
l = d.length,
|
|
th = result[2];
|
|
if ( l > 0 ) {
|
|
for ( i = 0; i < l; i++ ) {
|
|
tds += '<tr>';
|
|
for ( j = 0; j < d[i].length; j++ ) {
|
|
// build tbody cells
|
|
tds += '<td>' + d[i][j] + '</td>';
|
|
}
|
|
tds += '</tr>';
|
|
}
|
|
}
|
|
// only add new header text if the length matches
|
|
if ( th && th.length === hl ) {
|
|
hsh = $t.hasClass('hasStickyHeaders');
|
|
$sh = $t.find('.' + ((c.widgetOptions && c.widgetOptions.stickyHeaders) || 'tablesorter-stickyheader'));
|
|
$f = $t.find('tfoot tr:first').children();
|
|
$t.find('thead tr.tablesorter-header th').each(function(j){
|
|
var $t = $(this),
|
|
// add new test within the first span it finds, or just in the header
|
|
tar = ( $t.find('span').length ) ? $t.find('span:first') : $t;
|
|
tar.html( th[j] );
|
|
$f.eq(j).html( th[j] );
|
|
// update sticky headers
|
|
if ( hsh && $sh.length ){
|
|
tar = $sh.find('th').eq(j);
|
|
tar = ( tar.find('span').length ) ? tar.find('span:first') : tar;
|
|
tar.html( th[j] );
|
|
}
|
|
});
|
|
}
|
|
if ( exception ) {
|
|
// add error row to thead instead of tbody, or clicking on the header will result in a parser error
|
|
$t.find('thead').append(err);
|
|
} else {
|
|
$b.html( tds ); // add tbody
|
|
}
|
|
c.temp.remove(); // remove loading icon
|
|
$t.trigger('update');
|
|
c.totalRows = result[0] || 0;
|
|
c.totalPages = Math.ceil( c.totalRows / c.size );
|
|
updatePageDisplay(table, c);
|
|
fixHeight(table, c);
|
|
$t.trigger('pagerChange', c);
|
|
}
|
|
},
|
|
|
|
getAjax = function(table, c){
|
|
var $t = $(table),
|
|
url = c.ajaxUrl.replace(/\{page\}/g, c.page).replace(/\{size\}/g, c.size);
|
|
if ( url !== '' ) {
|
|
// loading icon
|
|
c.temp = $('<div/>', {
|
|
'class' : 'tablesorter-processing',
|
|
width : $t.outerWidth(true),
|
|
height: $t.outerHeight(true)
|
|
});
|
|
$t.before( c.temp );
|
|
$(document).ajaxError(function(e, xhr, settings, exception) {
|
|
renderAjax(null, table, c, exception);
|
|
});
|
|
$.getJSON(url, function(data) {
|
|
renderAjax(data, table, c);
|
|
});
|
|
}
|
|
},
|
|
|
|
renderTable = function(table, rows, c) {
|
|
var i, j, o,
|
|
f = document.createDocumentFragment(),
|
|
l = rows.length,
|
|
s = ( c.page * c.size ),
|
|
e = ( s + c.size );
|
|
if ( l < 1 ) { return; } // empty table, abort!
|
|
$(table).trigger('pagerChange', c);
|
|
if ( !c.removeRows ) {
|
|
hideRows(table, c);
|
|
} else {
|
|
if ( e > rows.length ) {
|
|
e = rows.length;
|
|
}
|
|
$(table.tBodies[0]).addClass('tablesorter-hidden');
|
|
$.tablesorter.clearTableBody(table);
|
|
for ( i = s; i < e; i++ ) {
|
|
o = rows[i];
|
|
l = o.length;
|
|
for ( j = 0; j < l; j++ ) {
|
|
f.appendChild(o[j]);
|
|
}
|
|
}
|
|
table.tBodies[0].appendChild(f);
|
|
$(table.tBodies[0]).removeClass('tablesorter-hidden');
|
|
}
|
|
if ( c.page >= c.totalPages ) {
|
|
moveToLastPage(table, c);
|
|
}
|
|
updatePageDisplay(table, c);
|
|
if ( !c.isDisabled ) { fixHeight(table, c); }
|
|
$(table).trigger('applyWidgets');
|
|
},
|
|
|
|
showAllRows = function(table, c){
|
|
if ( c.ajax ) {
|
|
pagerArrows(c, true);
|
|
} else {
|
|
c.isDisabled = true;
|
|
$.data(table, 'pagerLastPage', c.page);
|
|
$.data(table, 'pagerLastSize', c.size);
|
|
c.page = 0;
|
|
c.size = c.totalRows;
|
|
c.totalPages = 1;
|
|
$('tr.pagerSavedHeightSpacer', table.tBodies[0]).remove();
|
|
renderTable(table, table.config.rowsCopy, c);
|
|
}
|
|
// disable size selector
|
|
$(c.cssPageSize, c.container).addClass(c.cssDisabled)[0].disabled = true;
|
|
},
|
|
|
|
moveToPage = function(table, c) {
|
|
if ( c.isDisabled ) { return; }
|
|
var p = Math.min( c.totalPages, c.filteredPages );
|
|
if ( c.page < 0 || c.page > ( p - 1 ) ) {
|
|
c.page = 0;
|
|
}
|
|
$.data(table, 'pagerLastPage', c.page);
|
|
if ( c.ajax ) {
|
|
getAjax(table, c);
|
|
} else {
|
|
renderTable(table, table.config.rowsCopy, c);
|
|
}
|
|
},
|
|
|
|
setPageSize = function(table, size, c) {
|
|
c.size = size;
|
|
$.data(table, 'pagerLastPage', c.page);
|
|
$.data(table, 'pagerLastSize', c.size);
|
|
c.totalPages = Math.ceil( c.totalRows / c.size );
|
|
moveToPage(table, c);
|
|
},
|
|
|
|
moveToFirstPage = function(table, c) {
|
|
c.page = 0;
|
|
moveToPage(table, c);
|
|
},
|
|
|
|
moveToLastPage = function(table, c) {
|
|
c.page = ( Math.min( c.totalPages, c.filteredPages ) - 1 );
|
|
moveToPage(table, c);
|
|
},
|
|
|
|
moveToNextPage = function(table, c) {
|
|
c.page++;
|
|
if ( c.page >= ( Math.min( c.totalPages, c.filteredPages ) - 1 ) ) {
|
|
c.page = ( Math.min( c.totalPages, c.filteredPages ) - 1 );
|
|
}
|
|
moveToPage(table, c);
|
|
},
|
|
|
|
moveToPrevPage = function(table, c) {
|
|
c.page--;
|
|
if ( c.page <= 0 ) {
|
|
c.page = 0;
|
|
}
|
|
moveToPage(table, c);
|
|
},
|
|
|
|
destroyPager = function(table, c){
|
|
showAllRows(table, c);
|
|
$(c.container).hide(); // hide pager
|
|
table.config.appender = null; // remove pager appender function
|
|
$(table).unbind('destroy.pager sortEnd.pager filterEnd.pager enable.pager disable.pager');
|
|
},
|
|
|
|
enablePager = function(table, c, triggered){
|
|
var p = $(c.cssPageSize, c.container).removeClass(c.cssDisabled).removeAttr('disabled');
|
|
c.isDisabled = false;
|
|
c.page = $.data(table, 'pagerLastPage') || c.page || 0;
|
|
c.size = $.data(table, 'pagerLastSize') || parseInt(p.val(), 10) || c.size;
|
|
c.totalPages = Math.ceil( Math.min( c.totalPages, c.filteredPages ) / c.size);
|
|
if ( triggered ) {
|
|
$(table).trigger('update');
|
|
setPageSize(table, c.size, c);
|
|
hideRowsSetup(table, c);
|
|
fixHeight(table, c);
|
|
}
|
|
};
|
|
|
|
$this.appender = function(table, rows) {
|
|
var c = table.config.pager;
|
|
if ( !c.ajax ) {
|
|
table.config.rowsCopy = rows;
|
|
c.totalRows = rows.length;
|
|
c.size = $.data(table, 'pagerLastSize') || c.size;
|
|
c.totalPages = Math.ceil(c.totalRows / c.size);
|
|
renderTable(table, rows, c);
|
|
}
|
|
};
|
|
|
|
$this.construct = function(settings) {
|
|
return this.each(function() {
|
|
var config = this.config,
|
|
c = config.pager = $.extend( {}, $.tablesorterPager.defaults, settings ),
|
|
table = this,
|
|
$t = $(table),
|
|
pager = $(c.container).addClass('tablesorter-pager').show(); // added in case the pager is reinitialized after being destroyed.
|
|
config.appender = $this.appender;
|
|
enablePager(table, c, false);
|
|
if ( typeof(c.ajaxUrl) === 'string' ) {
|
|
// ajax pager; interact with database
|
|
c.ajax = true;
|
|
getAjax(table, c);
|
|
} else {
|
|
c.ajax = false;
|
|
// Regular pager; all rows stored in memory
|
|
$(this).trigger("appendCache", true);
|
|
hideRowsSetup(table, c);
|
|
}
|
|
|
|
if ( $(table).hasClass('hasFilters') ) {
|
|
$(table).unbind('filterEnd.pager').bind('filterEnd.pager', function() {
|
|
c.page = 0;
|
|
updatePageDisplay(table, c);
|
|
moveToPage(table, c);
|
|
changeHeight(table, c);
|
|
});
|
|
}
|
|
if ( $(c.cssGoto, pager).length ) {
|
|
$(c.cssGoto, pager).bind('change', function(){
|
|
c.page = $(this).val() - 1;
|
|
moveToPage(table, c);
|
|
});
|
|
updatePageDisplay(table, c);
|
|
}
|
|
$(c.cssFirst,pager).unbind('click.pager').bind('click.pager', function() {
|
|
if ( !$(this).hasClass(c.cssDisabled) ) { moveToFirstPage(table, c); }
|
|
return false;
|
|
});
|
|
$(c.cssNext,pager).unbind('click.pager').bind('click.pager', function() {
|
|
if ( !$(this).hasClass(c.cssDisabled) ) { moveToNextPage(table, c); }
|
|
return false;
|
|
});
|
|
$(c.cssPrev,pager).unbind('click.pager').bind('click.pager', function() {
|
|
if ( !$(this).hasClass(c.cssDisabled) ) { moveToPrevPage(table, c); }
|
|
return false;
|
|
});
|
|
$(c.cssLast,pager).unbind('click.pager').bind('click.pager', function() {
|
|
if ( !$(this).hasClass(c.cssDisabled) ) { moveToLastPage(table, c); }
|
|
return false;
|
|
});
|
|
$(c.cssPageSize,pager).unbind('change.pager').bind('change.pager', function() {
|
|
$(c.cssPageSize,pager).val( $(this).val() ); // in case there are more than one pagers
|
|
if ( !$(this).hasClass(c.cssDisabled) ) {
|
|
setPageSize(table, parseInt( $(this).val(), 10 ), c);
|
|
changeHeight(table, c);
|
|
}
|
|
return false;
|
|
});
|
|
|
|
$t
|
|
.unbind('disable.pager enable.pager destroy.pager update.pager')
|
|
.bind('disable.pager', function(){
|
|
showAllRows(table, c);
|
|
})
|
|
.bind('enable.pager', function(){
|
|
enablePager(table, c, true);
|
|
})
|
|
.bind('destroy.pager', function(){
|
|
destroyPager(table, c);
|
|
})
|
|
.bind('update.pager', function(){
|
|
hideRows(table, c);
|
|
});
|
|
});
|
|
};
|
|
|
|
}()
|
|
});
|
|
// extend plugin scope
|
|
$.fn.extend({
|
|
tablesorterPager: $.tablesorterPager.construct
|
|
});
|
|
|
|
})(jQuery); |