Mirakl Design
Mirakl Design
  • Getting started
    • Welcome to Roma
      • Design principles
  • Design
    • Components
      • Actions
        • Action menu
        • Buttons
        • Button group
        • File download
        • Save bar
        • Tasklist
        • Contextual Toolbar
      • Datalist
      • Datatable
      • Feedback
        • Alerts
        • Activity Loader
        • Badge (status)
        • Empty state
        • Snackbar
      • Form
        • Fields
        • Pickers
        • Selection controls
        • Tree
      • Images
        • Illustrations
        • Icons
        • Media
      • Navigation
        • Hyperlink
        • Page title
        • Sidebar
        • Top bar
      • Overlays
        • Modal
        • Popover
        • Tooltip
        • Side Drawer
      • Structure
        • Global layout
        • Panel
          • Activable Panel
          • Clickable Panel
          • Expandable Panel
          • Panel tabs
          • Totalizer Panel
        • Card
    • Patterns
      • Advanced selection
      • Configure options
      • Displaying data
      • Displaying history
      • Errors
      • Forms
        • Form - Creation mode
        • Form - Edition mode
        • Form - In a modal
        • Error Management
        • Stepper form
        • Onboarding form
      • Loading
      • Progressive disclosure
  • content
    • Writing for Mirakl
      • Grammar and formatting
    • Vocabulary
      • Mirakl products
      • Which verb to use
Powered by GitBook
On this page
  • Overview
  • Guidelines
  • When to use
  • When not to use
  • Selection types
  • Accessibility

Was this helpful?

  1. Design
  2. Components
  3. Form

Tree

A tree helps showcase data in a hierarchical way, either for selection or navigation.

Last updated 1 year ago

Was this helpful?

Overview

The tree component helps users navigate large amounts of data and potentially select some thanks to a clear hierarchy. Like a regular tree, the component has a root and can have branches that can be collapsed or expanded, and leaves.

At Mirakl, we use the tree component to showcase catalog categories, for example.

Guidelines

Tree items are sorted alphabetically, with priority given to branches arranged alphabetically, then to leaves arranged alphabetically.

It is possible to add extra information next to the root, branch, or leaf label, like a settings code or a number (e.g. number of products within a category). You may also add an icon.

In terms of loading, each brand has its own loader if it has lots of items. A loading icon will appear when this happens.

When to use

  • When navigating large amounts of data organized in a logical order.

When not to use

  • For primary navigation on a page.

  • For simpler information structures. Radio group or checkbox group instead.

Selection types

Roma offers 4 different selection types.

  • Simple allows for a single value to be selected at a time.

  • Navigation allows for a single value to be selected at a time but without showing the radio button.

  • Multiple allows for multiple selections with heritage. Selecting a branch will automatically select all its leaf children.

  • Multiple without heritage allows for multiple selections without heritage. Selecting a branch will only select the branch as if it were a leaf. To select a branch and its children, you can use the Select all button available when hovering over a branch.

It is not possible to split your tree with separators.

The tree selection icon will change depending on your selection type.

Accessibility

Tree offers keyboard navigation for accessibility purposes.

The tree root helps gives users a reference point so that they understand that they're at the right place. It is optional and can be selected by users.

Learn more about selection types
Tree in navigation mode
The 4 selection types