Lead:  Liav Nadler   

Description

A tree Tree table is a type of data table, Data Table where each row can be expanded to reveal related child rows.

Image Removed

Basic Flow

<< Relevant only for patterns that have a more complex flow than the typical control (e.g. drag & drop) >> 

Usage & Behaviour

<< Use a visual for each sub-section >>

General guidelines

<< Describes the component, use sub-section when they are relevant to the components >>

<< In case of a complex component duplicate this section, describing each sub-component separately >>

Structure

• A description of the structure of the component, including areas, sub-components etc.

Placement and Positioning

• For example, in popups and toast messages

Default State

• When there is more than one state for a control or area

Content

• Including labels, microcopy, number of items, order of items, default values etc.

Internal Logic

• For example, controls dependencies in a form

States

<<e.g. active disabled, error, hover, temporary (spinner size), empty etc...>>

Interaction

<<for example, how to change a value – type, arrows, use slider>>

<<use Click target to describe the interaction>>

Validations and errors

<<used for specific components e.g. slider>>

Transitions

<<Used to describe transitions or animations the occurs in any of the interaction stages>>

Best practices

<<e.g. Slider should display a label its on>>

Accessibility compliance

<<In general each component should be A11y complied,  please follow the 3 guidelines linked below. At the very least we should document that each component is in compliance with each of the 3>>

Focus management

<<How will the component work with keyboard only - without a mouse. Can be reference if written above

We already set a general guidelines described in /wiki/spaces/UX/pages/308969693 >>

Screen reader support 

<<Make sure the components support screen reader for content or behaviour where needed - see /wiki/spaces/UX/pages/308248620 >>

Contrast & size compliance

...

Usage & Behavior

A tree table is similar to a standard Data Table, with these exceptions:

• The first column of the table:

  • cannot be moved.

  • contains triangle icons on each row, allowing the user to expand and collapse them.

• The first row will be expanded by default, unless otherwise specified.

• Expanding a row will reveal at least one child row.

• On child rows:

  • the text of the first column will be indented in relation to parent rows.

  • all other cells may be similar to the parent rows, or may be blank (if the child row does not share the same values).

• If the table has a checkboxes column, clicking a parent checkbox will check all child checkboxes. For more information see Checkboxes.

• Table rows may be draggable. For more information see /wiki/spaces/~347593403/pages/918783940.

• Child rows will have a predefined order.

• Sorting any column will sort only the parent rows, keeping child rows intact (including the collapse / expand state).

Best Practices

Use for presenting hierarchical data.

Accessibility compliance

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

Design

Code

...

https://zpl.io/2pEq6rV

Image Added

Code

...