Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Lead:  Liav Nadler Asaf Ben-Oved  

Status
colourYellow
titleongoing

...

A filter pane is a panel located on the left side of a page, allowing users to filter the presented data set by a variety of parameters

...

State

Image

Comments

Regular

TBD

Hover

TBD

Selected

TBD

Only one tab can be selected at any given time

In Focus

TBD

Default State

  • By default no tabs are selected

...

  • The filter panel contains the following elements:

    • At the top:

      • A title, similar to the title on the filter bar

      • A pin icon, allowing the user to switch between pinned and unpinned states

      • A help icon (optional)

    • The area under the title is the main content area of the panel. See content below

    • The bottom of the panel may contain the following elements:

      • An Apply button:

        • The button is mandatory, unless the panel contains only one possible selection

        • The button is disabled until the content of the panel was changed

      • An indicator showing the number of selected items (e.g. 4 queues selected)

      • A Cancel button:

        • The button is disabled until the content of the panel was changed

      • A Reset button (TBD)

        • The button is disabled until the filter was applied

...

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

    • When pinned:

      • The content of the page is stretched to its full width

      • The panel closes, unless changes were made to the content before applying the filter. If changes were made the panel will stay open until changes are applied or cancelled

    • When unpinned:

      • The content of the page narrows to be shown next to the panel (so nothing is hidden)

  • Clicking the help icon opens a relevant help page in a new browser window

  • Changing the content of the panel enabled the Apply, the Cancel and the Reset buttons, if exists

  • Clicking the Apply button:

    • Applies the filter to the data set

    • Disables the Apply button

    • Enables the Reset button

    • Shows a blue indicator next to the relevant tab on the filter bar

    • If unpinned - closes the panel

    • When relevant - adds a chicklet to the chicklet area (see below)

  • Clicking the Cancelbutton:

    • Cancels any changes made to the content before hitting the Apply button

    • Disables the Apply and Cancel buttons

    • If unpinned - closes the panel

  • Clicking the Reset button:

    • Resets all fields in the filter to their initial state, either blanks or default values

    • At this point, the user can either:

      • Click the Apply button. In this case the

      • Clears the relevant filter

    • Removes the blue dot next to the relevant tab on the filter bar

    • Disables the Apply and Cancel buttons

    • If unpinned - closes the panel

  • Clicking outside the panel:

    • If no changes were made to the content and the panel is unpinned - closes the panel

    • If changes were made to the content but the filter was not applied, a dialog appears, allowing the user to either close the panel without applying the filter or continue editing

...

  • The filter pane will open and close with a brief slide effect

  • When pinning / unpinning the content will get wide / narrow with an effect

Best Practices

Opening a panel containing a form will set the focus to the first field of the form

...

  • Chicklets gives the user an indication that the data is currently filtered by one or more filters

  • There are two types of chicklets:

    • Pre-defined Mandatory- The user can change their value but cannot remove them (for example, when filtering by organization is mandatory)
      Deleting these chicklets will switch the data to empty state, instructing the user to apply all mandatory filters

    • Optional - the user can add, update and delete chicklets

...

State

Image

Comments

Regular

TBD

Hover

TBD

Selected

TBD

In Focus

TBD

Structure

  • The chicklet area stretched to the full width of its container

  • Each chicklet contains:

    • An icon, similar to the relevant icon on the filter bar

    • A label, showing the filter value (e.g. Last 24 hours). In case of multiple selection the chicklet will show the name of the filter, followed by the number of items in brackets (e.g. Interactions (3)). In this case, hovering the chicklet will show a tooltip with the list of items

    • A closing icon (x), allowing the user to remove the filter

...