React Hook Form Wizard

React multistep wizard library with React Hook Form integration.

This library let's you build multistep form wizards using React Hook Form. How this works is that steps are internally wrapped inside form element which has a submit handler provided by react-hook-form. You can configure validation, validation strategy and initial values for each step and connect to RHF with useFormContext in your step components. Form submission is handled by the wizard automatically but that is customizable to some extent as well.

Library basically consists of Wizard component that requires a list of step configuration objects. Wizard itself collects inputted form values from each step. Collected values can be accessed using useWizard hook.

NOTE: This project is based on the original Formik version of this same wizard. As it's almost a direct copy of the original project, there may be some hiccups or how this wizard is used may not feel the "react-hook-form way" but things are subject to change based on the feedback.

Demo

https://kennyhei.github.io/rhf-wizard/

Small demo showcasing the wizard and various use cases such as:

• Step with basic form validation
• Step with form where validation is dependent on what user inputted in previous view
• Skippable step
• Async step
• Final step with summary of inputted data
• Shared footer with navigation buttons
• Shared header with progress bar
• Animated steps
• URL hashes

You can find more information on usage below.

Table of Contents

• Installation
• Quickstart
• How it works
  • 1. Configuring list of steps
  • 2. Writing your step component(s)
  • 3. Setting up the Wizard
  • 4. Full example
  • What if I don't want to use RHF in step component?
• Navigation
  • BasicFooter
• API
  • Step object
  • Wizard
  • useWizard
• Advanced topics
  • Skipping steps
  • Validating form field based on what user inputted in previous step(s)
  • Saving form values in sessionStorage
  • Using URL hashes in the wizard
  • Animations
  • Creating wrapper for steps
  • Creating header for wizard
  • Creating custom submit handler for step

Installation

NPM:

npm install rhf-wizard --save

Yarn:

yarn add rhf-wizard react-hook-form

Note: It is also recommended to install yup for validation (it is used in examples below). You can install yup with npm install yup --save or yarn add yup. However, it's not mandatory as you can write your validation function to steps with plain JS as well (see validate).

Quickstart

1import React from "react";
2import ReactDOM from "react-dom/client";
3import { Wizard, useWizard, BasicFooter } from "rhf-wizard";
4import { useFormContext } from "react-hook-form";
5import * as Yup from "yup";
6
7function StepName() {
8  const {
9    register,
10    formState: { errors },
11  } = useFormContext();
12  return (
13    <div>
14      <label htmlFor="name">Name</label>
15      <input {...register("name")} />
16      {errors.name && <span>{errors.name.message}</span>}
17    </div>
18  );
19}
20
21function StepAge() {
22  const {
23    register,
24    formState: { errors },
25  } = useFormContext();
26  return (
27    <div>
28      <label htmlFor="age">Age</label>
29      <input type="number" min="0" max="125" {...register("age")} />
30      {errors.age && <span>{errors.age.message}</span>}
31    </div>
32  );
33}
34
35function StepFinal() {
36  const { values } = useWizard();
37  const name = values.StepName.name;
38  const age = values.StepAge.age;
39  return (
40    <div>
41      <h1>You did it!</h1>
42      <p>
43        Your name is {name} and your age is {age}.
44      </p>
45      <p>Press button to complete the wizard.</p>
46      <button type="submit">Finish</button>
47    </div>
48  );
49}
50
51function App() {
52  const steps = [
53    {
54      id: "StepName",
55      component: <StepName />,
56      initialValues: { name: "John" },
57      validationSchema: Yup.object({
58        name: Yup.string().required("Name is required"),
59      }),
60      hidePrevious: true,
61    },
62    {
63      id: "StepAge",
64      component: <StepAge />,
65      initialValues: { age: 30 },
66      validationSchema: Yup.object({
67        age: Yup.number().positive().required("Age is required"),
68      }),
69    },
70    {
71      id: "StepFinal",
72      component: <StepFinal />,
73      hideNext: true,
74    },
75  ];
76
77  return (
78    <Wizard
79      steps={steps}
80      onStepChanged={(fromStep, toStep, wizardValues) => {
81        console.log("step changed", fromStep.id, toStep.id, wizardValues);
82      }}
83      onCompleted={(values) => {
84        alert("wizard completed");
85        console.log("wizard completed", values);
86      }}
87      footer={<BasicFooter />}
88    />
89  );
90}
91
92ReactDOM.createRoot(document.getElementById("root")).render(<App />);

