
Security News
Crates.io Implements Trusted Publishing Support
Crates.io adds Trusted Publishing support, enabling secure GitHub Actions-based crate releases without long-lived API tokens.
formal-react-forms
Advanced tools
A very sophisticated form state manager for React. 🎩
Note: Decided to use Yup for form validation. An example of usage is below and you can learn more about Yup here: https://github.com/jquense/yup
npm i formal-react-forms
or
yarn add formal-react-forms
import Formal, {
generateError,
FormalProps,
FormalActionsProps,
} from "formal-react-forms";
import * as Yup from "yup";
const validationSchema = Yup.object().shape({
firstName: Yup.string().required("First name is required"),
lastName: Yup.string(),
email: Yup.string()
.email("Please provide a valid email address")
.required("Email is requried"),
password: Yup.string()
.min(8, "Passwords must be between 8 and 50 characters")
.max(50, "Passwords must be between 8 and 50 characters")
.required("Password is required"),
confirmPassword: Yup.string()
.min(8, "Passwords must be between 8 and 50 characters")
.max(50, "Passwords must be between 8 and 50 characters")
.required("Please confirm your password"),
});
const initialValues = {
firstName: "",
lastName: "",
email: "",
password: "",
confirmPassword: "",
};
const onSubmit = (actions: FormalActionsProps, values: InitialValuesProps) => {
// Make Axios (or equivalent) call
// You have access to :
// an object with the values from the form
values: actions: {
setIsSubmitting, // set state action to update isSubmitting state
setErrors; // set state action to update form errors
}
// Examples:
// actions.setErrors([newError]);
// actions.setIsSubmitting(false);
// Convert server returned errors to Yup errors with:
const newError = generateError({
message: "The passwords do not match",
path: "confirmPassword",
});
};
<Formal
isInitiallyValid={true}
validationSchema={validationSchema}
initialValues={initialValues}
onSubmit={(actions, values) => onSubmit(actions, values)}
>
{({ isValid, errors, values, onChangeValues, isSubmitting }: FormalProps) => {
return (
<div>
<input
type="text"
value={values.firstName}
placeholder="First Name"
onChange={({ target: { value } }) => {
onChangeValues({ firstName: value });
}}
/>
// See example function below
{getError({ field: "firstName", errors })}
</div>
<div>
<input
type="text"
value={values.lastName}
placeholder="Last Name"
onChange={({ target: { value } }) => {
onChangeValues({ lastName: value });
}}
/>
// See example function below
{getError({ field: "lastName", errors })}
</div>
<div>
<input
type="email"
value={values.email}
placeholder="Email Address"
onChange={({ target: { value } }) => {
onChangeValues({ email: value });
}}
/>
// See example function below
{getError({ field: "email", errors })}
</div>
<div>
<input
type="password"
placeholder="Password"
value={values.password}
onChange={({ target: { value } }) =>
onChangeValues({ password: value })
}
/>
// See example function below
{getError({ field: "password", errors })}
</div>
<div>
<input
type="password"
placeholder="Confirm Password"
value={values.confirmPassword}
onChange={({ target: { value } }) =>
onChangeValues({ confirmPassword: value })
}
/>
// See example function below
{getError({ field: "confirmPassword", errors })}
</div>
<div>
<button type="submit" disabled={!isValid}>
{isSubmitting ? "Loading..." : "Submit"}
</button>
</div>
);
}}
</Formal>
const getError = ({
field,
errors,
}: {
field: string,
errors: Yup.ValidationError[],
}) => {
const error = errors.find((error) => error.path === field);
return error ? <span>{error.message}</span> : null;
};
This project is licensed under the MIT License - see the LICENSE.md file for details
FAQs
The most sophisticated form state wrapper for React
The npm package formal-react-forms receives a total of 0 weekly downloads. As such, formal-react-forms popularity was classified as not popular.
We found that formal-react-forms demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Crates.io adds Trusted Publishing support, enabling secure GitHub Actions-based crate releases without long-lived API tokens.
Research
/Security News
Undocumented protestware found in 28 npm packages disrupts UI for Russian-language users visiting Russian and Belarusian domains.
Research
/Security News
North Korean threat actors deploy 67 malicious npm packages using the newly discovered XORIndex malware loader.