webcraftmedia/lib_tablesorter
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
lib_tablesorter/README.md
Messerbill f099d2c6b9 tablesorter submodule added
2015-06-08 20:46:04 +02:00

14 KiB
Raw Blame History

tablesorter (FORK) is a jQuery plugin for turning a standard HTML table with THEAD and TBODY tags into a sortable table without page refreshes. tablesorter can successfully parse and sort many types of data including linked data in a cell. This forked version adds lots of new enhancements including: alphanumeric sorting, pager callback functons, multiple widgets providing column styling, ui theme application, sticky headers, column filters and resizer, as well as extended documentation with a lot more demos.

Notice!

  • Because of the change to the internal cache, the tablesorter v2.16+ core, filter widget and pager (both plugin & widget) will only work with the same version or newer files.

Documentation

Demos

Features

  • Multi-column alphanumeric sorting and filtering.
  • Multi-tbody sorting - see the options table on the main document page.
  • Supports Bootstrap v2 and 3
  • Parsers for sorting text, alphanumeric text, URIs, integers, currency, floats, IP addresses, dates (ISO, long and short formats) & time. Add your own easily.
  • Inline editing - see demo
  • Support for ROWSPAN and COLSPAN on TH elements.
  • Support secondary "hidden" sorting (e.g., maintain alphabetical sort when sorting on other criteria).
  • Extensibility via widget system.
  • Cross-browser: IE 6.0+, FF 2+, Safari 2.0+, Opera 9.0+, Chrome 5.0+.
  • Small code size, starting at 25K minified
  • Works with jQuery 1.2.6+ (jQuery 1.4.1+ needed with some widgets).
  • Works with jQuery 1.9+ ($.browser.msie was removed; needed in the original version).

Licensing

Download

Related Projects

Contributing

