Skip to main content
An official website of the United States government

Outline

Set width and color of an item’s outline

OutlineSize
.outline-00px
.outline-1px1px
.outline-2px2px
.outline-054px

Global color tokens

Class nameHex
.outline-transparenttransparent
.outline-white#ffffff
.outline-black#000000

Grayscale color tokens

Class nameHex
.outline-gray-5#f0f0f0
.outline-gray-10#e6e6e6
.outline-gray-30#adadad
.outline-gray-50#757575
.outline-gray-70#454545
.outline-gray-90#1b1b1b

Basic color tokens

Class nameHex
.outline-teal#298085
.outline-cerulean#007bbd
.outline-cranberry#bb0e3d
.outline-navy#14315c
.outline-golden#947100

Theme color tokens

Class nameHex
.outline-base-lightest#f0f0f0
.outline-base-lighter#dfe1e2
.outline-base-light#a9aeb1
.outline-base#71767a
.outline-base-dark #565c65
.outline-base-darker#3d4551
.outline-base-darkest#1b1b1b
.outline-ink#1b1b1b
.outline-primary-lighter#99cae4
.outline-primary-light#3395ca
.outline-primary#007bbd
.outline-primary-vivid#067cbc
.outline-primary-dark#004e7a
.outline-primary-darker#003a57
.outline-secondary-lighter#beebee
.outline-secondary-light#4bbfc6
.outline-secondary#298085
.outline-secondary-vivid#338084
.outline-secondary-dark#1e4c4f
.outline-secondary-darker#17373a
.outline-accent-warm-lighter#fdf2bf
.outline-accent-warm-light#fee685
.outline-accent-warm#face00
.outline-accent-warm-dark#ddaa01
.outline-accent-warm-darker#b38c00
.outline-accent-cool-lighter#d7e5f4
.outline-accent-cool-light#92a9c8
.outline-accent-cool#5478ab
.outline-accent-cool-dark#284976
.outline-accent-cool-darker#06162d

State color tokens

Class nameHex
.outline-error-lighter#fde2ea
.outline-error-light#f27da2
.outline-error#e41154
.outline-error-dark#b60d43
.outline-error-darker#950b30
.outline-warning-lighter#fdf2bf
.outline-warning-light#ffe396
.outline-warning#ffbe2e
.outline-warning-dark #e5a000
.outline-warning-darker#936f38
.outline-success-lighter#dbf2f3
.outline-success-light#67e4e8
.outline-success #42979a
.outline-success-dark#338084
.outline-success-darker#206b6f
.outline-info-lighter#d4e7f2
.outline-info-light#99cae4
.outline-info#51b8f0
.outline-info-dark #2099df
.outline-info-darker#01679d
.outline-disabled-light #e6e6e6
.outline-disabled#c9c9c9
.outline-disabled-dark #adadad
.outline-emergency #b60d43
.outline-emergency-dark#700824

Utilities may be used in component Sass with utility mixins. Highlighted tokens are the design tokens that serve as the foundation for all design system styles.

UtilityMixinExample
.outline-unitsu-outline(units)@include outline('05')
.outline-coloru-outline(color)@include outline-color('primary-lighter')

Using utilities mixins

  • Use single-quoted strings in utility mixins. Do not quote numbers or px values, with the exception of half (05) values like '05', '105', and '205' which should be treated as strings.
  • String tokens for half values (05) and negative values (like neg-1)may also be written with their unquoted number token equivalent: 0.5, 1.5, 2.5, 2.5, -1, -1.5, etc
  • If multiple utilities share the same prefix (ex: .text- or .flex-) or a single utility accepts multiple kinds of values (ex: .border accepts both border weight and border color), their shared mixin can accept multiple comma-separated values: u-text('primary-darkest', 'no-underline', 'bold') or u-border-top(2px, 'accent-warm').
  • Output any utility mixin as !important by appending !important to the mixin’s argument list: u-bg('red-warm-50v', !important)

For Designers: How to apply Outline in the NCIDS Design Kit in Figma

Refer to the Figma Guide for how to apply Outline to an item in Figma.