From 26327ab91e1c38a6b06f419e82a1925afdf094b0 Mon Sep 17 00:00:00 2001 From: Niccolo Borgioli Date: Fri, 3 Mar 2023 23:18:44 +0100 Subject: [PATCH] readme --- README.md | 52 ++++++++++++++++++++++++++-------------------------- package.json | 2 +- 2 files changed, 27 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index af7fc04..689bfa7 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ ![Logo](https://raw.githubusercontent.com/cupcakearmy/formhero/master/.github/Logo.jpg) -![dependencies](https://badgen.net/david/dep/cupcakearmy/formhero) -![downloads badge](https://badgen.net/npm/dt/formhero) -![types badge](https://badgen.net/npm/types/formhero) ![version badge](https://badgen.net/npm/v/formhero) +![types badge](https://badgen.net/npm/types/formhero) +![downloads badge](https://badgen.net/npm/dt/formhero) +![dependencies](https://badgen.net//bundlephobia/dependency-count/formhero) ![minzip size badge](https://badgen.net/bundlephobia/minzip/formhero) **Fully customisable react form utility.** @@ -22,7 +22,7 @@ npm i formhero ``` -*Note:* Requires at least typescript version `3.5`, otherwise the error object will not have the right inherited types. +_Note:_ Requires at least typescript version `3.5`, otherwise the error object will not have the right inherited types. ### 👁 Demos @@ -99,7 +99,7 @@ const Form = () => { password: '', }, { - username: value => value.length > 3, + username: (value) => value.length > 3, email: { validator: /@/, message: 'Must contain an @', @@ -146,7 +146,7 @@ const Form = () => { return (
{ + onSubmit={(e) => { e.preventDefault() console.log(form) }} @@ -159,7 +159,7 @@ const Form = () => { {...field('awesome', { setter: 'checked', getter: 'onChange', - extractor: e => e.target.checked, + extractor: (e) => e.target.checked, })} /> Is it awesome? @@ -176,28 +176,28 @@ const Form = () => { Sometimes you don't know all the fields upfront. You can simply define a generic type and assign it to the initial object. Of course type assistance is limited in this case as formhero cannot be sure what keys are valid. ```typescript -import React from "react"; -import ReactDOM from "react-dom"; -import { useForm } from "formhero"; +import React from 'react' +import ReactDOM from 'react-dom' +import { useForm } from 'formhero' -type MyForm = { [field: string]: string | number }; +type MyForm = { [field: string]: string | number } const init: MyForm = { - username: "unicorn", - password: "" -}; + username: 'unicorn', + password: '', +} const Form: React.FC = () => { - const { field, form, errors } = useForm(init); + const { field, form, errors } = useForm(init) return ( - - - + + +
- ); -}; + ) +} ``` ## 📖 Documentation @@ -267,9 +267,9 @@ const validators = { message: 'My custom error message', }, /[\d]/, - async value => value.length > 0, + async (value) => value.length > 0, { - validator: value => true, + validator: (value) => true, message: 'Some other error', }, ], @@ -282,8 +282,8 @@ const validators = { const validators = { username: async (s: string) => { const taken = await API.isUsernameTaken(s) - return taken ? 'Username is taken': true - } + return taken ? 'Username is taken' : true + }, } ``` @@ -307,7 +307,7 @@ const validators = {} const options = { setter: 'value', // This is not stricly necessarry as 'value' would already be the default. getter: 'onChangeText', - extractor: text => text.toLowerCase(), + extractor: (text) => text.toLowerCase(), } export default () => { @@ -339,7 +339,7 @@ export default () => { {...field('username', { setter: 'value', // This is not stricly necessarry as 'value' would already be the default. getter: 'onChangeText', - extractor: text => text.toLowerCase(), + extractor: (text) => text.toLowerCase(), })} /> {form.username} diff --git a/package.json b/package.json index 69cf392..61d485c 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "formhero", - "version": "0.1.0", + "version": "1.0.0-rc.0", "type": "module", "module": "./dist/index.js", "types": "./dist/index.d.ts",