Carousel allows the user to browse through a set of items and view at least one item at a time. The user can navigate to the next or previous item by selecting paging indicators. Carousel is most helpful when the items within the set are visually distinct, as in images, and can be viewed side by side for comparison.
- Show strong visual representations of the items in the set.
- Ensure that the message preceding the component clarifies to the user what happens when they select an item.
- Don’t use if there is only one item in the set.
- Don’t show items that are visually similar to each other.
Main View Carousel
The Carousel component is composed of content, page indicators, navigation and navigation buttons. Buttons are optional.
The content includes all the items in the set to be displayed in the Carousel. Each item is shown as a Media Card.
B. Action List Items
Action List Items can be attached to the content, allowing users to trigger actions directly with Carousel.
C. Navigation Buttons
Navigation buttons allow the user to traverse the items in the Carousel by going forward or backward in the list. The backward button appears on the left of the Carousel, while the forward button appears on the right. The Navigation Buttons can appear either inside the Page Indicators or inside the Content.
D. Page Indicators
The Page Indicators show the total number of items in the Carousel and the current position in the set that the user is on. They appear either above or below the Content. Page Indicators that have 8 or less items appear as dots, with each one representing each item in the Carousel Content. Page Indicators with 9 or more items appear as just a number, showing which item is currently in view out of the total number of items.
The detail page contains more information about an item in the carousel. It consists of an image, header, a section, and action list buttons (if there are actions in the Carousel).
Image is center-aligned and scaled to display the full image within the following constraints:
Max height: 200 px
Max width: 416 px
Empty space is filled with background color: HEX #FFFFFF
Header consists of a title and subtitle corresponding with the information in the main view Carousel.
The section consists of a maximum of 8 value-pairs (Label Title + Content). Display as 2-columns if there’s 1 line of content. Use a 1-column display if there’s more than 1 line of content.
2-column value-pairs are always displayed above 1-column value-pairs.
A value-pair consists of a Label Title + Content.
In 1-column display, the value-pair content is constrained to a maximum of 250 characters. Truncate after 250 characters using ellipses.
If there is truncated content, the primary action button is “Open in App,” which will allow the user to see the full content.
E. Action List Items
Actions available in the Carousel should be available in the Detail Page as action list items, with a maximum of 3 actions.
If the action items list buttons cover the content (i.e., there’s less than 1 rem padding between the end of the content and action items list), the content is scrollable. A gradient will overlay the content above the action items list to indicate that there’s more scrollable content.
Action Items List
All the items of the list are clickable buttons. Action will be performed immediately after clicking, after which a message will follow.
Upon hovering the content, there will be a light shadow below the card indicating that it is clickable. Clicking Content of the carousel indicates clicking the entire carousel, after which a new view model will open showing more details.
The appearance of the navigation buttons depends on whether it is placed in the Page Indicators or over the Content. As shown in the image, navigation buttons over the Content have the shallow which don’t exist in Page Indicators.
Action List Items
Apply specs for Action List Items if they are attached to the content. Note to apply the cozy mode specs for that.