Timeline
The Avonni Timeline component transforms lists of events into interactive visual timelines for easier understanding of chronological data.
Last updated
Was this helpful?
The Avonni Timeline component transforms lists of events into interactive visual timelines for easier understanding of chronological data.
Last updated
Was this helpful?
The Data Source is crucial for determining what information will be displayed on the timeline. Three data sources are available: Manual, Variable, and Query.
Manual
Ideal for static timelines with a predetermined set of events or activities.
When the data doesn’t require updates or changes over time.
Variable
Perfect for dynamic timelines where events or activities are linked to changing data in Salesforce.
When your timeline needs to reflect real-time data or updates from Salesforce records.
Suitable for complex timelines that need to pull data from various sources or based on specific criteria.
Ideal for complex data retrieval or when sourcing. Using a 'Get Records' collection with this data source is unnecessary, as the query itself is powerful enough to simplify your flow.
ry Data Source:
Initial Display: By default, only 20 items will load at first. This helps keep the Timeline fast and responsive.
See All Data: Don't worry! The "Show More" button lets users easily load the rest of your Timeline items.
Customization (Optional): You can adjust the number of initially displayed items if desired. Set a value for the "Max Visible Items" attribute in the Pagination section.
Completing data mappings is essential when using a variable data source. This means connecting Salesforce fields from your 'Get Records' collection or the Query Data Source to the matching attributes in the Avonni Timeline component. Doing this will ensure your Salesforce data populates the timeline correctly, displaying the correct information in the right places.
Example: For instance, you might map a field from your 'Get Records' collection, which contains event start dates, directly to the start date attribute of a timeline event in the Avonni Timeline.
Horizontal: Displays the timeline in a left-to-right format.
Vertical: Presents the timeline in a top-down format.
Horizontal
The Horizontal Orientation is presenting chronological events or activities in a linear, horizontally-oriented way.
Vertical
Display a list of activities in a chronological vertical way.
Display Order (Asc/Desc): Control how timeline items are arranged – earliest to latest (Ascending) or latest to earliest (Descending).
Group By (Vertical Timeline): Organize your timeline by Day, Week, Month, or Year. For example, group tasks by their due date, or project milestones by month.
Customization of Layout
Define the number of columns each field occupies within the container, allowing precise control over the timeline's layout and appearance.
Purpose: Optimize the visual presentation for improved readability and alignment across different screen sizes.
Enhancing User Interaction
Place actions at the top right of each timeline item, providing users with quick access to complete tasks in Salesforce.
Benefit: Enables setting specific action names for each item, streamlining user interactions and task completion.
Offer filtering options displayed as a popover, allowing users to refine what's shown on the timeline.
Setting Up Filters: Add fields from your data source as filters, enabling users to narrow down the timeline view based on specific criteria or attributes
The Timeline is available in two variants. Horizontal and Vertical orientation.
Horizontal
The Horizontal Orientation is presenting chronological events or activities in a linear, horizontally-oriented way.
Vertical
Display a list of activities in a chronological vertical way.
The Header section gives you control over the appearance and functionality of your Timeline header.
Title
Define a meaningful title for your Timeline. It introduces the timeline'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 Timeline. This can be especially useful for providing context or additional details about the table data.
Icon
Add an icon to your header to enhance its visual appeal or to help convey the Timeline's purpose or content at a glance.
Is Joined
This property, when activated, gives the header a square, shadowless bottom border. This makes the header blend seamlessly with another component, making the Timeline appear as a continuous, unified element.
Buttons
From the interactions panel, you can create interactions when users click on an activity item and/or an action. For example, you may want to redirect users to the record page when they click the activity item link.
From the Style panel, you can customize styling attributes for the Timelime component:
Size: set a specific size for the component.
Toolbar: customize the background color of the toolbar.
You can only define Margin and Size for the Timeline from the Styles panel.
actions
String
Array of action objects. The actions are displayed at the top right of each item.
closed
Boolean
If present, the group sections are closed by default. This attribute is supported only for the vertical orientation.
collapsible
Boolean
If present, the section is collapsible and the collapse icon is visible. This attribute is supported only for the vertical orientation.
groupBy
String
If present, the value will define how the items will be grouped. Valid values include week, month or year. This attribute is supported only for the vertical orientation.
iconName
String
The Lightning Design System name of the icon displayed in the header, before the title. Specify the name in the format 'utility:down' where 'utility' is the category, and 'down' is the specific icon to be displayed.
iconSize
String
The size of the title's icon. Valid values are xx-small, x-small, small, medium and large.
itemDateFormat
String
orientation
String
Orientation of the timeline. Valid values include vertical and horizontal.
sortedDirection
String
If present, the value will define how the items will be grouped. Valid values include week, month or year. This attribute is supported only for the vertical orientation.
title
String
Title of the timeline, displayed in the header.
maxVisibleItems
String
The maximum number of visible items to display.
items
ActivityTimelineItem
Array of item objects.
on assigning various source collections from multiple objects to the Activity Timeline.
Add interactive buttons to your header to enable specific actions from the . This provides additional functionality and enhances user engagement with the Timeline.
Here is a complete you can add to the Timeline.
The date format to use for each item. .
