npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

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 be Step components)
  • onSubmit: Function to handle form submission
  • className: Optional CSS class name
  • style: Optional inline styles
  • stepperProps: Optional props for the stepper component
  • navigationProps: 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 name
  • style: 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