Customization

The following table lists the available variables for customizing the Material theme.

Variables

Common

Name Type Default value Computed value
$border-radius 2px 2px
Description
Border radius for all components.
$base-bg map-get( $theme, base-bg ) map-get( $theme, base-bg )
Description
The background of the components' chrome area.
$base-text map-get($theme, component-text) map-get($theme, component-text)
Description
The text color of the components' chrome area.
$base-border rgba( if($theme-type == dark, white, black), .08 ) rgba( if($theme-type == dark, white, black), .08 )
Description
The border of the components' chrome area.
$base-gradient null null
Description
The gradient background of the components' chrome area.
$hovered-bg map-get( $theme, hover-bg ) map-get( $theme, hover-bg )
Description
The background of hovered items.
$hovered-text $base-text map-get($theme, component-text)
Description
The text color of hovered items.
$hovered-border rgba( if($theme-type == dark, white, black), .15 ) rgba( if($theme-type == dark, white, black), .15 )
Description
The border color of hovered items.
$hovered-gradient null null
Description
The gradient background of hovered items.
$selected-bg $secondary material-color( $secondary-palette, default )
Description
The background of selected items.
$selected-text $secondary-contrast material-color( $secondary-palette, default-contrast )
Description
The text color of selected items.
$selected-border rgba( if($theme-type == dark, white, black), .1 ) rgba( if($theme-type == dark, white, black), .1 )
Description
The border color of selected items.
$selected-gradient null null
Description
The gradient background of selected items.

Buttons

Name Type Default value Computed value
$button-bg $base-bg map-get( $theme, base-bg )
Description
The background of the buttons.
$button-text $base-text map-get($theme, component-text)
Description
The text color of the buttons.
$button-border $button-bg map-get( $theme, base-bg )
Description
The border color of the buttons.
$button-gradient null null
Description
The background gradient of the buttons.
$button-hovered-bg true-mix( $button-text, $button-bg, 12%) true-mix( $button-text, $button-bg, 12%)
Description
The background of hovered buttons.
$button-hovered-text null null
Description
The text color of hovered buttons.
$button-hovered-border $button-hovered-bg true-mix( $button-text, $button-bg, 12%)
Description
The border color of hovered buttons.
$button-hovered-gradient null null
Description
The background gradient of hovered buttons.
$button-pressed-bg true-mix( $button-text, $button-bg, 12%) true-mix( $button-text, $button-bg, 12%)
Description
The background color of pressed buttons.
$button-pressed-text null null
Description
The text color of pressed buttons.
$button-pressed-border $button-pressed-bg true-mix( $button-text, $button-bg, 12%)
Description
The border color of pressed buttons.
$button-pressed-gradient null null
Description
The background gradient of pressed buttons.
$button-focused-shadow null null
Description
The shadow of focused buttons.

Charts

Name Type Default value Computed value
$series-a #3f51b5 #3f51b5
Description
The color of the first series.
$series-b #2196f3 #2196f3
Description
The clor of the second series.
$series-c #43a047 #43a047
Description
The color of the third series.
$series-d #ffc107 #ffc107
Description
The color of the fourth series.
$series-e #ff5722 #ff5722
Description
The color of the fifth series.
$series-f #e91e63 #e91e63
Description
The color of the sixth series.
$chart-major-lines rgba(0, 0, 0, .08) rgba(0, 0, 0, .08)
Description
The color of the Chart grid lines (major).
$chart-minor-lines rgba(0, 0, 0, .04) rgba(0, 0, 0, .04)
Description
The color of the Chart grid lines (minor).

Color System

Name Type Default value Computed value
$primary Color material-color( $primary-palette, default ) material-color( $primary-palette, default )
Description
The color that focuses the user attention.
Used for primary buttons and for elements of primary importance across the theme.
$primary-contrast Color material-color( $primary-palette, default-contrast ) material-color( $primary-palette, default-contrast )
Description
The color used along with the primary color denoted by $primary.
Used to provide contrast between the background and foreground colors.
$secondary Color material-color( $secondary-palette, default ) material-color( $secondary-palette, default )
Description
The secondary color of the theme.
$secondary-contrast Color material-color( $secondary-palette, default-contrast ) material-color( $secondary-palette, default-contrast )
Description
The color used along with the secondary color denoted by $secondary.
Used to provide contrast between the background and foreground colors.
$tertiary Color material-color($tertiary-palette, default) material-color($tertiary-palette, default)
Description
The tertiary color of the theme.
$tertiary-contrast Color material-color($tertiary-palette, default-contrast) material-color($tertiary-palette, default-contrast)
Description
The color used along with the tertiary color denoted by $tertiary.
Used to provide contrast between the background and foreground colors.
$info Color #0058e9 #0058e9
Description
The color for informational messages and states.
$success Color #37b400 #37b400
Description
The color for success messages and states.
$warning Color #ffc000 #ffc000
Description
The color for warning messages and states.
$error Color #f31700 #f31700
Description
The color for error messages and states.
$dark Color get-base-hue( grey, 800 ) get-base-hue( grey, 800 )
Description
The dark color of the theme.
$light Color get-base-hue( grey, 100 ) get-base-hue( grey, 100 )
Description
The light color of the theme.
$inverse if( $is-dark-theme, $light, $dark ) if( $is-dark-theme, $light, $dark )
Description
Inverse color of the theme. Depending on the theme luminance dark or lught, it will be light or dark

