table-sort-js

TABLE-SORT-JS.

• Description: A JavaScript client-side HTML table sorting library with no dependencies required.

• Demo

• Documentation. (work in progress)

• npm package.

• firefox browser extension

Install instructions.

Option 1. Install from npm: npm install table-sort-js

import tableSort from "table-sort-js/table-sort.js";

Refer to the documentation for examples on using table-sort-js with frontend frameworks such as React.js and Vue.js

Option 2. Download table-sort.js (Select save as.), or download a minified version (~5kB)

Then add the following script before your HTML table:

<script src="table-sort.js"></script>

Refer to the documenation for examples on how to use table-sort-js with HTML

To make tables sortable:

• Add class="table-sort" to HTML <table> tags.
• Click on table headers to sort columns.

Classes:

<table> classes

Description

"table-sort"

Make the table sortable! (Words, numbers, dates, file sizes)...

"no-class-infer"

Turns off inference for adding sort classes automatically i.e (file-size-sort, runtime-sort, dates-dmy-sort).

"table-arrows"

Display ascending or descending triangles.

"remember-sort"

If clicking on different columns remembers sort of the original column.

<th> classes	Description
"data-sort"	Sort by data attributes, e.g <td data-sort="42">
"dates-mdy-sort"	Sorts dates in US style mm/dd/yyyy format;. e.g (12/28/2023). Can use "/" or "-" as separator. Overides inferred "dates-dmy-sort" class.
"onload-sort"	Sort column on loading of the page. Simulates a click from the user. (can only sort onload for one column)
"disable-sort"	Disallow sorting the table by this specific column.

<th> Inferred Classes.	Description
"dates-dmy-sort"	Sorts dates in dd/mm/yyyy format. e.g (18/10/1995). Can use "/" or "-" as separator.
"dates-ymd-sort"	Sorts dates in ISO 8601 yyyy/mm/dd format. e.g (2021/10/28). Use "/" or "-" as separator.
"file-size-sort"	Sorts file sizes(B->TiB) uses the binary prefix. (e.g KiB). Input data ideally in Bytes e.g (10b or 10B)
"runtime-sort"	Sorts runtime in hours minutes and seconds e.g (10h 1m 20s). Useful for sorting the GitHub actions Run time column...

<th> Classes that change defaults.	Description
"order-by-desc"	Order by descending on first click. (default is aescending)
"alpha-sort"	Sort alphabetically (z11,z2); default is natural sort (z2,z11).
"punct-sort"	Sort punctuation; default ignores punctuation.

Development:

If you wish to contribute, install instructions can be found here.