Onboarding
Angular Bootstrap 5 Onboarding plugin
Onboarding is a guide plugin to show users how to use your website
Angular Onboarding plugin built with the latest Bootstrap 5. It is is a guide plugin to show users how to use your website.Note: Read the API tab to find all available options and advanced customization
Basic example
To initialize Onboarding on your page simply add anchors with mdbOnboardingAnchor
directive to the
elements of your steps.
As a first parameter to the init()
method specify steps by giving proper
id
corresponding to previously added anchors, content
of a step, and other individual options.
As a second parameter you can pass global options which will be introduced to every step. Note that individual options have higher priority than global options.
Start options
Autostart
Onboarding can be auto initialized by passing
delay
option with the value of seconds after which Onboarding will be triggered
Event triggered start
Run initialization methods on any trigger.
Backdrop options
Global backdrop
Backdrop for every step inside Onboarding can be set via
backdrop
option globally, same as the backdropOpacity
option which sets an opacity.
Individual step backdrop
Indivudal options have higher priority than global options.
Autoplay
Set autoplay
and stepDuration
to enable autoplay
Autoscroll
Toggle auto scrolling into element that is outside the view with
autoscroll
option.
Popover customization
Popover class
Add custom class for popovers by setting customClass
option and style it in
your css sheet.
Container example
Gallery






Index example
Onboarding - API
Installation
To install and configure the plugin follow our Plugins Installation Guide. Please remember to update all the plugin names and import paths. You can find all the necessary information in the Import section.
Import
Inputs
MdbOnboardingDirective
Name | Type | Default | Description |
---|---|---|---|
mdbOnboardingAnchor
|
string | '' |
Marks the element as an anchor to be referenced later in an id option |
Outputs
MdbOnboardingService
Name | Type | Description |
---|---|---|
onboardingStart
|
EventEmitter<void> | Emitted when an Onboarding has started. |
onboardingEnd
|
EventEmitter<void> | Emitted when the last step of the Onboarding has ended. |
onboardingOpen
|
EventEmitter<void> | Emitted when a step element has opened. |
onboardingClose
|
EventEmitter<void> | Emitted when a step element has closed |
onboardingNext
|
EventEmitter<void> | Emitted when next step is about to be opened. |
onboardingPrev
|
EventEmitter<void> | Emitted when previous step is about to be opened. |
Methods
MdbOnboardingService
Name | Description | Example |
---|---|---|
init(steps, config?) |
Initializes the Onboarding with given steps: MdbOnboardingStep[] and config: MdbOnboardingConfig .
|
onboardingService.init(steps, options);
|
close |
Closes opened step popover. |
onboardingService.close()
|
nextStep
|
Opens next step popover. |
onboardingService.nextStep()
|
prevStep
|
Opens previous step popover. |
onboardingService.prevStep()
|
pause
|
Pauses Onboarding on current step when autoplay is on. |
onboardingService.pause()
|
resume |
Resumes Onboarding on current step when autoplay is on. |
onboardingService.resume()
|
Advanced types
MdbOnboardingConfig
Name | Type | Default | Description |
---|---|---|---|
backdrop
|
boolean | undefined | false |
Defines whether backdrop should be rendered |
backdropOpacity
|
number | undefined | 0.4 |
Defines the backdrop opacity |
nextLabel
|
string | undefined | 'Next' |
Overwrites label of the 'Next' button |
prevLabel
|
string | undefined | 'Back' |
Overwrites label of the 'Back' button |
skipLabel
|
string | undefined | 'Skip' |
Overwrites label of the 'Skip' button |
finishLabel
|
string | undefined | 'Finish' |
Overwrites label of the 'Finish' button |
pauseLabel
|
string | undefined | 'Pause' |
Overwrites label of the 'Pause' button |
resumeLabel
|
string | undefined | 'Resume' |
Overwrites label of the 'Resume' button |
btnNextClass
|
string | undefined | 'btn-primary' |
Overwrites class of the 'Next' button |
btnPrevClass
|
string | undefined | 'btn-primary' |
Overwrites class of the 'Back' button |
btnSkipClass
|
string | undefined | 'btn-danger' |
Overwrites class of the 'Skip' button |
btnFinishClass
|
string | undefined | 'btn-danger' |
Overwrites class of the 'Finish' button |
btnPauseClass
|
string | undefined | 'btn-primary' |
Overwrites class of the 'Pause' button |
btnResumeClass
|
string | undefined | 'btn-success' |
Overwrites class of the 'Resume' button |
customClass
|
string | undefined | '' |
Custom class for the popover |
autoplay
|
boolean | undefined | false |
Defines whether autoplay is on or off |
stepDuration
|
number | undefined | 4 |
Defines the duration of a step for the autoplay in seconds |
autoscroll
|
boolean | undefined | true |
Defines whether window should automatically scroll into opened step position |
placement
|
'top' | 'right' | 'bottom' | 'left' | undefined | 'bottom' |
Defines placement of step popover |
container
|
ElementRef | null | undefined | null |
Defines wrapper element for onboarding |
delay
|
number | undefined | undefined |
Defines time in seconds after which Onboarding will start. |
index
|
number | undefined | 1 |
Defines index number for step element |
MdbOnboardingStep
Note: Due to its complexity, we present this advanced type in the form of a snippet rather than a table.