Skip to content

shadcn.io is an independent project built on shadcn/ui

Free

Responsive Layout Form for Ark UI

Name, email, company, and website in one column on small screens and two columns from the md breakpoint.

Name, email, company, and website stack on a narrow screen and pair into two columns once it is wider. Company needs 2 characters. Website must be a valid URL.

Use it for a form that has to work in a dialog and on a desktop page. A fixed two-column Field grid will not collapse. In React, Ark UI does not switch the columns.

Preview

Preview width

Installation

Sign in to get your install command
Free with an account. It carries your token, so the CLI installs everything in one go.
GoogleGitHub
Use email insteadNo credit card

Usage

<form className="w-full max-w-2xl" onSubmit={form.handleSubmit(onSubmit)}>
  <FieldGroup>
    <div className="grid grid-cols-1 gap-4 md:grid-cols-2">
      <Controller
        control={form.control}
        name="name"
        render={({ field, fieldState }) => (
          <Field invalid={fieldState.invalid}>
            <FieldLabel>Name</FieldLabel>
            <Input {...field} placeholder="John Doe" />
            <FieldDescription>Your full name.</FieldDescription>
            <FieldError>{fieldState.error?.message}</FieldError>
          </Field>
        )}
      />
      <Controller
        control={form.control}
        name="email"
        render={({ field, fieldState }) => (
          <Field invalid={fieldState.invalid}>
            <FieldLabel>Email</FieldLabel>
            <Input {...field} placeholder="john@example.com" type="email" />
            <FieldDescription>Your work email.</FieldDescription>
            <FieldError>{fieldState.error?.message}</FieldError>
          </Field>
        )}
      />
      <Controller
        control={form.control}
        name="company"
        render={({ field, fieldState }) => (
{/* The rest of the file is under Installation. */}

FAQ

How does the grid change width?

One div with grid grid-cols-1 gap-4 md:grid-cols-2 holds the four fields. Below the md breakpoint they stack. From md up they fill two rows of two. The form is max-w-2xl.

What does the schema require?

name and company are z.string().min(2), email is z.email() and website is z.url(). None passes a custom message, so FieldError shows Zod's defaults, such as Invalid URL.

Which fields have a description?

Name has the FieldDescription Your full name. and email has Your work email. Company and website have a label, an input and a FieldError only.

What input types are used?

Email is type="email". Website is type="url" with the placeholder https://example.com. Name and company are text inputs.

What website value passes?

z.url() needs a scheme: https://example.com passes and example.com fails.

When do the four checks run?

defaultValues starts every field as an empty string and mode is unset, so submit runs the resolver, then onSubmit logs the values.

API Reference

Field

Sets invalid={fieldState.invalid} and orientation="horizontal". The rest is on the Field page.

Input

Sets field, placeholder="John Doe", placeholder="john@example.com", type="email", placeholder="Acme Inc" and placeholder="https://example.com". The rest is on the Input page.

Button

Sets type="submit". The rest is on the Button page.

All 42 form examples