tablesorter

Ignore leading articles parser

Flexible client-side table sorting

NOTE!

• This parser can not be applied to the original plugin.
• Set the language to use by adding any of the following (they all do the same thing), set in order of priority (v2.8.2):
  • jQuery data data-ignore-articles="fr".
  • metadata class="{ ignoreArticles : 'fr' }". This requires the metadata plugin.
  • headers option headers : { 0 : { ignoreArticles : 'fr' } }.
  • header class name class="ignoreArticles-fr".
• To add a custom language to the parser, use the following code:

  $.extend( $.tablesorter.ignoreArticles, {
    "xx" : "a, l'_, de la"
  });
  
  $('table').tablesorter({
    headers: {
      2: {
        sorter: 'ignoreArticles',
        ignoreArticles : 'xx'
      }
    }
  });

  • where xx is the ignoreArticles id (abbreviation for the language)
  • Each leading article must be separated by a comma and will be case-insensitive.
  • Leading articles will only be removed if they are followed by a space; spaces are automatically included when parsed unless the article definition is followed by an underscore. See the l'_ note below.
  • a is an example of a leading article which will be removed. So, "A Fistfull of Dollars" will only parse "Fistfull of Dollars" and will sort with the other words that start with an "F".
  • l'_ includes an underscore (_); this tells the parser to not add a space after the word. So a title like "l'enfant" will parse as "enfant".
  • de la is an example showing that the parser can remove a multiple-word article.
• Some languages have been included by default. The information below was obtained from this wikipedia page, so if you discover any errors, or if you want to contribute another language, please open an issue.

  $.tablesorter.ignoreArticles = {
    "en" : "the, a, an",
    "de" : "der, die, das, des, dem, den, ein, eine, einer, eines, einem, einen",
    "nl" : "de, het, de, een",
    "es" : "el, la, lo, los, las, un, una, unos, unas",
    "pt" : "o, a, os, as, um, uma, uns, umas",
    "fr" : "le, la, l'_, les, un, une, des",
    "it" : "il, lo, la, l'_, i, gli, le, un', uno, una, un",
    "hu" : "a, az, egy"
  };

Demo

Page Header

<!-- tablesorter -->
<link rel="stylesheet" href="../css/theme.blue.css">
<script src="../js/jquery.tablesorter.js"></script>

<!-- load ignore-articles parser -->
<script src="../js/parsers/parser-ignore-articles.js"></script>
<script>
$(function() {

  $('table').tablesorter({
    theme: 'blue',
    widgets: ['zebra'],
    sortList: [[2, 0]],
    headers: {
      2: {
        sorter: 'ignoreArticles',
        ignoreArticles : 'fr'
      }
    }
  });

});
</script>