Generally, an alert displays a prominent message at the top of the screen. It could be used to promote a new feature or provide action-based feedback messages. Theyâ€™re persistent and nonmodal, allowing the user to either ignore them or interact with them at any time.

Alert

Avatars are used to show a thumbnail representation of an individual or business in the interface.

Avatar

The Badge component is a visual indicator for numeric values such as tallies and scores.

Badge

A breadcrumb displays the current location within a hierarchy. It allows going back to states higher up in the hierarchy.

Breadcrumbs

Buttons are used to initialize an action. Button labels express what action will occur when the user interacts with it.

Button

Cards are used to group information about subjects and their related actions. Cards can include images, text, buttons, links, and data visualizations.

Card

Checkbox are used when there are multiple items to select in a list. Users can select zero, one, or any number of items.

Checkbox

Similar to the Select (Dropdown) but allowing the user to edit the input field in order to sort through the list of options.

Combobox

A Date Picker is a text input to capture a date. You can select a single date, date range or date and time.

Date Picker

This component is used for presenting various empty states, such as no items, empty search, broken link, welcome screen, etc. They are most commonly seen the first time a user interacts with a product or page, but can be used when data has been deleted or is unavailable. An empty state is an opportunity to engage and delight users adding an actionable button.

Empty State

The File Uploader allows a user to transfer a file or submit content of their own.

File Uploader

Links are used as navigational elements. They may appear on their own, within a sentence or paragraph, or directly following the content.

Link

Pagination is used for splitting up content or data into several pages, with a control for navigating to the next or previous page.

Pagination

The Popover component displays floating informative and actionable content in relation to a target. Popovers appear either at the top, bottom, left, or right of their target.

Popover

A Progress Bar is a linear indicator for providing feedback about an ongoing, user-initiated process.

Progress Bar

Use Radio to select a single option from a list. Radio should be used instead of checkboxes if only one item can be selected from a list.

Radio

Search enables users to specify a word or a phrase to find relevant pieces of content or filter a long list of elements. Commonly represented as a Text Input with a little magnifying glass inside of it.

Search

This component could be thought of as a styled native select tag, but adding to it more functionalities such as filtering, multi selecting, among others. The source of the Select (Dropdown) is a list of options that the user can choose from and apply to an input field to later be submitted.

Select

Skeleton provides a low fidelity representation of the user interface to visually communicate that content is in the process of loading. Some studies indicate that Skeletons can reduce the user's perceived loading time.

Skeleton

A Spinner is an outline of a circle which animates around itself indicating to the user that things are processing. Use a Spinner when the content to be loaded is unknown or unpredictable.

Spinner

A stepper is a visual representation of a user’s progress through a set of steps, indicating how much the user has completed or how far they are from completing a task.

Stepper

Switch represents a physical switch that allows users to turn things on or off, where choosing an option results in an immediate action.

Switch

Table is a container for displaying data efficiently. Usually, it allows users to sort, search, paginate, filter data, and take action on large amounts of data.

Table

A text input is a field that allows a user to write or edit text.

Text Input

A multi-line text input component, used for longer texts in form fields. A Textarea lets users enter long form text which spans over multiple lines.

Textarea

Toasts are shown as a floating box typically in the top right of the page. They can optionally be displayed on other edges of the screen (top-left, bottom-left, etc). Toasts provide limited space for content, and therefore the content must be short and concise, providing immediate feedback in response to a user action or informing users of a process that the app has performed or will perform.

Toast

A tooltip is a floating, non-actionable label used to explain a user interface element or feature.

Tooltip

Pajamas is here to make it as comfortable as possible for anyone to contribute towards GitLab. You will find information such as our principles, components, usage guidelines, branding, research methodologies, and more!