1
1
mirror of https://github.com/theoludwig/react-component-form.git synced 2024-07-12 13:30:12 +02:00
Go to file
2021-06-17 18:48:19 +02:00
.github chore: rewrite package 2021-06-17 18:48:19 +02:00
example chore: rewrite package 2021-06-17 18:48:19 +02:00
src chore: rewrite package 2021-06-17 18:48:19 +02:00
test chore: rewrite package 2021-06-17 18:48:19 +02:00
.commitlintrc.json chore: rewrite package 2021-06-17 18:48:19 +02:00
.editorconfig 🎉 Initial commit 2020-08-04 16:22:31 +02:00
.gitignore chore: rewrite package 2021-06-17 18:48:19 +02:00
.markdownlint.json chore: rewrite package 2021-06-17 18:48:19 +02:00
.npmrc chore: rewrite package 2021-06-17 18:48:19 +02:00
.prettierrc.json chore: rewrite package 2021-06-17 18:48:19 +02:00
CODE_OF_CONDUCT.md chore: rewrite package 2021-06-17 18:48:19 +02:00
CONTRIBUTING.md chore: rewrite package 2021-06-17 18:48:19 +02:00
LICENSE chore(release): v1.3.0 2020-12-27 19:47:15 +01:00
package-lock.json chore: rewrite package 2021-06-17 18:48:19 +02:00
package.json chore: rewrite package 2021-06-17 18:48:19 +02:00
README.md chore: rewrite package 2021-06-17 18:48:19 +02:00
tsconfig.json chore: rewrite package 2021-06-17 18:48:19 +02:00

react-component-form

Manage React Forms with ease.

Licence MIT Contributor Covenant

Conventional Commits npm version

📜 About

react-component-form is a lightweight form component for React.js, it allows you to get the inputs values without state thanks to onChange or onSubmit props.

Demo : https://divlo.github.io/react-component-form/.

This project was bootstrapped with create-react-library.

💾 Install

npm install --save react-component-form

⚙️ Usage

import React from 'react'
import Form, { HandleForm } from 'react-component-form'

const Example = () => {
  const handleSubmit: HandleForm = (formData, formElement) => {
    console.log(formData) // { inputName: 'value of the input' }
    formElement.reset()
  }

  return (
    <Form onSubmit={handleSubmit}>
      <input type='text' name='inputName' />
      <button type='submit'>Submit</button>
    </Form>
  )
}

Note : The example use TypeScript, but obviously you can use JavaScript. Be aware that HandleForm is the type definition for the onChange and onSubmit props.

Basically you have access to the same props of the HTML form tag in React, but the onSubmit and the onChange props are differents.

Instead to get the event param you get formData and formElement params :

  • formData: It's an object where the keys are the name of your inputs and the current value. Behind the scene, it uses the FormData constructor.
  • formElement: It's the actual HTML form element in the DOM so for example you can access the .reset() method on a HTMLFormElement.

📄 License

MIT