[jQuery] TableSorter docs suggestion
I'm using the tablesorter plugin (Excellent work! - makes my job MUCH
easier). But I found a slight flaw with the documentation.
In my case, I wanted alternating row colors. When I set this up
manually with something like
$("#mytable tr:odd").css("background-color","#ddd");
The initial view was fine, but sorting the rows messed things up. (not
evenly alternating).
So I did some digging. I recalled seeing something on this list about a
zebra plugin. Searching my archives I found this, but could not find
anything that clearly stated how to use it.
So I went to the documentation at http://tablesorter.com/docs/. No
mention there of zebra. When I went into the "Widgets, writing your
own", I found the following sample:
// call the tablesorter plugin and assign widgets with id "zebra"
//(Default widget in the core) and the newly created "repeatHeaders"
$("table").tablesorter({
widgets: ['zebra','repeatHeaders']
});
This is the ONLY mention I found for Zebra within the tablesorter pages.
(thus far)
May I suggest that the table on the main docs page needs to include the
"widgets" option, and a list of all the "core" widgets (not sure if
there's more than just zebra).
The alternating row colors is such a common need, that this change would
make the tablesorter plugin much more friendly to those who only have a
few moments to search.
If I can only find documentation to complain about, somebody is doing
something right... :) Good job Christian.
Shawn