PROCESIO
OverviewPlatform ActionsIntegrations & DemosMarketplaceCustom ActionsDeveloper’s Guide

Carousel

The Carousel element shows a set of slides one at a time, with arrows, slide indicators, swipe and optional autoplay to move between them.

The Carousel element is a container that shows its content as slides, one slide at a time. Each slide holds its own form elements: text, images, fields, buttons. The person filling the form moves between slides with arrows, slide indicators, the keyboard or a swipe, or the carousel moves on its own.

All the slides belong to the same form. Values entered on any slide are submitted with the form, whichever slide is showing when the person clicks submit.

Key use cases

  • An introduction or onboarding tour shown at the top of a form
  • A gallery of images or product cards, one at a time
  • A long form split into short parts without the strict order of a Stepper
  • Announcements or tips that rotate on their own with autoplay

Add the element to a form

  1. Open the form in the Form Designer.
  2. In the Toolbar, open the Structure tab (or type Carousel in Search element).
  3. Drag Carousel onto the form.
  4. Select the carousel to open its settings.

The Carousel element in the Structure tab of the Toolbar: A container for slides shown one at a time

A new carousel has three slides. Its arrows and slide indicators work in the designer too, so you can move to any slide and fill it.

Add elements into the slides

Move the carousel to the slide you want to fill, then drag elements from the Toolbar onto it. An empty slide shows Drag and drop slide elements here. A slide can hold any number of elements, including containers such as a Section or Columns.

The Slides setting lists the carousel's slides in order:

  • Add slide adds a new empty slide at the end.
  • The text box of a slide renames it. The name is used to refer to the slide in events and scripts.
  • The gear icon opens the slide's own settings: Visible, Name and ID, and on the Styling tab the layout of the elements inside the slide.
  • The trash icon deletes the slide.

When you select an element on the canvas that sits on another slide, the carousel moves to that slide.

A carousel cannot be placed inside another carousel. The designer does not let you drop a carousel, or a container that holds a carousel, onto a slide.

Which slides the person filling the form sees

On the form, a slide is shown only when it is visible and holds at least one visible element. Hidden slides and empty slides are skipped by the arrows, the indicators and autoplay, and are not counted (a carousel with one hidden slide out of three shows 2 indicators). If you hide a slide before the one the person is on, they stay on the same slide.

When there is only one slide to show, the carousel shows it without arrows or indicators.

Settings

The settings of a Carousel element: the Slides list with three slides and Add slide, Show arrows on, Arrows position Bottom by the indicators, Show slide indicators on, Indicator style Dots, Controls alignment Center, Loop off, Swipe and mouse drag on, Autoplay off, Autoplay interval 5, Transition effect Slide, Transition duration 450, Visible, Name, ID and the onSlideChange event

SettingWhat it does
SlidesThe carousel's slides, in order. See Add elements into the slides.
Show arrowsOn (default): previous and next arrows are shown.
Arrows positionWhere the arrows sit: Bottom, by the indicators (default), Sides of the slide, or Over the slide. At the bottom the arrows are plain icons; on the sides and over the slide they are round buttons.
Show slide indicatorsOn (default): one indicator per slide is shown under the slides. Clicking an indicator moves to that slide.
Indicator styleDots (default), Lines, or Counter (2 / 4), which shows the current slide number and the number of slides as text instead of clickable indicators.
Controls alignmentWhere the row of indicators and controls sits: Left, Center (default) or Right.
LoopOff (default): the previous arrow stops at the first slide and the next arrow stops at the last. On: the next arrow goes from the last slide back to the first, and the previous arrow from the first to the last.
Swipe and mouse dragOn (default): the person can move between slides by swiping on a touch screen or dragging with the mouse. See Swipe and drag.
AutoplayOff (default). On: the carousel moves to the next slide on its own. See Autoplay.
Autoplay interval (s)How many seconds each slide is shown when Autoplay is on. Between 1 and 60, default 5.
Transition effectThe animation between two slides: Slide (default), Fade, Zoom, Cover, Flip or None. Slide, Cover and Flip follow the direction of the move: forward animates one way, back the other.
Transition duration (ms)How long the animation lasts, in milliseconds. Between 0 and 3000, default 450. 0 changes the slide at once.
VisibleShow or hide the whole carousel.
Name, IDThe element's name and ID, used to refer to the carousel in events and scripts.

The two number fields keep their values within their limits. Under each, the field shows its range (Between 1 and 60., Between 0 and 3000.). A value outside the range is changed to the nearest limit when you leave the field, and that is the value saved with the form. Leave a field empty to use its default.