How it works

You can follow this tutorial step by step. Full code is shown in the end.

1. Configuring list of steps

Wizard component requires a list of steps. Here's a basic example what the list looks like:

1const steps = [
2  {
3    id: "StepName",
4    component: <StepName />,
5    initialValues: { name: "" },
6    validationSchema: Yup.object({
7      name: Yup.string().required("Name is required"),
8    }),
9  },
10  {
11    id: "StepAge",
12    component: <StepAge />,
13    initialValues: { age: "" },
14    validationSchema: Yup.object({
15      age: Yup.number().positive().required("Age is required"),
16    }),
17  },
18  {
19    id: "StepFinal",
20    component: <StepFinal />,
21  },
22];

Each step object defines component that is used to render the step. Wizard wraps the currently active step inside <FormProvider><form></form></FormProvider>. The following step object attributes are passed automatically to react-hook-form:

• initialValues: Default values of the react-hook-form registered fields that are rendered in the component.
• validationSchema / validate: Either define Yup schema or function that validates the form fields.
• validateOnChange: Tells RHF to validate the form on each input's onChange event. Defaults to true.
• validateOnBlur: Tells RHF to validate the form on each input's onBlur event. Defaults to true.

Usually you would need to define at least initialValues and validationSchema / validate (presuming that your step component contains form fields).

You can view the full list of step options here.

2. Writing your step component(s)

If you plan to have form fields in your step component, you should use RHF's register method to render fields and formState.errors to render errors. For instance, this is what StepName and StepAge could look like:

1import { useWizard } from "rhf-wizard";
2import { useFormContext } from "react-hook-form";
3
4function StepName() {
5  const {
6    register,
7    formState: { errors },
8  } = useFormContext();
9  return (
10    <div>
11      <div>
12        <label htmlFor="name">Name</label>
13        <input {...register("name")} />
14        {errors.name && <span>{errors.name.message}</span>}
15      </div>
16      <button type="submit">Next</button>
17    </div>
18  );
19}
20
21function StepAge() {
22  const {
23    register,
24    formState: { errors },
25  } = useFormContext();
26  const { goToPreviousStep } = useWizard();
27  return (
28    <div>
29      <div>
30        <label htmlFor="age">Name</label>
31        <input type="number" {...register("age")} />
32        {errors.age && <span>{errors.age.message}</span>}
33      </div>
34      <button type="button" onClick={goToPreviousStep}>
35        Previous
36      </button>
37      <button type="submit">Next</button>
38    </div>
39  );
40}

Note that we retrieve goToPreviousStep utility function from useWizard hook. You can read more about it here.

3. Setting up the Wizard

Now you can pass the list to Wizard:

1<Wizard
2  steps={steps}
3  onStepChanged={(fromStep, toStep, wizardValues) => {
4    console.log("step changed", fromStep.id, toStep.id, wizardValues);
5  }}
6  onCompleted={(values) => {
7    alert("wizard completed");
8    console.log("wizard completed", values);
9  }}
10/>

• onStepChanged is called each time step is changed. fromStep and toStep represent step objects. wizardValues is a collection of all inputted values in previously completed steps.
• onCompleted is called when user completes the wizard (i.e. submits last step). values contains the field-value pairs from all steps.

If we look at Quickstart example, then onStepChanged would print this after user has completed first step:

