Design properties

Appearance, fit, and variant are three core properties in the Maersk Design System.

Appearance

“Appearance” is a cross-layer concept referring to the colour scheme applied to an entity.

Token-level appearance

The brand scheme context defined in design tokens, typically light or dark themes.

Brand: light appearance
Brand: dark appearance

Component-level appearance

Typically the semantic colour role expressed by a component, such as primary, secondary, error, success. It is not always a 1-to-1 relationship with colour role names, for example “inverse” and “default”.

Notification: info notification
Notification: warning appearance
Notification: success appearance
Button: primary appearance
Button: inverse appearance
Button: error appearance

Supported components

ComponentValues
mc-avatarcolor-1, color-2, color-3, color-4
mc-badgeinfo, success, warning, error
mc-buttonprimary, secondary, neutral, inverse, error
mc-code-previewdefault, inverse
mc-link-buttonprimary, secondary, neutral, inverse, error
mc-loading-indicatorprimary, neutral-inverse
mc-notificationneutral-weak, info, success, warning, error
mc-progress-indicatorprimary, neutral-inverse, success, warning, error
mc-split-buttonprimary, secondary, neutral, inverse, error
mc-step-indicator-itemdefault, warning, error
mc-tagneutral-default, neutral-weak, neutral-inverse, info, success, warning, error
mc-toastneutral-default, neutral-inverse, info, success, warning, error
mc-toolbardefault, inverse
mc-tooltipneutral-default, neutral-inverse

Fit

Components use a property called “fit” to control their sizing. Most components support three fit values: “small”, “medium”, and “large”. Fit determines a number of size-related properties including height, padding, border radius and typographic scale.

Small fit button
Medium fit button
Large fit button

Supported components

ComponentValues
mc-accordionsmall, medium, large
mc-accordion-itemsmall, medium, large
mc-avatarx-small, small, medium, large, x-large, xx-large
mc-badgesmall, medium
mc-buttonsmall, medium, large
mc-button-groupsmall, medium, large
mc-button-group-itemsmall, medium, large
mc-cardsmall, medium, large
mc-checkboxsmall, medium, large
mc-checkbox-groupsmall, medium, large
mc-code-previewsmall, medium
mc-date-rangesmall, medium, large
mc-dialogsmall, medium
mc-drawersmall, medium
mc-errorsmall, medium, large
mc-file-uploadsmall, medium, large
mc-hintsmall, medium, large
mc-inputsmall, medium, large
mc-input-datesmall, medium, large
mc-input-groupsmall, medium, large
mc-input-timesmall, medium, large
mc-labelsmall, medium, large
mc-link-buttonsmall, medium, large
mc-listsmall, medium, large
mc-list-itemsmall, medium, large
mc-loading-indicatorsmall, medium, large
mc-menusmall, medium, large
mc-modalsmall, medium
mc-multi-choice-fieldsetsmall, medium, large
mc-multi-selectsmall, medium, large
mc-notificationsmall, medium, large
mc-number-steppersmall, medium, large
mc-optionsmall, medium, large
mc-pickersmall, medium, large
mc-picker-itemsmall, medium, large
mc-popoversmall, medium, large
mc-progress-indicatorsmall, medium, large
mc-radiosmall, medium, large
mc-radio-groupsmall, medium, large
mc-segmented-controlsmall, medium, large
mc-segmented-control-itemsmall, medium, large
mc-selectsmall, medium, large
mc-select-nativesmall, medium, large
mc-split-buttonsmall, medium, large
mc-step-indicatorsmall, medium, large, x-large
mc-step-indicator-itemsmall, medium, large, x-large
mc-switchsmall, medium, large
mc-switch-groupsmall, medium, large
mc-tabsmall, medium, large
mc-tab-barsmall, medium, large
mc-tablesmall, medium, large
mc-tagsmall, medium, large
mc-text-and-iconsmall, medium, large
mc-textareasmall, medium, large
mc-theme-switchsmall, medium, large
mc-time-pickersmall, medium, large
mc-toastsmall, medium, large
mc-toolbarsmall, medium, large
mc-tooltipsmall, medium, large
mc-typeaheadsmall, medium, large
mc-typeahead-multi-selectsmall, medium, large

Variant

Variant changes visual composition (independent of colour) and, in some components, interaction pattern. Common values include “filled”, “outlined”, “plain”, “bordered” and “borderless”.

Split Button: filled variant
Split Button: outlined variant
Split Button: plain variant

Supported components

ComponentValues
mc-accordion-itemdefault, plain
mc-badgedefault, dot
mc-buttonfilled, outlined, plain
mc-button-groupbordered, borderless, rounded
mc-cardbordered, borderless
mc-code-previewtab-bar, select, none
mc-date-rangedefault, vanity
mc-file-uploaddefault, drag-drop
mc-inputdefault, vanity
mc-input-datedefault, vanity
mc-input-timedefault, vanity
mc-link-buttonfilled, outlined, plain
mc-loading-indicatorbar, ring
mc-multi-selectdefault, vanity
mc-progress-indicatorbar, ring
mc-selectdefault, vanity
mc-select-nativedefault, vanity, multiple
mc-split-buttonfilled, outlined, plain
mc-tab-bardefault, stretched
mc-typeaheaddefault, vanity
mc-typeahead-multi-selectdefault, vanity

See also