mirror of
https://github.com/Mottie/tablesorter.git
synced 2024-12-05 05:04:20 +00:00
478 lines
19 KiB
HTML
478 lines
19 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<title>jQuery plugin: Tablesorter 2.0 - Pager plugin - Ajax</title>
|
|
|
|
<!-- jQuery -->
|
|
<script src="js/jquery-latest.min.js"></script>
|
|
|
|
<!-- Demo stuff -->
|
|
<link class="ui-theme" rel="stylesheet" href="css/jquery-ui.min.css">
|
|
<link href="css/jq.css" rel="stylesheet">
|
|
<link href="css/prettify.css" rel="stylesheet">
|
|
<script src="js/jquery-ui.min.js"></script>
|
|
<script src="js/prettify.js"></script>
|
|
<script src="js/docs.js"></script>
|
|
|
|
<!-- Tablesorter: required -->
|
|
<link rel="stylesheet" href="../css/theme.blue.css">
|
|
<script src="../js/jquery.tablesorter.js"></script>
|
|
|
|
<!-- Tablesorter pager: required -->
|
|
<link rel="stylesheet" href="../addons/pager/jquery.tablesorter.pager.css">
|
|
<script src="../addons/pager/jquery.tablesorter.pager.js"></script>
|
|
|
|
<!-- Tablesorter: optional -->
|
|
<script src="../js/jquery.tablesorter.widgets.js"></script>
|
|
|
|
<script id="js">$(function(){
|
|
|
|
// Initialize tablesorter
|
|
// ***********************
|
|
$("table")
|
|
.tablesorter({
|
|
theme: 'blue',
|
|
widthFixed: true,
|
|
sortLocaleCompare: true, // needed for accented characters in the data
|
|
sortList: [ [0,1] ],
|
|
widgets: ['zebra', 'filter']
|
|
})
|
|
|
|
// initialize the pager plugin
|
|
// ****************************
|
|
.tablesorterPager({
|
|
|
|
// **********************************
|
|
// Description of ALL pager options
|
|
// **********************************
|
|
|
|
// target the pager markup - see the HTML block below
|
|
container: $(".pager"),
|
|
|
|
// use this format: "http:/mydatabase.com?page={page}&size={size}&{sortList:col}"
|
|
// where {page} is replaced by the page number (or use {page+1} to get a one-based index),
|
|
// {size} is replaced by the number of records to show,
|
|
// {sortList:col} adds the sortList to the url into a "col" array, and {filterList:fcol} adds
|
|
// the filterList to the url into an "fcol" array.
|
|
// So a sortList = [[2,0],[3,0]] becomes "&col[2]=0&col[3]=0" in the url
|
|
// and a filterList = [[2,Blue],[3,13]] becomes "&fcol[2]=Blue&fcol[3]=13" in the url
|
|
ajaxUrl : 'assets/City{page}.json?{filterList:filter}&{sortList:column}',
|
|
|
|
// modify the url after all processing has been applied
|
|
customAjaxUrl: function(table, url) {
|
|
// manipulate the url string as you desire
|
|
// url += '&cPage=' + window.location.pathname;
|
|
// trigger my custom event
|
|
$(table).trigger('changingUrl', url);
|
|
// send the server the current page
|
|
return url;
|
|
},
|
|
|
|
// ajax error callback from $.tablesorter.showError function
|
|
// ajaxError: function( config, xhr, settings, exception ){ return exception; };
|
|
// returning false will abort the error message
|
|
ajaxError: null,
|
|
|
|
// add more ajax settings here
|
|
// see http://api.jquery.com/jQuery.ajax/#jQuery-ajax-settings
|
|
ajaxObject: {
|
|
dataType: 'json'
|
|
},
|
|
|
|
// 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
|
|
// ]
|
|
// OR
|
|
// return [ total_rows, $rows (jQuery object; optional), headers (array; optional) ]
|
|
ajaxProcessing: function(data){
|
|
if (data && data.hasOwnProperty('rows')) {
|
|
var indx, r, row, c, d = data.rows,
|
|
// total number of rows (required)
|
|
total = data.total_rows,
|
|
// array of header names (optional)
|
|
headers = data.headers,
|
|
// cross-reference to match JSON key within data (no spaces)
|
|
headerXref = headers.join(',').replace(/\s+/g,'').split(','),
|
|
// all rows: array of arrays; each internal array has the table cell data for that row
|
|
rows = [],
|
|
// len should match pager set size (c.size)
|
|
len = d.length;
|
|
// this will depend on how the json is set up - see City0.json
|
|
// rows
|
|
for ( r=0; r < len; r++ ) {
|
|
row = []; // new row array
|
|
// cells
|
|
for ( c in d[r] ) {
|
|
if (typeof(c) === "string") {
|
|
// match the key with the header to get the proper column index
|
|
indx = $.inArray( c, headerXref );
|
|
// add each table cell data to row array
|
|
if (indx >= 0) {
|
|
row[indx] = d[r][c];
|
|
}
|
|
}
|
|
}
|
|
rows.push(row); // add new row array to rows array
|
|
}
|
|
// in version 2.10, you can optionally return $(rows) a set of table rows within a jQuery object
|
|
return [ total, rows, headers ];
|
|
}
|
|
},
|
|
|
|
// Set this option to false if your table data is preloaded into the table, but you are still using ajax
|
|
processAjaxOnInit: true,
|
|
|
|
// output string - default is '{page}/{totalPages}';
|
|
// possible variables: {page}, {totalPages}, {startRow}, {endRow} and {totalRows}
|
|
output: '{startRow} to {endRow} ({totalRows})',
|
|
|
|
// apply disabled classname (cssDisabled option) to the pager arrows when the rows
|
|
// are at either extreme is visible; default is true
|
|
updateArrows: true,
|
|
|
|
// starting page of the pager (zero based index)
|
|
page: 0,
|
|
|
|
// Number of visible rows - default is 10
|
|
size: 25,
|
|
|
|
// Saves the current pager page size and number (requires storage widget)
|
|
savePages: true,
|
|
// Saves tablesorter paging to custom key if defined.
|
|
// Key parameter name used by the $.tablesorter.storage function.
|
|
// Useful if you have multiple tables defined
|
|
storageKey: 'tablesorter-pager',
|
|
|
|
// Reset pager to this page after filtering; set to desired page number (zero-based index),
|
|
// or false to not change page at filter start
|
|
pageReset: 0,
|
|
|
|
// 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,
|
|
|
|
// If true, child rows will be counted towards the pager set size
|
|
countChildRows: false,
|
|
|
|
// css class names of pager arrows
|
|
cssNext : '.next', // next page arrow
|
|
cssPrev : '.prev', // previous page arrow
|
|
cssFirst : '.first', // go to first page arrow
|
|
cssLast : '.last', // go to last page arrow
|
|
cssGoto : '.gotoPage', // page select dropdown - select dropdown that set the "page" option
|
|
|
|
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; see the "updateArrows" option
|
|
// (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
|
|
cssErrorRow : 'tablesorter-errorRow' // error information row
|
|
|
|
});
|
|
|
|
});</script>
|
|
|
|
</head>
|
|
<body id="pager-demo">
|
|
<div id="banner">
|
|
<h1>table<em>sorter</em></h1>
|
|
<h2>Pager plugin - Ajax</h2>
|
|
<h3>Flexible client-side table sorting</h3>
|
|
<a href="index.html">Back to documentation</a>
|
|
</div>
|
|
|
|
<div id="main">
|
|
|
|
<p></p>
|
|
<br>
|
|
<div class="accordion">
|
|
|
|
<h3><a href="#">Notes</a></h3>
|
|
<div>
|
|
<ul>
|
|
<li>In <span class="version">v2.13.3</span>, the "ID" column has a default filter setting of ">30" and a descending sort, but neither is applied as this demo is not connected a server (just a basic JSON file).</li>
|
|
<li>In <span class="version">v2.11</span>, the pager now stores any object returned by the `ajaxProcessing` function in `table.config.pager.ajaxData` (see the ajaxProcessing section below for more details).</li>
|
|
<li>In <span class="version updated">v2.10</span>, the <code>ajaxProcessing</code> function was updated to only require a total number of rows to be returned, also instead of returning an array of table rows, you can build the table yourself and just return the jQuery object containing those rows. The addon triggers an update.</li>
|
|
<li><code>{filterList:fcol}</code> was added to the <code>ajaxUrl</code> in version 2.6.</li>
|
|
<li><code>{sortList:col}</code> was added to the <code>ajaxUrl</code> in version 2.4.5.</li>
|
|
<li>This update to the pager plugin that interacts with a database via ajax was added in version 2.0.32 and can be applied to the original tablesorter.</li>
|
|
<li>The <code>ajaxUrl</code> and <code>ajaxProcessing</code> function are both required options for this interaction to work properly.</li>
|
|
<li>The <code>ajaxUrl</code> contains a replaceable string to send the requested page (<code>{page}</code>), block size (<code>{size}</code>) or sort order (<code>{sortList:name}</code>).</li>
|
|
<li>The table header and footer text will be updated to match the JSON "header column #" text; but there is an issue with the table rendering improperly if the number of columns in the HTML and the number of columns in the JSON don't match.</li>
|
|
<li><strong>Limitations of this demo</strong>:
|
|
<ul>
|
|
<li>This demo will not work when viewing it locally (except in Firefox) due to communication restrictions between the browser and your desktop.</li>
|
|
<li>The record size is limited to 25 records because this demo is not interacting with an actual database, but with four JSON files containing 25 records each.</li>
|
|
<li>Sorting of columns is disabled in this demo because no table data is cached when <code>serverSideSorting</code> is enabled. <del>Sorting of columns is enabled in this demo by setting the <code>serverSideSorting</code> option to <code>false</code> after initialization. It only sorts the current table contents because there is no server to return sorted data</del>.</li>
|
|
<li>The filters will only update the "Current Ajax url" because again, we're just working with JSON files here.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<p class="small">* If you have a different JSON format and need help with the processing code, please ask the question on <a href="http://stackoverflow.com/questions/tagged/tablesorter">StackOverflow</a> or message me directly (gmail; wowmotty). Please don't open an issue for help with code.</p>
|
|
</div>
|
|
|
|
<h3><a href="#">ajaxProcessing</a></h3>
|
|
<div>
|
|
The <code>ajaxProcessing</code> function is needed to convert your custom JSON format into an array usable by the pager plugin (modified in 2.1.3)<br>
|
|
<br>
|
|
So, given this custom JSON format (this is only an example):
|
|
<pre class="prettyprint lang-javascript">{
|
|
"total_rows": 80,
|
|
|
|
"headers" : [
|
|
"ID", "Name", "Country Code", "District", "Population"
|
|
],
|
|
|
|
"rows" : [{
|
|
"ID": 1,
|
|
"Name": "Kabul",
|
|
"CountryCode": "AFG",
|
|
"District": "Kabol",
|
|
"Population": 1780000
|
|
}, {
|
|
"ID": 2,
|
|
"Name": "Qandahar",
|
|
"CountryCode": "AFG",
|
|
"District": "Qandahar",
|
|
"Population": 237500
|
|
}, {
|
|
...
|
|
}, {
|
|
"ID": 25,
|
|
"Name": "Haarlemmermeer",
|
|
"CountryCode": "NLD",
|
|
"District": "Noord-Holland",
|
|
"Population": 110722
|
|
}]
|
|
}</pre>
|
|
<h3>OBJECT returned</h3>
|
|
<ul>
|
|
<li>In <span class="version">v2.11</span>, the <code>ajaxProcessing</code> can just return the above object directly (<strong>or don't even bother setting an <code>ajaxProcessing</code> function</strong>).
|
|
So, if an object is returned by the <code>ajaxProcessing</code> function, the data is stored in <code>table.config.pager.ajaxData</code>:
|
|
<ul>
|
|
<li>The object should contain attributes for <code>total</code> (numeric), <code>headers</code> (array) and <code>rows</code> (array of arrays).</li>
|
|
<li>A replacement <code>output</code> option can also be loaded via this method and must be included in the <code>output</code> attribute (i.e. <code>ajaxData.output</code>).</li>
|
|
<li>Additional attributes are also available to the output display by using the attribute key wrapped in curly brackets (e.g. <code>{extra}</code> from <code>ajaxData.extra</code>).</li>
|
|
<li>Additional attributes can also be objects or arrays and can be accessed via the output string as <code>{extra:0}</code> (for arrays) or <code>{extra:key}</code> for objects.</li>
|
|
<li>The page number is processed first, so it would be possible to use this string <code>{extra:{page}}</code> (<code>{page}</code> is a one-based index), or if you need a different value use <code>{page+1}</code> (zero-based index plus any number), or <code>{page-1}</code> (zero-based index minus any number).</li>
|
|
<li>For more details, please see <a href="https://github.com/Mottie/tablesorter/issues/326">issue #326</a>.</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h3>ARRAY returned</h3>
|
|
<ul>
|
|
<li>The <code>ajaxProcessing</code> function can return the data in the following format <code>[ total, rows, headers (optional) ]</code>,
|
|
<br>or in version 2.9+ <code>[ rows, total, headers (optional) ]</code>,
|
|
<br>or in <span class="version">v2.10</span>, return a jQuery object within the array <code>[ total, $rows ]</code>, or just <code>[ total ]</code>:
|
|
<pre class="prettyprint lang-javascript">[
|
|
// total # rows contained in the database
|
|
80,
|
|
// row data: array of arrays; each internal array has the table cell data for that row
|
|
[
|
|
[ 1, "Kabul", "AFG", "Kabol", 1780000 ], // [ "row1cell1", "row1cell2", ... "row1cellN" ],
|
|
[ 2, "Qandahar", "AFG", "Qandahar", 237500 ], // [ "row2cell1", "row2cell2", ... "row2cellN" ],
|
|
...
|
|
[ 25, "Haarlemmermeer", "NLD", "Noord-Holland", 110722 ] // [ "rowNcell1", "rowNcell2", ... "rowNcellN" ]
|
|
],
|
|
[ "ID", "Name", "Country Code", "District", "Population" ] // [ "Header1", "Header2", ... "HeaderN" ] (optional)
|
|
]</pre></li>
|
|
</ul>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<h1>Demo</h1>
|
|
Original Ajax url: <span id="origurl"></span><br>
|
|
Current Ajax url: <span id="url"></span>
|
|
<br>
|
|
<table class="tablesorter">
|
|
<thead>
|
|
<tr>
|
|
<td class="pager sorter-false" colspan="5">
|
|
<img src="../addons/pager/icons/first.png" class="first" alt="First" />
|
|
<img src="../addons/pager/icons/prev.png" class="prev" alt="Prev" />
|
|
<span class="pagedisplay"></span> <!-- this can be any element, including an input -->
|
|
<img src="../addons/pager/icons/next.png" class="next" alt="Next" />
|
|
<img src="../addons/pager/icons/last.png" class="last" alt="Last" />
|
|
<select class="pagesize">
|
|
<option value="25">25</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<th data-value=">30">1</th>
|
|
<th>2</th>
|
|
<th>3</th>
|
|
<th>4</th>
|
|
<th>5</th>
|
|
</tr>
|
|
</thead>
|
|
<tfoot>
|
|
<tr>
|
|
<th>1</th>
|
|
<th>2</th>
|
|
<th>3</th>
|
|
<th>4</th>
|
|
<th>5</th>
|
|
</tr>
|
|
<tr>
|
|
<td class="pager" colspan="5">
|
|
<img src="../addons/pager/icons/first.png" class="first" alt="First" />
|
|
<img src="../addons/pager/icons/prev.png" class="prev" alt="Prev" />
|
|
<span class="pagedisplay"></span> <!-- this can be any element, including an input -->
|
|
<img src="../addons/pager/icons/next.png" class="next" alt="Next" />
|
|
<img src="../addons/pager/icons/last.png" class="last" alt="Last" />
|
|
<select class="pagesize">
|
|
<option value="25">25</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
</tfoot>
|
|
<tbody>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h1>Javascript</h1>
|
|
<div id="javascript">
|
|
<pre class="prettyprint lang-javascript"></pre>
|
|
</div>
|
|
|
|
<h1>CSS</h1>
|
|
<div>
|
|
<pre class="prettyprint lang-css">/* pager wrapper, div */
|
|
.pager {
|
|
padding: 5px;
|
|
}
|
|
/* pager wrapper, in thead/tfoot */
|
|
td.pager {
|
|
background-color: #e6eeee;
|
|
}
|
|
/* pager navigation arrows */
|
|
.pager img {
|
|
vertical-align: middle;
|
|
margin-right: 2px;
|
|
}
|
|
/* pager output text */
|
|
.pager .pagedisplay {
|
|
font-size: 11px;
|
|
padding: 0 5px 0 5px;
|
|
width: 50px;
|
|
text-align: center;
|
|
}
|
|
|
|
/*** loading ajax indeterminate progress indicator ***/
|
|
#tablesorterPagerLoading {
|
|
background: rgba(255,255,255,0.8) url(icons/loading.gif) center center no-repeat;
|
|
position: absolute;
|
|
z-index: 1000;
|
|
}
|
|
|
|
/*** css used when "updateArrows" option is true ***/
|
|
/* the pager itself gets a disabled class when the number of rows is less than the size */
|
|
.pager.disabled {
|
|
display: none;
|
|
}
|
|
/* hide or fade out pager arrows when the first or last row is visible */
|
|
.pager img.disabled {
|
|
/* visibility: hidden */
|
|
opacity: 0.5;
|
|
filter: alpha(opacity=50);
|
|
}</pre>
|
|
</div>
|
|
|
|
<h1>HTML</h1>
|
|
<div id="html">
|
|
<pre class="prettyprint lang-html"><table class="tablesorter">
|
|
<thead>
|
|
<tr>
|
|
<td class="pager" colspan="5">
|
|
<img src="../addons/pager/icons/first.png" class="first"/>
|
|
<img src="../addons/pager/icons/prev.png" class="prev"/>
|
|
<span class="pagedisplay"></span> <!-- this can be any element, including an input -->
|
|
<img src="../addons/pager/icons/next.png" class="next"/>
|
|
<img src="../addons/pager/icons/last.png" class="last"/>
|
|
<select class="pagesize">
|
|
<option value="25">25</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<th>1 data-value="&gt;30"</th> <!-- thead text will be updated from the JSON; make sure the number of columns matches the JSON data -->
|
|
<th>2</th>
|
|
<th>3</th>
|
|
<th>4</th>
|
|
<th>5</th>
|
|
</tr>
|
|
</thead>
|
|
<tfoot>
|
|
<tr>
|
|
<th>1</th> <!-- tfoot text will be updated at the same time as the thead -->
|
|
<th>2</th>
|
|
<th>3</th>
|
|
<th>4</th>
|
|
<th>5</th>
|
|
</tr>
|
|
<tr>
|
|
<td class="pager" colspan="5">
|
|
<img src="../addons/pager/icons/first.png" class="first"/>
|
|
<img src="../addons/pager/icons/prev.png" class="prev"/>
|
|
<span class="pagedisplay"></span> <!-- this can be any element, including an input -->
|
|
<img src="../addons/pager/icons/next.png" class="next"/>
|
|
<img src="../addons/pager/icons/last.png" class="last"/>
|
|
<select class="pagesize">
|
|
<option value="25">25</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
</tfoot>
|
|
<tbody> <!-- tbody will be loaded via JSON -->
|
|
</tbody>
|
|
</table></pre>
|
|
|
|
</div>
|
|
|
|
<div class="next-up">
|
|
<hr />
|
|
Next up: <a href="example-pager-filtered.html">Pager plugin + filter widget ››</a>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<script>
|
|
var $url = $('#url');
|
|
$('table')
|
|
|
|
// show current URL for the DEMO ONLY
|
|
.on('changingUrl', function(e, url){
|
|
$url.html(url);
|
|
})
|
|
|
|
.on('pagerInitialized', function(){
|
|
// allow THIS demo to sort the content; this variable is automatically set to true when ajax
|
|
// is used as there isn't any way to sort the server side data from the client side.
|
|
this.config.serverSideSorting = false;
|
|
// show original highlighted URL
|
|
$('#origurl').html( this.config.pager.ajaxUrl.replace(/(\{.*?\})/g, '<span class="results">$1</span>') );
|
|
});
|
|
</script>
|
|
|
|
</body>
|
|
</html>
|