title |
description |
Primer v16 Migration Guide |
Guide for migrating to version 16.0.0 of Primer |
Primer v16.0.0 introduces the idea of color modes and functional variables. A color mode defines a set of colors in the Primer system that differs from that of other color modes. Currently, Primer ships with a light mode and a dark mode.
Because colors differ in each color mode, it doesn't make sense to try to make an element a specific color; instead, Primer now applies colors based on the function of an element using functional variables. As a result, the Sass color variables that existed in Primer prior to version 16.0.0 have been replaced with functional CSS variables. These variables have different values depending on the current color mode. For a list of the new functional CSS color variables, see the color system page. The color utility classes have also been updated to match; see the color utilities page for more information.
Most components don't need to be updated and should work without making changes. But some of the componets that use presentational class names now use functional class names.
v15 |
v16 |
.Label--gray-darker |
.Label--primary |
.Label--gray |
.Label--secondary |
.Label--blue |
.Label--info |
.Label--green |
.Label--success |
.Label--yellow |
.Label--warning |
.Label--red |
.Label--danger |
.Label--orange |
n/a |
.Label--purple |
n/a |
.Label--pink |
n/a |
v15 |
v16 |
.Counter--gray |
.Counter--primary |
.Counter--gray-light |
.Counter--secondary |
v15 |
v16 |
n/a |
.State--draft |
.State--green |
.State--open |
.State--purple |
.State--merged |
.State--red |
.State--closed |
See the color utility classes page for a list of all the functional color utility classes.
v15 |
v16 |
.text-gray-dark |
.color-text-primary |
.text-gray |
.color-text-secondary |
.text-gray-light |
.color-text-tertiary |
.text-blue |
.color-text-link |
.text-green |
.color-text-success |
.text-yellow |
.color-text-warning |
.text-red |
.color-text-danger |
.text-white |
.color-text-white |
n/a |
.color-text-inverse |
.text-black |
n/a |
.text-orange |
n/a |
.text-orange-light |
n/a |
.text-purple |
n/a |
.text-pink |
n/a |
v15 |
v16 |
n/a |
.color-icon-primary |
n/a |
.color-icon-secondary |
n/a |
.color-icon-tertiary |
n/a |
.color-icon-info |
n/a |
.color-icon-success |
n/a |
.color-icon-warning |
n/a |
.color-icon-danger |
v15 |
v16 |
.border-gray |
.color-border-primary |
.border-gray-light |
.color-border-secondary |
.border-gray-dark |
.color-border-tertiary |
.border-blue |
.color-border-info |
.border-green |
.color-border-success |
.border-yellow |
.color-border-warning |
.border-red |
.color-border-danger |
.border-white |
.color-border-inverse |
.border-gray-darker |
n/a |
.border-blue-light |
n/a |
.border-red-light |
n/a |
.border-purple |
n/a |
.border-black-fade |
n/a |
.border-white-fade |
n/a |
.border-white-fade-15 |
n/a |
.border-white-fade-30 |
n/a |
.border-white-fade-50 |
n/a |
.border-white-fade-70 |
n/a |
.border-white-fade-85 |
n/a |
v15 |
v16 |
.bg-white |
.color-bg-primary |
.bg-gray-light |
.color-bg-secondary |
.bg-gray |
.color-bg-tertiary |
.bg-gray-dark |
.color-bg-canvas-inverse |
.bg-blue-light |
.color-bg-info |
.bg-blue |
.color-bg-info-inverse |
.bg-green-light |
.color-bg-success |
.bg-green |
.color-bg-success-inverse |
.bg-yellow-light |
.color-bg-warning |
.bg-yellow |
.color-bg-warning-inverse |
.bg-red-light |
.color-bg-danger |
.bg-red |
.color-bg-danger-inverse |
n/a |
.color-bg-canvas |
.bg-purple-light |
n/a |
.bg-purple |
n/a |
.bg-yellow-dark |
n/a |
.bg-orange |
n/a |
.bg-pink |
n/a |
v15 |
v16 |
.box-shadow |
.color-shadow-small |
.box-shadow-medium |
.color-shadow-medium |
.box-shadow-large |
.color-shadow-large |
.box-shadow-extra-large |
.color-shadow-extra-large |
The link
utilities are part of the Link
component.
v15 |
v16 |
.link-gray-dark |
.Link--primary |
.link-gray |
.Link--secondary |
.muted-link |
.Link--muted |
.link-hover-blue |
.Link--onHover |
n/a |
.Link |
See the color system page for a list of all the functional CSS variables.
v15 |
v16 |
$text-gray-dark ($gray-900 ) |
var(--color-text-primary) |
$text-gray ($gray-600 ) |
var(--color-text-secondary) |
$text-gray-light ($gray-500 ) |
var(--color-text-tertiary) |
$text-blue ($blue-500 ) |
var(--color-text-link) |
$text-green ($green-600 ) |
var(--color-text-success) |
$text-red ($red-600 ) |
var(--color-text-danger) |
$text-yellow ($yellow-800 ) |
var(--color-text-warning) |
$text-white ($white ) |
var(--color-text-white) |
n/a |
var(--color-text-inverse) |
n/a |
var(--color-text-placeholder) |
n/a |
var(--color-text-disabled) |
$text-black ($black ) |
n/a |
$text-orange ($orange-900 ) |
n/a |
$text-orange-light ($orange-600 ) |
n/a |
$text-purple ($purple-500 ) |
n/a |
$text-pink ($pink-500 ) |
n/a |
v15 |
v16 |
n/a |
var(--color-icon-primary) |
n/a |
var(--color-icon-secondary) |
n/a |
var(--color-icon-tertiary) |
n/a |
var(--color-icon-info) |
n/a |
var(--color-icon-danger) |
n/a |
var(--color-icon-success) |
n/a |
var(--color-icon-warning) |
v15 |
v16 |
$border-color ($gray-200 ) |
var(--color-border-primary) |
$border-gray ($gray-200 ) |
var(--color-border-primary) |
$border-gray-light (lighten($gray-200, 3%) ) |
var(--color-border-secondary) |
$border-gray-dark ($gray-300 ) |
var(--color-border-tertiary) |
$border-white ($white ) |
var(--color-border-inverse) |
$border-blue ($blue-500 ) |
var(--color-border-info) |
$border-green ($green-400 ) |
var(--color-border-success) |
$border-red ($red-500 ) |
var(--color-border-danger) |
$border-yellow ($yellow-600 ) |
var(--color-border-warning) |
$border-gray-darker ($gray-700 ) |
n/a |
$border-blue-light ($blue-200 ) |
n/a |
$border-red-light ($red-300 ) |
n/a |
$border-purple ($purple-500 ) |
n/a |
$border-black-fade ($black-fade-15 ) |
n/a |
$border-white-fade ($white-fade-15 ) |
n/a |
$border-green-light (desaturate($green-300, 40%) ) |
n/a |
v15 |
v16 |
$bg-white ($white ) |
var(--color-bg-primary) |
$bg-gray-light ($gray-000 ) |
var(--color-bg-secondary) |
$bg-gray ($gray-100 ) |
var(--color-bg-tertiary) |
$bg-gray-dark ($gray-900 ) |
var(--color-bg-canvas-inverse) |
$bg-red ($red-500 ) |
var(--color-bg-danger-inverse) |
$bg-red-light ($red-000 ) |
var(--color-bg-danger) |
$bg-green ($green-500 ) |
var(--color-bg-success-inverse) |
$bg-green-light ($green-100 ) |
var(--color-bg-success) |
$bg-blue ($blue-500 ) |
var(--color-bg-info-inverse) |
$bg-blue-light ($blue-000 ) |
var(--color-bg-info) |
$bg-yellow ($yellow-500 ) |
var(--color-bg-warning-inverse) |
$bg-yellow-light ($yellow-200 ) |
var(--color-bg-warning) |
n/a |
var(--color-bg-canvas) |
$bg-black ($black ) |
n/a |
$bg-black-fade ($black-fade-50 ) |
n/a |
$bg-orange ($orange-700 ) |
n/a |
$bg-purple ($purple-500 ) |
n/a |
$bg-purple-light ($purple-000 ) |
n/a |
$bg-pink ($pink-500 ) |
n/a |
$bg-yellow-dark ($yellow-700 ) |
n/a |
v15 |
v16 |
$box-shadow |
var(--color-shadow-small) |
$box-shadow-medium |
var(--color-shadow-medium) |
$box-shadow-large |
var(--color-shadow-large) |
$box-shadow-extra-large |
var(--color-shadow-extra-large) |
$box-shadow-highlight |
var(--color-shadow-highlight) |
$box-shadow-inset |
var(--color-shadow-inset) |
$box-shadow-focus |
var(--color-state-focus-shadow) |
v15 |
v16 |
$black |
var(--color-scale-black) |
$white |
var(--color-scale-white) |
$gray-000 |
var(--color-scale-gray-0) |
$gray-100 |
var(--color-scale-gray-1) |
$gray-200 |
var(--color-scale-gray-2) |
... |
... |
$pink-700 |
var(--color-scale-pink-7) |
$pink-800 |
var(--color-scale-pink-8) |
$pink-900 |
var(--color-scale-pink-9) |