Our neutrals have been streamlined for on-screen use. They are organized by lightness value from Black (0) to White (100).
Always pair with
mds-text-color-white when used as a background color.
Always pair with
mds-text-color-primary-on-light when used as a background color.
Background colors work in pairs to establish visual hierarchy.
Primary backgrounds always contain the product’s focal point. The user is doing most of their work on this background.
Secondary backgrounds offer visual rest from primary backgrounds. They often contain auxiliary elements such as side navigation, card backgrounds, registration forms, or ad-unit containers.
The MDS site uses the
secondary-background for the navigation on the left. The site’s content is contained in the
Morningstar.com uses the
secondary-background to contain ad units. This helps separate ad units from editorial content.
Use to establish interactivity and hierarchy between UI components (i.e.,
$mds-text-color-primary-on-darkwhen used as a background color.
$mds-interactive-color-primary-defaultfor text, as this creates an optical imbalance with interactive objects.
Text on any background color must have a minimum foreground-to-background contrast ratio of 4.5:1. This ensures compliance with WCAG 2.0 Level AA Accessibility Guidelines.
Brand logos and disabled text do not have a minimum contrast ratio. All other content, including placeholder text, must meet or exceed 4.5:1.
In this example,
mds-text-color-secondary-on-light is used for text box placeholder text in Forms, as well as for the readout of disclosure information in small type (metadata).
Use to highlight errors. Error text color doesn't meet accessibility benchmarks for color contrast, so MDS is evaluating alternatives. In the interim, teams can still use this color in production.
Use to indicate components that cannot be used. Disabled components are exempt from minimum contrast ratios.
@include disabled-text(text-color) mixin on a component to render the disabled text color.
We assign specific meanings and orders to colors to create clarity and consistency across widely-used data visualizations.
Use to tie data to asset classes.
Use to show positive or negative correlation within a Correlation Matrix.
Use to represent data relating to Morningstar Super Sectors.
Use to represent data related to the Morningstar Sustainability Rating.
Use to represent under, fair, or over valuation.
Use to show positive, neutral, or negative performance in both text and visualizations. Positive and negative colors used on text don't meet accessibility benchmarks for color contrast, so MDS is evaluating alternatives. In the interim, teams can still use these colors in production.
$mds-font-weight-boldas the font weight to typography using performance colors.
Use when there are no specific color meanings associated with a visualization.
$mds-chart-color-1and ascending in order to
$mds-chart-color-15. If there are more than 15 items, begin again with
Borders define and structure content.
Color contrast refers to the difference between foreground and background. The World Wide Web Consortium established specific color-contrast ratios for achieving compliance. The guidelines are split into three levels: A, AA, and AAA. The organizational benchmark for Morningstar products is Level AA.
The color decisions shared here reflect an adherence to a contrast ratio of at least 4.5:1. When possible, we recommend a ratio near 5.5:1, just to be safe. Never use any combinations that do not meet Level AA Guidelines.
|Passes Level AAA Guidelines at all sizes. Minimum contrast ratio ≥ 7.0:1.|
|Passes Level AA Guidelines at all sizes. Minimum contrast ratio ≥ 4.5:1.|
|Passes Level AA Guidelines only at ≥18px type size or bold weight. Minimum contrast ratio ≥ 3.0:1.|
|Does not pass Level AA Guidelines. Do not use.|
The table above is reproduced from W3C’s Web Content Accessibility Guidelines 2.0.
Subtlety and refinement are integral to our visual language, however, ensuring that our content is legible takes precedent. The successes and failures below guided System color decisions.