mirror of
https://github.com/cupcakearmy/formhero.git
synced 2024-12-22 16:16:24 +00:00
Update README.md
This commit is contained in:
parent
7cc9654507
commit
dd993e091e
82
README.md
82
README.md
@ -1,2 +1,82 @@
|
||||
# formhero
|
||||
Fully customisable React form utility
|
||||
|
||||
Fully customisable react form utility.
|
||||
|
||||
## ✓ Features
|
||||
|
||||
- Typescript compatible
|
||||
- Customizable extractor, validator, getter and setters. (More in the docs)
|
||||
- No Deps
|
||||
- Miniscule ()
|
||||
|
||||
## 🚀 Quickstart
|
||||
|
||||
```tyimport React from 'react'
|
||||
import ReactDOM from 'react-dom'
|
||||
import { useForm } from 'formhero'
|
||||
|
||||
const Form = () => {
|
||||
|
||||
const { auto, form, errors } = useForm({
|
||||
username: '',
|
||||
password: '',
|
||||
type: 'formhero',
|
||||
awesome: true,
|
||||
}, {
|
||||
username: /^test/,
|
||||
password: {
|
||||
validator: /^.{3,}$/,
|
||||
message: 'To short',
|
||||
},
|
||||
awesome: (value) => !!value
|
||||
})
|
||||
|
||||
const _submit = (e: React.FormEvent) => {
|
||||
e.preventDefault()
|
||||
console.log(form, errors)
|
||||
}
|
||||
|
||||
return (
|
||||
<div>
|
||||
<form onSubmit={_submit}>
|
||||
|
||||
<div>Username</div>
|
||||
<input {...auto('username')} />
|
||||
{errors.username && 'Something went wrong'}
|
||||
<br />
|
||||
|
||||
<div>Password</div>
|
||||
<input {...auto('password')} />
|
||||
<br />
|
||||
|
||||
<div>Which one to choose?</div>
|
||||
<select {...auto('type')}>
|
||||
<option value="redux-form">Redux-Form</option>
|
||||
<option value="react-hook-forms">React-Hook-Forms</option>
|
||||
<option value="formik">Formik</option>
|
||||
<option value="formhero">FormHero</option>
|
||||
</select>
|
||||
<br />
|
||||
|
||||
<div>Is it awesome?</div>
|
||||
<input type="checkbox" name="vehicle" {...auto('awesome', {
|
||||
setter: 'checked',
|
||||
getter: 'onChange',
|
||||
extractor: (e) => e.target.checked
|
||||
})} />
|
||||
<br />
|
||||
|
||||
<button type="submit">Go 🚀</button>
|
||||
</form>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
```
|
||||
|
||||
## 📖 Docs
|
||||
|
||||
### `useForm`
|
||||
|
||||
```typescript
|
||||
const {auto, errors, update, form} = useForm(initial, validators, options)
|
||||
```
|
||||
|
Loading…
Reference in New Issue
Block a user