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.
Ideas for Using Carousel
- Showcase beautiful product images, allowing your customers to swipe through a brief gallery of up to six images.
- Create customer testimonial graphics with a quote and logo. Set the Mode to “contain” and adjust the Carousel Relative Height property to ensure the graphics are not cropped.
- Enable the Display Dots property, as this will indicate to users that they can swipe through more images.
- If you want a carousel that can link to other app Pages or external websites, check out the Swiper Cover Flow Carousel and Swiper Image Carousel.
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.
- Image - Upload a .JPG or .PNG to display an Image. To remove an uploaded Image, click on the Trash Can.
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.