Card Carousel

The Card Carousel is part of the Ionic L Component Set. This Component is designed to be used over all columns of the app and allows app end-users to swipe left and right in the carousel. 

Add a Card 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 Card Carousel in the list or begin typing Card Carousel to search the list. 
5
Select the Card Carousel. The Card Carousel Component will appear at the bottom of the General list in the left-hand column. The Card Carousel Properties will appear in the right-hand column.

Card Carousel Properties

The Card Carousel component has the following properties:

  • Component Id - Sets the name of the Card 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.
  • Type - Select from two different types of Card Carousel, small or large. 
  • Individual Card Properties (Up to 10)
    • 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 Fit- Select from three choices for Image Fit
      • Fill - This is the default. The image is resized to fill the Component's dimensions. This may cause the image to appear distorted in order to fill the image frame.
      • Contain - The Image keeps its aspect ratio, but is resized to fit within the image frame. This may cause a border to appear above the image, as the image is not filling the image frame.
      • Cover - The Image keeps its aspect ratio and fills the image frame. The edges of the image may appear cropped.
    • ALT Text - Sets the text that appears if the image fails to load. The Alt Text appears in a blank box where the Image would normally appear. It's recommended to always use Alt Text for any Images. 
    • Icon - Upload a .SVG image file to display an Icon. Other image file types, such as .JPG and .PNG are not supported. To remove an uploaded Icon, click on the Trash Can. If an Image is uploaded, then it will override the Icon property.
    • Ionic Icon - Pulls in icons from a library of open source icons built by the Ionic Framework team. If an Image or Icon is uploaded, then it will override Ionic Icon property.
    • Icon Color - Sets the color for the Icon. There are two ways to set the colors: Click the Color Swatch to choose from the app's Color Palette or enter the hex code in the text field. 
    • Icon Background Color - Sets the color for the Icon Background. When a Card Item uses an Icon, this property sets the color that will appear behind the Icon. There are two ways to set the colors: Click the Color Swatch to choose from the app's Color Palette or enter the hex code in the text field. 
    • Background Color - Sets the color for the Card Item's Background. When a Card Item uses an Icon, this property will only set the color for the Card Item's bottom section. When a Card Item uses an Image, this property will set the color for the entire Card Item's background. There are two ways to set the colors: Click the Color Swatch to choose from the app's Color Palette or enter the hex code in the text field. 
    • Headline - Enter the text as it should appear in the app. The text uses the font selected in the Font Styling section of Branding. This text will wrap and there is no limit on the number of characters allowed.  
    • Headline Text Color - Sets the color of the Headline Text. There are two ways to set the Text Color: Click the Color Swatch to choose from the app’s Color Palette or enter the hex code in the text field.
    • Headline Text Bold - Toggle on or off for the Headline Text to appear bold.
    • Headline Text Alignment - Sets the alignment of the Headline Text. Choose from the dropdown list: Left, Right, or Center.
    • Link - Sets the link to another Page in the app or an external URL.
    • Open Link in a New Tab - Toggles on or off whether the Link opens in a new tab or not in the app. 
    Pro Tip: Type in tel:5558675309 to link to a phone number with "5558675309" replaced with the applicable 10-digit phone number or mailto:emailaddress to open up the default email client from the app with "emailaddress" replaced with the email address you want to be sent the email.

Card 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 is 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