Overview
Card Containers are used to organise and display information, such as text, images and buttons, in a visually appealing and structured way.
Card containers are backed by a table to display the data from the table.
How-to add a Card Container to a Screen
In this example, we will add a card container that will display employee contact information.
Note, for this example, a Blank-Column tile has already been added to the screen.
- In the palette, expand the Card Containers section
- Drag the Contacts card container onto your screen and give it a name
- Click on the card container to open its Properties tab on the right
- Or click on the card container in the Layers section on the left
- To tell the card container where to get its information from, the card container must be backed by a Table - this then allows the data from the table to be displayed
- In the Properties, under Basic Settings, click Table, next to the Table drop down box
- Drag a table from the Repository into the Table drop down box
- Click Apply
- To display the table data, the text fields on the card need to be associated with attributes on the table
- Right-click on First Name and select Add Backing Attribute
- In the Available Attributes selector that opens, tick
first_name
and click the Add button- The form field will now display this data in the first_name attribute on the screen
- Repeat these steps to set the backing attribute of last_name to the Last Name field and the attribute of Role to the Role field
- Note: Backing attributes can be changed by either right-clicking on the form field and selecting Change Backing Attribute, or click on the form field on the canvas, then in the Properties, under Backing Attribute, select a new Table Attribute
- Note: Backing attributes can be changed by either right-clicking on the form field and selecting Change Backing Attribute, or click on the form field on the canvas, then in the Properties, under Backing Attribute, select a new Table Attribute
- Switch to Application Mode or Lock the screen to see all of the cards with the chosen data displayed
The Contacts Card Container contains three buttons, which can have actions configured to perform specific activities, such as calling a phone number or sending an email. See 9. Grid Actions and In-Grid Editing.
Card containers can be linked with other types of Views, using background filters, to dynamically change the information on the card container depending on the records selected in the other View. For example, on a screen with a grid of Companies and a card container of Employees, linking the content will ensure that only employees show on the card container that are associated with the selected company in the grid. See 6. Linking Content on a Screen.
Card Containers in Serene Grey
The following Card Containers can be found in the Serene Grey palette.
Card Type | Icon | Description | Example Use |
---|---|---|---|
Basic | A standard card container with no styling that displays the content of each row of data on a backing table. Content is displayed by adding fields or dynamic text to a card. | ||
Contacts | A card container with icon and button styling that displays the content of each row of data on a backing table. Content is displayed by adding fields or dynamic text to a card. Buttons can be configured to perform actions, such as calling a phone number or creating a new email. | ||
Comment | A card container with button styling, displaying data from another table. | See 21. Exercises | |
Read Only | A card container that shows one card, displaying data from another table. | ||
Expandable | A card container that shows one card with an expandable area. | Use when there is extra data that does not require displaying. | |
Filter List | A card container that displays an aggregate view to group repeated values to display as a list. Users can then select records to filter an existing grid or card component. | Add next to an existing grid or card component to filter its content. Filter can be applied to the existing grid or card component to filter the records by the selected card. | |
Counter | A card container that displays a counter that can generate a total. It provides a circular card component that can be used to display a numeric value. This component requires a backing aggregate view that returns a single value in an attribute called "Count". | ||
Labelled Counter | As above. Includes a label field. | ||
Triple Counter | A card container that displays a counter that can generate 3 totals, with label fields. It provides 3 circular counters in a single card component that can be used to display numeric values. This component requires a backing aggregate view that returns three total values. By default these are called "Count" but the names will need to be changed to display the values shown in the backing view. | ||
Kanban Board 1 | A card container that displays a basic Kanban board, designed to display the statuses of different tasks. | ||
Kanban Board 2 | As above. Includes styling to display the cards as yellow sticky notes/ |