> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/dynamic-components/components/list.md). # 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:
ManualEnter data directly into the component configuration.
VariableThis is useful for data that changes based on user interactions or other component logic.
QueryThis is the most common option for displaying Salesforce records.
PicklistRetrieve data dynamically from a standard or custom picklist field within Salesforce.Picklist
### 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.
Data Mapping section in the Edit List panel
**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. | Divider | Description | Illustration | | ---------- | ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Top** | Allows you to place a divider at the top of each item in the list. | ![](https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2Fgit-blob-bc22a65601b9782fd27500682d51fffe947378b4%2FListe%20Documentation%20Hub.png?alt=media) | | **Bottom** | Adds a divider line at the bottom of each list item. | ![](https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2Fgit-blob-3366e899d449e00432ec1223446a75135c3ac53e%2FListe%20Documentation%20Hub%20\(1\).png?alt=media) | | **Around** | Places divider lines both above and below each item in the list. | ![](https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2Fgit-blob-5c061daaf5cd8a6bc89542704b1536a797c404fd%2FListe%20Documentation%20Hub%20\(2\).png?alt=media) | | **Card** | Sets each list item within its own card-like container, separated by dividers. | ![](https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2Fgit-blob-e02c118b6bd95520fdb2bf3e9f972d955ed84d27%2FListe%20Documentation%20Hub.avif?alt=media) | #### Items Clickable If enabled, all items in the list become clickable.
{% hint style="danger" %} **Important** **Configuring the interaction** correctly is **essential** for clickable items to work effectively. The clickable functionality enhances user interaction with the list of items. {% endhint %} ### 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
AttributeDescription

Title

Define a meaningful title for your List. It introduces the list's content and is a key element of the visual hierarchy.

Caption

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.

Avatar

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.

Help Text

Add help text content to the header to give users extra guidance about the list.

Is Joined

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.

Show Number of Items

Display a counter of the number of items in the list next to the header title.
**Actions** Add interactive buttons to your header with the **Add Actions** option, and trigger specific behavior from the [interaction pane](https://docs.avonnicomponents.com/flow/component-builder/interactions-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.
| Attribute | Description | Options | | --------------------- | ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- | | **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**. {% hint style="info" %} The **Picklist Values Data Source** doesn't support images. {% endhint %} ### 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. ![](https://docs.avonnicomponents.com/~gitbook/image?url=https%3A%2F%2F27923732-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F1FUd4apB9YHgCEMUFbVb%252Fuploads%252F3OXfITHEkCMIBidyYm03%252FSept%25203%2520Screenshotqq.png%3Falt%3Dmedia%26token%3D4656aa91-b336-4c55-9e2a-9a73b74ec4f8\&width=768\&dpr=4\&quality=100\&sign=c184ccb9\&sv=2) **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** | Feature | Description | Options | | ------------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | **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. | {% hint style="info" %} **Items loading.** With **Pagination** off, the List loads **Items Per Page** items at a time behind a **Show More** button — or, if you set a fixed **Height** (Size style), it switches to **infinite scroll** (loading the next batch as you reach the bottom). With **Pagination** on, it shows one page of **Items Per Page** items with pagination controls. {% endhint %} ### Filter The **Filter** section controls how the filter menu is presented to end users. Filter fields are enabled in the **Data Mapping** section.

How to add filters

**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. | Name | Description | Illustration | | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

Horizontal

| 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. | ![](https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2Fgit-blob-a5e27a79d91c0b8ca839a03b2f83313f0f5e1616%2FListe%20Documentation%20Hub%20\(1\).avif?alt=media) | |

Popover

| 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. | ![](https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2Fgit-blob-ffac9494126bdb1bdaedb105ad1717cd69ef41c4%2FListe%20Documentation%20Hub%20\(2\).avif?alt=media) | |

Side Panel

|

Filters in a side panel are located to the left or right of your data table, accessible through a panel that can be expanded or collapsed.


| ![](https://2532358799-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FODPvvv7Cx9Z9RECLn3oV%2Fuploads%2Fgit-blob-35090612366acb898dce3f2a50c39a72197eb186%2FListe%20Documentation%20Hub%20\(3\).avif?alt=media) | **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** * **Is Closed:** 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. | Attribute | Description | | --------------------------- | ---------------------------------------------------- | | **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.

How to activate the Sortable option

Sortable icon in Left Position example
### Set Component Visibility All components support conditional visibility — see [Component Visibility](/dynamic-components/core-concepts/component-visibility.md). ## Interactions [Interactions](/dynamic-components/component-builder/interactions.md) 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. {% tabs %} {% tab title="Margin" %} Controls the outer spacing around the entire list. * **Top / Right / Bottom / Left:** Adjust the space on each side of the list. {% endtab %} {% tab title="Padding" %} Controls the inner spacing between the list's content and its container. * **Top / Right / Bottom / Left:** Adjust the inner spacing on each side. {% endtab %} {% tab title="Size" %} 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. {% endtab %} {% tab title="Border" %} 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. {% endtab %} {% tab title="Header" %} 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. {% endtab %} {% tab title="Item" %} 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. {% endtab %} {% tab title="Item Fields" %} 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. {% endtab %} {% tab title="Pagination Buttons" %} Changes the look of the pagination controls (when enabled). * **Background Color / Text/Icon Color / Color Border:** Set the colors for the default, active, hover, and disabled states. * **Border Size / Border Style:** Control the button border. * **Active Button Background / Text/Icon / Border Colors:** Style the currently active page button across its states. {% endtab %} {% tab title="Footer" %} Styles the footer area of the list. * **Background Color / Border Color:** Set the footer colors. * **Border Size / Border Style / Border Radius:** Control the footer border. {% endtab %} {% tab title="Show More Button" %} Customizes the "Show More" button (when load-more is used). * **Background Color / Text Color / Border Color:** Set the colors for the default, active, and hover states. * **Border Size / Border Radius:** Control the button border. * **Block Start / Block End / Inline Start / Inline End:** Set the spacing around the button. {% endtab %} {% tab title="Checkbox Button" %} Modifies the appearance of the checkboxes (shown when the **Check List** variant is used). * **Size:** Set the checkbox dimensions. * **Background Color / Background Color Active / Icon Color:** Set the checkbox colors. * **Border Color / Border Size / Border Radius:** Control the checkbox border. {% endtab %} {% endtabs %} ## 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. | Output variable | Type | What it returns | | ------------------------ | ---------------- | --------------------------------------------------------------- | | **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. | Output variable | Type | What it returns | | -------------------------------------- | ---------------- | ---------------------------------------- | | **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. | Output variable | Type | What it returns | | --------------------------------------- | ---------------- | ---------------------------------------------- | | **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 | Output variable | Type | What it returns | | ------------------------------ | ------------- | ------------------------------------------------------ | | **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). | Output variable | Type | What it returns | | -------------------------- | ------------------------------ | ---------------------------------------------- | | **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). | Output variable | Type | What it returns | | ------------------------ | ------------------------------ | ------------------------------------------ | | **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 | Output variable | Type | What it returns | | ------------------- | ------- | ------------------------------------------------------- | | **Number of Items** | Integer | The total number of items currently loaded in the list. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.avonnicomponents.com/dynamic-components/components/list.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.