The following page documents visual specifications such as color, typography, structure, and size.

Color
Typography
Structure
Size
Feedback

Color

Date picker color

Element	Property	Color token
Label	text-color	`$text-secondary`
Field	background-color	`$field` *
	border-bottom	`$border-strong` *
Field text	text-color	`$text-primary`
Placeholder text	text-color	`$text-placeholder`
Helper text	text-color	`$text-helper`
Calendar icon	svg	`$icon-primary`

* Denotes a contextual color token that will change values based on the layer it is placed on.

Default date picker input colors

Interactive state color

State	Element	Property	Color token
Focus	Field	border	`$focus`
Error	Field	border	`$support-error`
	Error message	text-color	`$text-error`
	Error icon	svg	`$support-error`
Warning	Warning message	text-color	`$text-primary`
	Warning icon	svg	`$support-warning`
Disabled	Label	text-color	`$text-disabled`
	Field	background-color	`$field`
	Field text	text-color	`$text-disabled`
	Field (default)	border-bottom	transparent
	Field (fluid)	border-bottom	`$border-subtle` *
	Calendar icon	svg	`$icon-disabled`
Read-only	Label	text-color	`$text-secondary`
	Field text (default)	text-color	`$text-primary`
	Field (default)	background-color	transparent
	Field text (fluid)	text-color	`$text-secondary`
	Field (fluid)	background-color	`$field` *
	Chevron icon	svg	`$icon-disabled`

* Denotes a contextual color token that will change values based on the layer it is placed on.

Default date picker input states

Examples of date picker input states

Element	Property	Color token
Calendar	background-color	`$layer` *
Calendar menu	box-shadow	`0 2px 6px 0 rgba(0, 0, 0, 0.2)`
Today	text-color	`$link-01`

* Denotes a contextual color token that will change values based on the layer it is placed on.

Date picker calendar color example

Example of a date picker calendar menu.

Interactive state color

State	Element	Property	Color token
Hover	Day	background-color	`$layer-hover` *
Focus	Day	border	`$focus`
Disabled	Day	text-color	`$text-disabled`
Selected	Day	text-color	`$text-on-color`
		background-color	`$background-brand`
In range	Day	text-color	`$text-primary`
		background-color	`$highlight`
End range	Day	text-color	`$text-primary`
		border	`$focus`
Next month	Day	text-color	`$text-secondary`

* Denotes a contextual color token that will change values based on the layer it is placed on.

Date picker calendar examples

Example of a single date calendar picker (left) and a date range calendar picker (right).

Time picker color

The time picker is made up of text input and select input components.

Element	Property	Color token
Label	text-color	`$text-secondary`
Field	background-color	`$field` *
	border-bottom	`$border-strong` *
	dividers (fluid)	`$border-strong` *
Field text	text-color	`$text-primary`
Placeholder text	text-color	`$text-placeholder`
Chevron icon	svg	`$icon-primary`

* Denotes a contextual color token that will change values based on the layer it is placed on.

Default time picker input colors

Interactive state color

The interactive state color example shown below is specificaly for text input. See the select input style tab for more details on select component interactive state colors.

State	Element	Property	Color token
Focus	Field	border	`$focus`
Error	Field	border	`$support-error`
	Error message	text-color	`$text-error`
	Error icon	svg	`$support-error`
Warning	Warning message	text-color	`$text-primary`
	Warning icon	svg	`$support-warning`
Disabled	Label	text-color	`$text-disabled`
	Field	background-color	`$field` *
	Field text	text-color	`$text-disabled`
	Field (default)	border-bottom	transparent
	Field (fluid)	border-bottom	`$border-subtle` *
	Chevron icon	svg	`$icon-disabled`
Read-only	Label	text-color	`$text-secondary`
	Field text (default)	text-color	`$text-primary`
	Field (default)	background-color	transparent
	Field text (fluid)	text-color	`$text-secondary`
	Field (fluid)	background-color	`$field` *
	Chevron icon	svg	`$icon-disabled`

* Denotes a contextual color token that will change values based on the layer it is placed on.

Default time picker input states

Examples of time picker input states

