List
The Avonni List component displays a collection of records as a customizable list — vertical, single-line, or interactive checklist — with support for avatars, images, fields, actions, pagination, filtering, search, and drag-and-drop sorting.
Overview
To start with the Avonni List component, you'll first need to connect it to your data and configure how it is displayed. The sections below follow the configuration panel from top to bottom, so you can read along as you build.
Configuration
To configure the List, select it on the canvas. The Edit List panel opens on the right with three tabs: Properties, Interactions, and Style. The sections below mirror the Properties tab.
Data Source
Before you build your list, you must tell the Avonni List component where to get the data it should display. You have several options, depending on the source and nature of your data:
Manual
Enter data directly into the component configuration.
Variable
This is useful for data that changes based on user interactions or other component logic.
Query
This is the most common option for displaying Salesforce records.
Data Mapping
When using a dynamic data source for your List, configure the Data Mapping section to tell the component how to create list items from your data.
Without data mapping, the list would not know which Salesforce fields to use for each item attribute.
In Data Mapping, map each Salesforce field to the corresponding List attribute (for example, Account Name to Label) so each item shows the correct information.
Filter Fields
In Data Mapping, select which fields are available to end users as filters. Only the fields you select here appear in the filter menu.
Search Fields
By default, the search covers all searchable fields you map in Data Mapping. Use Search Fields to limit the search to specific mapped fields.
Content
Variant
The Variant setting defines the overall style and layout of the List.
Base (Default)
This is the standard list view. Items are displayed in a vertical list format, ideal for detailed information and various content types.
Single-Line
This variant presents list items horizontally in a single row, allowing you to navigate between items using left and right arrows. It's handy for displaying concise information or maximizing space when vertical real estate is limited.
Checklist
This specialized variant transforms the list into a checklist format. Each item includes a checkbox for selection, making it ideal for interactive task lists or preference selections.
Choosing the Right Variant
Base: This is when you need to present detailed information for each list item, including multiple fields or rich media.
Single-Line: For concise data points or when you want a compact list layout.
Checklist: When you need user input in the form of selections or checkmarks
Divider
The Divider attribute is designed to enhance the visual structure of your list by introducing dividers between items.
This attribute allows you to customize how each item in the list is separated from the others.
Top
Allows you to place a divider at the top of each item in the list.
Bottom
Adds a divider line at the bottom of each list item.
Around
Places divider lines both above and below each item in the list.
Card
Sets each list item within its own card-like container, separated by dividers.
Items Clickable
If enabled, all items in the list become clickable.
Important
Configuring the interaction correctly is essential for clickable items to work effectively. The clickable functionality enhances user interaction with the list of items.
Check List
When you opt for the "Checklist" variant in the Avonni List Component, a new set of customization options becomes available, allowing you to tailor the appearance and behavior of your interactive checklist.
Key Checklist Settings
Strike-Through on Check: Activate this toggle to apply a strikethrough style to items that have been checked off. This visual cue provides immediate feedback to the end user and helps them track their progress.
Show Check Counter: Enable this option to display a real-time counter indicating the number of checked items. This is useful when users need to assess how many items have been selected or completed quickly.
Header
The Header section gives you control over the appearance and functionality of your List header.
Header section on a list
Define a meaningful title for your List. It introduces the list's content and is a key element of the visual hierarchy.
Use the caption field to add a brief description or supplementary information for your List. This can be especially useful for providing context or additional details about the list's content.
Display an avatar in the header to enhance its visual appeal or convey the List's purpose at a glance. Set an Image, a Fallback Icon Name, or Initials, and adjust the avatar size and variant under Advanced Options.
This property gives the header a square, shadowless bottom border when activated. This makes the header blend seamlessly with another component, making the List appear as a continuous, unified element.
Actions
Add interactive buttons to your header with the Add Actions option, and trigger specific behavior from the interaction pane. This provides additional functionality and enhances user engagement with the List.
Layout
The Layout section controls how many columns list items occupy so the list adapts across screen sizes.
Layout customization
Column Count: Choose the number of columns you want your list items to occupy. You have the flexibility to select from one to twelve columns.
Responsive Design: Fine-tune the layout for different screen sizes. For instance, you might prefer a single column for mobile phones to maximize readability while using multiple columns on larger screens to showcase more content simultaneously.
Avatar
The Avatar Attributes section enables you to customize the appearance and placement of avatars within each item in your Avonni List.
Variant
Modify the shape of the avatar for each item in the list
Circle, Square
Icon Size
Adjust the size of the avatar icon to match your design needs
Small for minimalism, Large for emphasis
Position
Define the placement of the avatar within each list item
Left, Top-Left, Bottom-Left, Right, Top-Right, Bottom-Right, Left of the Title, Right of the Title
Presence Position
Customize the location of the presence icon, indicating user status, in relation to the avatar.
Top-Left, Top-Right, Bottom-Left, Bottom-Right
Image
An image can be added to any item. Use the image attributes to customize how images appear on items. You can set Position, Size, Height, and Crop.
Fields Layout
The Field Attributes section allows you to define the number of columns each field will occupy within the container, giving you granular control over the layout and appearance of your list content.
How to Use It
1 - Define Fields: Add the fields you want to display on your Avonni List Component - navigate to the 'Fields' attribute. You can find this at the bottom of the Properties Panel.
2 - Specify Column Span: Use the Fields Attributes section to specify the number of columns the fields added should span.
Variants for Fields
The Variant setting for fields changes how field information appears. Available values:
Standard: This is the usual way, where the label sits above the field. It's straightforward to read.
Label Hidden: Use this if you want a clean look. The label is hidden, which is useful when you're short on space, or the field's purpose is already apparent.
Label Inline: The label sits next to the field, usually on the left. This is helpful when you have more room side-to-side than up-and-down.
Label Stacked: The label starts atop the field and moves up when you click it or start typing. This style saves space, especially on mobile devices.
Actions
The Avonni List Component can embed actions within your list, transforming it from a display component into an engaging, interactive interface.
Where to Add Actions
Item Level
Enhance each list item with clickable elements such as buttons or links. These actions could trigger navigation to a detailed record page, launch a popup for editing, or execute any other custom flow logic.
Media Level
If your list includes images or videos, you can embed actions directly within these media elements. For instance, clicking on a product image could open a product detail page, or tapping a video thumbnail could initiate playback.
Pagination
The "Pagination Options" area lets you split long lists into smaller parts in the Avonni List Component. You can choose how many items are shown on each page and how the controls look, making it easier to handle extensive lists.
Key Features
Show Pagination
Control the visibility of pagination controls at the bottom of the list.
Enable or Disable
Number of Items per Page
Specify how many items to display per page.
Range from 1 to 500, default 100
Alignment
Choose the alignment for the pagination controls.
Left (default), Center, Right, Fill
Customize Button Icons and Labels
Personalize icons and labels for pagination buttons (First, Last, Next, Previous).
Adapt to different languages or align with application branding and style.
Filter
The Filter section controls how the filter menu is presented to end users. Filter fields are enabled in the Data Mapping section.
Filtering Option
The "Filter" section allows you to add a filter menu that appears as a popover. When this feature is enabled, all the fields designated as filters will be displayed in this popover, keeping the list uncluttered and focused.
Open the Component Builder
Scroll down to the Filter section
Select how you'd like to display filters.
Filter Type
The Avonni List offers three filtering options to streamline your data navigation experience. Each option is designed to accommodate different user preferences and screen sizes.
These filters appear directly above the data table, laid out in a horizontal row. This layout is ideal for quickly accessing and applying filters without obstructing the view of the data table.
This option allows filters to be hidden behind clickable icons or buttons; when clicked, a small, floating interface (a popover) appears, containing the filter options.
Side Panel Filter menu options
When configuring your Avonni List component to use a "Panel" filter, you can present filtering options in a convenient side panel. This panel offers additional customization settings, described below:
Where the Filter Panel Appears
Position (Left or Right): The filter panel slides out from the side of the screen. Choose the position that best suits your design.
How the Filter Panel Starts
Closed by Default: Decide if you want the filter panel hidden or visible when the screen first loads.
True: The panel starts hidden. This is good if you want to focus on the data table first.
False: The panel starts open, encouraging users to filter right away.
Show or Hide the Toggle Button
Hide Toggle Button: Control whether users see a button to open and close the filter panel.
True: The button is hidden. Use this if you want the panel to open and close automatically based on other things happening in your flow (like clicking a filter icon).
False: The button is always visible so users can control the panel.
Picklist Filter Values
Use Record Picklist Values: When filtering a picklist field, derive the filter options only from the values actually present in the loaded records rather than the field's full picklist definition.
Use Cascading Filter Values: When a user applies a filter, narrow the options available in the other filters to only those matching the current selection. Overrides Use Record Picklist Values.
Search
The "Searchable" toggle lets you specify whether the items in the list can be searched. When activated, a search bar is made available. Additionally, you can set placeholder text for the search bar and determine its position with available values: left, right, center, and fill.
Activating Search: To make the list searchable, toggle on the "Searchable" option in the configuration settings of your Avonni List Component.
Setting Placeholder Text: Customize the search bar by adding placeholder text to guide users.
Positioning the Search Bar: Use the position attribute to set the location of the search bar. Options include:
left: Aligns the search bar to the left.right: Aligns the search bar to the right.center: Centers the search bar.fill: Expands the search bar to fill the available space.
Best Practices
Use descriptive placeholder text to guide users on what they can search for.
Choose a search bar position that harmonizes with the overall layout of your list component.
No Results Message
The No Results Message section controls what the list displays when its data source returns no records, so users see helpful feedback instead of an empty area.
No Results Message
The message to display when no records are returned.
Hide No Results Image
If enabled, the no results illustration is hidden.
Hide No Results Message
If enabled, the no results message is hidden.
Sort
To empower users to sort items within your list, activate the "Sort" option. When enabled, a clear visual indicator (typically an icon) will appear on each item, signaling that the list can be reordered.
Sortable icon in Left Position example
Set Component Visibility
All components support conditional visibility — see Component Visibility.
Interactions
Interactions define what happens when users interact with the List. Configure them from the Interactions tab of the Edit List panel.
Item Click
Fires when a user clicks a list item. Use this to navigate to a record page, open an edit form, or trigger any flow logic tied to the clicked item.
Item Action Click
Fires when a user clicks one of an item's actions. Use the targetName output to identify which action was clicked and branch your flow logic accordingly.
Item Media Action Click
Fires when a user clicks an action embedded on an item's image or media area. Use the targetName output to identify which media action was clicked.
Header Action Click
Fires when a user clicks one of the header action buttons. Use the targetName output to identify which header action was clicked and branch your flow logic accordingly.
Reorder
Fires when a user reorders the list by drag and drop. Requires Sort to be enabled. Use this to persist the new item order, for example by updating an order field on each record.
Item Check
Fires when a user checks or unchecks an item. Available only with the Check List variant. Use this to react to the current selection of checked items.
Styling
The Avonni List Component offers extensive styling options to help you seamlessly integrate it into your Salesforce. Configure them from the Style tab of the Edit List panel.
Controls the outer spacing around the entire list.
Top / Right / Bottom / Left: Adjust the space on each side of the list.
Controls the inner spacing between the list's content and its container.
Top / Right / Bottom / Left: Adjust the inner spacing on each side.
Controls the list's dimensions.
Width / Height: Set fixed dimensions for the list.
Min Width / Max Width / Min Height / Max Height: Constrain the size within bounds.
Overflow / Overflow X / Overflow Y: Control how content that exceeds the bounds is handled.
Customizes the border surrounding the list container.
Color: Set the border color.
Size: Adjust the border thickness.
Style: Choose a border style (e.g. solid, dashed, dotted).
Radius: Control the roundness of the corners.
Styles the list header, its border, title, caption, and avatar.
Header: Background Color; Padding Top / Right / Bottom / Left; Margin Bottom.
Border: Color / Size / Style / Radius; Bottom Border Color / Size / Style (Is Joined).
Title: Color; Font Size / Font Style / Font Weight.
Caption: Color; Font Size / Font Style / Font Weight.
Avatar: Background Color / Foreground Color; Border Radius.
Styles each list item — its spacing, alignment, text, background, and border.
Item: Avatar Image Object Fit.
Spacing: Top / Bottom / Left / Right; Block Between / Inline Between.
Vertical Alignment: Body / Actions / Avatar.
Label: Text Color / Link Color / Link Color Hover; Font Size / Font Style / Font Weight.
Description: Color; Font Size / Font Style / Font Weight; Line Clamp.
Background: Color / Color Hover / Color Highlight; Color Sortable / Color Sortable Hover.
Border: Color; Size / Style / Radius.
Info: Text Color / Link Color / Link Color Hover; Font Size / Font Style / Font Weight.
Styles the fields displayed within an item, including their labels and values.
Item Fields: Background Color / Border Color / Border Size / Border Style / Border Radius; Spacing Inline / Spacing Block.
Label: Color; Font Size / Font Style / Font Weight.
Value: Color; Font Size / Font Style / Font Weight.
Output Variables
The List exposes output variables you can reference elsewhere on the page after the user interacts with it. "sObject" variables require a Query or Variable data source.
Item Click
When a user clicks a list item.
Clicked Item
Object
The clicked item's data (same fields as the data source items).
Clicked Item sObject
Record (SObject)
The Salesforce record behind the clicked item.
Example: Click a Contact in the list and show that record in a detail component beside it using Clicked Item sObject.
Item Action
When a user clicks an inline action on an item.
Clicked Item Action - Item
Object
The item the action was triggered on.
Clicked Item Action - Item sObject
Record (SObject)
The Salesforce record behind that item.
Clicked Item Action - Action Name
Text (String)
The name of the action that was clicked.
Media Action
When a user clicks a media action on an item.
Clicked Media Action - Item
Object
The item the media action was triggered on.
Clicked Media Action - Item sObject
Record (SObject)
The Salesforce record behind that item.
Clicked Media Action - Action Name
Text (String)
The name of the media action that was clicked.
Header Actions
Clicked Header Action Name
Text (String)
The name of the header action button the user clicked.
Selection
The items the user has checked (Checklist variant).
Selected Item Names
Text Collection (String[])
The names of the selected items.
Selected Items
Object Collection
The selected items' data.
Selected Items sObject
Record Collection (SObject[])
The Salesforce records for the selected items.
Sorting
The list order after the user reorders items (drag-to-reorder).
Sorted Items
Object Collection
The items in their new order.
Sorted Items sObject
Record Collection (SObject[])
The Salesforce records in their new order.
Example: Let a user reorder a checklist, then save the new sequence back to Salesforce with Sorted Items sObject and an update action.
Others
Number of Items
Integer
The total number of items currently loaded in the list.
Last updated
Was this helpful?