Components

Page Navigation

Page navigation is the shared multipage UI surface for page tabs, current step treatment, completed-step treatment, hidden future pages, and page-level navigation actions.

Use this page to preserve the tab and page-state hooks that multipage forms rely on as users move through steps.

Preview

Browser attributes

Useful hooks include:

HookPurpose
data-formie-tabPage-tab item
data-formie-tab-linkTab link
data-formie-tab-completeCompleted tab state
data-formie-tab-errorError tab state
data-formie-page-hiddenHidden inactive page marker
data-formie-pagePage section marker
data-formie-page-idStable page identity

Styling classes

ClassPurpose
formie-page-tabsTab collection
formie-tabIndividual tab
formie-tab-currentCurrent tab state
formie-tab-completeCompleted tab state
formie-tab-errorError tab state
formie-page-hiddenHidden page styling fallback

Behavior

These surfaces are updated by the broader multipage submit and page-navigation flow:

  • the active page receives current-state treatment
  • completed steps receive formie-tab-complete
  • invalid future or review steps can receive formie-tab-error
  • inactive pages are hidden with data-formie-page-hidden

For the lifecycle side of these transitions, use JavaScript events and Submission handling.

Last updated: May 6, 2026, 3:46 PM