natural-sort

Sorting with support for numbers, dates, unicode and more.

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
natural-sort
1171.0.08 years ago9 years agoMinified + gzip package size for natural-sort in KB

Readme

David – status of dependencies
Code style: airbnb
natural-sort.js
Sorting with support for numbers, dates, unicode and more.
 

Default features

  • Numbers are handled properly (“2” is before “10”)
  • Dates are detected and sorted as well
  • Empty strings are after “z”

 

Usage

['10. tenth', 'odd', 1, '', '2. second'].sort(naturalSort())
// [1, '2. second', '10. tenth', 'odd', '']

[3, 4, 1, 5, 2].sort(naturalSort({direction: 'desc'}))
// [5, 4, 3, 2, 1]

['a', 'B'].sort(naturalSort())
// ['a', 'B']
['a', 'B'].sort(naturalSort({caseSensitive: true}))
// ['B', 'a']

 

Installation

  1. Download the script. You can use npm or bower:

npm install natural-sort

bower install natural-sort

  1. Include the script before yours:

<script src="/bower_components/natural-sort/dist/natural-sort.js"></script>

 

Credits

The original version of this algorithm was published by Jim Palmer in this blog post.
 

License

MIT © Studio B12 GmbH