1> step changed, StepName, StepAge, { StepName: { firstName: 'John', lastName: 'Doe' } }

After second step:

1> step changed, StepAge, StepFinal, { StepName: { firstName: 'John', lastName: 'Doe' }, { StepAge: { age: 30 } } }

After user has completed the wizard, onCompleted would print this:

1> wizard completed, { firstName: 'John', lastName: 'Doe', age: 30 }

4. Full example

Here's what the finished code looks like:

1import React from "react";
2import { useWizard, Wizard } from "rhf-wizard";
3import { useFormContext } from "react-hook-form";
4import * as Yup from "yup";
5
6function StepName() {
7  const {
8    register,
9    formState: { errors },
10  } = useFormContext();
11  return (
12    <div>
13      <div>
14        <label htmlFor="name">Name</label>
15        <input {...register("name")} />
16        {errors.name && <span>{errors.name.message}</span>}
17      </div>
18      <button type="submit">Next</button>
19    </div>
20  );
21}
22
23function StepAge() {
24  const { goToPreviousStep } = useWizard();
25  const {
26    register,
27    formState: { errors },
28  } = useFormContext();
29  return (
30    <div>
31      <div>
32        <label htmlFor="age">Age</label>
33        <input type="number" min="0" {...register("age")} />
34        {errors.age && <span>{errors.age.message}</span>}
35      </div>
36      <button type="button" onClick={goToPreviousStep}>
37        Previous
38      </button>
39      <button type="submit">Next</button>
40    </div>
41  );
42}
43
44function StepFinal() {
45  const { values, goToPreviousStep } = useWizard();
46  return (
47    <div>
48      <p>
49        Your name is {values.StepName.name} and your age is {values.StepAge.age}
50      </p>
51      <button type="button" onClick={goToPreviousStep}>
52        Previous
53      </button>
54      <button type="submit">Finish</button>
55    </div>
56  );
57}
58
59function App() {
60  const steps = [
61    {
62      id: "StepName",
63      component: <StepName />,
64      initialValues: { name: "" },
65      validationSchema: Yup.object({
66        name: Yup.string().required("Name is required"),
67      }),
68    },
69    {
70      id: "StepAge",
71      component: <StepAge />,
72      initialValues: { age: "" },
73      validationSchema: Yup.object({
74        age: Yup.number().positive().required("Age is required"),
75      }),
76    },
77    {
78      id: "StepFinal",
79      component: <StepFinal />,
80    },
81  ];
82
83  return (
84    <Wizard
85      steps={steps}
86      onStepChanged={(fromStep, toStep, wizardValues) => {
87        console.log("step changed", fromStep.id, toStep.id, wizardValues);
88      }}
89      onCompleted={(values) => {
90        alert("wizard completed");
91        console.log("wizard completed", values);
92      }}
93    />
94  );
95}

What if I don't want to use RHF in step component?

Then you can omit initialValues and validationSchema / validate attributes from the step object and not just use RHF's useFormContext hook in your step component. You can basically write anything in your component as long as it has a button of type submit for proceeding to the next step or alternatively you can use shared navigation component which will be explained next.

Navigation

If you wish to include a shared navigation for all steps in your wizard, you can create your own component and pass it to Wizard using footer or header props. When you do that, the following properties would be useful to retrieve from Wizard using useWizard hook:

• goToPreviousStep: Function that goes to previous step.
• isFirstStep: Boolean indicating whether step is first step.
• isLastStep: Boolean indicating whether step is last step.
• isLoading: Boolean indicating whether step is in loading state.
• activeStep:
  • hidePrevious: Boolean indicating whether "Previous" button should be hidden.
  • disablePrevious: Boolean indicating whether "Previous" button should be disabled.
  • hideNext: Boolean indicating whether "Next" button should be hidden.
  • disableNext: Boolean indicating whether "Next" button should be disabled.
  • disableNextOnErrors: Boolean indicating whether "Next" button should be disabled if form has errors.

