Tooltip

v3.0.0

Tooltips disclose an element’s label when the label isn’t visible.

Stylized artwork of a tooltip.

Anatomy

A tourtip diagram with 2 elements numbered: 1. Label, 2. Container.
  1. Label
  2. Container

Properties

Label

The label is usually populated automatically by the anchor element’s accessible label.

A tooltip with a ‘Save’ label.

Behavior

Presentation

Tooltips appear after a 2 second delay while hovering or focusing on an anchor element. They fade out 1 second after the anchor element loses hover or focus.

A cursor hovers over a ‘Customize’ icon button, with a ‘Customize’ tooltip situated above.

Dismissing

Tooltips automatically disappear 1 second after the element loses hover or focus, or when another element receives hover or focus that reveals a tooltip.

A tooltip.

Text overflow

Tooltip labels should avoid wrapping where possible. When required, the label wraps to a new line when extending beyond the width of the container.

A tooltip with the label spanning two lines.

Placement

Tooltips appear to the side of the anchor element that has open space. The default position is below the anchor element.

Four tooltips surround a circle: one Above, Leading (to the left), Trailing (to the right), and Below. The Below tooltip is the default placement.

Screen sizes

Small

Tooltips appear on hover or focus on smaller screens or browser windows. They’re uncommon on native platforms.

A ‘Customize’ tooltip sits below a Customize icon button on the eBay app.

Medium

On medium screens, tooltips appear on hover or focus.

A cursor hovers over a Favorites icon button on a medium screen, with a tooltip labelled ‘Favorites’ situated below.

Large

On large screens, tooltips appear on hover or focus.

A cursor hovers over a Favorites icon button on a large screen, with a tooltip labelled ‘Favorites’ situated below.

Best practices

Multiple tips

Do only show a single tip at a time.

A cursor hovers over a Favorites icon button with a tooltip labelled ‘Favorites’ situated below.

Don’t override tip behavior to show multiple at once.

A ‘Favorites’ tooltip sits below a ‘Favorites’ icon button, next to a ‘Cart’ tool tip situated below a ‘Cart icon button.

Specs

A tooltip with specs is shown. The padding to the left and right of the tooltip is 16px, and the padding on the top and bottom is 8px.

Change log

VersionDateNotes
3.0.0
Sep, 2024
  • Updated to eBay Evo
3.0.0
Feb, 2023
  • Separated tooltip logic from infotip logic
2.0.0
Apr, 2022
  • Updated fill to bg.elevated
  • Updated size of pointer
  • Added max width