Skip to end of banner
Go to start of banner

Details Pane

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 45 Next »

Description

The details pane is a panel located on the right side of the page, presenting information and actions related to selected items on the main area.

Usage & Behavior

General guidelines

  • In case no items are selected, the details pane will show an empty state (see states below).

  • In case two or more items are selected, the pane will show either a combimation or just the number of selected items (see states below).

  • The details pane may have an option to pin to the side of the page

Structure

Header

  • The details panel contains a header with the pane’s title.

  • The header may also contain:

    • a secondary title,

    • a Thumbnail image (for example: an avatar),

    • a pin icon (see interaction below),

    • a contextual help icon.

Tabs

  • Where relevant, the details pane will include between 2 to 5 tabs.

  • All tabs will be of the same width. Long titles will be truncated and a tooltip will appear on hover.

The Content Area

  • The details pane (or any tab) content area may contain various types of content (see content below).

  • If the content exceed the height of its container, a scroll bar will appear. The scroll bar will apply to the content area only, excluding the header and the action area, if exists (see below).

Action Area

  • Where relevant, an actions area will be shown at the bottom of the details pane, allowing users to perform tab level actions.

  • Examples - buttons / dropdown menu?

Placement & Positioning

  • The details pane is attached the right side of the page (in LTR languages), and stretches from below the page header to the bottom of the page. Add ribbon / no ribbon

  • The details pane has a fixed width.

Default State

  • The default state of the details pane will be determined for each application separately.

Content

  • The content area may contain any combination of text, lists, cards, tables, forms, graphs, links etc.

  • The content area may contain multiple items (for example, cards).

Examples

States

State

Description

Example

Expanded

Collapsed

  • In case the details pane is not pinned the only visible part will be a narrow bar with an arrow pointing to the left.

  • Mouseover the bar will reveal the details pane with a sliding effect, in overlay mode (hiding the content behind it.

Empty State

In case no items are selected, the details pane can present an empty state with guiding text or actions, and/or page summary.

(Rotem Avidan (Unlicensed) please update the empty state here)

Loading

While details pane content is loading a corresponding animation will be presented.

The Collapse/Expand bar

State

Collapsed details pane

Expanded details pane

Hover

Interaction

  • Clicking the pin icon switches the icon between pinned and unpinned states.

  • When unpinned, the content of the page stretches to its full width, being partially hidden by the content panel. In this case:

    • Clicking anywhere on the bar opens the details pane in an overlay, hiding the content behind it.

    • When pinned, the content of the page narrows to be shown next to the panel, so nothing is hidden.

Validations and Errors

  • The details pane itself does not require special validations.

  • For validations and errors related to content, see Field Validation.

Transitions

  • When the details pane is expanded from collapsed mode, the transition will slide from right to left.

  • When the details pane is collapsed, the transition will slide from left to right.

Best practices

Use:

  • Where there is a lot of information related to items that need to be displayed.

  • Where there is a need to perform actions on sub-elements of items (e.g. cards).

Don’t use:

Accessibility Compliance

Unless otherwise specified, see our general compliance information in Fundamentals - Accessibility.

Design

See some examples below:

Code

  • No labels