Here's an example of simple navigation component:

1import React from "react";
2import { Wizard, useWizard } from "rhf-wizard";
3import { useFormContext } from "react-hook-form";
4
5const steps = [
6  { id: "Step1", component: <h1>Step 1</h1>, hidePrevious: true },
7  { id: "Step2", component: <h1>Step 2</h1>, hideNext: true },
8];
9
10function Navigation() {
11  const {
12    goToPreviousStep,
13    isFirstStep,
14    isLastStep,
15    isLoading,
16    activeStep: {
17      hidePrevious,
18      disablePrevious,
19      hideNext,
20      disableNext,
21      disableNextOnErrors,
22    },
23  } = useWizard();
24  const {
25    formState: { isValid },
26    trigger,
27  } = useFormContext();
28  const isPreviousDisabled = disablePrevious || isLoading;
29  const isNextDisabled =
30    disableNext || isLoading || (disableNextOnErrors && !isValid);
31
32  if (isLoading) {
33    return "Loading...";
34  }
35
36  return (
37    <div>
38      {!hidePrevious && (
39        <button
40          type="button"
41          onClick={goToPreviousStep}
42          disabled={isPreviousDisabled}
43        >
44          Previous
45        </button>
46      )}
47      {!hideNext && (
48        <div
49          onClick={
50            isNextDisabled
51              ? () => {
52                  trigger();
53                }
54              : undefined
55          }
56        >
57          <button type="submit" disabled={isNextDisabled}>
58            Next
59          </button>
60        </div>
61      )}
62    </div>
63  );
64}
65
66function App() {
67  return <Wizard steps={steps} footer={<Navigation />} />;
68}

BasicFooter

If you don't wish to create your own navigation component, a basic footer with navigation buttons is included in rhf-wizard. Here's how you can use it:

1import React from "react";
2import { Wizard, BasicFooter } from "rhf-wizard";
3
4const steps = [
5  { id: "Step1", component: <h1>Step 1</h1>, hidePrevious: true },
6  { id: "Step2", component: <h1>Step 2</h1>, hideNext: true },
7];
8
9function App() {
10  return (
11    <Wizard
12      steps={steps}
13      footer={<BasicFooter textNext="Proceed" textPrevious="Go back" />}
14    />
15  );
16}

Note that BasicFooter has two additional props textNext and textPrevious for customizing button texts. By default they are "Next" and "Previous".

You can customize looks of the basic footer by defining CSS for classes .navigation and .navigation-wrapper.

API

Step object

List of step objects that are passed to Wizard have various options you can set. Here's the full specification:

Name	Type	Default	Description
id	string		(Required) Unique ID for step component. Form values inputted by user are stored in the Wizard's values object under step ID key. E.g. { [id]: { [field]: [value] } }. Values can be retrieved from Wizard using useWizard hook.
component	ReactElement		Component used for rendering step content. Usually this is always required unless you implement default component object like in the demo/ code.
initialValues	object	{}	Contains key-value pairs for step's form fields. Example: initialValues: { name: '', email: '' }
hideNext	boolean	false	Indicates whether to hide submit button.
hidePrevious	boolean	false	Indicates whether to hide "Previous" button.
disableNext	boolean	false	Indicates whether to disable submit button.
disableNextOnErrors	boolean	false	Indicates whether to disable submit button when form has errors.
disablePrevious	boolean	false	Indicates whether to disable "Previous" button.
keepValuesOnPrevious	boolean	true	Remembers inputted values in current step if user decides to navigate back to previous step without submitting the form.
shouldSkip	async (allValues, direction) => stepValues		Function that returns boolean telling whether the step should be skipped or not. Params: - allValues: all form field values from previous steps - direction: Tells whether user came to the current step by pressing "Previous" (-1) or by pressing "Next" (1)
onSubmit	async (stepValues, allValues) => stepValues		Function that serves as a custom submit handler where you can do things after successful form submission. You should return stepValues. Params: - stepValues: form field values filled in current step - allValues: all form field values from previous steps
validate	(stepValues, allValues) => object		Validate the form's values with a function. If there are errors, return object containing field's name as key and error message as value. Params: - stepValues: form field values filled in current step - allValues: all form field values from previous steps
validationSchema	Yup.object		A Yup schema. This is used for validation. Errors are mapped by key to the inner component's errors. Its keys should match of those values. Example here: https://react-hook-form.com/get-started#SchemaValidation
validateOnBlur	boolean	true	Use this option to tell RHF to run validations on blur events.
validateOnChange	boolean	true	Use this option to tell RHF to run validations on change events.

