2014-04-19 14:34:18 +00:00
<!DOCTYPE html>
< html >
< head >
< meta charset = "utf-8" >
2015-02-07 05:04:28 +00:00
< title > jQuery plugin: Tablesorter 2.0 - Static Row Widget< / title >
2014-04-19 14:34:18 +00:00
<!-- jQuery -->
2014-05-21 22:09:23 +00:00
< script src = "js/jquery-latest.min.js" > < / script >
2014-04-19 14:34:18 +00:00
<!-- Demo stuff -->
2014-05-21 22:09:23 +00:00
< link class = "ui-theme" rel = "stylesheet" href = "css/jquery-ui.min.css" >
< script src = "js/jquery-ui-latest.min.js" > < / script >
2014-04-19 14:34:18 +00:00
< link rel = "stylesheet" href = "css/jq.css" >
< link href = "css/prettify.css" rel = "stylesheet" >
< script src = "js/prettify.js" > < / script >
< script src = "js/docs.js" > < / script >
<!-- Tablesorter: required -->
< link rel = "stylesheet" href = "../css/theme.blue.css" >
< script src = "../js/jquery.tablesorter.js" > < / script >
< script src = "../js/widgets/widget-staticRow.js" > < / script >
< style >
.options th:not(.sorter-false) {
width: 10%;
}
#alphimals * {
font-size: 12px;
line-height: 12px;
}
< / style >
< style id = "css" > # a l p h i m a l s t d {
text-align: center;
}
.tablesorter tbody tr.static td {
background-color: #999;
color: #fff;
}< / style >
< script id = "js" > $ ( f u n c t i o n ( ) {
$('#alphimals, #table2').tablesorter({
theme: 'blue',
widgets: ['zebra', 'staticRow']
2014-06-22 13:15:49 +00:00
})
// (ctrl or mac command) + click to toggle static row
.find('tbody tr').click(function(event){
if (event.ctrlKey || event.metaKey) {
$(this)
.toggleClass('static')
.trigger('staticRowsRefresh');
}
2014-04-19 14:34:18 +00:00
});
$('.addrow').click(function(){
$('#alphimals tbody')
.append('< tr > < td > AA< / td > < td > 0< / td > < td > Aardvark< / td > < / tr > ')
.trigger('update');
});
// move row up or down
$('.move').click(function(){
var direction = $(this).hasClass('up'),
$rows = $('#alphimals tr'),
2014-06-22 13:15:49 +00:00
$ig = $rows.filter(':contains(Iguana)').addClass('static'),
len = $rows.length - 3, // subtract two because there are two other static rows
2014-04-19 14:34:18 +00:00
v = $ig.data('row-index');
v = direction ? --v : ++v;
v = v > len ? len : v < = 0 ? 0 : v;
$ig.data('row-index', v);
$rows.trigger('staticRowsRefresh');
});
});< / script >
< / head >
< body >
< div id = "banner" >
< h1 > table< em > sorter< / em > < / h1 >
2015-02-07 05:04:28 +00:00
< h2 > Static Row Widget< / h2 >
2014-04-19 14:34:18 +00:00
< h3 > Flexible client-side table sorting< / h3 >
< a href = "index.html" > Back to documentation< / a >
< / div >
< div id = "main" >
< p > < / p >
< br >
< div class = "accordion" >
< h3 id = "notes" > < a href = "#" > Notes< / a > < / h3 >
< div >
< ul >
2015-02-09 23:01:27 +00:00
< li >
In < span class = "version" > v2.19.1< / span > , the < code > staticRow_event< / code > option was added.
< p > < / p >
< / li >
2014-04-19 14:34:18 +00:00
< li > This widget will only work in tablesorter version 2.8+.< / li >
< li > The widget was modified from < a href = "https://github.com/ascii-soup/Tablesorter-Static-Row-Plugin" > Tablesorter-Static-Row-Plugin< / a > by < a href = "https://github.com/ascii-soup" > ascii-soup< / a > (< a href = "https://github.com/ascii-soup/Tablesorter-Static-Row-Plugin/blob/master/LICENSE" > MIT license< / a > ).< / li >
< li > It has been updated to work in tables with multiple tbodies, but not within information-only tbodies.< / li >
< li > This widget was not tested, nor was it meant to be used with the pager.< / li >
2014-06-22 13:15:49 +00:00
< li > < span class = "label label-info" > Note< / span > This demo was updated to allow toggling of static rows.< / li >
2014-04-19 14:34:18 +00:00
< / ul >
< / div >
< h3 > < a href = "#" > Options< / a > < / h3 >
< div >
< h3 > Group widget default options (added inside of tablesorter < code > widgetOptions< / code > )< / h3 >
< div class = "tip" >
< span class = "label label-info" > TIP!< / span > Click on the link in the option column to reveal full details (or < a href = "#" class = "toggleAll" > toggle< / a > |< a href = "#" class = "showAll" > show< / a > |< a href = "#" class = "hideAll" > hide< / a > all) or double click to update the browser location.
< / div >
< table class = "tablesorter-blue options" >
< thead >
< tr > < th > Option< / th > < th > Default< / th > < th class = "sorter-false" > Description< / th > < / tr >
< / thead >
< tbody >
< tr id = "staticrow_class" >
< td > < span class = "permalink" > staticRow_class< / span > < / td >
< td > < code > " .static" < / code > < / td >
< td >
Set a class name to use to lock a row in place, include a period.
< / td >
< / tr >
2015-02-09 23:01:27 +00:00
2014-04-19 14:34:18 +00:00
< tr id = "staticrow_data" >
< td > < span class = "permalink" > staticRow_data< / span > < / td >
< td > < code > " static-index" < / code > < / td >
< td >
Set the jQuery data name to use with the row element. This data name saves the row index, and is only available as an option to avoid conflicts.
< / td >
< / tr >
2015-02-09 23:01:27 +00:00
< tr id = "staticrow_event" >
< td > < span class = "permalink" > staticRow_event< / span > < / td >
< td > < code > " staticRowsRefresh" < / code > < / td >
< td >
Set the event that the widget listens for to perform a refresh.
< / td >
< / tr >
2014-04-19 14:34:18 +00:00
< tr id = "staticrow_index" >
< td > < a href = "#" class = "permalink" > staticRow_index< / a > < / td >
< td > < code > " row-index" < / code > < / td >
< td >
Use this data-attribute to set the desired static row location
< div class = "collapsible" >
< br >
Set the desired location using either of these two methods:
< ul >
< li >
Use a zero-based index of the row
< pre class = "prettyprint lang-html" > < tr data-row-index=" 5" > ...< /tr> < / pre >
< span class = "label label-info" > Note< / span > setting this index to much more than the number of table rows ensures that it will stay at the bottom when adding new rows.< br >
< br >
< / li >
< li >
Use a percentage if total rows within it's tbody
< pre class = "prettyprint lang-html" > < tr data-row-index=" 50%" > ...< /tr> < / pre >
< / li >
< / ul >
These values take priority over the actual row index, so as shown in the "Single tbody" demo below, the header row is set to 50%, but initially, it is located at the top of the table.< br >
< br >
2015-02-07 05:04:28 +00:00
If these values are changed dynamically, the static row location can be updated
2014-04-19 14:34:18 +00:00
< / div >
< / td >
< / tr >
< / tbody >
< / table >
< / div >
< h3 > < a href = "#" > Methods / Events< / a > < / h3 >
< div >
< h3 > Method< / h3 >
If adding or removing rows from the table, using any of the update methods will automatically refresh the static row indexes. Use the "Add Row" button below to test this.< br >
< br >
To modify or refresh the static row indexing without updating, trigger a < code > staticRowsRefresh< / code > event on the table:
< pre class = "prettyprint lang-js" > var $row = $("tr:contains('Iguana')");
// move Iguana row down one (remember, this only works on static rows)
$row.data('row-index', $row.data('row-index') + 1);
$(table).trigger('staticRowsRefresh');< / pre >
this allows moving a static row dynamically; try the Move "Ignuana" row buttons above the "Single tbody" demo.
< h3 > Event< / h3 >
A < code > staticRowsComplete< / code > event is triggered after the static rows widget has completed moving the static rows back into place. Use it as follows:
< pre class = "prettyprint lang-js" > $(table).bind('staticRowsComplete', function(table){
console.log('static rows applied to ' + table.id);
});< / pre >
< / div >
< / div >
< h1 > Demo< / h1 >
2014-06-22 13:15:49 +00:00
< span class = "label label-info" > Note< / span > Make any row static or normal by toggling the < code > static< / code > class name using < kbd > Ctrl< / kbd > + left click (< kbd > ⌘ < / kbd > + click on Mac)< br >
2014-04-19 14:34:18 +00:00
< div id = "demo" > < h3 > Single tbody< / h3 >
2014-07-18 01:42:01 +00:00
< p > < button class = "addrow" > Add Row< / button > Move "Iguana" row: < button class = "move up" > up< / button > < button class = "move" > down< / button > < p >
2014-04-19 14:34:18 +00:00
< table id = "alphimals" class = "tablesorter" >
< thead >
< tr > < th > Column 1< / th > < th > Column 2< / th > < th > Column 3< / th > < / tr >
< / thead >
< tbody >
< tr class = "static" data-row-index = "50%" > < th > Column 1< / th > < th > Column 2< / th > < th > Column 3< / th > < / tr >
< tr > < td > D< / td > < td > 4< / td > < td > Dog< / td > < / tr >
< tr > < td > E< / td > < td > 5< / td > < td > Emu< / td > < / tr >
< tr > < td > F< / td > < td > 6< / td > < td > Frog< / td > < / tr >
< tr > < td > G< / td > < td > 7< / td > < td > Goat< / td > < / tr >
< tr > < td > A< / td > < td > 1< / td > < td > Anteater< / td > < / tr >
< tr > < td > B< / td > < td > 2< / td > < td > Bear< / td > < / tr >
< tr > < td > C< / td > < td > 3< / td > < td > Cat< / td > < / tr >
< tr > < td > H< / td > < td > 8< / td > < td > Horse< / td > < / tr >
<!-- index of next row set to one less because of static row above set to 50% -->
< tr class = "static" data-row-index = "8" > < td > I< / td > < td > 9< / td > < td > Iguana< / td > < / tr >
< tr > < td > J< / td > < td > 10< / td > < td > Jellyfish< / td > < / tr >
< tr > < td > V< / td > < td > 22< / td > < td > Vole< / td > < / tr >
< tr > < td > W< / td > < td > 23< / td > < td > Walrus< / td > < / tr >
< tr > < td > X< / td > < td > 24< / td > < td > Xantis< / td > < / tr >
< tr > < td > K< / td > < td > 11< / td > < td > Koala< / td > < / tr >
< tr > < td > L< / td > < td > 12< / td > < td > Lemur< / td > < / tr >
< tr > < td > Q< / td > < td > 17< / td > < td > Quail< / td > < / tr >
< tr > < td > R< / td > < td > 18< / td > < td > Rhino< / td > < / tr >
< tr > < td > S< / td > < td > 19< / td > < td > Seal< / td > < / tr >
< tr > < td > M< / td > < td > 13< / td > < td > Mink< / td > < / tr >
< tr > < td > N< / td > < td > 14< / td > < td > Nightingale< / td > < / tr >
< tr > < td > O< / td > < td > 15< / td > < td > Octopus< / td > < / tr >
< tr > < td > P< / td > < td > 16< / td > < td > Pig< / td > < / tr >
< tr > < td > T< / td > < td > 20< / td > < td > Tiger< / td > < / tr >
< tr > < td > U< / td > < td > 21< / td > < td > Urchin< / td > < / tr >
< tr > < td > Y< / td > < td > 25< / td > < td > Yak< / td > < / tr >
< tr > < td > Z< / td > < td > 26< / td > < td > Zebra< / td > < / tr >
< tr class = "static" data-row-index = "50" > < td > Total Count< / td > < td > Lots!< / td > < td > < / td > < / tr >
< / tbody >
< / table >
< h4 > Multiple tbody< / h4 >
< table id = "table2" class = "tablesorter" >
< thead >
< tr >
< th > Rank< / th >
< th > First Name< / th >
< th > Last Name< / th >
< th > Age< / th >
< th > Total< / th >
< th > Discount< / th >
< th > Date< / th >
< / tr >
< / thead >
< tbody >
< tr > < td > 1< / td > < td > Philip Aaron Wong< / td > < td > Johnson Sr Esq< / td > < td > 25< / td > < td > $5.95< / td > < td > 22%< / td > < td > Jun 26, 2004 7:22 AM< / td > < / tr >
< tr > < td > 11< / td > < td > Aaron< / td > < td > Hibert< / td > < td > 12< / td > < td > $2.99< / td > < td > 5%< / td > < td > Aug 21, 2009 12:21 PM< / td > < / tr >
< tr class = "static" > < td > 12< / td > < td > Brandon Clark< / td > < td > Henry Jr< / td > < td > 51< / td > < td > $42.29< / td > < td > 18%< / td > < td > Oct 13, 2000 1:15 PM< / td > < / tr >
< tr > < td > 111< / td > < td > Peter< / td > < td > Parker< / td > < td > 28< / td > < td > $9.99< / td > < td > 20%< / td > < td > Jul 6, 2006 8:14 AM< / td > < / tr >
< tr > < td > 21< / td > < td > John< / td > < td > Hood< / td > < td > 33< / td > < td > $19.99< / td > < td > 25%< / td > < td > Dec 10, 2002 5:14 AM< / td > < / tr >
< tr > < td > 013< / td > < td > Clark< / td > < td > Kent Sr.< / td > < td > 18< / td > < td > $15.89< / td > < td > 44%< / td > < td > Jan 12, 2003 11:14 AM< / td > < / tr >
< / tbody >
< tbody class = "tablesorter-infoOnly" >
< tr > < th colspan = "7" > Second tbody< / th > < / tr >
< / tbody >
< tbody >
< tr > < td > 005< / td > < td > Bruce< / td > < td > Almighty Esq< / td > < td > 45< / td > < td > $153.19< / td > < td > 44%< / td > < td > Jan 18, 2021 9:12 AM< / td > < / tr >
< tr > < td > 10< / td > < td > Alex< / td > < td > Dumass< / td > < td > 13< / td > < td > $5.29< / td > < td > 4%< / td > < td > Jan 8, 2012 5:11 PM< / td > < / tr >
< tr > < td > 16< / td > < td > Jim< / td > < td > Franco< / td > < td > 24< / td > < td > $14.19< / td > < td > 14%< / td > < td > Jan 14, 2004 11:23 AM< / td > < / tr >
< tr > < td > 166< / td > < td > Bruce Lee< / td > < td > Evans< / td > < td > 22< / td > < td > $13.19< / td > < td > 11%< / td > < td > Jan 18, 2007 9:12 AM< / td > < / tr >
< tr > < td > 100< / td > < td > Brenda Dexter< / td > < td > McMasters< / td > < td > 18< / td > < td > $55.20< / td > < td > 15%< / td > < td > Feb 12, 2010 7:23 PM< / td > < / tr >
< tr > < td > 55< / td > < td > Dennis< / td > < td > Bronson< / td > < td > 65< / td > < td > $123.00< / td > < td > 32%< / td > < td > Jan 20, 2001 1:12 PM< / td > < / tr >
< tr class = "static" > < td > 9< / td > < td > Martha< / td > < td > delFuego< / td > < td > 25< / td > < td > $22.09< / td > < td > 17%< / td > < td > Jun 11, 2011 10:55 AM< / td > < / tr >
< / tbody >
< / table >
< / div >
< h1 > Javascript< / h1 >
< div id = "javascript" >
< pre class = "prettyprint lang-javascript" > < / pre >
< / div >
< h1 > CSS< / h1 >
< div id = "css" >
< pre class = "prettyprint lang-css" > < / pre >
< / div >
< h1 > HTML< / h1 >
< div id = "html" >
< pre class = "prettyprint lang-html" > < / pre >
< / div >
2014-07-18 01:42:01 +00:00
< / div >
2014-04-19 14:34:18 +00:00
< / body >
< / html >