If both Show arrows and Show slide indicators are off, the carousel still keeps a way to the other slides: the arrows appear when the person reaches the carousel with the Tab key.

What the person filling the form sees

A form in Preview with a carousel on its first slide, Welcome aboard, with a previous arrow, three dots with the first one filled, and a next arrow under the slide

After clicking the next arrow, the second slide is shown and the second dot is filled:

The same carousel on its second slide, Meet your team, with the second of the three dots filled

Keyboard

  • The arrows and the indicators are buttons, so the person can reach them with Tab and use them with Enter or Space.
  • While an arrow or an indicator has focus, the Left and Right arrow keys move to the previous or next slide.
  • Screen readers announce the carousel, the position of each slide (for example 2 of 3) and every move.

Swipe and drag

With Swipe and mouse drag on and more than one slide, the person can drag a slide sideways with a finger or the mouse. A short drag springs back; a longer one moves to the next or previous slide. Dragging up or down scrolls the page as usual, and a drag that starts on a field, a button or a link is left to that element, so typing and clicking inside a slide work as normal.

Swipe works on the form only, not while you edit the carousel in the designer.

Autoplay

With Autoplay on, the carousel moves to the next slide every Autoplay interval (s) seconds.

  • It pauses while the pointer is over the carousel and goes on when the pointer leaves.
  • It stops once the person moves into the carousel with the keyboard or clicks a control in it.
  • A pause button is shown with the indicators. The person can stop the slideshow with it and start it again with the same button.
  • For people whose device asks for reduced motion, the carousel does not play on its own and no pause button is shown. They move between slides with the arrows and indicators.

Autoplay does not run while you edit the form in the designer.

Required fields on other slides

A required field can sit on a slide that is not showing. When the person submits the form with such a field empty, the form is not submitted, and the indicator of that slide shows a warning icon (screen readers read it as has a field to fix). Clicking the indicator moves to the slide, where the field is marked. The warning goes away as soon as the field is filled.

With Indicator style set to Counter (2 / 4) there are no indicators to carry the warning, so consider Dots or Lines for a carousel with required fields.

A carousel in a List

A carousel can be placed inside a List. Each row of the list has its own carousel, and moving one row's carousel does not move the others.

Events

The carousel has one event, under Events in its settings:

EventWhen it fires
onSlideChangeEach time the carousel moves to another slide. The $event variable holds the index of the slide now shown, starting from 0.

For example, use onSlideChange to show a field or update a value when the person reaches the last slide.

Move between slides from JavaScript

Two functions move a carousel one slide forward or back, the same as clicking its arrows. Call them from any Trigger JAVASCRIPT event in the form, for example the onClick event of a button:

FunctionWhat it does
goToNextSlide()Moves to the next slide. On the last slide it does nothing, unless Loop is on: then it goes back to the first slide.
goToPreviousSlide()Moves to the previous slide. On the first slide it does nothing, unless Loop is on: then it goes to the last slide.
ProcesioForm.data.fields.Carousel1.goToNextSlide();
ProcesioForm.data.fields.Carousel1.goToPreviousSlide();

Here Carousel1 is the name of your Carousel element. Moving the carousel this way also fires its onSlideChange event.

  • A carousel inside a List does not offer these functions.
  • The designer's Preview doesn't run form scripts. Test on the published form.

Styling

On the Styling tab of the carousel's settings you can change how it looks. Turn on the check box next to a property to override the form theme for this carousel.

PropertyDefaultWhat it changes
Gap16pxThe space between the slides and the controls.
Padding vertical, Padding horizontal16pxThe space between the edge of a slide and its content.
Surface background colorNeutral 50The background of the slides.
Surface border radius, Surface border width, Surface border color4px, 1px, BorderThe border around the slides.
Slide min height0pxThe minimum height of a slide. Set it to keep the carousel the same height on short and tall slides.
Arrow colorNeutral 700The colour of the plain arrows (at the bottom), the pause button and the counter.
Round arrow background color, Round arrow icon colorNeutral 700, Neutral 0The colours of the round arrows (on the sides or over the slide).
Arrow border radius50%The shape of the round arrows.
Indicator color, Indicator fill, Indicator color activeNeutral 800, Neutral 100, Neutral 800The colours of the dots and lines, and of the current one.

CSS Classes applies classes from the form's own CSS code (Form settings → Switch to code).

Each slide has its own Styling tab too (open it with the gear icon in Slides): Gap (default 10px) between the elements in the slide, and Inner direction, Inner main axis and Inner cross axis to lay them out in a column or a row.

You can also style every carousel of the form at once in the form's Theme.

For support, please join our Discord community for further assistance and support.

On this page