Typography

Labels should be set in sentence case, with only the first word in a phrase and any proper nouns capitalized, and no more than three words.

Element	Font-size	Font-weight	Type token
Label	12 / 0.75	Regular / 400	`$label-01`
Field text	14 / 0.875	Regular / 400	`$code-02`
Helper text	12 / 0.75	Regular / 400	`$label-01`
Error message	12 / 0.75	Regular / 400	`$label-01`
Warning message	12 / 0.75	Regular / 400	`$label-01`
Month and year	14 / 0.875	SemiBold / 600	`$heading-compact-01`
Day	14 / 0.875	Regular / 400	`$body-compact-01`

Structure

Date picker input structure

Default input

The widths of the date inputs may vary based on the grid and layout.

Element	Property	px / rem	Spacing token
Label	margin-bottom	8 / 0.5	`$spacing-03`
Field	padding-left, padding-right	16 / 1	`$spacing-05`
	border-bottom	1px	–
Helper text	margin-top	4 / .25	`$spacing-02`
Calendar icon	height, width	16 / 1	–
	padding-left	8 / 0.5	`$spacing-03`

Structure for date picker inputs

Structure and spacing for default date picker inputs | px / rem

Fluid input

The widths of the date inputs may vary based on the grid and layout.

Element	Property	px / rem	Spacing token
Label	padding-bottom	4 / 0.25	`$spacing-02`
Field	height	64 / 4	`$spacing-10`
	padding-left, padding-right	16 / 1	`$spacing-05`
	padding-top, padding-bottom	13 / 0.8125	–
	border-bottom	1px	–
Calendar icon	height, width	16 / 1	–
	padding-left	8 / 0.5	`$spacing-03`
Focus	border	2px	–
Error	border	2px	–

Structure for date picker inputs

Structure and spacing for fluid date picker inputs | px / rem

Element	Property	px / rem	Spacing token
Calendar menu	height	336 / 21	–
	width	288 / 18	–
	padding-top, padding-right, padding-left	4 / 0.25	`$spacing-02`
	padding-bottom	8 / 0.5	`$spacing-03`
Day	height, width	40 / 2.5	–
Today: dot	height, width	4 / 0.25	–

Structure for date picker

Structure for date picker | px / rem

Spacing for date picker

Spacing for date picker | px / rem

Time picker structure

The time picker is a combination of a text input and select component. Refer to each component page for further details.

Default input

The widths of the time picker may vary based on the grid and layout.

Element	Property	px / rem	Spacing token
Label	padding-bottom	8 / 0.5	`$spacing-03`
Field	height	40 / 2.5	–
	padding-right, padding-left	16 / 1	`$spacing-05`
Select	padding-right, padding-left	16 / 1	`$spacing-05`

Structure for a time picker

Structure and spacing for a time picker | px / rem

Fluid input

The width of each component in the fluid time picker is a percentage of the group. Time picker’s total width will vary based on the grid and layout

Element	Property	px / rem	Spacing token
Label	padding-bottom	4 / 0.25	`$spacing-02`
Field	height	64 / 4	–
	padding-right, padding-left	16 / 1	`$spacing-05`
Divider	width	1px	–
Time input	width	25% or 50%	–
Clock select	width	25% or 50%	–
Timezone select	width	50%	–

Structure for a time picker

Structure and spacing for a time picker | px / rem

Structure for a time picker

The width of each component in the fluid time picker is a percentage of the group.

Size

Default date picker input

Element	Size	Height px / rem
Field	Small (sm)	32 / 2
	Medium (md)	40 / 2.5
	Large (lg)	48 / 3

Sizes for simple and single date calendar sizes

Sizes for simple and single date calendar sizes | px / rem

Default time picker input

Element	Size	Height px / rem
Field	Small (sm)	32 / 2
	Medium (md)	40 / 2.5
	Large (lg)	48 / 3

Sizes for simple and single date calendar sizes

Sizes for default style time picker input | px / rem

Feedback

Help us improve this component by providing feedback, asking questions, and leaving any other comments on GitHub.

Edit this page on GitHub

Date picker: Usage

Date picker: Code