By default, recalculations are performed after:

• Tablesorter initialization.
• After any triggered "update" which may change a cell value.
• After a "filterReset".
• And after a "filterEnd" event, or a "pagerComplete" event (if the pager is being used), but not both!

To ignore the first and second columns in a table, set this option using zero-based column indexs as follows:

// column index(es) to ignore
math_ignore : [0,1]

In v2.25.0, this option can now be set to an empty string.

To understand when this text is used, select a Region in the "Row & Column Sums" table below. The totals for hidden rows will display this text.

Use it as follows:

math_none : 'N/A',
math_complete : function($cell, wo, result, value, arry) {
  // don't include currency symbol when no result is available
  return value === wo.math_none ? value : '$ ' + value;
}

As of v2.16.2, you can set a mask for each math cell by adding a data-math-mask data-attribute (the math part of the data-attribute is obtained from the math_data setting).

<th data-math="all-sum" data-math-mask="##0.00">all-sum</th>

---

Javascript-number-formatter details

Features

• Short, fast, flexible yet standalone. Only 75 lines including MIT license info, blank lines & comments.
• Accept standard number formatting like #,##0.00 or with negation -000.####.
• Accept any country format like # ##0,00, #,###.##, #'###.## or any type of non-numbering symbol.
• Accept any numbers of digit grouping. #,##,#0.000 or #,###0.## are all valid.
• Accept any redundant/fool-proof formatting. ##,###,##.# or 0#,#00#.###0# are all OK.
• Auto number rounding.
• Include a prefix & suffix with the mask
• Simple interface, just supply mask & value like this: $.tablesorter.formatMask( "0.0000", 3.141592, "prefix ", " suffix" );

  $.tablesorter.formatMask( "$ 0.0000 USD", 1234.567, "prefix ", " suffix" );
  // prefix $ 1234.5670 USD suffix

Limitation

• No scientific/engineering formatting.
• Not for date or phone formation.
• No color control.
• No prefix or suffix is allowed except leading negation symbol. So $#,##0.00 or #,###.##USD will not yield expected outcome. Use '$'+ $.tablesorter.formatMask('#,##0.00', 123.45) or $.tablesorter.formatMask('#,##0.00', 456.789) + 'USD'
• The prefix or suffix can not include any numbers (0-9), hashes (#), dashes (-), or plus signs (+)

Note

• When there's only one symbol is supplied, system will always treat the single symbol as Decimal. For instance, $.tablesorter.formatMask( '#,###', 1234567.890) will output 1234567,890.
• To force a single symbol as Separator, add a trailing dot to the end like this: $.tablesorter.formatMask( '#,###.', 1234567.890) which will then output 1,234,567.
• Original plugin demo

† The number formatter code was copied from javascript-number-formatter (MIT) - now forked on GitHub.

Use this option as follows:

// complete executed after each function
math_complete : function($cell, wo, result, value, arry){
    return '$ ' + result + $cell.attr('data-suffix');
}

• $cell - the target cell (jQuery object)
• wo - tablesorter's widget options (from table.config.widgetOptions).
• result - the formatted result of the calculation.
• value - an unformatted result of the calculation.
• arry - the array of values gathered by the widget.

In this function, if a anything is returned, it will be automatically added to the $cell as html. Or, return false and no change is made to the cell contents; use this method if you manipulate the $cell contents and don't want the widget to do it.

If you need to format the data output after manipulating the value, you can use wo.math_mask, or a different mask, by using the $.tablesorter.formatMask( mask, value ); function. For example:

math_complete : function($cell, wo, result, value, arry){
    var percent = Math.round( value * 1e4 ) / 100; // percent with two decimal places
    return $.tablesorter.formatMask( wo.math_mask, percent ) + ' %';
}

More details can be found in the math_mask description.

• By default, the widget cycles through the calculated cells as follows:
  • Search all non-informational tbodies for data-math table cells (data-attribute set by math_data option).
  • Cycle through these cells by priority: row, above, col (set by this option).
  • Search all informational tbodies, and tfoot for data-math table cells.
  • Cycle through these cells by priority: row, above, col (set by this option).
  • Search the entire table for data-math cells of the "all" type.
• So, all row calculations are made first, followed by "above" calculations then "col" (column) calculations.
• The "all" type calculations are always performed last, and therefore the type is not included in this list.
• Change this order if the order of calculations needs to be made column first, followed by rows.
• For more details about the differences between "col" and "above" types, see the "Attribute Settings" section.

• This option adds content before the mask.
• If the mask includes any content for the prefix, then this value is added before it.
• If this option contains a {content} tag, the prefix within the mask will replace this tag.

  math_mask   : '$ #,##0.00',
  math_prefix : '{content}'
  
  // result of the value 12345.67
  // <span class="blue">$ </span>12,345.67

  You can experiment with this option in the "Mask Examples" section.

• This option adds content after the mask.
• If the mask includes any content for the suffix, then this value is added after it.
• If this option contains a {content} tag, the suffix within the mask will replace this tag.

  math_mask   : '#,##0.00 USD',
  math_suffix : '{content}!'
  
  // result of the value 12345.67
  // 12,345.67 USD<span class="red">!</span>

  You can experiment with this option in the "Mask Examples" section.

This option applys the set filter (jQuery .filter() to the targeted rows.

If this option is set, rows filtered out by the filter widget are included, so you will need to include them in this selector if you wish to filter them out (e.g. ':visible:not(.filtered)' (only include visible & rows not filtered out by the filter widget)

// this option will accept any of the jQuery filter types (i.e. selector, function or elements)
// for example, here is the functional equivalent
// math_rowFilter : function(index, element) { return $(element).is(':visible:not(.filtered)'); }
math_rowFilter : ':visible:not(.filtered)'

In v2.25.0, this setting may be overridden for each math type by adding a data-math-filter attribute (The "math" portion is set by the math_data option) to the cell.

<td data-math-filter=":visible" data-math="all-sum">...</td>

Note The data-math-filter attribute is ignored if set to an empty string; instead use data-math-filter="*" to target all rows as done in the first example on this page.