Forms

Raptor provides several types for building forms. Form is the basic container for collecting user input:

Form {
   TextField("One-Time Password")
   Button("Sign In", role: .submit, action: SubmitAction())
}

Label Styling

Control label positioning across all form controls using labelStyle(_:):

Form {
   TextField("Email")
   TextField("Password")
}
.labelStyle(.leading)

Available styles include:

.top — Labels appear above inputs (default)
.leading — Labels appear beside inputs (when supported)
.hidden — Labels remain in HTML for accessibility but are visually hidden

Controls can override this individually if needed.

GridForm

GridForm is a form built on Grid for column-aligned layouts:

GridForm {
   GridRow {
      TextField("Email")
      TextField("Password")
         .textContentType(.password)
      Button("Sign In", action: SignInAction())
   }
}
.labelStyle(.hidden)

For more details on grid layouts, see Grids.

SubscribeForm

SubscribeForm is a ready-made form for collecting email subscriptions and integrating with newsletter services:

SubscribeForm(.buttondown("myID"))

Use it when you’re integrating with providers like Mailchimp or SendFox and want correct semantics, accessibility, and anti-bot handling out of the box.

Control the layout with formStyle(_:) and customize text with emailFieldLabel(_:) and subscribeButtonLabel(_:):

SubscribeForm(.mailchimp)
    .formStyle(.stacked)
    .emailFieldLabel("Your email")
    .subscribeButtonLabel("Join Newsletter")

SubscribeForm automatically configures form attributes for the selected provider, includes honeypot fields for spam prevention, injects required provider scripts, and uses accessible labels even when visually hidden.

Grids

Code