If you would like to contribute, please...

  1. Fork.
  2. Make changes in a branch & add unit tests.
  3. Run grunt test (if qunit fails, run it again - it's fickle).
  4. Create a pull request.

Special Thanks

  • Big shout-out to Nick Craver for getting rid of the eval() function that was previously needed for multi-column sorting.
  • Big thanks to thezoggy for helping with code, themes and providing valuable feedback.
  • Big thanks to ThsSin- for taking over for a while and also providing valuable feedback.
  • Thanks to prijutme4ty for numerous contributions!
  • Also extra thanks to christhomas and Lynesth for help with code.
  • And, of course thanks to everyone else that has contributed, and continues to contribute to this forked project!

Questions?

  • Check the FAQ page.
  • Search the main documentation (click the menu button in the upper left corner).
  • Search the issues to see if the question or problem has been brought up before, and hopefully resolved.
  • If someone is available, ask your question in the #tablesorter IRC channel at freenode.net.
  • Ask your question at Stackoverflow using a tablesorter tag.
  • Please don't open a new issue unless it really is an issue with the plugin, or a feature request. Thanks!

Recent Changes

View the complete change log here.

Version 2.22.1 (5/17/2015)

  • Filter: fix issue with searches always looking for parsed content in numeric columns.

Version 2.22.0 (5/17/2015)

  • Docs
    • Lots of minor version updates, spelling corrections & clarifications in wording.
    • Update box-sizing styles (ref).
    • Update characterEquivalents cross-reference to correctly match the code of the plugin.
    • Add Build table widget example resulting HTML for the json example.
  • Grunt build
    • package.json files now points to the entire "dist" folder. See issue #881.
    • Add grunt quick build to only update widget & parser files; it skips updating the dates in the widgets & combined files.
  • Core
    • The isDigit function now reports false on empty strings. See issue #865.
    • Add pointer events options (pointerClick, pointerDown and pointerUp). Fixes issue #885.
    • Prevent js error when using the computeColumnIndex function on empty tables (used by the math widget). Fixes issue #889.
    • Prevent js error when sortList includes an out-of-bounds column. Fixes issue #908.
    • Centralize extractor & parser code; this code is used by the main build cache loop and the "addRows" & "updateCell" methods.
    • Child row content is now properly stored in row data as an array of arrays.
    • Add "o" to sortLocaleCompare replacement table & update docs.
    • Replace all instances of using jQuery each with plain javascript. Fixes issue #827.
  • Editable
    • Modify trimContent option & use HTML to modify text. Fixes issue #886.
    • Fix selectAll & change tbody mouseleave to complete editing to thead mouseenter. Fixes issue #848.
    • Only make table cell child div/span contenteditable. See issue #900.
    • Add remove widget code & allow dynamic updating if the "no-edit" class changes. Fixes issue #900.
  • Filter
    • Regex filter searches now cache the created regex object for each query to optimize speed & a regex search now properly uses case-sensitive content
    • Add data parameter to filter_functions. This is the same data used by the filter search type functions. See issue #891.
    • Any match searches which target specific columns will no longer save each filter to its respective column; see "AnyMatch Searches" documentation.
    • Operator filter searchs now ignore empty strings (because "" < 10 is true).
    • Clean up parseFilter function.
    • Add filter_childByColumn option.
      • Setting this to true allows searching through the child rows by column.
      • When false, the search behaves as before and all child row content is included in the search of every column.
      • See a demo here.
      • Fixes issues #396 & #574.
    • Code cleanup - added a bunch of whitespace & forced line wraps at around 120.
    • Prevent setFilter function from setting the same filters after an update. Fixes issues #903 & #733.
  • Grouping
    • Add keyboard accessibility to group headers. See issue #260.
  • Math
    • Fix issues with isNaN('') // false. See issue #873.
    • Reapply column indexing after updates & prevent js error on empty tables. Fixes issue #889.
    • Reduce update time to 20ms. See issue #898.
    • Exclude ignored cells even if math_ignore is empty. Fixes issue #896.
  • Output
    • Add BOM back to downloaded file. Fixes issue #862.
    • Add output_hiddenColumns option. Fixes issue #869.
    • Add known issues section about downloading in Safari.
  • Pager (addon & widget)
    • Replace all instances of using jQuery each with plain javascript. Fixes issue #827.
  • Resizable
    • Refreshing the widget will now preserve the storage. See issue #874.
  • Scroller
    • Set overflow-x auto & apply border-box to scroller. See issue #135.
    • Remove pointer-events: none from fixed column. See issue #878.
    • Hide fixed column scrollbar in IE9 & older. See issue #135.
    • Update pointer-events and tabbing accessibility. See issue #135.
    • setFixedColumnSize now properly updates with no set size.
    • Add scroller_addFixedOverlay
      • When true, a fixed column overlay is added for additional styling. See issue #887.
      • It includes css pointer-events set to none to allow interaction with elements underneath; make sure your browser supports it!
    • Fix selector issue in the remove function.
    • Properly refresh column size after an update. Fixes the third part of issue #906.
  • Parsers
    • Add "inputs-numeric" parser. Fixes issue #888.
    • Add jQuery Globalize date & number parsers.
    • "namedNumbers" parser: ignores adjacent puncutation. Fixes issue #890.
    • input-select parsers:
      • Clean up & add event namespaces.
      • Now return an empty string if the value is empty; previously, it would return the cell text when the value was empty.
    • Network "MAC" parser:
      • Return the original string if the address is grossly invalid. Fixes issue #895.
      • No longer auto-detect as iPv6. See issue #895.
  • Themes

Version 2.21.5 (4/8/2015)

  • Filter
    • Cache main loop variables - speed enhancement.
    • Allow setting filter_selectSource along with filter_functions (demo).
  • Resizable
    • Integrate with columnSelector. See issue #859.
    • Prevent javascript error.
    • Resizable handles now properly align when the table is within a layout with margins. Fixes issue #864.
  • Scroller

Version 2.21.4 (3/28/2015)

  • Core
    • Add a utility $.tablesorter.getColumnText() function.
      • This function will provide a centralized method of obtaining column data (raw & parsed text from cells) and allow processing cells.
      • I plan to update all widgets that need to interact or obtain column data to use this function in v2.22.0.
  • Build
    • The build process now includes selected parsers (added parsers option to build json).
    • A new jquery.tablesorter.combined.js file is created which will contain the core plugin along with all selected widgets & parsers; a default build does not have any selected parsers.
    • This will work around, but not resolve, issue #855.
  • Extras
    • Update semver.js & semver-mod.js to v4.3.3.