React-Wizard

React-Wizard is a React library for handling multi-page forms.

Features

• Clean layout
• Flexible
• Supports optional pages
• Uses Typescript

Installation

yarn add @sbacic/react-wizard

Examples

Basic example:

import { Wizard } from "@sbacic/react-wizard";

<Wizard>
  <Page1 />
  <Page2 />
  <Page3 />
</Wizard>

With optional pages:

import { Wizard, Optional } from "@sbacic/react-wizard";

<Wizard>
  <Page1 />
  <Page2 />
  <Page3 />
  <Optional>
    <Step1a />
    <Step1b />
  </Optional>
</Wizard>

With additional context added in:

import { Wizard, Optional, Steps, useWizard } from "@sbacic/react-wizard";
import { Formik } from "formik";

const FormWithFormikContext = () => {
    const initialValues = {name: "John Smith"};
    const { values, step, next, store, optional } = useWizard();
    const submit = (values) => {
        if (step < 3) {
            store(values);
            next();
        } else {
            // Submit the data
        }
    }
    const schema = [
        {/* schema for first page*/},
        {/* schema for second page*/},
        {/* schema for third page*/}
    ];

    const optionalSchema = [
        {/* schema for first page*/},
        {/* schema for second page*/},
    ];

    const validationSchema = optional === undefined ? optionalSchema[optional] : schema[step];

    return (
        <Formik onSubmit={submit} initialValues={{...initialValues, ...values}} validationSchema={validationSchema}>
        <Steps>
            <Page1 />
            <Page2 />
            <Page3 />
            <Optional>
                <Step1a />
                <Step1b />
            </Optional>
        </Steps>
    </Formik>
    )
}

const Form = () => {
    return (
        <Wizard useWizardRenderer={false}>
          <FormWithFormikContext />
        </Wizard>
    )
}

API

<Wizard>

Your form pages should be wrapped in this to receive the Wizard context. It accepts the following props:

Props

startingStep: number

The starting step of the Wizard. Default is 0.

startingOptional: number

An Optional step to render on the first render. Default is undefined.

wrapInSteps: boolean

Whether to wrap the children in <Steps> or render them normally. Default is true.

<Steps>

Must be a child of Wizard to inherit the wizard context. Will render only the child that matches the current step of the wizard. If the step is less than 0, it shows the first step. If the step is greater than the number of children, shows the last child.

<Optional>

Must be a child of Wizard to inherit the wizard context. Renders optional pages. These are only renderered if you manually send the user there (see go(), below). If the step is less than 0, it shows the first step. If the step is greater than the number of children, shows the last child.

useWizard()

This hook provides functions to switch between forms and store form values for later submission.

Props

next()

Go to the next page in form. If used on an optional page, it returns you to the next non-optional page (eg: if you were on step 2 of a wizard it sends you to step 3).

back()

Go to the previous page in the form. If used on an optional page, it returns you to the main page you were at (eg: if you were on step 2 and went to an optional page, it returns you to step 2).

go(step: number, goToOptional?: true)

Jump to a specific step in the form. If goToOptional is set to true, it jumps to that optional page instead.

store(fields: { [key: string]: unknown })

Stores an object of key/value pairs for later submission.

clear(keys?: string[])

Clear the stored values by key. If no keys are provided, the entire store is emptied.

values

A dictionary of values stored with store().

step

A number representing the current step in the wizard. Zero-indexed.

optional

A number representing the current optional step. If undefined, no optional page is shown.

isFirst

Whether the current step is the first step in the Wizard.

isLast

Whether the current step is the last step in the Wizard.

Development

1. Clone the repository:

git clone https://github.com/sbacic/react-wizard

2. Pack the tarball:

yarn pack

or

npm pack

3. Install it in your test application:

yarn add react-wizard-VERSION.tgz

or

npm add react-wizard-VERSION.tgz

Demo

https://sbacic.github.io/react-wizard-demo/