mirror of
https://github.com/DataTables/DataTables.git
synced 2024-12-04 16:24:11 +01:00
b84cc6063e
- See DataTables/DataTables #679 and https://jsfiddle.net/7mgny9gb/2/ - Thanks @mpryvkin for noting this bug and the test cases
228 lines
19 KiB
HTML
228 lines
19 KiB
HTML
<!doctype html>
|
|
<html>
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<link rel="shortcut icon" type="image/ico" href="http://www.datatables.net/favicon.ico" />
|
|
<meta name="viewport" content="initial-scale=1.0, maximum-scale=2.0" />
|
|
|
|
<title>DataTables example - Multi-column ordering</title>
|
|
|
|
<link rel="stylesheet" type="text/css" href="../../media/css/jquery.dataTables.css"><link rel="stylesheet" type="text/css" href="../resources/syntax/shCore.css"><link rel="stylesheet" type="text/css" href="../resources/demo.css">
|
|
<style type="text/css" class="init">
|
|
|
|
</style>
|
|
<script type="text/javascript" language="javascript" src="//code.jquery.com/jquery-1.11.3.min.js"></script><script type="text/javascript" language="javascript" src="../../media/js/jquery.dataTables.js"></script><script type="text/javascript" language="javascript" src="../resources/syntax/shCore.js"></script><script type="text/javascript" language="javascript" src="../resources/demo.js"></script>
|
|
<script type="text/javascript" language="javascript" class="init">
|
|
|
|
|
|
$(document).ready(function() {
|
|
$('#example').DataTable( {
|
|
columnDefs: [ {
|
|
targets: [ 0 ],
|
|
orderData: [ 0, 1 ]
|
|
}, {
|
|
targets: [ 1 ],
|
|
orderData: [ 1, 0 ]
|
|
}, {
|
|
targets: [ 4 ],
|
|
orderData: [ 4, 0 ]
|
|
} ]
|
|
} );
|
|
} );
|
|
|
|
</script>
|
|
</head>
|
|
<body class="dt-example ">
|
|
<div class="container">
|
|
<section>
|
|
<h1>DataTables example <span>Multi-column ordering</span></h1>
|
|
<div class="info">
|
|
<p>DataTables allows ordering by multiple columns at the same time, which can be activated in a number of different ways:</p>
|
|
|
|
<ul class="markdown">
|
|
<li>User shift click on a column (added the clicked column as a secondary, tertiary etc ordering column).</li>
|
|
<li>On a per-column basis (i.e. order by a specific column and then a secondary column if the data in the first column is identical), through the <a href="//datatables.net/reference/option/columns.orderData"><code class="option" title="DataTables initialisation option">columns.orderData</code></a> option.</li>
|
|
<li>Using the <a href="//datatables.net/reference/option/columns.orderData"><code class="option" title="DataTables initialisation option">columns.orderData</code></a> option to specify a multiple column order by default (for example <code>[ 0, 1 ]</code>).</li>
|
|
<li>Through the <a href="//datatables.net/reference/api/order()"><code class="api" title="DataTables API method">order()</code></a> API method.</li>
|
|
</ul>
|
|
|
|
<p>Note that, the ability for the user to shift click to order multiple columns can be disabled through the <a href="//datatables.net/reference/option/orderMulti"><code class="option" title="DataTables initialisation option">orderMulti</code></a> option.</p>
|
|
|
|
<p>The example below shows the first column having a secondary order applied to the second column in the table, vice-versa for the second column being tied directly to the first and the salary column to the first name column.</p>
|
|
|
|
</div>
|
|
|
|
|
|
<table id="example" class="display" cellspacing="0" width="100%"><thead><tr><th>First name</th><th>Last name</th><th>Position</th><th>Office</th><th>Salary</th></tr></thead><tbody><tr><td>Tiger</td><td>Nixon</td><td>System Architect</td><td>Edinburgh</td><td>$320,800</td></tr><tr><td>Garrett</td><td>Winters</td><td>Accountant</td><td>Tokyo</td><td>$170,750</td></tr><tr><td>Ashton</td><td>Cox</td><td>Junior Technical Author</td><td>San Francisco</td><td>$86,000</td></tr><tr><td>Cedric</td><td>Kelly</td><td>Senior Javascript Developer</td><td>Edinburgh</td><td>$433,060</td></tr><tr><td>Airi</td><td>Satou</td><td>Accountant</td><td>Tokyo</td><td>$162,700</td></tr><tr><td>Brielle</td><td>Williamson</td><td>Integration Specialist</td><td>New York</td><td>$372,000</td></tr><tr><td>Herrod</td><td>Chandler</td><td>Sales Assistant</td><td>San Francisco</td><td>$137,500</td></tr><tr><td>Rhona</td><td>Davidson</td><td>Integration Specialist</td><td>Tokyo</td><td>$327,900</td></tr><tr><td>Colleen</td><td>Hurst</td><td>Javascript Developer</td><td>San Francisco</td><td>$205,500</td></tr><tr><td>Sonya</td><td>Frost</td><td>Software Engineer</td><td>Edinburgh</td><td>$103,600</td></tr><tr><td>Jena</td><td>Gaines</td><td>Office Manager</td><td>London</td><td>$90,560</td></tr><tr><td>Quinn</td><td>Flynn</td><td>Support Lead</td><td>Edinburgh</td><td>$342,000</td></tr><tr><td>Charde</td><td>Marshall</td><td>Regional Director</td><td>San Francisco</td><td>$470,600</td></tr><tr><td>Haley</td><td>Kennedy</td><td>Senior Marketing Designer</td><td>London</td><td>$313,500</td></tr><tr><td>Tatyana</td><td>Fitzpatrick</td><td>Regional Director</td><td>London</td><td>$385,750</td></tr><tr><td>Michael</td><td>Silva</td><td>Marketing Designer</td><td>London</td><td>$198,500</td></tr><tr><td>Paul</td><td>Byrd</td><td>Chief Financial Officer (CFO)</td><td>New York</td><td>$725,000</td></tr><tr><td>Gloria</td><td>Little</td><td>Systems Administrator</td><td>New York</td><td>$237,500</td></tr><tr><td>Bradley</td><td>Greer</td><td>Software Engineer</td><td>London</td><td>$132,000</td></tr><tr><td>Dai</td><td>Rios</td><td>Personnel Lead</td><td>Edinburgh</td><td>$217,500</td></tr><tr><td>Jenette</td><td>Caldwell</td><td>Development Lead</td><td>New York</td><td>$345,000</td></tr><tr><td>Yuri</td><td>Berry</td><td>Chief Marketing Officer (CMO)</td><td>New York</td><td>$675,000</td></tr><tr><td>Caesar</td><td>Vance</td><td>Pre-Sales Support</td><td>New York</td><td>$106,450</td></tr><tr><td>Doris</td><td>Wilder</td><td>Sales Assistant</td><td>Sidney</td><td>$85,600</td></tr><tr><td>Angelica</td><td>Ramos</td><td>Chief Executive Officer (CEO)</td><td>London</td><td>$1,200,000</td></tr><tr><td>Gavin</td><td>Joyce</td><td>Developer</td><td>Edinburgh</td><td>$92,575</td></tr><tr><td>Jennifer</td><td>Chang</td><td>Regional Director</td><td>Singapore</td><td>$357,650</td></tr><tr><td>Brenden</td><td>Wagner</td><td>Software Engineer</td><td>San Francisco</td><td>$206,850</td></tr><tr><td>Fiona</td><td>Green</td><td>Chief Operating Officer (COO)</td><td>San Francisco</td><td>$850,000</td></tr><tr><td>Shou</td><td>Itou</td><td>Regional Marketing</td><td>Tokyo</td><td>$163,000</td></tr><tr><td>Michelle</td><td>House</td><td>Integration Specialist</td><td>Sidney</td><td>$95,400</td></tr><tr><td>Suki</td><td>Burks</td><td>Developer</td><td>London</td><td>$114,500</td></tr><tr><td>Prescott</td><td>Bartlett</td><td>Technical Author</td><td>London</td><td>$145,000</td></tr><tr><td>Gavin</td><td>Cortez</td><td>Team Leader</td><td>San Francisco</td><td>$235,500</td></tr><tr><td>Martena</td><td>Mccray</td><td>Post-Sales support</td><td>Edinburgh</td><td>$324,050</td></tr><tr><td>Unity</td><td>Butler</td><td>Marketing Designer</td><td>San Francisco</td><td>$85,675</td></tr><tr><td>Howard</td><td>Hatfield</td><td>Office Manager</td><td>San Francisco</td><td>$164,500</td></tr><tr><td>Hope</td><td>Fuentes</td><td>Secretary</td><td>San Francisco</td><td>$109,850</td></tr><tr><td>Vivian</td><td>Harrell</td><td>Financial Controller</td><td>San Francisco</td><td>$452,500</td></tr><tr><td>Timothy</td><td>Mooney</td><td>Office Manager</td><td>London</td><td>$136,200</td></tr><tr><td>Jackson</td><td>Bradshaw</td><td>Director</td><td>New York</td><td>$645,750</td></tr><tr><td>Olivia</td><td>Liang</td><td>Support Engineer</td><td>Singapore</td><td>$234,500</td></tr><tr><td>Bruno</td><td>Nash</td><td>Software Engineer</td><td>London</td><td>$163,500</td></tr><tr><td>Sakura</td><td>Yamamoto</td><td>Support Engineer</td><td>Tokyo</td><td>$139,575</td></tr><tr><td>Thor</td><td>Walton</td><td>Developer</td><td>New York</td><td>$98,540</td></tr><tr><td>Finn</td><td>Camacho</td><td>Support Engineer</td><td>San Francisco</td><td>$87,500</td></tr><tr><td>Serge</td><td>Baldwin</td><td>Data Coordinator</td><td>Singapore</td><td>$138,575</td></tr><tr><td>Zenaida</td><td>Frank</td><td>Software Engineer</td><td>New York</td><td>$125,250</td></tr><tr><td>Zorita</td><td>Serrano</td><td>Software Engineer</td><td>San Francisco</td><td>$115,000</td></tr><tr><td>Jennifer</td><td>Acosta</td><td>Junior Javascript Developer</td><td>Edinburgh</td><td>$75,650</td></tr><tr><td>Cara</td><td>Stevens</td><td>Sales Assistant</td><td>New York</td><td>$145,600</td></tr><tr><td>Hermione</td><td>Butler</td><td>Regional Director</td><td>London</td><td>$356,250</td></tr><tr><td>Lael</td><td>Greer</td><td>Systems Administrator</td><td>London</td><td>$103,500</td></tr><tr><td>Jonas</td><td>Alexander</td><td>Developer</td><td>San Francisco</td><td>$86,500</td></tr><tr><td>Shad</td><td>Decker</td><td>Regional Director</td><td>Edinburgh</td><td>$183,000</td></tr><tr><td>Michael</td><td>Bruce</td><td>Javascript Developer</td><td>Singapore</td><td>$183,000</td></tr><tr><td>Donna</td><td>Snider</td><td>Customer Support</td><td>New York</td><td>$112,000</td></tr></tbody></table>
|
|
|
|
<ul class="tabs">
|
|
<li class="active">Javascript</li>
|
|
<li>HTML</li>
|
|
<li>CSS</li>
|
|
<li>Ajax</li>
|
|
<li>Server-side script</li>
|
|
</ul>
|
|
|
|
<div class="tabs">
|
|
<div class="js">
|
|
<p>The Javascript shown below is used to initialise the table shown in this example:</p>
|
|
<code class="multiline language-js">$(document).ready(function() {
|
|
$('#example').DataTable( {
|
|
columnDefs: [ {
|
|
targets: [ 0 ],
|
|
orderData: [ 0, 1 ]
|
|
}, {
|
|
targets: [ 1 ],
|
|
orderData: [ 1, 0 ]
|
|
}, {
|
|
targets: [ 4 ],
|
|
orderData: [ 4, 0 ]
|
|
} ]
|
|
} );
|
|
} );</code>
|
|
|
|
<p>In addition to the above code, the following Javascript library files are loaded for use in this example:</p>
|
|
<ul><li><a href="//code.jquery.com/jquery-1.11.3.min.js">//code.jquery.com/jquery-1.11.3.min.js</a></li><li><a href="../../media/js/jquery.dataTables.js">../../media/js/jquery.dataTables.js</a></li></ul>
|
|
</div>
|
|
<div class="table">
|
|
<p>The HTML shown below is the raw HTML table element, before it has been enhanced by DataTables:</p>
|
|
</div>
|
|
<div class="css">
|
|
<div>
|
|
<p>This example uses a little bit of additional CSS beyond what is loaded from the library files (below), in order to correctly display the table. The additional CSS used is shown below:</p>
|
|
<code class="multiline language-css"></code>
|
|
</div>
|
|
|
|
<p>The following CSS library files are loaded for use in this example to provide the styling of the table:</p>
|
|
<ul><li><a href="../../media/css/jquery.dataTables.css">../../media/css/jquery.dataTables.css</a></li></ul>
|
|
</div>
|
|
<div class="ajax">
|
|
<p>This table loads data by Ajax. The latest data that has been loaded is shown below. This data will update automatically as any additional data is loaded.</p>
|
|
</div>
|
|
<div class="php">
|
|
<p>The script used to perform the server-side processing for this table is shown below. Please note that this is just an example script using PHP. Server-side processing scripts can be written in any language, using <a href="//datatables.net/manual/server-side">the protocol described in the DataTables documentation</a>.</p>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
|
|
</div>
|
|
|
|
<section>
|
|
<div class="footer">
|
|
<div class="gradient"></div>
|
|
<div class="liner">
|
|
<h2>Other examples</h2>
|
|
<div class="toc">
|
|
<div class="toc-group"><h3><a href="./index.html
|
|
">Basic initialisation</a></h3><ul class="toc active"><li><a href="./zero_configuration.html
|
|
">Zero configuration</a></li><li><a href="./filter_only.html
|
|
">Feature enable / disable</a></li><li><a href="./table_sorting.html
|
|
">Default ordering (sorting)</a></li><li class="active"><a href="./multi_col_sort.html
|
|
">Multi-column ordering</a></li><li><a href="./multiple_tables.html
|
|
">Multiple tables</a></li><li><a href="./hidden_columns.html
|
|
">Hidden columns</a></li><li><a href="./complex_header.html
|
|
">Complex headers (rowspan and colspan)</a></li><li><a href="./dom.html
|
|
">DOM positioning</a></li><li><a href="./flexible_width.html
|
|
">Flexible table width</a></li><li><a href="./state_save.html
|
|
">State saving</a></li><li><a href="./alt_pagination.html
|
|
">Alternative pagination</a></li><li><a href="./scroll_y.html
|
|
">Scroll - vertical</a></li><li><a href="./scroll_y_dynamic.html
|
|
">Scroll - vertical, dynamic height</a></li><li><a href="./scroll_x.html
|
|
">Scroll - horizontal</a></li><li><a href="./scroll_xy.html
|
|
">Scroll - horizontal and vertical</a></li><li><a href="./comma-decimal.html
|
|
">Language - Comma decimal place</a></li><li><a href="./language.html
|
|
">Language options</a></li></ul></div><div class="toc-group"><h3><a href="../advanced_init/index.html
|
|
">Advanced initialisation</a></h3><ul class="toc"><li><a href="../advanced_init/events_live.html
|
|
">DOM / jQuery events</a></li><li><a href="../advanced_init/dt_events.html
|
|
">DataTables events</a></li><li><a href="../advanced_init/column_render.html
|
|
">Column rendering</a></li><li><a href="../advanced_init/length_menu.html
|
|
">Page length options</a></li><li><a href="../advanced_init/dom_multiple_elements.html
|
|
">Multiple table control elements</a></li><li><a href="../advanced_init/complex_header.html
|
|
">Complex headers with column visibility</a></li><li><a href="../advanced_init/object_dom_read.html
|
|
">Read HTML to data objects</a></li><li><a href="../advanced_init/html5-data-attributes.html
|
|
">HTML5 data-* attributes - cell data</a></li><li><a href="../advanced_init/html5-data-options.html
|
|
">HTML5 data-* attributes - table options</a></li><li><a href="../advanced_init/language_file.html
|
|
">Language file</a></li><li><a href="../advanced_init/defaults.html
|
|
">Setting defaults</a></li><li><a href="../advanced_init/row_callback.html
|
|
">Row created callback</a></li><li><a href="../advanced_init/row_grouping.html
|
|
">Row grouping</a></li><li><a href="../advanced_init/footer_callback.html
|
|
">Footer callback</a></li><li><a href="../advanced_init/dom_toolbar.html
|
|
">Custom toolbar elements</a></li><li><a href="../advanced_init/sort_direction_control.html
|
|
">Order direction sequence control</a></li></ul></div><div class="toc-group"><h3><a href="../styling/index.html
|
|
">Styling</a></h3><ul class="toc"><li><a href="../styling/display.html
|
|
">Base style</a></li><li><a href="../styling/no-classes.html
|
|
">Base style - no styling classes</a></li><li><a href="../styling/cell-border.html
|
|
">Base style - cell borders</a></li><li><a href="../styling/compact.html
|
|
">Base style - compact</a></li><li><a href="../styling/hover.html
|
|
">Base style - hover</a></li><li><a href="../styling/order-column.html
|
|
">Base style - order-column</a></li><li><a href="../styling/row-border.html
|
|
">Base style - row borders</a></li><li><a href="../styling/stripe.html
|
|
">Base style - stripe</a></li><li><a href="../styling/bootstrap.html
|
|
">Bootstrap</a></li><li><a href="../styling/foundation.html
|
|
">Foundation</a></li><li><a href="../styling/jqueryUI.html
|
|
">jQuery UI ThemeRoller</a></li></ul></div><div class="toc-group"><h3><a href="../data_sources/index.html
|
|
">Data sources</a></h3><ul class="toc"><li><a href="../data_sources/dom.html
|
|
">HTML (DOM) sourced data</a></li><li><a href="../data_sources/ajax.html
|
|
">Ajax sourced data</a></li><li><a href="../data_sources/js_array.html
|
|
">Javascript sourced data</a></li><li><a href="../data_sources/server_side.html
|
|
">Server-side processing</a></li></ul></div><div class="toc-group"><h3><a href="../api/index.html
|
|
">API</a></h3><ul class="toc"><li><a href="../api/add_row.html
|
|
">Add rows</a></li><li><a href="../api/multi_filter.html
|
|
">Individual column searching (text inputs)</a></li><li><a href="../api/multi_filter_select.html
|
|
">Individual column searching (select inputs)</a></li><li><a href="../api/highlight.html
|
|
">Highlighting rows and columns</a></li><li><a href="../api/row_details.html
|
|
">Child rows (show extra / detailed information)</a></li><li><a href="../api/select_row.html
|
|
">Row selection (multiple rows)</a></li><li><a href="../api/select_single_row.html
|
|
">Row selection and deletion (single row)</a></li><li><a href="../api/form.html
|
|
">Form inputs</a></li><li><a href="../api/counter_columns.html
|
|
">Index column</a></li><li><a href="../api/show_hide.html
|
|
">Show / hide columns dynamically</a></li><li><a href="../api/api_in_init.html
|
|
">Using API in callbacks</a></li><li><a href="../api/tabs_and_scrolling.html
|
|
">Scrolling and Bootstrap tabs</a></li><li><a href="../api/regex.html
|
|
">Search API (regular expressions)</a></li></ul></div><div class="toc-group"><h3><a href="../ajax/index.html
|
|
">Ajax</a></h3><ul class="toc"><li><a href="../ajax/simple.html
|
|
">Ajax data source (arrays)</a></li><li><a href="../ajax/objects.html
|
|
">Ajax data source (objects)</a></li><li><a href="../ajax/deep.html
|
|
">Nested object data (objects)</a></li><li><a href="../ajax/objects_subarrays.html
|
|
">Nested object data (arrays)</a></li><li><a href="../ajax/orthogonal-data.html
|
|
">Orthogonal data</a></li><li><a href="../ajax/null_data_source.html
|
|
">Generated content for a column</a></li><li><a href="../ajax/custom_data_property.html
|
|
">Custom data source property</a></li><li><a href="../ajax/custom_data_flat.html
|
|
">Flat array data source</a></li><li><a href="../ajax/defer_render.html
|
|
">Deferred rendering for speed</a></li></ul></div><div class="toc-group"><h3><a href="../server_side/index.html
|
|
">Server-side</a></h3><ul class="toc"><li><a href="../server_side/simple.html
|
|
">Server-side processing</a></li><li><a href="../server_side/custom_vars.html
|
|
">Custom HTTP variables</a></li><li><a href="../server_side/post.html
|
|
">POST data</a></li><li><a href="../server_side/ids.html
|
|
">Automatic addition of row ID attributes</a></li><li><a href="../server_side/object_data.html
|
|
">Object data source</a></li><li><a href="../server_side/row_details.html
|
|
">Row details</a></li><li><a href="../server_side/select_rows.html
|
|
">Row selection</a></li><li><a href="../server_side/jsonp.html
|
|
">JSONP data source for remote domains</a></li><li><a href="../server_side/defer_loading.html
|
|
">Deferred loading of data</a></li><li><a href="../server_side/pipeline.html
|
|
">Pipelining data to reduce Ajax calls for paging</a></li></ul></div><div class="toc-group"><h3><a href="../plug-ins/index.html
|
|
">Plug-ins</a></h3><ul class="toc"><li><a href="../plug-ins/api.html
|
|
">API plug-in methods</a></li><li><a href="../plug-ins/sorting_auto.html
|
|
">Ordering plug-ins (with type detection)</a></li><li><a href="../plug-ins/sorting_manual.html
|
|
">Ordering plug-ins (no type detection)</a></li><li><a href="../plug-ins/range_filtering.html
|
|
">Custom filtering - range search</a></li><li><a href="../plug-ins/dom_sort.html
|
|
">Live DOM ordering</a></li></ul></div>
|
|
</div>
|
|
|
|
<div class="epilogue">
|
|
<p>
|
|
Please refer to the <a href="http://www.datatables.net">DataTables documentation</a> for full information about its API properties and methods.<br>
|
|
Additionally, there are a wide range of <a href="http://www.datatables.net/extensions">extensions</a> and <a href="http://www.datatables.net/plug-ins">plug-ins</a> which extend the capabilities of DataTables.
|
|
</p>
|
|
|
|
<p class="copyright">
|
|
DataTables designed and created by <a href="http://www.sprymedia.co.uk">SpryMedia Ltd</a> © 2007-2015<br>
|
|
DataTables is licensed under the <a href="http://www.datatables.net/mit">MIT license</a>.
|
|
</p>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
</body>
|
|
</html> |