Card Carousel

The Card Carousel is part of the Ionic 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. 

Ideas for Using Card Carousel

  • Add images to the cards and add text labels underneath to further explain your content or to connect app users to important information in the app, or to external pages.
  • Use the cards to display product images and use the text labels for the product name. Link each card to more information, including a detailed product page within the app, or an external page or document.
  • Create categories for navigation on your app homepage by using the cards to display photos of your different products. Link each category to other Pages in the app that provide additional information.
  • If you would prefer a carousel with circular images, check out Avatar Carousel.

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. 

Styling

  • Headline Font Size - Set the font size in pixels.
  • Bold Headline Text - Toggle on or off for the text to appear bold.
  • Italics Headline Text- Toggle on or off for the text to appear italicized. Default is set to off. 
  • Alignment - Sets the alignment of the Headline Text. Choose from the dropdown list: Left, Right, or Center.

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. 
    • Text - 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.  
    • 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.
    • 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