2016-12-02 17:46:11 +01:00
<!doctype html>
2013-10-16 13:13:30 +02:00
< html >
2016-12-02 17:46:11 +01:00
< 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 - Complex headers with column visibility< / 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.12.0.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" >
2013-10-16 13:13:30 +02:00
$(document).ready(function() {
2015-08-10 15:57:47 +02:00
$('#example').DataTable( {
2013-10-16 13:13:30 +02:00
"columnDefs": [ {
"visible": false,
"targets": -1
} ]
} );
} );
2016-12-02 17:46:11 +01:00
< / script >
< / head >
< body class = "dt-example " >
< div class = "container" >
< section >
< h1 > DataTables example < span > Complex headers with column visibility< / span > < / h1 >
< div class = "info" >
< p > Complex headers (using < code > colspan< / code > / < code > rowspan< / code > ) can be used to group columns of similar information in DataTables, creating a very powerful visual effect.< / p >
< p > In addition to the basic behaviour, DataTables can also take < code > colspan< / code > and < code > rowspan< / code > s into account when working with hidden columns. The < code > colspan< / code > and < code > rowspan< / code > attributes for each cell are automatically calculated and rendered on the page for you. This allows the < a href = "//datatables.net/reference/option/columns.visible" > < code class = "option" title = "DataTables initialisation option" > columns.visible< / code > < / a > option and < a href = "//datatables.net/reference/api/column().visible()" > < code class = "api" title = "DataTables API method" > column().visible()< / code > < / a > method to take into account < code > rowspan< / code > / < code > colspan< / code > cells, drawing the header correctly.< / p >
< p > Note that each column must have at least one unique cell (i.e. a cell without < code > colspan< / code > ) so DataTables can use that cell to detect the column and use it to apply ordering.< / p >
< p > The example below shows a header spanning multiple cells over the contact information, with one of the columns that the span covers being hidden.< / p >
< / div >
< table id = "example" class = "display" cellspacing = "0" width = "100%" > < thead > < tr > < th rowspan = "2" > Name< / th > < th colspan = "2" > HR Information< / th > < th colspan = "3" > Contact< / th > < / tr > < tr > < th > Position< / th > < th > Salary< / th > < th > Office< / th > < th > Extn.< / th > < th > E-mail< / th > < / tr > < / thead > < tfoot > < tr > < th > Name< / th > < th > Position< / th > < th > Salary< / th > < th > Office< / th > < th > Extn.< / th > < th > E-mail< / th > < / tr > < / tfoot > < tbody > < tr > < td > Tiger Nixon< / td > < td > System Architect< / td > < td > $320,800< / td > < td > Edinburgh< / td > < td > 5421< / td > < td > t.nixon@datatables.net< / td > < / tr > < tr > < td > Garrett Winters< / td > < td > Accountant< / td > < td > $170,750< / td > < td > Tokyo< / td > < td > 8422< / td > < td > g.winters@datatables.net< / td > < / tr > < tr > < td > Ashton Cox< / td > < td > Junior Technical Author< / td > < td > $86,000< / td > < td > San Francisco< / td > < td > 1562< / td > < td > a.cox@datatables.net< / td > < / tr > < tr > < td > Cedric Kelly< / td > < td > Senior Javascript Developer< / td > < td > $433,060< / td > < td > Edinburgh< / td > < td > 6224< / td > < td > c.kelly@datatables.net< / td > < / tr > < tr > < td > Airi Satou< / td > < td > Accountant< / td > < td > $162,700< / td > < td > Tokyo< / td > < td > 5407< / td > < td > a.satou@datatables.net< / td > < / tr > < tr > < td > Brielle Williamson< / td > < td > Integration Specialist< / td > < td > $372,000< / td > < td > New York< / td > < td > 4804< / td > < td > b.williamson@datatables.net< / td > < / tr > < tr > < td > Herrod Chandler< / td > < td > Sales Assistant< / td > < td > $137,500< / td > < td > San Francisco< / td > < td > 9608< / td > < td > h.chandler@datatables.net< / td > < / tr > < tr > < td > Rhona Davidson< / td > < td > Integration Specialist< / td > < td > $327,900< / td > < td > Tokyo< / td > < td > 6200< / td > < td > r.davidson@datatables.net< / td > < / tr > < tr > < td > Colleen Hurst< / td > < td > Javascript Developer< / td > < td > $205,500< / td > < td > San Francisco< / td > < td > 2360< / td > < td > c.hurst@datatables.net< / td > < / tr > < tr > < td > Sonya Frost< / td > < td > Software Engineer< / td > < td > $103,600< / td > < td > Edinburgh< / td > < td > 1667< / td > < td > s.frost@datatables.net< / td > < / tr > < tr > < td > Jena Gaines< / td > < td > Office Manager< / td > < td > $90,560< / td > < td > London< / td > < td > 3814< / td > < td > j.gaines@datatables.net< / td > < / tr > < tr > < td > Quinn Flynn< / td > < td > Support Lead< / td > < td > $342,000< / td > < td > Edinburgh< / td > < td > 9497< / td > < td > q.flynn@datatables.net< / td > < / tr > < tr > < td > Charde Marshall< / td > < td > Regional Director< / td > < td > $470,600< / td > < td > San Francisco< / td > < td > 6741< / td > < td > c.marshall@datatables.net< / td > < / tr > < tr > < td > Haley Kennedy< / td > < td > Senior Marketing Designer< / td > < td > $313,500< / td > < td > London< / td > < td > 3597< / td > < td > h.kennedy@datatables.net< / td > < / tr > < tr > < td > Tatyana Fitzpatrick< / td > < td > Regional Director< / td > < td > $385,750< / td > < td > London< / td > < td > 1965< / td > < td > t.fitzpatrick@datatables.net< / td > < / tr > < tr > < td > Michael Silva< / td > < td > Marketing Designer< / td > < td > $198,500< / td > < td > London< / td > < td > 1581< / td > < td > m.silva@datatables.net< / td > < / tr > < tr > < td > Paul Byrd< / td > < td > Chief Financial Officer (CFO)< / td > < td > $725,000< / td > < td > New York< / td > < td > 3059< / td > < td > p.byrd@datatables.net< / td > < / tr > < tr > < td > Gloria Little< / td > < td > Systems Administrator< / td > < td > $237,500< / td > < td > New York< / td > < td > 1721< / td > < td > g.little@datatables.net< / td > < / tr > < tr > < td > Bradley Greer< / td > < td > Software Engineer< / td > < td > $132,000< / td > < td > London< / td > < td > 2558< / td > < td > b.greer@datatables.net< / td > < / tr > < tr > < td > Dai Rios< / td > < td > Personnel Lead< / td > < td > $217,500< / td > < td > Edinburgh< / td > < td > 2290< / td > < td > d.rios@datatables.net< / td > < / tr > < tr > < td > Jenette Caldwell< / td > < td > Development Lead< / td > < td > $345,000< / td > < td > New York< / td > < td > 1937< / td > < td > j.caldwell@datatables.net< / td > < / tr > < tr > < td > Yuri Berry< / td > < td > Chief Marketing Officer (CMO)< / td > < td > $675,000< / td > < td > New York< / td > < td > 6154< / td > < td > y.berry@datatables.net< / td > < / tr > < tr > < td > Caesar Vance< / td > < td > Pre-Sales Support< / td > < td > $106,450< / td > < td > New York< / td > < td > 8330< / td > < td > c.vance@datatables.net< / td > < / tr > < tr > < td > Doris Wilder< / td > < td > Sales Assistant< / td > < td > $85,600< / td > < td > Sidney< / td > < td > 3023< / td > < td > d.wilder@datatables.net< / td > < / tr > < tr > < td > Angelica Ramos< / td > < td > Chief Executive Officer (CEO)< / td > < td > $1,200,000< / td > < td > London< / td > < td > 5797< / td > < td > a.ramos@datatables.net< / td > < / tr > < tr > < td > Gavin Joyce< / td > < td > Developer< / td > < td > $92,575< / td > < td > Edinburgh< / td > < td > 8822< / td > < td > g.joyce@datatables.net< / td > < / tr > < tr > < td > Jennifer Chang< / td > < td > Regional Director< / td > < td > $357,650< / td > < td > Singapore< / td > < td > 9239< / td > < td > j.chang@datatables.net< / td > < / tr > < tr > <
< 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() {
2015-08-10 15:57:47 +02:00
$('#example').DataTable( {
2013-10-16 13:13:30 +02:00
" columnDefs" : [ {
" visible" : false,
" targets" : -1
} ]
} );
2013-12-19 15:03:24 +01:00
} );< / code >
2016-12-02 17:46:11 +01:00
< 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.12.0.min.js" > //code.jquery.com/jquery-1.12.0.min.js< / a > < / li > < li > < a href = "../../media/js/jquery.dataTables.js" > ../../media/js/jquery.dataTables.js< / a > < / li > < / ul >
2013-10-16 13:13:30 +02:00
< / div >
2016-12-02 17:46:11 +01:00
< div class = "table" >
< p > The HTML shown below is the raw HTML table element, before it has been enhanced by DataTables:< / p >
2013-10-16 13:13:30 +02:00
< / div >
2016-12-02 17:46:11 +01:00
< 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 >
2013-10-16 13:13:30 +02:00
< / div >
2016-12-02 17:46:11 +01:00
< 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 >
2013-10-16 13:13:30 +02:00
< / div >
2016-12-02 17:46:11 +01:00
< 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 >
2015-09-25 11:08:52 +02:00
< / div >
2016-12-02 17:46:11 +01:00
< / 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 = "../basic_init/index.html
">Basic initialisation< / a > < / h3 > < ul class = "toc" > < li > < a href = "../basic_init/zero_configuration.html
">Zero configuration< / a > < / li > < li > < a href = "../basic_init/filter_only.html
">Feature enable / disable< / a > < / li > < li > < a href = "../basic_init/table_sorting.html
">Default ordering (sorting)< / a > < / li > < li > < a href = "../basic_init/multi_col_sort.html
">Multi-column ordering< / 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/complex_header.html
">Complex headers (rowspan and colspan)< / a > < / li > < li > < a href = "../basic_init/dom.html
">DOM positioning< / a > < / li > < li > < a href = "../basic_init/flexible_width.html
">Flexible table width< / a > < / li > < li > < a href = "../basic_init/state_save.html
">State saving< / a > < / li > < li > < a href = "../basic_init/alt_pagination.html
">Alternative pagination< / a > < / li > < li > < a href = "../basic_init/scroll_y.html
">Scroll - vertical< / a > < / li > < li > < a href = "../basic_init/scroll_y_dynamic.html
">Scroll - vertical, dynamic height< / a > < / li > < li > < a href = "../basic_init/scroll_x.html
">Scroll - horizontal< / a > < / li > < li > < a href = "../basic_init/scroll_xy.html
">Scroll - horizontal and vertical< / a > < / li > < li > < a href = "../basic_init/comma-decimal.html
">Language - Comma decimal place< / a > < / li > < li > < a href = "../basic_init/language.html
">Language options< / a > < / li > < / ul > < / div > < div class = "toc-group" > < h3 > < a href = "./index.html
">Advanced initialisation< / a > < / h3 > < ul class = "toc active" > < li > < a href = "./events_live.html
">DOM / jQuery events< / a > < / li > < li > < a href = "./dt_events.html
">DataTables events< / a > < / li > < li > < a href = "./column_render.html
">Column rendering< / a > < / li > < li > < a href = "./length_menu.html
">Page length options< / a > < / li > < li > < a href = "./dom_multiple_elements.html
">Multiple table control elements< / a > < / li > < li class = "active" > < a href = "./complex_header.html
">Complex headers with column visibility< / a > < / li > < li > < a href = "./object_dom_read.html
">Read HTML to data objects< / a > < / li > < li > < a href = "./html5-data-options.html
">HTML5 data-* attributes - table options< / a > < / li > < li > < a href = "./html5-data-attributes.html
">HTML5 data-* attributes - cell data< / a > < / li > < li > < a href = "./language_file.html
">Language file< / a > < / li > < li > < a href = "./defaults.html
">Setting defaults< / a > < / li > < li > < a href = "./row_callback.html
">Row created callback< / a > < / li > < li > < a href = "./row_grouping.html
">Row grouping< / a > < / li > < li > < a href = "./footer_callback.html
">Footer callback< / a > < / li > < li > < a href = "./dom_toolbar.html
">Custom toolbar elements< / a > < / li > < li > < a href = "./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 3< / a > < / li > < li > < a href = "../styling/foundation.html
">Foundation< / a > < / li > < li > < a href = "../styling/jqueryUI.html
">jQuery UI ThemeRoller< / a > < / li > < li > < a href = "../styling/bootstrap4.html
">Bootstrap 4 (Tech. preview)< / a > < / li > < li > < a href = "../styling/semanticui.html
">Semantic UI (Tech. preview)< / a > < / li > < li > < a href = "../styling/material.html
">Material Design (Tech. preview)< / a > < / li > < li > < a href = "../styling/uikit.html
">UIKit (Tech. preview)< / 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 >
2013-10-16 13:13:30 +02:00
< / div >
2016-12-02 17:46:11 +01:00
< 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-2016< br >
DataTables is licensed under the < a href = "http://www.datatables.net/mit" > MIT license< / a > .
< / p >
2015-09-25 11:08:52 +02:00
< / div >
< / div >
2013-10-16 13:13:30 +02:00
< / div >
2016-12-02 17:46:11 +01:00
< / section >
< / body >
2013-10-16 13:13:30 +02:00
< / html >
