mirror of
https://github.com/DataTables/DataTables.git
synced 2024-11-29 11:24:10 +01:00
fde6ba858a
New: The distance from the end of the current scrolling container before new data is added (with infinite scrolling) can be controlled with iScrollLoadGap (which is a numeric value in pixels). New: Example (basic_init/scrolling_y_infinite.html) to show how infinite scrolling can be used. Fixed: iDraw was not being incremented for a draw that did not use server-side processing.
355 lines
13 KiB
HTML
355 lines
13 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
|
<link rel="shortcut icon" type="image/ico" href="http://www.sprymedia.co.uk/media/images/favicon.ico" />
|
|
|
|
<title>DataTables example</title>
|
|
<style type="text/css" title="currentStyle">
|
|
@import "../../media/css/demo_page.css";
|
|
@import "../../media/css/demo_table.css";
|
|
</style>
|
|
<script type="text/javascript" language="javascript" src="../../media/js/jquery.js"></script>
|
|
<script type="text/javascript" language="javascript" src="../../media/js/jquery.dataTables.js"></script>
|
|
<script type="text/javascript" charset="utf-8">
|
|
$(document).ready(function() {
|
|
$('#example').dataTable( {
|
|
"bProcessing": true,
|
|
"bServerSide": true,
|
|
"sAjaxSource": "../examples_support/server_processing.php"
|
|
} );
|
|
} );
|
|
</script>
|
|
</head>
|
|
<body id="dt_example">
|
|
<div id="container">
|
|
<div class="full_width big">
|
|
<i>DataTables</i> server-side processing example
|
|
</div>
|
|
|
|
<h1>Preamble</h1>
|
|
<p>There are many ways to get your data into DataTables, and if you are working with seriously large databases, you might want to consider using the server-side options that DataTables provides. Basically all of the paging, filtering, sorting etc that DataTables does can be handed off to a server (or any other data source - Google Gears or Adobe Air for example!) and DataTables is just an events and display module.</p>
|
|
<p>The example here shows a very simple display of the CSS data (used in all my other examples), but in this instance coming from the server on each draw. Filtering, multi-column sorting etc all work as you would expect.</p>
|
|
|
|
<h1>Live example</h1>
|
|
<div id="dynamic">
|
|
<table cellpadding="0" cellspacing="0" border="0" class="display" id="example">
|
|
<thead>
|
|
<tr>
|
|
<th width="20%">Rendering engine</th>
|
|
<th width="25%">Browser</th>
|
|
<th width="25%">Platform(s)</th>
|
|
<th width="15%">Engine version</th>
|
|
<th width="15%">CSS grade</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td colspan="5" class="dataTables_empty">Loading data from server</td>
|
|
</tr>
|
|
</tbody>
|
|
<tfoot>
|
|
<tr>
|
|
<th>Rendering engine</th>
|
|
<th>Browser</th>
|
|
<th>Platform(s)</th>
|
|
<th>Engine version</th>
|
|
<th>CSS grade</th>
|
|
</tr>
|
|
</tfoot>
|
|
</table>
|
|
</div>
|
|
<div class="spacer"></div>
|
|
|
|
|
|
<h1>Initialisation code</h1>
|
|
<pre>$(document).ready(function() {
|
|
$('#example').dataTable( {
|
|
"bProcessing": true,
|
|
"bServerSide": true,
|
|
"sAjaxSource": "../examples_support/server_processing.php"
|
|
} );
|
|
} );</pre>
|
|
|
|
|
|
<h1>Server side (PHP) code</h1>
|
|
<pre><?php
|
|
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* Easy set variables
|
|
*/
|
|
|
|
/* Array of database columns which should be read and sent back to DataTables. Use a space where
|
|
* you want to insert a non-database field (for example a counter or static image)
|
|
*/
|
|
$aColumns = array( 'engine', 'browser', 'platform', 'version', 'grade' );
|
|
|
|
/* Indexed column (used for fast and accurate table cardinality) */
|
|
$sIndexColumn = "id";
|
|
|
|
/* DB table to use */
|
|
$sTable = "ajax";
|
|
|
|
/* Database connection information */
|
|
$gaSql['user'] = "";
|
|
$gaSql['password'] = "";
|
|
$gaSql['db'] = "";
|
|
$gaSql['server'] = "localhost";
|
|
|
|
|
|
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
|
|
* If you just want to use the basic configuration for DataTables with PHP server-side, there is
|
|
* no need to edit below this line
|
|
*/
|
|
|
|
/*
|
|
* MySQL connection
|
|
*/
|
|
$gaSql['link'] = mysql_pconnect( $gaSql['server'], $gaSql['user'], $gaSql['password'] ) or
|
|
die( 'Could not open connection to server' );
|
|
|
|
mysql_select_db( $gaSql['db'], $gaSql['link'] ) or
|
|
die( 'Could not select database '. $gaSql['db'] );
|
|
|
|
|
|
/*
|
|
* Paging
|
|
*/
|
|
$sLimit = "";
|
|
if ( isset( $_GET['iDisplayStart'] ) && $_GET['iDisplayLength'] != '-1' )
|
|
{
|
|
$sLimit = "LIMIT ".mysql_real_escape_string( $_GET['iDisplayStart'] ).", ".
|
|
mysql_real_escape_string( $_GET['iDisplayLength'] );
|
|
}
|
|
|
|
|
|
/*
|
|
* Ordering
|
|
*/
|
|
if ( isset( $_GET['iSortCol_0'] ) )
|
|
{
|
|
$sOrder = "ORDER BY ";
|
|
for ( $i=0 ; $i<intval( $_GET['iSortingCols'] ) ; $i++ )
|
|
{
|
|
if ( $_GET[ 'bSortable_'.intval($_GET['iSortCol_'.$i]) ] == "true" )
|
|
{
|
|
$sOrder .= $aColumns[ intval( $_GET['iSortCol_'.$i] ) ]."
|
|
".mysql_real_escape_string( $_GET['sSortDir_'.$i] ) .", ";
|
|
}
|
|
}
|
|
|
|
$sOrder = substr_replace( $sOrder, "", -2 );
|
|
if ( $sOrder == "ORDER BY" )
|
|
{
|
|
$sOrder = "";
|
|
}
|
|
}
|
|
|
|
|
|
/*
|
|
* Filtering
|
|
* NOTE this does not match the built-in DataTables filtering which does it
|
|
* word by word on any field. It's possible to do here, but concerned about efficiency
|
|
* on very large tables, and MySQL's regex functionality is very limited
|
|
*/
|
|
$sWhere = "";
|
|
if ( $_GET['sSearch'] != "" )
|
|
{
|
|
$sWhere = "WHERE (";
|
|
for ( $i=0 ; $i<count($aColumns) ; $i++ )
|
|
{
|
|
$sWhere .= $aColumns[$i]." LIKE '%".mysql_real_escape_string( $_GET['sSearch'] )."%' OR ";
|
|
}
|
|
$sWhere = substr_replace( $sWhere, "", -3 );
|
|
$sWhere .= ')';
|
|
}
|
|
|
|
/* Individual column filtering */
|
|
for ( $i=0 ; $i<count($aColumns) ; $i++ )
|
|
{
|
|
if ( $_GET['bSearchable_'.$i] == "true" && $_GET['sSearch_'.$i] != '' )
|
|
{
|
|
if ( $sWhere == "" )
|
|
{
|
|
$sWhere = "WHERE ";
|
|
}
|
|
else
|
|
{
|
|
$sWhere .= " AND ";
|
|
}
|
|
$sWhere .= $aColumns[$i]." LIKE '%".mysql_real_escape_string($_GET['sSearch_'.$i])."%' ";
|
|
}
|
|
}
|
|
|
|
|
|
/*
|
|
* SQL queries
|
|
* Get data to display
|
|
*/
|
|
$sQuery = "
|
|
SELECT SQL_CALC_FOUND_ROWS ".str_replace(" , ", " ", implode(", ", $aColumns))."
|
|
FROM $sTable
|
|
$sWhere
|
|
$sOrder
|
|
$sLimit
|
|
";
|
|
$rResult = mysql_query( $sQuery, $gaSql['link'] ) or die(mysql_error());
|
|
|
|
/* Data set length after filtering */
|
|
$sQuery = "
|
|
SELECT FOUND_ROWS()
|
|
";
|
|
$rResultFilterTotal = mysql_query( $sQuery, $gaSql['link'] ) or die(mysql_error());
|
|
$aResultFilterTotal = mysql_fetch_array($rResultFilterTotal);
|
|
$iFilteredTotal = $aResultFilterTotal[0];
|
|
|
|
/* Total data set length */
|
|
$sQuery = "
|
|
SELECT COUNT(".$sIndexColumn.")
|
|
FROM $sTable
|
|
";
|
|
$rResultTotal = mysql_query( $sQuery, $gaSql['link'] ) or die(mysql_error());
|
|
$aResultTotal = mysql_fetch_array($rResultTotal);
|
|
$iTotal = $aResultTotal[0];
|
|
|
|
|
|
/*
|
|
* Output
|
|
*/
|
|
$sOutput = '{';
|
|
$sOutput .= '"sEcho": '.intval($_GET['sEcho']).', ';
|
|
$sOutput .= '"iTotalRecords": '.$iTotal.', ';
|
|
$sOutput .= '"iTotalDisplayRecords": '.$iFilteredTotal.', ';
|
|
$sOutput .= '"aaData": [ ';
|
|
while ( $aRow = mysql_fetch_array( $rResult ) )
|
|
{
|
|
$sOutput .= "[";
|
|
for ( $i=0 ; $i<count($aColumns) ; $i++ )
|
|
{
|
|
if ( $aColumns[$i] == "version" )
|
|
{
|
|
/* Special output formatting for 'version' */
|
|
$sOutput .= ($aRow[ $aColumns[$i] ]=="0") ?
|
|
'"-",' :
|
|
'"'.str_replace('"', '\"', $aRow[ $aColumns[$i] ]).'",';
|
|
}
|
|
else if ( $aColumns[$i] != ' ' )
|
|
{
|
|
/* General output */
|
|
$sOutput .= '"'.str_replace('"', '\"', $aRow[ $aColumns[$i] ]).'",';
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Optional Configuration:
|
|
* If you need to add any extra columns (add/edit/delete etc) to the table, that aren't in the
|
|
* database - you can do it here
|
|
*/
|
|
|
|
|
|
$sOutput = substr_replace( $sOutput, "", -1 );
|
|
$sOutput .= "],";
|
|
}
|
|
$sOutput = substr_replace( $sOutput, "", -1 );
|
|
$sOutput .= '] }';
|
|
|
|
echo $sOutput;
|
|
?></pre>
|
|
|
|
|
|
<h1>Other examples</h1>
|
|
<h2>Basic initialisation</h2>
|
|
<ul>
|
|
<li><a href="../basic_init/zero_config.html">Zero configuration</a></li>
|
|
<li><a href="../basic_init/filter_only.html">Feature enablement</a></li>
|
|
<li><a href="../basic_init/table_sorting.html">Sorting data</a></li>
|
|
<li><a href="../basic_init/multi_col_sort.html">Multi-column sorting</a></li>
|
|
<li><a href="../basic_init/multiple_tables.html">Multiple tables</a></li>
|
|
<li><a href="../basic_init/hidden_columns.html">Hidden columns</a></li>
|
|
<li><a href="../basic_init/dom.html">DOM positioning</a></li>
|
|
<li><a href="../basic_init/state_save.html">State saving</a></li>
|
|
<li><a href="../basic_init/alt_pagination.html">Alternative pagination styles</a></li>
|
|
<li>Scrolling:
|
|
<a href="../basic_init/scroll_x.html">Horizontal</a> /
|
|
<a href="../basic_init/scroll_y.html">Vertical</a> /
|
|
<a href="../basic_init/scroll_xy.html">Both</a> /
|
|
<a href="../basic_init/scroll_y_theme.html">Themed</a> /
|
|
<a href="../basic_init/scroll_y_infinite.html">Infinite</a>
|
|
</li>
|
|
<li><a href="../basic_init/language.html">Change language information (internationalisation)</a></li>
|
|
<li><a href="../basic_init/themes.html">ThemeRoller themes (Smoothness)</a></li>
|
|
</ul>
|
|
|
|
<h2>Advanced initialisation</h2>
|
|
<ul>
|
|
<li><a href="../advanced_init/events_pre_init.html">Events (pre initialisation)</a></li>
|
|
<li><a href="../advanced_init/events_post_init.html">Events (post initialisation)</a></li>
|
|
<li><a href="../advanced_init/column_render.html">Column rendering</a></li>
|
|
<li><a href="../advanced_init/html_sort.html">Sorting without HTML tags</a></li>
|
|
<li><a href="../advanced_init/dom_multiple_elements.html">Multiple table controls (sDom)</a></li>
|
|
<li><a href="../advanced_init/length_menu.html">Defining length menu options</a></li>
|
|
<li><a href="../advanced_init/dom_toolbar.html">Custom toolbar (element) around table</a></li>
|
|
<li><a href="../advanced_init/highlight.html">Row highlighting with CSS</a></li>
|
|
<li><a href="../advanced_init/complex_header.html">Column grouping through col/row spans</a></li>
|
|
<li><a href="../advanced_init/row_grouping.html">Row grouping</a></li>
|
|
<li><a href="../advanced_init/row_callback.html">Row callback</a></li>
|
|
<li><a href="../advanced_init/footer_callback.html">Footer callback</a></li>
|
|
<li><a href="../advanced_init/language_file.html">Change language information from a file (internationalisation)</a></li>
|
|
</ul>
|
|
|
|
<h2>Data sources</h2>
|
|
<ul>
|
|
<li><a href="../data_sources/dom.html">DOM</a></li>
|
|
<li><a href="../data_sources/js_array.html">Javascript array</a></li>
|
|
<li><a href="../data_sources/ajax.html">Ajax source</a></li>
|
|
<li><a href="../data_sources/server_side.html">Server side processing</a></li>
|
|
</ul>
|
|
|
|
<h2>Server-side processing</h2>
|
|
<ul>
|
|
<li><a href="../server_side/server_side.html">Obtain server-side data</a></li>
|
|
<li><a href="../server_side/custom_vars.html">Add extra HTTP variables</a></li>
|
|
<li><a href="../server_side/post.html">Use HTTP POST</a></li>
|
|
<li><a href="../server_side/column_ordering.html">Custom column ordering (in callback data)</a></li>
|
|
<li><a href="../server_side/pipeline.html">Pipelining data (reduce Ajax calls for paging)</a></li>
|
|
<li><a href="../server_side/row_details.html">Show and hide details about a particular record</a></li>
|
|
<li><a href="../server_side/select_rows.html">User selectable rows (multiple rows)</a></li>
|
|
</ul>
|
|
|
|
<h2>API</h2>
|
|
<ul>
|
|
<li><a href="../api/add_row.html">Dynamically add a new row</a></li>
|
|
<li><a href="../api/multi_filter.html">Individual column filtering (using "input" elements)</a></li>
|
|
<li><a href="../api/multi_filter_select.html">Individual column filtering (using "select" elements)</a></li>
|
|
<li><a href="../api/highlight.html">Highlight rows and columns</a></li>
|
|
<li><a href="../api/row_details.html">Show and hide details about a particular record</a></li>
|
|
<li><a href="../api/select_row.html">User selectable rows (multiple rows)</a></li>
|
|
<li><a href="../api/select_single_row.html">User selectable rows (single row) and delete rows</a></li>
|
|
<li><a href="../api/editable.html">Editable rows (with jEditable)</a></li>
|
|
<li><a href="../api/form.html">Submit form with elements in table</a></li>
|
|
<li><a href="../api/counter_column.html">Index column (static number column)</a></li>
|
|
<li><a href="../api/show_hide.html">Show and hide columns dynamically</a></li>
|
|
<li><a href="../api/api_in_init.html">API function use in initialisation object (callback)</a></li>
|
|
<li><a href="../api/tabs_and_scrolling.html">DataTables scrolling and tabs</a></li>
|
|
<li><a href="../api/regex.html">Regular expression filtering</a></li>
|
|
</ul>
|
|
|
|
<h2>Plug-ins</h2>
|
|
<ul>
|
|
<li><a href="../plug-ins/plugin_api.html">Add custom API functions</a></li>
|
|
<li><a href="../plug-ins/sorting_plugin.html">Sorting and type detection</a></li>
|
|
<li><a href="../plug-ins/paging_plugin.html">Custom pagination controls</a></li>
|
|
<li><a href="../plug-ins/range_filtering.html">Range filtering / custom filtering</a></li>
|
|
<li><a href="../plug-ins/dom_sort.html">Live DOM sorting</a></li>
|
|
<li><a href="../plug-ins/html_sort.html">Automatic HTML type detection</a></li>
|
|
</ul>
|
|
|
|
|
|
<p>Please refer to the <a href="http://www.datatables.net/"><i>DataTables</i> documentation</a> for full information about its API properties and methods.</p>
|
|
|
|
|
|
<div id="footer" style="text-align:center;">
|
|
<span style="font-size:10px;">DataTables © Allan Jardine 2008-2010</span>
|
|
</div>
|
|
</div>
|
|
</body>
|
|
</html> |