a-multistep-form
v1.0.1
Published
A flexible and customizable multi-step form component for React applications. This package provides an easy way to create multi-step forms with a sleek UI, including a progress stepper and animated transitions between steps.
Downloads
14
Readme
Multi-Step Form Component
A flexible and customizable multi-step form component for React applications. This package provides an easy way to create multi-step forms with a sleek UI, including a progress stepper and animated transitions between steps.
Features
- Easy-to-use API
- Customizable styling
- Built-in form context for managing form state
- Animated transitions between steps
- Progress stepper with completed step indicators
Installation
Install the package using npm:
npm install @your-username/multi-step-form
Or using yarn:
yarn add @your-username/multi-step-form
Usage
Here's a basic example of how to use the Multi-Step Form component:
import React from 'react';
import { MultiStepForm, Step } from '@your-username/multi-step-form';
const MyForm = () => {
const handleSubmit = (data) => {
console.log('Form submitted with data:', data);
};
return (
<MultiStepForm onSubmit={handleSubmit}>
<Step title="Personal Info">
<h2>Personal Information</h2>
{/* Add your form fields here */}
</Step>
<Step title="Contact">
<h2>Contact Information</h2>
{/* Add your form fields here */}
</Step>
<Step title="Review">
<h2>Review Your Information</h2>
{/* Add a summary of the form data here */}
</Step>
</MultiStepForm>
);
};
export default MyForm;
API
MultiStepForm
The main component that wraps all the steps.
Props:
children
: React nodes (should beStep
components)onSubmit
: Function to handle form submissionclassName
: Optional CSS class namestyle
: Optional inline stylesstepperProps
: Optional props for the stepper componentnavigationProps
: Optional props for the navigation component
Step
Represents a single step in the form.
Props:
children
: React nodes (your form fields)title
: String title for the step (displayed in the stepper)className
: Optional CSS class namestyle
: Optional inline styles
Styling
The components come with basic styling, but you can easily customize the appearance by passing className
or style
props to the MultiStepForm
and Step
components.
Form State Management
This package uses React Context to manage the form state. You can access and update the form data using the useFormContext
hook:
import { useFormContext } from '@your-username/multi-step-form';
const MyCustomInput = () => {
const { formData, setFormData } = useFormContext();
const handleChange = (e) => {
setFormData({ ...formData, [e.target.name]: e.target.value });
};
return <input name="myField" value={formData.myField || ''} onChange={handleChange} />;
};
Example
Here's a more complete example showing how to create a multi-step registration form:
import React from 'react';
import { MultiStepForm, Step, useFormContext } from '@your-username/multi-step-form';
const RegistrationForm = () => {
const handleSubmit = (data) => {
console.log('Registration complete:', data);
// Submit data to your API here
};
return (
<MultiStepForm onSubmit={handleSubmit}>
<Step title="Personal Info">
<PersonalInfoStep />
</Step>
<Step title="Account">
<AccountStep />
</Step>
<Step title="Confirm">
<ConfirmStep />
</Step>
</MultiStepForm>
);
};
const PersonalInfoStep = () => {
const { formData, setFormData } = useFormContext();
const handleChange = (e) => {
setFormData({ ...formData, [e.target.name]: e.target.value });
};
return (
<div>
<h2>Personal Information</h2>
<input
name="firstName"
value={formData.firstName || ''}
onChange={handleChange}
placeholder="First Name"
/>
<input
name="lastName"
value={formData.lastName || ''}
onChange={handleChange}
placeholder="Last Name"
/>
</div>
);
};
const AccountStep = () => {
const { formData, setFormData } = useFormContext();
const handleChange = (e) => {
setFormData({ ...formData, [e.target.name]: e.target.value });
};
return (
<div>
<h2>Account Information</h2>
<input
name="email"
type="email"
value={formData.email || ''}
onChange={handleChange}
placeholder="Email"
/>
<input
name="password"
type="password"
value={formData.password || ''}
onChange={handleChange}
placeholder="Password"
/>
</div>
);
};
const ConfirmStep = () => {
const { formData } = useFormContext();
return (
<div>
<h2>Confirm Your Information</h2>
<p>First Name: {formData.firstName}</p>
<p>Last Name: {formData.lastName}</p>
<p>Email: {formData.email}</p>
</div>
);
};
export default RegistrationForm;
This example demonstrates how to create a three-step registration form using the Multi-Step Form component.
License
MIT