react-fieldz

react-fieldz is a library built off of fieldz.

It provides the useFields react hook, which simply wraps fieldz in React's useState.

Please see fieldz for more detail on the api.

Example Usage

import React from 'react'
import { useFields } from '@zecos/react-fieldz'
import { nameValidator } from '@zecos/validatorz'

const fieldProperties = {
  firstName: {
    init: "",
    validate: nameValidator
  },
  customField: {
    validate: (val: string) => {
      if (val !== "hello") {
        return [new Error("value must be hello!")]
      }
      return []
    },
    init: "this is my init value"
  }
}


const camelToTitle = camelCase => camelCase
    .replace(/([A-Z])/g, match => ` ${match}`)
    .replace(/^./g, match => match.toUpperCase())
    .trim()

const App = () => {
  const [state, actions] = useFields(fieldProperties)
  const {setValue, setValues, setTouched, resetField, resetFields } = actions

  return (
    <form>
      {Object.entries(state).map(([fieldName, {errors}]) => <div key={fieldName}>Error: {JSON.stringify(errors.map(err => err.toString()))}</div>)}
      {Object.entries(state)
        .map(([fieldName, {errors, value, touched, pristine}]) => (
          <div key={fieldName}>
            {(touched && errors.length) ? <span className="input-error">{errors.map(err => <div>{err.toString()}</div>)}</span> : ""}
            <label htmlFor={fieldName}>{camelToTitle(fieldName)}</label>
            <input
              name={fieldName}
              id={fieldName}
              value={value}
              aria-label={fieldName}
              onChange={e => setValue(fieldName, e.target.value)}
              onBlur={_ => setTouched(fieldName)}
            />
          </div>
        ))
      }
    </form>
  )
}

export default App

Or you can use useField for a single field like so:

import React from 'react'
import { useField } from '@zecos/react-fieldz'
import { nameValidator } from '@zecos/validatorz'

const App = () => {
  const [firstNameState, firstNameActions] = useField({
    init: "",
    validate: nameValidator,
  })

  const {setValue, setTouched, reset } = actions

  return (
    <form>
      <div key={fieldName}>
        {(touched && errors.length) ? <span className="input-error">{errors.map(err => <div>{err.toString()}</div>)}</span> : ""}
        <label htmlFor="firstName">First Name</label>
        <input
          name="firstName"
          id="firstName"
          value={value}
          aria-label="firstName
          onChange={e => setValue(e.target.value)}
          onBlur={_ => setTouched()}
        />
      </div>
    </form>
  )
}