Expansion

v2.0

Expansion is a lightweight container that can function independently or be integrated into a larger surface. Tapping the expansion controls will either expand the content into a larger section or collapse it back to its original size.

  • CSS
  • Marko
  • React
Stylized artwork of an expansion.

Considerations

Progressive

Expansions reduce visual complexity and information density.

Empower

Users decide what information they want to see and when.

On-demand

Revealing and hiding information is a single tap away.

Anatomy

Properties

Title

The title describes what occurs when the button is selected. The title can be adjusted according to the context.

Three expansions with different titles: ‘See more’, ‘View details’, and ‘Read more’.

Behavior

Expanding

The expansion button title adjusts according to its state to indicate what occurs when pressed. The title says “more” when collapsed and “less” when expanded. The expand button remains below the revealed content.

Two quick filter groups titled ‘Explore related searches’. The group above has three lines of quick filters, with a ‘See more’ expansion below. The group below has six lines of quick filters, with a ‘See less’ expansion below.

Overflow

The title wraps to another line when extending beyond the parent container.

An expansion with the title wrapping into two lines.

Screen sizes

Small

Expansion buttons appear directly beneath the content they expand on small screens.

A ‘See more’ expansion below a ‘Description’ section on the eBay mobile app.

Large

Expansion buttons appear directly below the content they expand on large screens.

A ‘See more’ expansion below a ‘Description’ section on an eBay larger page.

Best practices

Specs

Two expansions are shown with specs highlighted. The height of an expansion is 44px, the padding on the top and bottom of an expansion is 12px, the padding between the title and trailing icon is 6px, and the width of the trailing icon is 16px.