Carousel

The Carousel is part of the Image Component Set. It features multiple images and allows the app end user to slide or tap through these images. The images within the Carousel cannot be linked. 

Add a Carousel to a Page

1
Create or open an existing app.
2
Click the Edit Pencil on a Page.
3
Click the Green + Icon, located in the bottom right corner.
4
Either scroll to Carousel in the list or begin typing Carousel to search the list.
5
Select the Carousel. The Carousel Component will appear at the bottom of the Content list in the left-hand column. The Carousel Properties will appear in the right-hand column.

Carousel Properties

The Carousel component has the following properties:

  • Component Id - Sets the name of the Carousel component in the app. The Component Id can be referenced using JavaScript to add more functionality to the app as needed.

    Pro Tip: It is a best practice to use only letters without spaces for the Component Id. Symbols, spaces, and numbers are not recommended.
  • Carousel Relative Height - Sets the height of the Carousel as a percentage of the available device screen. The recommend value is 30. 
  • Mode - Sets the image display type. Choose from the dropdown list: Contain or Cover. If Contain is selected, the images are shown as large as possible to fill the Carousel Relative Height without cropping or stretching the image. If Cover is selected, the images are shown as large as possible without stretching the image. If the proportions of any images in the Carousel differ from the Relative Height, that specific image is cropped either vertically or horizontally so that no empty space remains.
  • Arrow Color - Sets the color of the Arrows in the Carousel. There are two ways to set the Arrow Color: Click the Color Swatch to choose from the app’s Color Palette or enter the hex code in the text field.
  • Display Dots - Toggle on or off whether or not the dots indicating the number of images in the Carousel component appear.
  • Lower Light Box Icons - Toggles on or off the Lower Light Box Icons.
  • Carousel Images Properties (Up to 6)
    • Image - Upload a .JPG or .PNG to display an Image. To remove an uploaded Image, click on the Trash Can.

      Pro Tip: Optimize all Images for the web to increase app performance and shorten load time.

Carousel Placement Settings

The Placement Settings for the Component sets which column(s) the Component will appear. Each Page of the app can have a different number of columns that are set in the Layout section of the Page Settings. The following Placement settings are available for this Component:

  • Column Start - Sets the column where the Component will start. 
  • Column Span - Sets how many columns the Component will span. 
  • Padding - Sets how much space will appear on the top, bottom, left, and right of the Component. When building a Page with multiple Components, the Padding will determine the overall spacing between Components.
  • Display Mode - Sets how the Component is displayed. If Both is selected, the Component will always show. Both are the default option. If Optimal is selected, the Component will only show if the browser supports the app. The main supported browsers are Chrome and Safari. If Degraded is selected, the Component will only show if the browser does not support the app. The main unsupported browser is Internet Explorer.

Still need help? Contact Us Contact Us