Wizard

Wizard controls the step flow. Only required props is steps which contains a list of step config objects. You can customize the wizard by passing custom components using header, wrapper and footer props.

Name	Type	Description
steps	list	(Required) List of step objects. See example and configuration instructions above.
onStepChanged	(fromStep, toStep, wizardValues) => void	Function that is called when user either submits currently active step or navigates back to previous step.
onCompleted	(values) => void	Function that is called when user completes the wizard.
header	ReactElement	Header that is shown above the active step.
wrapper	ReactElement	Wrapper component that is wrapped around step.component. Useful if you need e.g. styling that is shared across all step components.
footer	ReactElement	Footer that is shown below the active step.
enableHash	boolean	Enables URL hashes per step. Hash matches with slugified step id (e.g. StepName -> #step-name) and is updated accordingly every time when step is changed.

useWizard

Wizard hook that you can use in any step component or in custom header, wrapper and footer component. Used to retrieve info and utility functions related to wizard.

Name	Type	Description
values	object	Contains all form field values from previously completed steps. Example: { StepName: { firstName: 'John', lastName: 'Doe' }, StepAge: { age: 30 }
activeStep	object	Active step object.
stepNumber	number	Order number of currently active step. Indexing starts from 1.
totalSteps	number	Number of total steps.
isLoading	boolean	Is step in loading state or not. Set to true when step.onSubmit handler is called and back to false when executing handler is done.
isFirstStep	boolean	Is the currently active step the first step.
isLastStep	boolean	Is the currently active step the last step.
updateStep	(key: string, value: any) => void	Function used to set the step object's [key] attribute to value. Mostly used to manually hide or disable navigational buttons (e.g. hideNext / disableNext).
setIsLoading	(truthy: boolean) => void	Function used to set the value of isLoading attribute.
goToPreviousStep	() => void	Go to previous step.
goToStep	(index: number) => void	Go to step at the specified index.

Advanced topics

For more advanced use of the wizard I recommend playing with demo and reading code in demo/ folder. Some topics are covered below:

Skipping steps

You can define a shouldSkip function that returns boolean value in the step object. If true, step is skipped and wizard moves on the next step (or previous step, depending on if user pressed "Previous" button or "Next" button).

shouldSkip receives two parameters:

• values: All values that were inputted in previous steps
• direction: Either -1 or 1, indicating whether we are moving backwards or forwards in the wizard.

Example:

1import { Wizard, useWizard } from "rhf-wizard";
2import { useFormContext } from "react-hook-form";
3
4function NonSkippableStep() {
5  const {
6    register,
7    formState: { errors },
8  } = useFormContext();
9  return (
10    <div>
11      <p>This is non-skippable step.</p>
12      <p>Type "skip" if you want to skip next step.</p>
13      <div>
14        <input {...register("text")} />
15        {errors.text && <span>{errors.text.message}</span>}
16      </div>
17      <button type="submit">Next</button>
18    </div>
19  );
20}
21
22function SkippableStep() {
23  const { goToPreviousStep } = useWizard();
24  return (
25    <div>
26      <p>This is skipped if user typed "skip" in previous step.</p>
27      <button type="button" onClick={goToPreviousStep}>
28        Previous
29      </button>
30      <button type="submit">Next</button>
31    </div>
32  );
33}
34
35function FinalStep() {
36  const { goToPreviousStep } = useWizard();
37  return (
38    <div>
39      <h1>You did it!</h1>
40      <button type="button" onClick={goToPreviousStep}>
41        Previous
42      </button>
43    </div>
44  );
45}
46
47const steps = [
48  {
49    id: "NonSkippableStep",
50    component: <NonSkippableStep />,
51    initialValues: { text: "" },
52  },
53  {
54    id: "SkippableStep",
55    component: <SkippableStep />,
56    shouldSkip: (values, direction) => {
57      return values.NonSkippableStep.text === "skip";
58    },
59  },
60  {
61    id: "FinalStep",
62    component: <FinalStep />,
63  },
64];
65
66function App() {
67  return <Wizard steps={steps} />;
68}

Validating form field based on what user inputted in previous step(s)

Sometimes there's a need to validate field based on what user inputted in previous steps. In this case, you can define a validate function to the step object.

validate receives following parameters:

• stepValues: form field values filled in current step
• allValues: all form field values from previous steps

If there are errors, return object containing field's name as key and error message as value.

Example:

1function StepName() {
2  const {
3    register,
4    formState: { errors },
5  } = useFormContext();
6  return (
7    <div>
8      <div>
9        <label htmlFor="name">Name</label>
10        <input {...register("name")} />
11        {errors.name && <span>{errors.name.message}</span>}
12      </div>
13      <button type="submit">Next</button>
14    </div>
15  );
16}
17
18function StepFullName() {
19  const {
20    register,
21    formState: { errors },
22  } = useFormContext();
23  const { goToPreviousStep } = useWizard();
24  return (
25    <div>
26      <div>
27        <label htmlFor="fullName">Full Name</label>
28        <input {...register("fullName")} />
29        {errors.fullName && <span>{errors.fullName.message}</span>}
30      </div>
31      <button type="button" onClick={goToPreviousStep}>
32        Previous
33      </button>
34    </div>
35  );
36}
37
38const steps = [
39  {
40    id: "StepName",
41    component: <StepName />,
42    initialValues: {
43      name: "",
44    },
45  },
46  {
47    id: "StepFullName",
48    component: <StepFullName />,
49    initialValues: {
50      fullName: "",
51    },
52    validate: (stepValues, allValues) => {
53      const errors = {};
54      if (!stepValues.fullName.includes(allValues.StepName.name)) {
55        errors.fullName = "Full name is missing your first name.";
56      }
57      return errors;
58    },
59  },
60];

Saving form values in sessionStorage

If you want form fields to persist e.g. between page refreshes, you can use sessionStorage to your advantage. rhf-wizard doesn't offer solution out of the box but here's one way you can implement the logic:

1function getStepInitialValues(stepId) {
2  const values = JSON.parse(sessionStorage.getItem("wizardValues"));
3  return values?.[stepId];
4}
5
6function StepName() {
7  const {
8    register,
9    formState: { errors },
10  } = useFormContext();
11  return (
12    <div>
13      <label htmlFor="name">Name</label>
14      <input {...register("name")} />
15      {errors.name && <span>{errors.name.message}</span>}
16    </div>
17  );
18}
19
20const steps = [
21  {
22    id: "StepName",
23    component: <StepName />,
24    initialValues: getStepInitialValues("StepName") || {
25      name: "",
26    },
27  },
28  {
29    id: "StepInstructions",
30    component: (
31      <p>
32        Refresh page to see that value of "Name" input is prefilled from session
33        storage.
34      </p>
35    ),
36  },
37];
38
39return (
40  <Wizard
41    steps={steps}
42    onStepChanged={(fromStep, toStep, wizardValues) => {
43      sessionStorage.setItem("wizardValues", JSON.stringify(wizardValues));
44    }}
45    footer={<BasicFooter />}
46  />
47);

Using URL hashes in the wizard

When initiating Wizard, you can enable URL hashes with prop enableHash:

1<Wizard
2  enableHash
3  steps={[
4    { id: "StepName", component: <div>Name</div> },
5    { id: "StepAge", component: <div>Age</div> },
6  ]}
7/>

Step IDs are converted into URL-friendly hashes. When user is in the first step, URL will be updated with hash /#step-name and when user proceeds to the next step, URL is updated with hash /#step-age. When refreshing page, active step will be chosen based on URL hash. If there is no hash or hash doesn't match with any step, first step is shown.

Animations

Check demo/components/WizardStepWrapper.jsx on how to use framer-motion in your steps.

Example:

1import { BasicFooter, Wizard, useWizard } from "rhf-wizard";
2import { useFormContext } from "react-hook-form";
3import { AnimatePresence, motion } from "framer-motion";
4
5function Field({ name, type }) {
6  const { register } = useFormContext();
7  return (
8    <div>
9      <label htmlFor={name}>{name}</label>
10      <input type={type} {...register(name)} />
11    </div>
12  );
13}
14
15const steps = [
16  {
17    id: "Step1",
18    component: <Field name="name" type="text" />,
19    initialValues: { name: "" },
20  },
21  {
22    id: "Step2",
23    component: <Field name="age" type="number" />,
24    initialValues: { age: "" },
25  },
26];
27
28function Wrapper() {
29  const { activeStep } = useWizard();
30  return (
31    <AnimatePresence mode="wait">
32      <motion.div
33        key={activeStep.id}
34        initial={{ opacity: 0 }}
35        animate={{ opacity: 1 }}
36        exit={{ opacity: 0 }}
37        transition={{ duration: 0.5 }}
38      >
39        {activeStep.component}
40      </motion.div>
41    </AnimatePresence>
42  );
43}
44
45return <Wizard steps={steps} wrapper={<Wrapper />} footer={<BasicFooter />} />;

Creating wrapper for steps

You can wrap steps by defining your own wrapper component. Here's an example:

1import { useWizard, Wizard } from "rhf-wizard";
2
3function StepWrapper() {
4  const { activeStep } = useWizard();
5  return (
6    <div style={{ backgroundColor: "lightblue" }}>
7      <h1>Wrapper</h1>
8      {activeStep.component}
9    </div>
10  );
11}
12
13const steps = [{ id: "Step", component: <p>I'm a simple step.</p> }];
14
15function App() {
16  return <Wizard steps={steps} wrapper={<StepWrapper />} />;
17}

Creating header for wizard

You can create header for wizard by defining your own header component. Here's an example:

1import { useWizard, Wizard } from "rhf-wizard";
2
3function Header() {
4  const { activeStep } = useWizard();
5  return (
6    <div style={{ padding: "2rem 0", background: "yellow" }}>
7      <h1 style={{ textAlign: "center" }}>Header of #{activeStep.id}</h1>
8    </div>
9  );
10}
11
12const steps = [{ id: "Step", component: <p>I'm a simple step.</p> }];
13
14function App() {
15  return <Wizard steps={steps} header={<Header />} />;
16}

Creating custom submit handler for step

You can write custom submit handler for step in attribute onSubmit which is a function. onSubmit receives three parameters:

• stepValues: Form field values filled in current step
• allValues: All form field values from previous steps

One use case would be to save the inputted values in backend so that user won't have to start the wizard over if e.g. page is refreshed:

1const steps = [
2  {
3    id: "StepName",
4    component: <StepName />,
5    onSubmit: async (stepValues, allValues) => {
6      await fetch(someUrl, {
7        method: "POST",
8        body: JSON.stringify({ id: "StepName", data: stepValues }),
9      });
10      return stepValues;
11    },
12  },
13];

Note that when onSubmit is called, Wizard sets isLoading to true and when executing onSubmit is done, isLoading is set back to false.