USAJOBS Design System || Spacing|18|1|Check that the title element describes the document.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Skip to main content||usa-skipnav|95|3|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81|Skip to main content||usa-skipnav|95|3|Check that the link text combined with programmatically determined link context identifies the purpose of the link.
NOTICE|WCAG2AA.Principle1.Guideline1_1.1_1_1.G94.Image||||101|6|Ensure that the img element's alt text serves the same purpose and presents the same information as the image.
NOTICE|WCAG2AA.Principle1.Guideline1_1.1_1_1.G73,G74||||101|6|If this image cannot be fully described in a short text alternative, ensure a long text alternative is also available, such as in the body text or through a link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
An official website of the United States government
|||102|6|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle3.Guideline3_2.3_2_1.G107|||usa-accordion-button usa-banner-button|1|0|Check that a change of context does not occur when this input field receives focus.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Here's how you know||usa-banner-button-text|105|8|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle1.Guideline1_1.1_1_1.G94.Image|||usa-banner-icon usa-media_block-img|111|8|Ensure that the img element's alt text serves the same purpose and presents the same information as the image.
NOTICE|WCAG2AA.Principle1.Guideline1_1.1_1_1.G73,G74|||usa-banner-icon usa-media_block-img|111|8|If this image cannot be fully described in a short text alternative, ensure a long text alternative is also available, such as in the body text or through a link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.
There are some exceptions to this rule. During the USAJOBS application process, you may be sent to an agency specific application system that DOES NOT contain a .mil or .gov. Rest assured, if you apply to any job through USAJOBS.gov your information is safe and secure.
|||113|10|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|The .gov means it’s official.|||114|12|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle1.Guideline1_1.1_1_1.G94.Image|||usa-banner-icon usa-media_block-img|124|8|Ensure that the img element's alt text serves the same purpose and presents the same information as the image.
NOTICE|WCAG2AA.Principle1.Guideline1_1.1_1_1.G73,G74|||usa-banner-icon usa-media_block-img|124|8|If this image cannot be fully described in a short text alternative, ensure a long text alternative is also available, such as in the body text or through a link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.
|||126|10|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|The site is secure.|||127|12|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|https://|||129|16|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
Design System
||usajobs-documentation-header__dslink|1|0|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81,H33|
Design System
||usajobs-documentation-header__dslink|1|0|Check that the link text combined with programmatically determined link context, or its title attribute, identifies the purpose of the link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|||usa-menu-btn|207|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle3.Guideline3_2.3_2_1.G107|||usa-menu-btn|207|4|Check that a change of context does not occur when this input field receives focus.
NOTICE|WCAG2AA.Principle3.Guideline3_2.3_2_1.G107|||usa-nav-close|212|6|Check that a change of context does not occur when this input field receives focus.
NOTICE|WCAG2AA.Principle3.Guideline3_2.3_2_1.G107|||usa-accordion-button usa-nav-link|217|10|Check that a change of context does not occur when this input field receives focus.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Base elements|||218|12|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle3.Guideline3_2.3_2_1.G107|||usa-accordion-button usa-nav-link|273|10|Check that a change of context does not occur when this input field receives focus.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Components|||274|12|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle3.Guideline3_2.3_2_1.G107|||usa-accordion-button usa-nav-link|360|10|Check that a change of context does not occur when this input field receives focus.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Layouts|||361|12|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
GitHub
|||442|12|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81|
GitHub
|||442|12|Check that the link text combined with programmatically determined link context identifies the purpose of the link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|usajobs.gov|||447|12|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81|usajobs.gov|||447|12|Check that the link text combined with programmatically determined link context identifies the purpose of the link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
element
||site-subheading|458|8|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
Spacing
|spacing||459|8|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
USAJOBS defines a nonlinear, geometric progression of spacing to provide a consistent pattern.
||usa-font-lead|460|8|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
Design Complete
||usa-label maturity design_complete|461|11|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81|
Design Complete
||usa-label maturity design_complete|461|11|Check that the link text combined with programmatically determined link context identifies the purpose of the link.
WARNING|WCAG2AA.Principle1.Guideline1_3.1_3_1_A.G141|
Progression
|||465|0|The heading structure is not logically nested. This h3 element should be an h2 to be properly nested.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
Progression
|||465|0|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
XS: 0.25rem/2.5px
||usajobs-spacing-example__item|468|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
Base: 0.5rem/5px
||usajobs-spacing-example__item|472|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
S: 1rem/10px - $size-base * 2
||usajobs-spacing-example__item|476|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
Default: 1.5rem/15px - $size-base * 3
||usajobs-spacing-example__item|480|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
SM: 2rem/20px - $size-base * 4 (use sparingly if at all)
||usajobs-spacing-example__item|484|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
M: 3rem/30px - $size-base * 6
||usajobs-spacing-example__item|488|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
L: 4.5rem/45px - $size-base * 9
||usajobs-spacing-example__item|492|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
XL: 6rem/60px - $size-M * 2
||usajobs-spacing-example__item|496|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
XXL: 7.5rem/75px - $size-default * 5
||usajobs-spacing-example__item|500|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|||usa-button-unstyled usa-accordion-button|508|2|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle3.Guideline3_2.3_2_1.G107|||usa-button-unstyled usa-accordion-button|508|2|Check that a change of context does not occur when this input field receives focus.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
Guidelines
||usa-heading|512|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
When to use
|||513|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
All designs and implementations using the USAJOBS design system MUST align to this spacing progression in order for the inter-relationships of components to operate properly.
|||515|6|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
The SM (2rem/20px) is an exception that we're trying to remove. Any instances that can be removed should be replaced by either the default or M size.
|||516|6|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
|||526|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|GitHub repository|||526|40|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81|GitHub repository|||526|40|Check that the link text combined with programmatically determined link context identifies the purpose of the link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
|||529|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_3.1_3_1.H48|
|||529|4|If this element contains a navigation section, it is recommended that it be marked up as a list.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|USAJOBS|||530|36|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81|USAJOBS|||530|36|Check that the link text combined with programmatically determined link context identifies the purpose of the link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|github.com/USAJOBS/design-system|||531|38|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81|github.com/USAJOBS/design-system|||531|38|Check that the link text combined with programmatically determined link context identifies the purpose of the link.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
As a work of the United States Government, this project is in the public domain within the United States.
|||533|4|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|in the public domain|||533|66|This element's text is placed on a background image. Ensure the contrast ratio between the text and all covered parts of the image are at least 4.5:1.
NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_4.H77,H78,H79,H80,H81|in the public domain|||533|66|Check that the link text combined with programmatically determined link context identifies the purpose of the link.