The following properties that can be configured:

​
Properties and settings

​
Settings (applicable across all platforms)

These settings added in the Generic tab are available and they apply to all platforms including Web, iOS, and Android.

​
When used as root

When the Card is utilized as the root component, it offers the following settings:
  • Custom UI Payload: A valid JSON describing the custom data transmitted to the frontend when the process reaches a specific user task.
  • Title: The title displayed on the card.
  • Subtitle: Additional descriptive text accompanying the card.
  • Has accordion: Introduces a Bootstrap accordion, facilitating the organization of content within collapsible items. It ensures that only one collapsed item is displayed at a time.
The accordion feature is not available for mobile configuration.

​
Mobile configuration (iOS & Android)

For mobile configuration (iOS and Android), you can also configure the following property (not available on Web configuration):
  • Screen title: Set the screen title used in the navigation bar on mobile devices (available only when the card element is set as the root).
Android Screen Title

Android Card Screen Title

​
Card settings overrides

You may want to override the card title or subtitle set as Generic to be displayed differently on mobile devices. For example, on the web, titles might be shorter.
Available properties overrides for web (overriding properties set in Generic settings tab):
  • Title
  • Subtitle

​
When not used as root

When the card is not the root, you can configure: Title, Subtitle, Card Style and Has Accordion. Leverage cards in your designs to organize and present content, enhancing the overall user experience.

​
Styling

When designing for the web, consider the layout options available for the card. These options include:
  • Direction: Choose between Horizontal or Vertical alignment to define the flow of components. For example, select Horizontal for a left-to-right layout.
  • Justify (H): Specify how content is aligned along the main axis. For instance, select end to align items to the end of the card.
  • Align (V): Align components vertically within their card using options such as top, center, or bottom alignment.
  • Wrap: Enable wrapping to automatically move items to the next line when they reach the end of the card. Useful for creating multi-line layouts.
  • Gap: Define the space between components to control the distance between each item. Adjusting the gap enhances visual clarity and organization.

​
Theme overrides

Customize the appearance by overriding style options coming from your default theme. Available overrides:
  • Border width
  • Border radius
  • Border color
  • Background color
  • Shadow
  • Title
  • Title Color
  • Subtitle
  • Subtitle Color

Layout Demos

​
Validating elements

To ensure the validation of all form elements and custom components within a card upon executing a Save Data action such as Submit or Continue, follow these steps:
  1. When adding a UI action to a button inside a card, locate the dropdown menu labeled Add forms to submit.
  2. From the dropdown menu, select the specific forms, individual form elements, or custom components you wish to validate.
  3. If you select custom components, ensure they are properly configured to handle validation and data saving responsibilities.

​
Custom component validation

UI actions enable validation and data management for custom components alongside form elements. This provides flexibility if you want to design custom components for entire screens, such as custom forms not natively supported by the platform.

​
Key features

  • Validation API: The renderer provides a public API for validating custom components before triggering an action.
  • Custom Component Responsibilities:
    • Validate custom forms and return a boolean (true for valid, false for invalid).
    • Display validation errors in the UI for invalid data.
    • Populate a saveData property with the structured data to be submitted.
  • Configurator Responsibilities:
    • Select custom components in the Add forms to submit dropdown when configuring a UI action.
    • Set the custom key to store the data submitted by the custom component.
By including custom components in the validation process, you can now validate and retrieve data from custom form sections, ensuring comprehensive and reliable form submission.