ant-design/docs/spec/colors.en-US.md
2017-10-10 20:23:21 +08:00

5.5 KiB

order title
3 Colors

Not only is color an effective way to create brand recognition, but it also plays an important role in conveying information, providing interactive feedback, and bringing attention to a particular element. Ant Design makes using color simple and practical through an emphasis on efficiency, clarity, and user experience. Please note the following three points when choosing colors:

  • Color usage and positioning should respect cognitive psychology (stay user-focused)
  • Visual hierarchy should be clear-cut, and color should establish visual continuity
  • Color usage should be in compliance with the WCAG 2.0 standards by using sufficient contrast to ensure accessibility

Color Palettes

Ant Design's color palettes consist of 10 shallow-to-deep color swatches, and default palettes are defined for certain hues. Users can select a swatch from the color scheme using keywords. In theory, all colors used in the design should be taken from a color palette.

After hard working of designers and programmers, we got a great color palette generation algorithm which can be used to generate a whole new palette based on an input color you specify, replacing our original tint / shade color system).

Ant Design's default theme consists of eight basic colors, each of which is derived from the above algorithm.

Note: In these shallow-to-deep palettes, the 6th color cell generally satisfies WCAG 2.0's 4.5:1 minimum contrast ratio (AA level), and is used as the default for the palette.

import ColorPalettes from '../../site/theme/template/Color/ColorPalettes';

ReactDOM.render(<ColorPalettes />, mountNode);

In order to provide contrast against different background shades, we chose White #FFFFFF and Black #000000 with varying transparency to distinguish foreground text. For details, please see font color.

Palette Generation Tool

If the above palettes do not meet your needs, you can choose a main color below, and Ant Design's color generation algorithm will generate a palette for you.

import ColorPaletteTool from '../../site/theme/template/Color/ColorPaletteTool';

ReactDOM.render(<ColorPaletteTool />, mountNode);

Color application

Brand color application

Ant Design's commonly used brand color values

The brand color is one of the most intuitive visual elements used that is used to embody product characteristics and communicate ideas. When selecting colors, it is important to understand how the brand color is used in the user interface. Taking the default styles of an Ant Design web component as an example, the brand color is mainly reflected in key actions and when highlighting important information.

Note: Images and logos can not automatically adhere to the color palette, but should be compatible.

Neutral color application

Ant Design's neutral color values

Gray as a neutral color is used extensively in Ant Design's web design, and its use facilitates the targeting and functional guidance of key content. This color is mainly seen in the navigation frame, backgrounds, secondary operations, and so on.

Functional color application

Ant Design's functional color card

Functional colors are colors that are used to convey state. These are mainly used in notifications, form validations, status messages, etc. Green indicates success, yellow indicates alerts / warnings, red indicates errors, gray indicates skipped / disabled.

Visual hierarchy

Good example

Use the brand color to convey important information or to highlight important actions while surrounding it with large areas of neutral color. This allows users to focus more on the task itself, improving efficiency.


Bad example

Note: We suggest using no more than three colors in the user interface (except for within data charts and graphic illustrations)

Color contrast

Good example Bad example

Ant Design's color palette conforms to the WCAG 2.0 standard. The foreground and background colors should always meet the minimum standard of a 3:1 contrast ratio.