From 071634860e69e0039a3bd9b3074a66678322a7ef Mon Sep 17 00:00:00 2001
From: Rostislav Harlanov <thorn_pear@icloud.com>
Date: Sun, 11 Jan 2026 22:23:45 +0100
Subject: [PATCH] docs: multistep form

---
 .../navigation/examples_navigation.tsx        |   7 +
 .../stackblitz-preview/stackblitz-preview.tsx |   4 +-
 .../stackblitz-preview.types.ts               |   1 +
 docs/src/routes/examples/index.tsx            |   9 +-
 docs/src/routes/examples/multistep-form.tsx   | 168 ++++++++++++++++++
 5 files changed, 185 insertions(+), 4 deletions(-)
 create mode 100644 docs/src/routes/examples/multistep-form.tsx

diff --git a/docs/src/components/navigation/examples_navigation.tsx b/docs/src/components/navigation/examples_navigation.tsx
index 35aa193..9629884 100644
--- a/docs/src/components/navigation/examples_navigation.tsx
+++ b/docs/src/components/navigation/examples_navigation.tsx
@@ -35,6 +35,13 @@ export const ExamplesNavigation = () => {
         Async Validation
       </Link>
 
+      <Link
+        href="/examples/multistep-form"
+        color={location.pathname.includes("/examples/multistep-form") ? "accent" : "secondary"}
+      >
+        Multi-Step Form
+      </Link>
+
       <Link
         href="/examples/nested-values"
         color={location.pathname.includes("/examples/nested-values") ? "accent" : "secondary"}
diff --git a/docs/src/components/stackblitz-preview/stackblitz-preview.tsx b/docs/src/components/stackblitz-preview/stackblitz-preview.tsx
index 8af599f..6656035 100644
--- a/docs/src/components/stackblitz-preview/stackblitz-preview.tsx
+++ b/docs/src/components/stackblitz-preview/stackblitz-preview.tsx
@@ -1,7 +1,7 @@
 import type { StackBlitzPreviewProps } from "./stackblitz-preview.types";
 
 export const StackBlitzPreview = (props: StackBlitzPreviewProps) => {
-  const { src, title, height = "450px", ...iframeProps } = props;
+  const { src, title, height = "450px", hideExplorer = true, ...iframeProps } = props;
 
   return (
     <div
@@ -12,7 +12,7 @@ export const StackBlitzPreview = (props: StackBlitzPreviewProps) => {
       }}
     >
       <iframe
-        src={`${src}&embed=1&view=preview&hideExplorer=1&hideNavigation=1`}
+        src={`${src}&embed=1&view=preview&hideExplorer=${Number(hideExplorer)}&hideNavigation=1`}
         title={`StackBlitz - ${title}`}
         style={{
           width: "100%",
diff --git a/docs/src/components/stackblitz-preview/stackblitz-preview.types.ts b/docs/src/components/stackblitz-preview/stackblitz-preview.types.ts
index 5a446d3..fdc1997 100644
--- a/docs/src/components/stackblitz-preview/stackblitz-preview.types.ts
+++ b/docs/src/components/stackblitz-preview/stackblitz-preview.types.ts
@@ -4,4 +4,5 @@ export type StackBlitzPreviewProps = JSX.IframeHTMLAttributes<HTMLIFrameElement>
   src: string;
   title: string;
   height?: string;
+  hideExplorer?: boolean;
 };
diff --git a/docs/src/routes/examples/index.tsx b/docs/src/routes/examples/index.tsx
index 5597c49..598f906 100644
--- a/docs/src/routes/examples/index.tsx
+++ b/docs/src/routes/examples/index.tsx
@@ -45,10 +45,15 @@ const Examples = () => {
             <p>Give error feedback to a user after server-side validation.</p>
           </Grid.Item>
 
+          <Grid.Item href="/examples/multistep-form">
+            <h2>Muiti-Step Form</h2>
+            <p>Collect user information through different pages and sections.</p>
+          </Grid.Item>
+
           <Grid.Item href="/examples/nested-values">
             <h2>
               <span innerHTML={curly} />
-              Nested values
+              Nested Values
             </h2>
             <p>Access object properties and array items in form fields.</p>
           </Grid.Item>
@@ -56,7 +61,7 @@ const Examples = () => {
           <Grid.Item href="/examples/file-upload">
             <h2>
               <span innerHTML={upload} />
-              File upload
+              File Upload
             </h2>
             <p>Control documents upload using native file input.</p>
           </Grid.Item>
diff --git a/docs/src/routes/examples/multistep-form.tsx b/docs/src/routes/examples/multistep-form.tsx
new file mode 100644
index 0000000..6cbe4e5
--- /dev/null
+++ b/docs/src/routes/examples/multistep-form.tsx
@@ -0,0 +1,168 @@
+import { Title } from "@solidjs/meta";
+import { Link } from "solid-uix";
+import { Code } from "~/components/code/code";
+import { Container } from "~/components/container/container";
+import { ExamplesNavigation } from "~/components/navigation/examples_navigation";
+import { StackBlitzPreview } from "~/components/stackblitz-preview/stackblitz-preview";
+
+const stackblitzUrl =
+  "https://stackblitz.com/edit/solidjs-templates-gjnvz92x?file=src%2Fmultistep_form%2Fstep1.tsx";
+
+const MultistepForm = () => {
+  return (
+    <main>
+      <Title> Multi-Step Form</Title>
+      <Container.Grid>
+        <ExamplesNavigation />
+        <Container.Content>
+          <h1>Multi-Step Form</h1>
+
+          <p>Collect user information through different pages and sections.</p>
+
+          <p>
+            Check full example at{" "}
+            <Link href={stackblitzUrl} target="_blank" color="accent">
+              StackBlitz
+            </Link>
+            .
+          </p>
+
+          <StackBlitzPreview
+            src={stackblitzUrl}
+            title="Multi-Step Form"
+            height="820px"
+            hideExplorer={false}
+          />
+
+          <p>Step 1: Set up your routes.</p>
+
+          <Code language="js">{`import { Router, Route } from "@solidjs/router"
+import { MultiStepForm } from "./multistep_form"
+import { Step1 } from "./step1"
+import { Step2 } from "./step2"
+import { Result } from "./result"
+
+export const App = () => {
+  return (
+    <Router>
+      <Route path="/" component={MultiStepForm}>
+        <Route path="/step1" component={Step1} />
+        <Route path="/step2" component={Step2} />
+        <Route path="/result" component={Result} />
+      </Route>
+    </Router>
+  )
+}`}</Code>
+
+          <p>Step 2: Create your pages, collect the data and navigate to the next page.</p>
+
+          <Code language="js">{`import { createForm, FormProvider } from 'solid-hook-form'
+
+export const MultiStepForm = (props) => {
+  const form = createForm({
+    defaultValues: {
+      addressLine1: '',
+      addressLine2: '',
+      firstName: '',
+      lastName: ''
+    }
+    mode: 'onChange'
+  })
+  const { handleSubmit } = form
+
+  const onSubmit = (values) => {
+    console.log(values)
+  }
+
+  return (
+    <FormProvider form={form}>
+      <form onSubmit={handleSubmit(onSubmit)}>
+        {props.children}
+      </form>
+    </FormProvider>
+  )
+}
+`}</Code>
+
+          <p></p>
+
+          <Code language="js">
+            {`import { useFormContext } from 'solid-hook-form';
+import { useNavigate } from '@solidjs/router';
+import { Show } from 'solid-js';
+
+export const Step1 = () => {
+  const navigate = useNavigate();
+  const { register, errors, trigger, formState } =
+    useFormContext();
+
+  const onNext = () => {
+    trigger();
+
+    if (formState.isValid()) {
+      navigate('/step2');
+    }
+  };
+
+  return (
+    <fieldset
+      name="address"
+    >
+      <h3>Step 1</h3>
+
+      <input {...register('addressLine1', { required: 'Required' })} />
+      <Show when={errors.addressLine1}>
+        <p role="alert">{errors.addressLine1?.message}</p>
+      </Show>
+
+      <input {...register('addressLine2', { required: 'Required' })} />
+      <Show when={errors.addressLine2}>
+        <p role="alert">{errors.addressLine2?.message}</p>
+      </Show>
+
+      <button type="button" onClick={onNext}>Next</button>
+    </fieldset>
+  );
+};
+`}
+          </Code>
+
+          <p>Step 3: Make final submission with all the data or display the resulting data.</p>
+
+          <Code language="js">{`import { useFormContext } from 'solid-hook-form';
+import { useNavigate } from '@solidjs/router';
+
+export const Summary = () => {
+  const navigate = useNavigate();
+  const { getValues } = useFormContext();
+
+  const onBack = () => {
+    navigate(-1);
+  };
+
+  return (
+    <div>
+      <h3>Result</h3>
+
+      <p>
+        Address: {getValues('addressLine1')} {getValues('addressLine2')}
+      </p>
+      <p>
+        Contact: {getValues('firstName')} {getValues('lastName')}
+      </p>
+
+      <button type="submit">Submit</button>
+      <button type="button" onClick={onBack}>
+        Back
+      </button>
+    </div>
+  );
+};
+`}</Code>
+        </Container.Content>
+      </Container.Grid>
+    </main>
+  );
+};
+
+export default MultistepForm;