GitHub

Form Success State

Success state indicator for completed form actions

Basic Usage

Loading...

Installation

pnpm add @corew500/ui

Usage

import { FormSuccessState } from "@corew500/ui/form-success-state"

<FormSuccessState>Content</FormSuccessState>

Variants

formSuccessStateVariants

AxisValuesDefault
variant
successprimary
success
size
defaultsmlg
default

iconContainerVariants

AxisValuesDefault
variant
successprimary
success
size
defaultsmlg
default

iconVariants

AxisValuesDefault
variant
successprimary
success
size
defaultsmlg
default

titleVariants

AxisValuesDefault
variant
successprimary
success
size
defaultsmlg
default

formSuccessDescriptionVariants

AxisValuesDefault
variant
successprimary
success
size
defaultsmlg
default

subDescriptionVariants

AxisValuesDefault
variant
successprimary
success
size
defaultsmlg
default

API Reference

Props

PropTypeDefaultDescription
iconenumCustom icon to display. Defaults to a checkmark.
title*stringTitle text displayed after the icon
descriptionstringDescription text displayed below the title
subDescriptionstringSecondary description text displayed below the main description
actionenumOptional action element (e.g., a button) displayed below the description
variantenumsuccess
sizeenumdefault

Accessibility

Keyboard Navigation

  • Action button (if provided) is keyboard accessible

Screen Readers

  • - Uses role="status" for ARIA live region
  • aria-live="polite" announces success to screen readers without interruption
  • Icon uses aria-hidden="true" as it's decorative

Additional

  • Semantic heading structure with h3 for title

Localization

Translatable Content

  • - Component accepts pre-resolved translated strings
  • All user-facing text is customizable via props:
  • `action` - Optional action element (render your own button with localized text)
  • No internal text hardcoding - all strings flow through props

Additional

  • `title` - Main success message
  • `description` - Optional detailed description
  • `subDescription` - Optional secondary description