React useFormValidate Hook

Este hook de React proporciona funcionalidades para gestionar el estado y la validación de formularios de manera sencilla.

Instalación

Puedes instalar el hook utilizando npm:

npm install --save use-form-validate

Uso

import React from 'react';
import {useFormValidate} from 'use-form-validate';

const MyFormComponent = () => {
  const {
    inputs,
    handleChange,
    errors,
    setError,
    clearError,
    validate,
    handleSubmit,
    getFieldProps,
    getFieldError,
    resetForm
  } = useFormValidate();

  const onSubmit = (formData) => {
    // Lógica para manejar el envío del formulario
    console.log('Formulario enviado:', formData);
  };

  return (
    <form onSubmit={handleSubmit(onSubmit)}>
      <div>
        <label htmlFor="fieldName">Campo de Ejemplo:</label>
        <input
          type="text"
          id="fieldName"
          {...getFieldProps('fieldName', { required: true })}
        />
        <span style={{ color: 'red' }}>{getFieldError('fieldName')}</span>
      </div>

      {/* Agrega más campos del formulario según tus necesidades */}

      <div>
        <button type="submit">Enviar</button>
      </div>
    </form>
  );
};

export default MyFormComponent;

Funcionalidades

• handleChange(name, value): Actualiza el valor de un campo en el estado.
• updateInput(name, updatedProperties): Actualiza propiedades específicas de un campo en el estado.
• removeInput(name): Elimina un campo del estado.
• setError(name, message): Establece un mensaje de error para un campo específico.
• clearError(name): Limpia el mensaje de error para un campo específico.
• validate(name, value, rules): Realiza la validación de un campo según reglas específicas.
• handleSubmit(onSubmit): Maneja la lógica de envío del formulario, ejecuta la validación y llama a la función onSubmit si el formulario es válido.
• getFieldProps(name, rules, anotherValue,defaultValue): Proporciona props para un campo específico, incluido el valor, el manejo de cambios y el estado de error.
• resetForm(): Permite reiniciar el formulario.

Reglas de Validación

El useFormValidate hook proporciona varias funcionalidades para facilitar la gestión de formularios, junto con reglas de validación personalizadas. Aquí hay un resumen de las reglas de validación disponibles:

• errorBoolean: Si el input trabaja con error pero es de tipo booleano.

  getFieldProps('fieldName', { errorBoolean: true })

• required: Campo obligatorio.

  getFieldProps('fieldName', { required: true })

• helperText: Permite establecer cual es la propiedad que muestra el mensaje de error (Es mas util cuando se usa alguna librería como MUI o se crean componentes que reciben el mensaje de error por props).

  getFieldProps('fieldName', { helperText: 'helperText' })

• value: Permite establecer un valor por defecto.

  getFieldProps('fieldName', { value: 'valor inicial' })

• minLength: Mínimo número de caracteres permitidos.

  getFieldProps('fieldName', { minLength: 5 })

• maxLength: Máximo número de caracteres permitidos.

  getFieldProps('fieldName', { maxLength: 10 })

• money: Valor debe ser un formato de dinero válido.

  getFieldProps('amount', { money: true })

• phone: Valor debe ser un formato de numero válido.

  getFieldProps('telephone', { phone: true })

• isEqual: Igualdad con otro campo.

  getFieldProps('password', { isEqual: 'confirmPassword' })

• email: Debe ser un correo electrónico válido.

  getFieldProps('email', { email: true })

• date: Debe ser una fecha válida.

  getFieldProps('eventDate', { date: true })

• checkbox: Para inputs de tipo checkbox.

  getFieldProps('check_input', { checkbox: true })

• radio: Para inputs de tipo radio.

    <input 
      type="radio"
      { ...getFieldProps('radio_input', { radio: true })}
      value="option1"
    />
    <input 
      type="radio"
      { ...getFieldProps('radio_input', { radio: true })}
      value="option2"
    />

• file: Para inputs de tipo file.

  getFieldProps('file_input', { file: true })

• onBlur: Ejecuta la validación cuando pierde el foco.

  getFieldProps('fieldName', { onBlur: true })

• validate: Validación personalizada con una función.

  getFieldProps('customField', {
    validate: (value, allInputs) => {
      // Lógica de validación personalizada
      return true; // Devuelve `true` si la validación es exitosa, un mensaje de error si falla.
    }
  })

• errorLabel: Permite modificar el mensaje de error.

  getFieldProps('fieldName', { required:true, errorLabel: "Verifica el campo antes de continuar" })

Ejemplo de uso de getFieldProps y getFieldError

const {
  getFieldProps,
  getFieldError,
} = useFormValidate();

// ...

<input
  type="text"
  id="fieldName"
  {...getFieldProps('fieldName', { required: true, minLength: 3, maxLength: 10 })}
/>
<span style={{ color: 'red' }}>{getFieldError('fieldName')}</span>

Con estas reglas, puedes personalizar la validación de cada campo de acuerdo con tus requisitos específicos. ¡Experimenta con ellas y ajusta según sea necesario para tu aplicación!

Personalización de Mensajes de Error

Puedes personalizar los mensajes de error pasando un objeto al hook. Los mensajes pueden incluir marcadores de posición, como {minLength}, {maxLength}, o {customMessage}, que se reemplazarán con los valores correspondientes durante la validación.

const customErrorMessages = {
  is_type_file: 'Debe seleccionar un archivo',
  is_type_checkbox: 'Debe seleccionar al menos una opción',
  is_type_radio: 'Debe seleccionar una opción',
  is_required: 'Campo obligatorio',
  is_type_money: 'Debe ser un valor numérico válido para dinero',
  min_length: 'El campo debe tener al menos {minLength} caracteres',
  max_length: 'El campo no debe exceder los {maxLength} caracteres',
  fields_not_match: 'Los campos no coinciden',
  invalid_email: 'Ingrese un correo electrónico válido',
  invalid_phone: 'Ingrese un numero telefónico válido',
  invalid_date: 'Ingrese una fecha válida',
  invalid_url: 'Ingrese una url válida',
  custom_validation: 'Error de validación personalizada: {customMessage}',
};

const {
  // ... otras props del hook
} = useFormValidate(customErrorMessages);

Contribuciones

Las contribuciones son bienvenidas. Si encuentras algún error o tienes sugerencias para mejorar este hook, no dudes en abrir un problema o enviar un pull request.

Licencia

Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.