Dark Light
System
Default LBBW Jira Confluence Source Code
Share
Playground

Stepper

<afp-stepper> Since 1.5.0 experimental This component uses the light DOM, so its markup and styles are part of the regular document flow.

A stepper component displays a sequence of steps in a process. Steps are defined as afp-stepper-item child elements, and content is provided through afp-stepper-content components. Content can be linked by index (default) or by explicit name matching.

Details Finances Review Provide your personal information including name, date of birth, and address. Enter your employment status, monthly income, and existing financial obligations. Review your loan summary, monthly installment, and confirm submission.

Examples #

Horizontal #

The default stepper is horizontal, displaying steps in a row with content appearing below the steps.

Personal Address Review

Please enter your full name, email address and phone number

+49

Please enter your residential address.

Review your information before submitting.

Vertical #

Use the orientation="vertical" attribute to display steps vertically. Content appears beside the steps.

Personal Information

Please enter your full name, email address and phone number

+49
Address

Please enter your residential address.

Review

Review your information before submitting.

Use the previousStep() and nextStep() methods to navigate between steps. You can also listen for the afp-change event to synchronize external controls with the stepper's state.

Selection Verification Confirmation Choose the account type that best fits your needs. Complete identity verification and upload required documents. Review your information and accept the terms and conditions.
Previous
Selection Verification Confirmation Next

Linear #

Use the linear attribute to enforce sequential step progression. Users can only proceed to the next step after it has been completed and cannot skip ahead.

Recipient Amount Authorize Enter beneficiary name, IBAN, and SWIFT/BIC. Specify transfer amount, currency, and reference. Confirm the payment using strong customer authentication.
Complete Previous Next

Properties

Learn more about properties.

Name Description Reflects
variant
Variant of stepper
Type
AfpVariant
Name Description
NEUTRAL
The main call-to-action.
BRAND
Less prominent than primary.
ACCENT
Secondary highlight for emphasis.
ERROR
Used for destructive or critical actions.
INFO
Conveys general information.
SUCCESS
Indicates a successful or positive action.
WARNING
Communicates cautionary actions.
AfpVariant
Default AfpVariant.NEUTRAL
shape
Shape of the stepper
Type
AfpShape
Name Description
PILL
Makes the component circular.
ROUNDED
Makes the component rounded.
SOFT
Makes the component have soft edges.
SQUARE
Makes the component square.
AfpShape
Default AfpShape.PILL
orientation
Orientation of the stepper
Type
AfpOrientation
Name Description
HORIZONTAL
Horizontal layout orientation.
VERTICAL
Vertical layout orientation.
AfpOrientation
Default AfpOrientation.HORIZONTAL
linear
Whether the stepper is linear (steps must be completed in order)
Type boolean
Default false
noConnector
noconnector
Whether to show connectors between steps
Type boolean
Default false
activeStep
activestep
Index of the currently active step
Type number
Default 0
size
Size of the stepper
Type
AfpSize
Name Description
SMALL
Small size with compact dimensions.
MEDIUM
Medium size with standard dimensions.
LARGE
Large size with expanded dimensions.
AfpSize
Default AfpSize.MEDIUM
disabled
Disabled state
Type boolean
Default false

Methods

Learn more about using methods.

Name Description Arguments
selectStep
Navigate to a specific step
stepIndex<number> — The index of the step to navigate to
nextStep
Move to the next step
-
previousStep
Move to the previous step
-
completeStep
Set completion state of a step
stepIndex<number> — The index of the step to mark as completed
completed<boolean> — Whether the step is completed or not

Events

Learn more about events.

Name Return Description
afp-change AfpStepperItem
Emitted when the active step changes, with the new active step as detail.

Slots

Learn more about slots.

Name Description
default
Default slot for afp-stepper-item children. In horizontal orientation, content appears below all steps. In vertical orientation, content appears beside the active step.

Internationalization

Learn more about internationalization.

Key Description
stepper.aria-label
The aria-label for the stepper component.

CSS Parts

Learn more about CSS Parts.

Name Description Selector
base
The component's base wrapper.
::part(base)
steps-column
The column containing the steps.
::part(steps-column)
content-column
The column containing the step content.
::part(content-column)
steps
The wrapper for the steps.
::part(steps)
content
The wrapper for the step content.
::part(content)
steps-wrapper
The wrapper around the steps for layout purposes.
::part(steps-wrapper)
content
The wrapper around the step content for layout purposes.
::part(content)

CSS Custom Properties

Name Description Default
--afp-stepper-gap
The gap between steps and content.
--afp-space-xs

Dependencies

The component automatically brings in the listed items, including any nested dependencies that may exist.

afp-stepper-item afp-stepper-content

Importing

Using the bundle is the recommended method to include components. If you’d rather handle imports manually, you can use the code examples below.

import '@afp-design-system/core/dist/components/stepper/stepper.js';
Share
Create a link with a predefined theme that is automatically applied when the generated link is opened. Default LBBW Presentation Mode
Abort Copy Link