0.3.1 • Published 3 years ago

@promise_learning/usefilter v0.3.1

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

useFilter

A react hook to filter large amount of data in frontend using Web Worker.In order to keep the main thread free and run the web application without any glitches we can leverage the use of Web Worker which runs on a separate thread and can share the messages with main thread.

Live Demo

How to use

Installation

  • NPM: npm install @promise_learning/usefilter
  • Yarn: yarn add @promise_learning/usefilter

Usage

We recommend using react-window for rendering large data set. Also use useDebounce hook with search

  import { useFilter } from '@promise_learning/usefilter';
  import from './data.json';


  ///////////////////////////////////////////
  // handle this using the state in your app
  //////////////////////////////////////////

  const searchData = {
    query: '',
    fields: ['name'],
  };

  const filtersData = {
    category: ['Sci Fiction'],
  };


  export const App = () => {
    const { loading, data: result } = useFilter({ data, search: searchData, filters: filterData });

    if (loading) {
      return <div>Loading..</div>
    }

    return (
      <>
          // render result
      </>
    )
  }

Parameters

ParameterTypeRequired
dataArraytrue
searchObject -> {query: '', fields: [], enableHighlighting: true}. query is the search term, fields is the object keys to search on and enableHighlighting lets you highlight the matching partfalse
filtersObject -> Key Value Pair. Where key is a field from object in array and value could be possible valuefalse

Data Returned

Object with following data is returned by the useFilter hook.

KeyValuesDescription
loadingtrue / falseWorker state if it is processing the data or not
dataArrayfiltered response based on the input

When to use?

  • Filter / Search large list in frontend
  • Filter / Search large data table in frontend

License

MIT License

0.3.1

3 years ago

0.3.0

3 years ago

0.2.4

3 years ago

0.2.3

3 years ago

0.2.2

3 years ago

0.2.1

3 years ago

0.2.0

3 years ago

0.1.0

3 years ago