Liferay.Design / Lexicon
/
Get StartedResources
Part of Liferay, IncCode/Content Licenses

Management Toolbar

Sign In
LIFERAY DXP

Management toolbar is an extension of Toolbar. It is a combination of different components, including filters, orders, search, visualization select, and other actions that let users manage a dataset.

Warning This component is deprecated in Lexicon, now it's a DXP responsibility

state one of the management bar

state two of the management bar

Note: The management toolbar doesn't have gray borders. They are just used in the examples on this page to show its height.

Usage

The Management Toolbar is always part of a bigger structure that works along with other data management patterns such as tables, lists, or card. Its functionality is directly related to them.

The Management Toolbar has two main states:

State 1

It is the default state.

It displays tools focused on filtering, sorting, and data visualization.

state one of the management toolbar with points to explain the different components inside it

  1. Checkbox: selects all elements on the current page
  2. Filter and Order: dropdown with dropdown menu associated. See dropdown with groups for more information.
  3. Sort toggle button: The arrow identifies the sorting order, depending on the selected option inside the Filter and Order dropdown. The main attribute, usually the name, states the default sort parameter.
  4. Search bar to filter out the current dataset
  5. Info toggle button: displays/hides the info panel.
  6. Visualization button to select the desired visualization
  7. Plus button to add content and folders into the dataset

State 2

It displays contextual tools when one or more items are selected. Only the specific actions that the selected dataset allows are displayed.

The background color changes to reflect the change of state.

state two of the management bar with points to explain the different components inside it

  1. Checkbox: To select all elements in the current page
  2. Counter: Selected elements counter
  3. Select all: To select all elements in the dataset
  4. Quick actions: set of quick actions with a visual representation
  5. Actions menu: on interaction, displays a dropdown menu with all the actions that can be applied over the selected dataset.

Requirements

  • The Management Toolbar has to be fixed to the page header so it can always be visible during the vertical scroll.
  • In the default state of the toolbar, filter and order tools always have to be on the left side, and visualization and information tools have to be on the right side.
  • In the second state, the tools for selected items always appear on the right side of the toolbar and vary according to the items selected.
  • The Management Toolbar only displays the tools that the type of data displayed requires for a specific context.
  • A user can only sort and filter by the elements that are visible in the current visualization.

Examples

Selection

The Management Toolbar follows these rules for selection:

  • State 1: A click on the checkbox, off state, selects all the elements on the current page.
  • State 1 and 2: The checkbox is marked with a dash when only some of the items are selected in the whole dataset.
  • State 2: Even if only some of the items are selected, clicking the checkbox selects all elements on the page.
  • State 2: There is a "Select all" that selects all elements in the dataset.
  • State 2: Unselecting the checkbox deselects all selected items in the dataset.

Filter and order

A dropdown button triggers the dropdown menu with groups. This configuration keeps the Management Toolbar organized by collapsing options into collapsible menus.

dropdown menu displayed from filter and order dropdown button to filter and sort

Filter by: used to filter elements from the dataset.

Order by: used to order the dataset by one of the available attributes. If there is no possible order or only one order available, this section must not appear.

Group by: used to group the dataset in different ways. A title and a data provider with the different classification terms per each criteria must be provided. If there is no criteria to group by or there is only one criteria, this section must not appear.

Filters are reflected in the results bar. This bar includes a label for each filter that is applied.

state after applying filters

Changing Views

The icon button lets the user change visualization between tables, lists, and cards.

dropdown menu displayed from change view button dropdown button to change view

This button must not appear if there is only one possible visualization.

When a management Toolbar contains a search field, and it is used to filter elements, a thing stripe is displayed, informing the user of the total results. This can be combined with filters.

state one after typing

Layout Variations

The functionalities that are not required disappear. The Search field expands to fill the remaining space, as shown below.

This example displays all the features:

state one of the management bar

There may be cases where selection or filters are not required. In these cases, you can remove the elements from the Management Toolbar that you don't need. In this example, we only need the search field, a button to change visualizations, and the plus button to add elements into the dataset.

state three without selection checkbox filter and order

You may not require the visualizations and the plus buttons. In this case, you can remove these options, as shown in the layout below:

state four without view change and plus button

Having the management toolbar only configured with the search field is the minimum possible configuration.

state five only with search field

Last but not least, a very common case, and aforementioned in the View Case section, is to go without the visualizations button:

state six without view change

Mobile

State 1

On mobile devices, all actions are transformed into icons to conserve space and condense the toolbar to only one line. This provides more space for content, rather than tools.

state one of the management bar mobile

State 2

In contrast to the desktop version, no actions are available outside of the actions menu.

state two of the management bar mobile

Search

The magnifying glass icon triggers the Management Toolbar to switch to the search state. The search field expands to the width of the whole bar to provide the best user experience.

state two of the management bar mobile

Search results

Tap the entry in the search field to view the results. The Management Toolbar returns to state 1 with a summary of the results found.

state two of the management bar mobile

Mobile Layout Variations

The search field grows to fill the remaining space leftover from features that were removed from the Management Toolbar.

The example below displays all the features:

state one of the management bar mobile

This example only includes the options to change the view mode and add new elements:

state three of the management bar mobile without selection filter and order

This example includes the options for selection, filter, and order:

state four of the management bar mobile without view change and plus button

The dataset display in this case, only allows users to Search.

state five of the management bar mobile only with the search field

The most common configuration includes all options, except the ability to change the view.

state six of the management bar mobile without change view

Note: The management toolbar doesn't have gray borders. They are just used in the examples on this page to show its height.

Something to improve? Report an issue!
Menu