Component

Name Type Default value Computed value
$component-bg map-get($theme, component-bg) map-get($theme, component-bg)
Description
Background color of a component.
Note: do not use this variable directly. Instead derive it as `$component-name-bg` e.g. `$grid-bg: $component-bg !defualt;`.
$component-text map-get($theme, component-text) map-get($theme, component-text)
Description
Text color of a component.
Note: do not use this variable directly. Instead derive it as `$component-name-text` e.g. `$grid-text: component-text !default;`.
$component-border map-get($theme, component-border) map-get($theme, component-border)
Description
Border color of a component.
Note: do not use this variable directly. Instead derive it as `$component-name-border` e.g. `$grid-border: component-border !default;`.
$widget-bg $component-bg map-get($theme, component-bg)
Deprecated
Will be removed in v5. Use `$component-bg` variable instead.
Description
Background color of a component.
$widget-text $component-text map-get($theme, component-text)
Deprecated
Will be removed in v5. Use `$component-text` variable instead.
Description
Text color of a component.
$widget-border $component-border map-get($theme, component-border)
Deprecated
Will be removed in v5. Use `$component-border` variable instead.
Description
Border color of a component.

Grid

Name Type Default value Computed value
$grid-bg $component-bg map-get($theme, component-bg)
Description
Background color of the grid component
$grid-text $component-text map-get($theme, component-text)
Description
Text color of the grid component
$grid-border $component-border map-get($theme, component-border)
Description
Border color of the grid component
$grid-header-bg transparent transparent
Description
Background color of grid header
$grid-header-text if($theme-type == dark, $light-secondary-text, $dark-secondary-text) if($theme-type == dark, $light-secondary-text, $dark-secondary-text)
Description
Background color of grid header
$grid-header-border $grid-border map-get($theme, component-border)
Description
Border color of grid header
$grid-header-gradient null null
Description
Background gradient of grid header
$grid-alt-bg transparent transparent
Description
Background color of alternating rows in grid
$grid-alt-text null null
Description
Text color of alternating rows in grid
$grid-alt-border null null
Description
Text color of alternating rows in grid
$grid-hovered-bg rgba( contrast-wcag( $grid-bg ), .07 ) rgba( contrast-wcag( $grid-bg ), .07 )
Description
Background color of hovered rows in grid
$grid-hovered-text $grid-text map-get($theme, component-text)
Description
Text color of hovered rows in grid
$grid-hovered-border $grid-border map-get($theme, component-border)
Description
Border color of hovered rows in grid
$grid-selected-bg rgba( contrast-wcag( $grid-bg ), .04 ) rgba( contrast-wcag( $grid-bg ), .04 )
Description
Background color of selected rows in grid
$grid-selected-text #000000 #000000
Description
Text color of selected rows in grid
$grid-selected-border $grid-border map-get($theme, component-border)
Description
Border color of selected rows in grid

Icons

Name Type Default value Computed value
$icon-font-url null null
Description
The URL to the icon font that will be used by the theme
The default value of `null` embeds the package font with a `data:` URL

Shadows

