Skip to Content
Which part for what

Overview

The part to use for each thing a view shows.

Build every view from these parts. Views then look and behave alike, however many teams or modules write them.

Do not restyle a part for one view. If a part lacks something, add a variant to it.

Sizes are the tokens in src/styles/tokens.css: --control-*, --row-*, --header, --space-* and --radius-*. On a phone each part takes the phone scale by itself, see Phones.

You are showingUsePage
The frame of a viewViewLayout, ViewHeaderViews
A box of contentCardViews
A tool region with a headerPanelViews
The heading of a sectionSectionHeadingViews
A list of thingsRowList and ListRowLists
Records in lanesBoard, BoardLane, BoardCardRecords
A table of recordsDataTableRecords
Records edited in placeDataListRecords
An actionButtonActions
An action shown as an iconIconButtonActions
Text edited in placeInlineFieldForms
A form fieldTextField, TextArea, Select, Switch, SchemaFormForms
A numberNumberFieldForms
A bounded value, roughlySlider, RangeSliderForms
Label and value pairsPropertyListForms
Search and filtersFilterBarFilters
Filters over the fields of a listQueryBuilderFilters
The state of an itemStateStatus
A kind, category or countBadge, LabelChip, CountStatus
Facts about an itemMetaLineStatus
Nothing to showEmptyStateStatus
Text that may not fitTruncateStatus
A figureStat, StatCardFigures
A live valueWidgetFigures
A page of widgetsWidgetGridFigures
A conversation with the assistantChatMessage, ComposerConversation and code
Code and changesCodeBlock, DiffViewConversation and code

The rules for focus, contrast, colour and spacing hold for every part. See Focus, Colour and Sizes.

A view: sidebar, header, main column and panelViewLayout lays out the view's own navigation, its main column and a secondary panel; ViewHeader holds crumbs and actions in one order. Drag the edge of the sidebar or the panel to resize it, and click an edge or a header toggle to hide or show it; opened by hand, a column docks beside the main column while the main column keeps 360px, and opens over it only below that. In the shell, Alt B and Alt Shift B toggle them.
Open the example ↗
Edit on GitHub

Last updated on