So what's it good for? Well, let's say you want to display a long list of fairly uniform tabluar data, like stock exchange listings or sport statistics but you don't want your users to get lost in the data as they scroll down on the page.
StickyTableHeaders to the rescue: By applying the StickyTableHeaders jQuery plugin to the table, the column headers will stick to the top of the viewport as you scroll down.
Go ahead and try out a demo.
The code is based on this proof of concept.
- Download the source from /js/jquery.stickytableheaders.js
- Include it in your project
- Initialize the plugin:
$(function() {
$('table').stickyTableHeaders();
});
####Tear down To remove the plugin:
$('table').stickyTableHeaders('destroy');
####Trigger an update
$(window).trigger('resize.stickyTableHeaders');
If any of this is confusing, please check out the /demo folder. There are a couple of examples in there. E.g. you can see how to use it with Twitter Bootstrap.
- Writing a better readme :)
- Internet Explorer: You need to set the padding of the
<th>
s explicitly in the css in order to make the plugin work - Internet Explorer: Adding horizontal margin to the table causes the header to be misaligned when scrolling. (Issue #10)
border-collapse: collapse
is not supported (issue #2)- Using the plugin together with tablesorter breaks in Internet Explorer 8
The plugin has been verified to work in:
- Chrome 24
- Firefox 20
- Internet Explorer 8-10
- Safari 5
NOTE: It does not work in Internet Explorer 7 (but it degrades nicely)