/Library/WebServer/Documents/lab/design-system/_site/spacing/index.html heading|issue|element|id|class|line|column|description NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_2.H25.2|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|U.S. flag|||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|U.S. flag|||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|Dot gov||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|Dot gov||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|SSL||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|SSL||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|

    Feedback? Create an issue on the GitHub repository.

    |||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|

    This project is maintained by USAJOBS. The source code is available at github.com/USAJOBS/design-system

    |||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|

    This project is maintained by USAJOBS. The source code is available at github.com/USAJOBS/design-system

    |||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.