@reusejs/react-text-inputs NPM

React Pickers

View Storybook at: https://master--61813814a34217003af04032.chromatic.com

React Pickers consist of UI Components to solve use cases of "picking"! Be it a radio button, checkbox, dropdown, multi select dropdown, cards. The end goal is to pick one or more options, and most of the times we also want to preselect some options.

Usage

Data Source

The implementation of this picker is done in multiple layers, the bottom most one which drives the logic is a renderless hook. So, you can use that if needed and build any kind of picker you need. The most important aspect of this hook is the prop: dataSource.

When you implement any picker - the question you would eventually face is where does the picker gets it's options from! We solved it simply introducing a callback function which the component itself calls or you can trigger it too.

Static Data

dataSource={(q) => { 
    return [
        { 'label': 'Asia', "value": 'asia' }
        { 'label': 'Europe', "value": 'europe' }
    ]
}}

You can have something as simple as above, which serves as static data. Do you need to mention the key as "value"? You can override that too if you want. But, "value" seems to cover most of the use cases which we faced.

Dynamic Data

dataSource={async (q) => { 
    let response = await callSomeAPI();
    return restructureResponseAsOptions(response);
}}

Single Select implementation

<Picker
    label="Select Continent"
    dataSource={async (q) => { 
        let response = await callSomeAPI();
        return restructureResponseAsOptions(response);
    }}
    defaultSelected={[
        { 'label': 'Asia', "value": 'asia' }
    ]}
/>

Multiple Select implementation

<Picker
    label="Select Continent(s)"
    dataSource={async (q) => { 
        let response = await callSomeAPI();
        return restructureResponseAsOptions(response);
    }}
    defaultSelected={[
        { 'label': 'Asia', "value": 'asia' }
    ]}
    multiple
/>

Where to write components?

There is a src folder where you can write your components
Whichever components you want to be exposed would go into: index.js

Workflow

There are two ways you can develop components.

Storybook

Run: yarn storybook which will run the storybook in your localhost
When you write your own component, also write a .stories.jsx and storybook would pick it up

Another ReactJS App

Create a brand new react js app (Ex: my-app) using following: https://reactjs.org/docs/create-a-new-react-app.html#create-react-app
Run yarn link in current component library. Ex: If you component name is react-text-inputs, you would run yarn link inside react-text-inputs
Go to newly created reactjs app (my-app) and run yarn link @reusejs/react-text-inputs
At the same time also run yarn serve in react-text-inputs, so that as you make changes, build happens simultaneously and your my-app refreshes it