Name Type Default value Computed value
$elevation map-get( $theme, elevation ) map-get( $theme, elevation )
Description
Color of shadows
$box-shadow-depth-1 0 2px 1px -1px rgba( $elevation, .2 ), 0 1px 1px 0 rgba( $elevation, .14 ), 0 1px 3px 0 rgba( $elevation, .12 ) 0 2px 1px -1px rgba( $elevation, .2 ), 0 1px 1px 0 rgba( $elevation, .14 ), 0 1px 3px 0 rgba( $elevation, .12 )
Description
Shadow for switch.
Equivalent to material elevation 1.
$box-shadow-depth-2 0 3px 1px -2px rgba( $elevation, .2 ), 0 2px 2px 0 rgba( $elevation, .14 ), 0 1px 5px 0 rgba( $elevation, .12 ) 0 3px 1px -2px rgba( $elevation, .2 ), 0 2px 2px 0 rgba( $elevation, .14 ), 0 1px 5px 0 rgba( $elevation, .12 )
Description
Shadow for resting state of button, card and other widgets.
Equivalent to material elevation 2.
$box-shadow-depth-3 0 5px 5px -3px rgba( $elevation, .2 ), 0 8px 10px 1px rgba( $elevation, .14 ), 0 3px 14px 2px rgba( $elevation, .12 ) 0 5px 5px -3px rgba( $elevation, .2 ), 0 8px 10px 1px rgba( $elevation, .14 ), 0 3px 14px 2px rgba( $elevation, .12 )
Description
Shadow for menu, popups and raised state of button and card.
Equivalent to material elevation 8.
$box-shadow-depth-4 0 8px 10px -5px rgba( $elevation, .2 ), 0 16px 24px 2px rgba( $elevation, .14 ), 0 6px 30px 5px rgba( $elevation, .12 ) 0 8px 10px -5px rgba( $elevation, .2 ), 0 16px 24px 2px rgba( $elevation, .14 ), 0 6px 30px 5px rgba( $elevation, .12 )
Description
Shadow for drawers and other overlaying elements.
Equivalent to material elevation 16.
$box-shadow-depth-5 0 11px 15px -7px rgba( $elevation, .2 ), 0 24px 38px 3px rgba( $elevation, .14 ), 0 9px 46px 8px rgba( $elevation, .12 ) 0 11px 15px -7px rgba( $elevation, .2 ), 0 24px 38px 3px rgba( $elevation, .14 ), 0 9px 46px 8px rgba( $elevation, .12 )
Description
Shadow for window and dialog.
Equivalent to material elevation 24.

Tabstrip

Name Type Default value Computed value
$button-border-width 0px 0px
Description
Width of border around buttons
$button-border-radius $border-radius 2px
Description
Border radius of buttons
$button-padding-x $padding-x
Description
Horizontal padding of buttons
$button-padding-y 8px 8px
Description
Vertical padding of buttons
$tabstrip-bg null null
Description
Background color of tabstrip component
$tabstrip-text inherit inherit
Description
Text color of tabstrip component
$tabstrip-border $component-border map-get($theme, component-border)
Description
Border color of tabstrip component
$tabstrip-item-padding-x 24px 24px
Description
Horizontal padding of tabs
$tabstrip-item-padding-y 14px 14px
Description
Vertical padding of tabs
$tabstrip-item-border-width 0px 0px
Description
Width of border around of tabs
$tabstrip-item-border-radius 0px 0px
Description
Border radius of tabs
$tabstrip-item-gap 0px 0px
Description
Spacing between tabs
$tabstrip-item-bg null null
Description
Background color of tabs
$tabstrip-item-text inherit inherit
Description
Text color of tabs
$tabstrip-item-border null null
Description
Border color of tabs
$tabstrip-item-gradient null null
Description
Background gradient of tabs
$tabstrip-item-hovered-bg null null
Description
Background color of hovered tabs
$tabstrip-item-hovered-text inherit inherit
Description
Text color of hovered tabs
$tabstrip-item-hovered-border null null
Description
Border color of hovered tabs
$tabstrip-item-hovered-gradient null null
Description
Background gradent of hovered tabs
$tabstrip-item-selected-bg null null
Description
Background color of selected tabs
$tabstrip-item-selected-text inherit inherit
Description
Text color of selected tabs
$tabstrip-item-selected-border null null
Description
Border color of selected tabs
$tabstrip-item-selected-gradient null null
Description
Background gradient of selected tabs
$tabstrip-content-padding-x $tabstrip-item-padding-x 24px
Description
Horizontal padding of tabstrip content
$tabstrip-content-padding-y $tabstrip-item-padding-y 14px
Description
Vertical padding of tabstrip content
$tabstrip-content-border-width 0px 0px
Description
Width of border around tabstrip content
$tabstrip-content-bg transparent transparent
Description
Background color of tabstrip content
$tabstrip-content-text inherit inherit
Description
Text color of tabstrip content
$tabstrip-content-border transparent transparent
Description
Border color of tabstrip content

Toolbar

Name Type Default value Computed value
$toolbar-padding-x 0px 0px
Description
The horizontal padding of the container.
$toolbar-padding-y 0px 0px
Description
The vertical padding of the container.

Typography

Name Type Default value Computed value
$font-size 14px 14px
Description
Base font size across all components.
$font-family Roboto, "Helvetica Neue", sans-serif Roboto, "Helvetica Neue", sans-serif
Description
Font family across all components.
$font-family-monospace Consolas, "Ubuntu Mono", "Lucida Console", "Courier New", monospace Consolas, "Ubuntu Mono", "Lucida Console", "Courier New", monospace
Description
Font family for monospaced text. Used for styling the code.
$line-height (28 / 14) (28 / 14)
Description
Line height used along with $font-size.

Mixins

In this article