@aloysius-software-factory/array-sort-helper v1.0.7
array-sort-helper
A simple library to make sorting array of objects easier
Install
You can install this library via npm
npm i @aloysius-software-factory/array-sort-helper
How to use
This package provides 3 functions:
- SortFunction
- SortFunctionMultiple
- SortFunctionMultipleFieldAndDirection
These functions will return a function that will be used as an argument when sorting array
array.sort(SortFunction('name', false, null);
SortFunction
SortFunction is the simplest of the 3. It simply sorts an array of objects according to the specified attribute string.
SortFunction<T, V = T>(
field: keyof V,
reverse: boolean,
conversion: (input: any) => V | null
): (a: T, b: T) => number
It takes 3 arguments:
1. field - a string containing the attribute name you want to sort the array with
2. reverse - a boolean which denotes whether you want the array to be sorted in ascending or descending order. true means it will sort in ascending order. false means it will sort in descending order.
3. conversion - is a function that will be applied to each member to each array to transform it to another form. the input of the function is the value of the object's attribute (Tfield). Pass null if no conversion is needed.
SortFunctionMultiple
SortFunctionMultiple is similar to SortFunction but it can sort the array using multiple attributes.
SortFunctionMultiple<T, V = T>(
fields: (keyof V)[],
reverse: boolean,
conversions: ((input: any) => V | null)[]
): (a: T, b: T) => number
It takes 3 arguments:
1. fields - an array of attribute names (string) to sort by. sorting will be applied in sequence
2. reverse - a boolean which denotes whether you want the array to be sorted in ascending or descending order. true means it will sort in ascending order. false means it will sort in descending order.
3. conversion - is an array of function that will be applied to each member to each array to transform it to another form. The input of the function is the value of the object's attribute (Tfield). Pass null if no conversion is needed. Each function will be applied to the corresponding attribute at the same index as fields
SortFunctionMultipleFieldAndDirection
SortFunctionMultipleFieldAndDirection is similar to SortFunctionMultiple. It can sort the array using multiple attributes with multiple directions (e.g. sort by attribute X in ascending order then by attribute Y in descending order).
SortFunctionMultipleFieldAndDirection<T, V = T>(
fields: (keyof V)[],
reverse: boolean[],
conversions: ((input: any) => V | null)[]
): (a: T, b: T) => number
It takes 3 arguments:
1. fields - an array of attribute names (string) to sort by. sorting will be applied in sequence
2. reverse - an array of boolean which denotes whether you want the array to be sorted in ascending or descending order. true means it will sort in ascending order. false means it will sort in descending order. The order is applied to the corresponding attribute at the same index as fields.
3. conversion - is an array of function that will be applied to each member to each array to transform it to another form. The input of the function is the value of the object's attribute (Tfield). Pass null if no conversion is needed. Each function will be applied to the corresponding attribute at the same index as fields