When displaying a table which scrolls along the x-axis, it can sometimes be useful to the end user for the left most column to be fixed in place, if it shows grouping, index or similar information. This is basically the same idea as 'freeze columns' in Excel. This can be achieved with the FixedColumns plug-in for DataTables, as shown below.
FixedColumns allows columns to be fixed from both the left and right hand sides of the table. Fixing right hand-side columns is done by using the fixedColumns.rightColumns initialisation parameter, which works just the same as fixedColumns.leftColumns does for the left side of the table. This example shows both the left and right columns being fixed in place.
FixedColumns allows columns to be fixed from both the left and right hand sides of the table. Fixing right hand-side columns is done by using the fixedColumns.rightColumns initialisation parameter, which works just the same as fixedColumns.leftColumns does for the left side of the table. This example shows both the left and right columns being fixed in place.
FixedColumns has the ability to freeze columns on both the left and right hand sides of the table. By default it will fix the first column on the left, but using the initialisation parameters fixedColumns.leftColumns and fixedColumns.rightColumns you can alter this to fix the columns on the right as well. This example shows a single column fixed in place, in this case the right most column.
FixedColumns operates with DataTables' built-in column visibility options (columns.visible and column().visible()), which columns that are hidden not being shown in the fixed columns. This integration also means that FixedColumns works well with the column visibility module of the Buttons extension, with columns that are dynamically shown and hidden updated immediately in the fixed columns.
Because of the method FixedColumns uses to display the fixed columns, an important consideration is the alignment of the rows due to different heights in the individual rows of the table. There are two different algorithms in FixedColumns which can be used, or you can switch off automatic row sizing all together. This is controlled through the heightMatch parameter. If can take the following values:
A typical interaction to want to perform with a fixed column, is an index column. A method for how this can be achieved with FixedColumns is shown in this example, building on the index column example for DataTables. Also shown in this example is how the fixed column can be styled with CSS to show it more prominently.
This example shows the Select extension for DataTables being used with FixedColumns. With Select the end user has the ability to select elements in the table - in the case below this is done by clicking on the table cells (including in the fixed column) to select cells. Select is enabled using select, which also provides its own configuration options.
If you are using multiple rows in the table header, it can be useful to have a row spanning cell on the column(s) you have fixed in place - equally at other times it can be useful to not and make use of the two or more cells per column. FixedColumns builds on the complex header support in DataTables to make this trivial to use in FixedColumns. Just initialize your FixedColumns instance as you normally would!
Airi Satou | Accountant | $162,700 | Tokyo | 5407 | a.satou@datatables.net |
Angelica Ramos | Chief Executive Officer (CEO) | $1,200,000 | London | 5797 | a.ramos@datatables.net |
Ashton Cox | Junior Technical Author | $86,000 | San Francisco | 1562 | a.cox@datatables.net |
Bradley Greer | Software Engineer | $132,000 | London | 2558 | b.greer@datatables.net |
Brenden Wagner | Software Engineer | $206,850 | San Francisco | 1314 | b.wagner@datatables.net |
Brielle Williamson | Integration Specialist | $372,000 | New York | 4804 | b.williamson@datatables.net |
Bruno Nash | Software Engineer | $163,500 | London | 6222 | b.nash@datatables.net |
Caesar Vance | Pre-Sales Support | $106,450 | New York | 8330 | c.vance@datatables.net |
Cara Stevens | Sales Assistant | $145,600 | New York | 3990 | c.stevens@datatables.net |
Cedric Kelly | Senior Javascript Developer | $433,060 | Edinburgh | 6224 | c.kelly@datatables.net |
Charde Marshall | Regional Director | $470,600 | San Francisco | 6741 | c.marshall@datatables.net |
Colleen Hurst | Javascript Developer | $205,500 | San Francisco | 2360 | c.hurst@datatables.net |
Dai Rios | Personnel Lead | $217,500 | Edinburgh | 2290 | d.rios@datatables.net |
Donna Snider | Customer Support | $112,000 | New York | 4226 | d.snider@datatables.net |
Doris Wilder | Sales Assistant | $85,600 | Sidney | 3023 | d.wilder@datatables.net |
Finn Camacho | Support Engineer | $87,500 | San Francisco | 2927 | f.camacho@datatables.net |
Fiona Green | Chief Operating Officer (COO) | $850,000 | San Francisco | 2947 | f.green@datatables.net |
Garrett Winters | Accountant | $170,750 | Tokyo | 8422 | g.winters@datatables.net |
Gavin Cortez | Team Leader | $235,500 | San Francisco | 2860 | g.cortez@datatables.net |
Gavin Joyce | Developer | $92,575 | Edinburgh | 8822 | g.joyce@datatables.net |
Gloria Little | Systems Administrator | $237,500 | New York | 1721 | g.little@datatables.net |
Haley Kennedy | Senior Marketing Designer | $313,500 | London | 3597 | h.kennedy@datatables.net |
Hermione Butler | Regional Director | $356,250 | London | 1016 | h.butler@datatables.net |
Herrod Chandler | Sales Assistant | $137,500 | San Francisco | 9608 | h.chandler@datatables.net |
Hope Fuentes | Secretary | $109,850 | San Francisco | 6318 | h.fuentes@datatables.net |
Howard Hatfield | Office Manager | $164,500 | San Francisco | 7031 | h.hatfield@datatables.net |
Jackson Bradshaw | Director | $645,750 | New York | 1042 | j.bradshaw@datatables.net |
Jena Gaines | Office Manager | $90,560 | London | 3814 | j.gaines@datatables.net |
Jenette Caldwell | Development Lead | $345,000 | New York | 1937 | j.caldwell@datatables.net |
Jennifer Acosta | Junior Javascript Developer | $75,650 | Edinburgh | 3431 | j.acosta@datatables.net |
Jennifer Chang | Regional Director | $357,650 | Singapore | 9239 | j.chang@datatables.net |
Jonas Alexander | Developer | $86,500 | San Francisco | 8196 | j.alexander@datatables.net |
Lael Greer | Systems Administrator | $103,500 | London | 6733 | l.greer@datatables.net |
Martena Mccray | Post-Sales support | $324,050 | Edinburgh | 8240 | m.mccray@datatables.net |
Michael Bruce | Javascript Developer | $183,000 | Singapore | 5384 | m.bruce@datatables.net |
Michael Silva | Marketing Designer | $198,500 | London | 1581 | m.silva@datatables.net |
Michelle House | Integration Specialist | $95,400 | Sidney | 2769 | m.house@datatables.net |
Olivia Liang | Support Engineer | $234,500 | Singapore | 2120 | o.liang@datatables.net |
Paul Byrd | Chief Financial Officer (CFO) | $725,000 | New York | 3059 | p.byrd@datatables.net |
Prescott Bartlett | Technical Author | $145,000 | London | 3606 | p.bartlett@datatables.net |
Quinn Flynn | Support Lead | $342,000 | Edinburgh | 9497 | q.flynn@datatables.net |
Rhona Davidson | Integration Specialist | $327,900 | Tokyo | 6200 | r.davidson@datatables.net |
Sakura Yamamoto | Support Engineer | $139,575 | Tokyo | 9383 | s.yamamoto@datatables.net |
Serge Baldwin | Data Coordinator | $138,575 | Singapore | 8352 | s.baldwin@datatables.net |
Shad Decker | Regional Director | $183,000 | Edinburgh | 6373 | s.decker@datatables.net |
Shou Itou | Regional Marketing | $163,000 | Tokyo | 8899 | s.itou@datatables.net |
Sonya Frost | Software Engineer | $103,600 | Edinburgh | 1667 | s.frost@datatables.net |
Suki Burks | Developer | $114,500 | London | 6832 | s.burks@datatables.net |
Tatyana Fitzpatrick | Regional Director | $385,750 | London | 1965 | t.fitzpatrick@datatables.net |
Thor Walton | Developer | $98,540 | New York | 8327 | t.walton@datatables.net |
Tiger Nixon | System Architect | $320,800 | Edinburgh | 5421 | t.nixon@datatables.net |
Timothy Mooney | Office Manager | $136,200 | London | 7580 | t.mooney@datatables.net |
Unity Butler | Marketing Designer | $85,675 | San Francisco | 5384 | u.butler@datatables.net |
Vivian Harrell | Financial Controller | $452,500 | San Francisco | 9422 | v.harrell@datatables.net |
Yuri Berry | Chief Marketing Officer (CMO) | $675,000 | New York | 6154 | y.berry@datatables.net |
Zenaida Frank | Software Engineer | $125,250 | New York | 7439 | z.frank@datatables.net |
Zorita Serrano | Software Engineer | $115,000 | San Francisco | 4389 | z.serrano@datatables.net |
This example shows FixedColumns being configured with individual column filtering abilities. Note that the data-index attribute is attached to the input elements in order to track which column the input should filter. The event handler then uses this with the column() selector method to search the corresponding column.
Airi | Satou | Accountant | Tokyo | 33 | 2008/11/28 | $162,700 | 5407 | a.satou@datatables.net |
Angelica | Ramos | Chief Executive Officer (CEO) | London | 47 | 2009/10/09 | $1,200,000 | 5797 | a.ramos@datatables.net |
Ashton | Cox | Junior Technical Author | San Francisco | 66 | 2009/01/12 | $86,000 | 1562 | a.cox@datatables.net |
Bradley | Greer | Software Engineer | London | 41 | 2012/10/13 | $132,000 | 2558 | b.greer@datatables.net |
Brenden | Wagner | Software Engineer | San Francisco | 28 | 2011/06/07 | $206,850 | 1314 | b.wagner@datatables.net |
Brielle | Williamson | Integration Specialist | New York | 61 | 2012/12/02 | $372,000 | 4804 | b.williamson@datatables.net |
Bruno | Nash | Software Engineer | London | 38 | 2011/05/03 | $163,500 | 6222 | b.nash@datatables.net |
Caesar | Vance | Pre-Sales Support | New York | 21 | 2011/12/12 | $106,450 | 8330 | c.vance@datatables.net |
Cara | Stevens | Sales Assistant | New York | 46 | 2011/12/06 | $145,600 | 3990 | c.stevens@datatables.net |
Cedric | Kelly | Senior Javascript Developer | Edinburgh | 22 | 2012/03/29 | $433,060 | 6224 | c.kelly@datatables.net |
Charde | Marshall | Regional Director | San Francisco | 36 | 2008/10/16 | $470,600 | 6741 | c.marshall@datatables.net |
Colleen | Hurst | Javascript Developer | San Francisco | 39 | 2009/09/15 | $205,500 | 2360 | c.hurst@datatables.net |
Dai | Rios | Personnel Lead | Edinburgh | 35 | 2012/09/26 | $217,500 | 2290 | d.rios@datatables.net |
Donna | Snider | Customer Support | New York | 27 | 2011/01/25 | $112,000 | 4226 | d.snider@datatables.net |
Doris | Wilder | Sales Assistant | Sidney | 23 | 2010/09/20 | $85,600 | 3023 | d.wilder@datatables.net |
Finn | Camacho | Support Engineer | San Francisco | 47 | 2009/07/07 | $87,500 | 2927 | f.camacho@datatables.net |
Fiona | Green | Chief Operating Officer (COO) | San Francisco | 48 | 2010/03/11 | $850,000 | 2947 | f.green@datatables.net |
Garrett | Winters | Accountant | Tokyo | 63 | 2011/07/25 | $170,750 | 8422 | g.winters@datatables.net |
Gavin | Joyce | Developer | Edinburgh | 42 | 2010/12/22 | $92,575 | 8822 | g.joyce@datatables.net |
Gavin | Cortez | Team Leader | San Francisco | 22 | 2008/10/26 | $235,500 | 2860 | g.cortez@datatables.net |
Gloria | Little | Systems Administrator | New York | 59 | 2009/04/10 | $237,500 | 1721 | g.little@datatables.net |
Haley | Kennedy | Senior Marketing Designer | London | 43 | 2012/12/18 | $313,500 | 3597 | h.kennedy@datatables.net |
Hermione | Butler | Regional Director | London | 47 | 2011/03/21 | $356,250 | 1016 | h.butler@datatables.net |
Herrod | Chandler | Sales Assistant | San Francisco | 59 | 2012/08/06 | $137,500 | 9608 | h.chandler@datatables.net |
Hope | Fuentes | Secretary | San Francisco | 41 | 2010/02/12 | $109,850 | 6318 | h.fuentes@datatables.net |
Howard | Hatfield | Office Manager | San Francisco | 51 | 2008/12/16 | $164,500 | 7031 | h.hatfield@datatables.net |
Jackson | Bradshaw | Director | New York | 65 | 2008/09/26 | $645,750 | 1042 | j.bradshaw@datatables.net |
Jena | Gaines | Office Manager | London | 30 | 2008/12/19 | $90,560 | 3814 | j.gaines@datatables.net |
Jenette | Caldwell | Development Lead | New York | 30 | 2011/09/03 | $345,000 | 1937 | j.caldwell@datatables.net |
Jennifer | Chang | Regional Director | Singapore | 28 | 2010/11/14 | $357,650 | 9239 | j.chang@datatables.net |
Jennifer | Acosta | Junior Javascript Developer | Edinburgh | 43 | 2013/02/01 | $75,650 | 3431 | j.acosta@datatables.net |
Jonas | Alexander | Developer | San Francisco | 30 | 2010/07/14 | $86,500 | 8196 | j.alexander@datatables.net |
Lael | Greer | Systems Administrator | London | 21 | 2009/02/27 | $103,500 | 6733 | l.greer@datatables.net |
Martena | Mccray | Post-Sales support | Edinburgh | 46 | 2011/03/09 | $324,050 | 8240 | m.mccray@datatables.net |
Michael | Silva | Marketing Designer | London | 66 | 2012/11/27 | $198,500 | 1581 | m.silva@datatables.net |
Michael | Bruce | Javascript Developer | Singapore | 29 | 2011/06/27 | $183,000 | 5384 | m.bruce@datatables.net |
Michelle | House | Integration Specialist | Sidney | 37 | 2011/06/02 | $95,400 | 2769 | m.house@datatables.net |
Olivia | Liang | Support Engineer | Singapore | 64 | 2011/02/03 | $234,500 | 2120 | o.liang@datatables.net |
Paul | Byrd | Chief Financial Officer (CFO) | New York | 64 | 2010/06/09 | $725,000 | 3059 | p.byrd@datatables.net |
Prescott | Bartlett | Technical Author | London | 27 | 2011/05/07 | $145,000 | 3606 | p.bartlett@datatables.net |
Quinn | Flynn | Support Lead | Edinburgh | 22 | 2013/03/03 | $342,000 | 9497 | q.flynn@datatables.net |
Rhona | Davidson | Integration Specialist | Tokyo | 55 | 2010/10/14 | $327,900 | 6200 | r.davidson@datatables.net |
Sakura | Yamamoto | Support Engineer | Tokyo | 37 | 2009/08/19 | $139,575 | 9383 | s.yamamoto@datatables.net |
Serge | Baldwin | Data Coordinator | Singapore | 64 | 2012/04/09 | $138,575 | 8352 | s.baldwin@datatables.net |
Shad | Decker | Regional Director | Edinburgh | 51 | 2008/11/13 | $183,000 | 6373 | s.decker@datatables.net |
Shou | Itou | Regional Marketing | Tokyo | 20 | 2011/08/14 | $163,000 | 8899 | s.itou@datatables.net |
Sonya | Frost | Software Engineer | Edinburgh | 23 | 2008/12/13 | $103,600 | 1667 | s.frost@datatables.net |
Suki | Burks | Developer | London | 53 | 2009/10/22 | $114,500 | 6832 | s.burks@datatables.net |
Tatyana | Fitzpatrick | Regional Director | London | 19 | 2010/03/17 | $385,750 | 1965 | t.fitzpatrick@datatables.net |
Thor | Walton | Developer | New York | 61 | 2013/08/11 | $98,540 | 8327 | t.walton@datatables.net |
Tiger | Nixon | System Architect | Edinburgh | 61 | 2011/04/25 | $320,800 | 5421 | t.nixon@datatables.net |
Timothy | Mooney | Office Manager | London | 37 | 2008/12/11 | $136,200 | 7580 | t.mooney@datatables.net |
Unity | Butler | Marketing Designer | San Francisco | 47 | 2009/12/09 | $85,675 | 5384 | u.butler@datatables.net |
Vivian | Harrell | Financial Controller | San Francisco | 62 | 2009/02/14 | $452,500 | 9422 | v.harrell@datatables.net |
Yuri | Berry | Chief Marketing Officer (CMO) | New York | 40 | 2009/06/25 | $675,000 | 6154 | y.berry@datatables.net |
Zenaida | Frank | Software Engineer | New York | 63 | 2010/01/04 | $125,250 | 7439 | z.frank@datatables.net |
Zorita | Serrano | Software Engineer | San Francisco | 56 | 2012/06/01 | $115,000 | 4389 | z.serrano@datatables.net |