Specifications
An accordion (aka expansion panel) is a vertically stacked, full-width list of options that can expand/collapse to reveal or hide more associated content.
- Accordions can display directly on the page or in a card container.
- The arrow icon acts as an affordance to indicate the functionality of the accordion, and as a visual marker of the state of the accordion through its rotation and direction.
- When stacking multiple accordions, use stack space constants to add margin-bottom to the block element.
Anatomy
Sizing
States
Default states for Accordion are:
- Collapsed
- Expanded
- Focused
- Disabled
Expanded Items
Highlight expanded state to let a user recognize what is opened in case of multiple Accordions. There are several possible styles for the highlighting:
- Elevation Shadow
- Background Fill
- Outline Stroke
While the elevation works well on both smooth gray and white surfaces, you may fill the background of an expanded item with an appropriate Trimble color. You may also add an outline, if necessary.
Chevron Placement
Chevron could be placed both at the left or right.
Behavior
- Chevron icon signal to the user that the accordion can be expanded. Once the accordion is tapped, the chevron rotates to indicate successful expansion. Collapsing the accordion by tapping again, returns the chevron to the previous position.
- Accordions allow a single section to expand at one time, while automatically collapsing the section that loses focus (default behavior), or they allow for all sections to expand at the same time.
- When an accordion expands and collapses, only its height should change; its width should stay consistent.
- The expand-and-collapse functionality of an accordion is tied to the entire header of the element with additional actions being triggered only by interaction within the bounds of their related UI element.
- Avoid “nested” accordions—that is, collapsible content within collapsible content. This type of pattern goes against UX best practices.
Editorial
- Keep titles to five words, if possible, to avoid wrapping.
- Use title case and capitalize prepositions of four letters or more.