Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/robcalcroft/react-use-input

🎣 A hook whose setter can be directly given to HTML inputs
https://github.com/robcalcroft/react-use-input

controlled hooks input react react-hooks

Last synced: 3 months ago
JSON representation

🎣 A hook whose setter can be directly given to HTML inputs

Lists

README

        

# react-use-input
A hook :fishing_pole_and_fish: whose setter can be directly given to HTML inputs

This package is designed to be super simple and small; it won't add any bloat to your project. However, feel free to copy and paste the [code](https://raw.githubusercontent.com/robcalcroft/react-use-input/master/index.js) if you'd like to avoid another dependency :smile:

Other packages use object spread syntax to achieve a similar result, but this package doesn't because:
- This way is much easier to read
- You don't end up with bloat in your props for super simple use cases

## Install
```
yarn add react-use-input
```

## Use
By default, `useInput()` returns a tuple of the current value and a setter which will pick the `value` key out of an `Event` object.

```javascript
useInput(, )
```

**A simple example**

```javascript
import useInput from 'react-use-input';

function Component() {
const [name, setName] = useInput();

return ;
}
```

**Checkbox type input with non default state**

```javascript
import useInput from 'react-use-input';

function Component() {
const [selected, setSelected] = useInput(false, 'checked');

return (

);
}
```

Feel free to raise an issue to discuss other use cases that aren't covered here