/Library/WebServer/Documents/lab/design-system/_site/getting-started/index.html heading|issue|element|id|class|line|column|description NOTICE|WCAG2AA.Principle2.Guideline2_4.2_4_2.H25.2|USAJOBS Design System || Getting started|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|

Getting started

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

Setting the base visual language, components, and guidelines that help define the next generation of USAJOBS.

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

For developers

||usa-heading|461|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|

The UI components are built on a solid HTML foundation, progressively enhanced to provide core experiences across browsers. All users get critical information and experiences. New browsers get the prettiest experiences, while older browsers get less pretty, but usable ones. If JavaScript fails, users will still get a robust HTML foundation.

|||463|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|HTML|||463|42|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|

CSS

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

This repo sticks fairly closely to the 18F CSS Coding Styleguide with some exceptions. Read the coding styleguide first and the refer to this list for the differences:

|||466|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|18F CSS Coding Styleguide|||467|41|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|18F CSS Coding Styleguide|||467|41|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|
  • Sass (.scss) files are compiled by node-sass, a wrapper around the very fast libsass C/C++ preprocessor.
  • |||470|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|node-sass|||470|41|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|node-sass|||470|41|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|libsass|||470|137|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|libsass|||470|137|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|
  • rem units for positioning instead of em
  • |||471|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
  • Sticking closer to the BEM methodology.
  • |||472|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|BEM|||472|29|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|BEM|||472|29|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|
  • Our architecture is a bit flatter. We have base elements (color, typography, buttons) and components made of those elements (alerts, modals, navigation). We don't differentiate between components and modules.
  • |||473|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|

    Preprocessing

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

    The CSS foundation of this site is built with the Sass preprocessor language. The Sass is the scss flavor and is compiled by node-sass, a wrapped around the very fast libsass C/C++ preprocessor.

    |||477|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_3.1_3_1.H48|

    The CSS foundation of this site is built with the Sass preprocessor language. The Sass is the scss flavor and is compiled by node-sass, a wrapped around the very fast libsass C/C++ preprocessor.

    |||477|0|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|Sass|||477|53|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|node-sass|||470|41|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|node-sass|||470|41|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|libsass|||470|137|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|libsass|||470|137|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|

    Frameworks

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

    Uses Bourbon for its simple and lightweight Sass mixin library, and the Neat library for the grid framework. Bourbon and Neat are open-source products from thoughtbot.

    |||480|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|Bourbon|||481|15|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|Bourbon|||481|15|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|Neat|||481|132|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|Neat|||481|132|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|thoughtbot|||481|271|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|thoughtbot|||481|271|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 is migrating away from Bootstrap due to the difficulty in adapting its opinionated styles to bespoke design work and the extra markup it requires in placing semantic layout instructions directly in HTML classes. This Design System is intended to replace Bootstrap over time.

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

    Breakpoints

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

    Media queries are built mobile first. A full table of our breakpoints can be found on the Grid page.

    |||488|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|mobile first|||488|27|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|Grid|||488|110|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|Grid|||488|110|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|

    Architecture

    |||490|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|
  • CSS selectors from the U.S. Web Design Standards are prefixed with usa (For example: .usa-button).
  • |||492|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|prefixed|||492|59|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|||492|90|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|||492|121|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|
  • CSS selectors from this design systerm are prefixed with usajobs (For example: .usajobs-button).
  • |||493|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|prefixed|||492|59|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|||493|80|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-button|||493|115|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|
  • Objects in CSS are separated by single dashes. Multi-word objects are separated by an underscore (For example: .usajobs-button-cool_feature-active).
  • |||494|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|.usajobs-button-cool_feature-active|||494|117|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|
  • Uses modular CSS for scalable, modular, and flexible code.
  • |||495|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|modular CSS|||495|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
  • Uses nesting when appropriate. Nest minimally with up to three levels of nesting.
  • |||496|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|nesting|||496|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|
  • Global variables are defined in the _variables.scss file. This is where custom theming can be done to change site-wide colors, fonts, etc.
  • |||497|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Global variables|||497|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|
  • Hard-coded magic numbers are avoided and, if necessary, defined in the _variables.scss file.
  • |||498|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|_variables.scss|||498|77|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 units are as much as possible defined as rem or em units so they scale appropriately with text size. Pixels can be used for detail work and should not exceed 5px (For example: 3px borders).
  • |||499|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Spacing units|||499|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|

    Where things are:

    |||504|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|
  • HTML markup for the components are located in: _visual, _elements, _components in the site root.
  • |||507|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|HTML|||463|42|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|_visual, _elements, _components|||507|70|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|
  • Sass styles are located in: _scss (/base, /element, /component). Compiled CSS is located in: css/usajobs-design-system-base.css.
  • |||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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Sass|||477|53|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|_scss (/base, /element, /component)|||508|51|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|Compiled CSS|||508|101|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|css/usajobs-design-system-base.css|||508|146|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|
  • JS is located in: js/.
  • |||509|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|JS|||509|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|js/|||509|41|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|
  • Fonts are located in: fonts.
  • |||510|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Fonts|||510|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|fonts|||510|45|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|
  • Images and icons are located in: img.
  • |||511|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Images|||511|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|img|||511|56|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|

    Browser support:

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

    The standards are designed to support both older and newer browsers through progressive enhancement, and officially support Internet Explorer 9 and up, and the latest versions of Chrome, Firefox, and Safari. Internet Explorer 8 and below generally see very low usage today, and most agency websites should be able to safely begin support at Internet Explorer 9.

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

    For designers

    ||usa-heading|518|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|

    All of the designs meet the WCAG 2.0 AA accessibility guidelines and are compliant with Section 508 of the Americans with Disabilities Act. If you choose to customize them, ensure they continue to meet the requirements listed in the “Accessibility” section of each design.

    |||520|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_3.1_3_1.H48|

    All of the designs meet the WCAG 2.0 AA accessibility guidelines and are compliant with Section 508 of the Americans with Disabilities Act. If you choose to customize them, ensure they continue to meet the requirements listed in the “Accessibility” section of each design.

    |||520|0|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|WCAG 2.0 AA accessibility guidelines|||520|31|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|WCAG 2.0 AA accessibility guidelines|||520|31|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|Section 508 of the Americans with Disabilities Act|||520|134|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|Section 508 of the Americans with Disabilities Act|||520|134|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|If you choose to customize them, ensure they continue to meet the requirements listed in the “Accessibility” section of each design.|||520|227|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|

    Maturity Scale

    |maturity|usa-heading|522|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|

    Given that we have just started to formulate the Design System the system is not yet stable. Thus some design decisions are still being considered, documentation is sparse, and components are being rapidly added and removed. Thus maturity tags will be placed at the top of each page of the Design System to help explain what state the component or element is in within the design process.

    |||524|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|
  • Incomplete: A new addition to the system that is still under work and is not yet ready for review.
  • |||527|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Incomplete|||527|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|
  • Proposed: A new addition to the system, proposed by a team member, that has not yet been reviewed by the entire Design team.
  • |||528|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Proposed|||528|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|
  • Under Review: A component or element that is actively being reviewed by the Design team.
  • |||529|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Under Review|||529|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|
  • Design Complete: The component or element has been reviewed by the Design team and guidelines need to be created.
  • |||530|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Design Complete|||530|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|
  • Available: The component or element is complete and ready to be used.
  • |||531|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Available|||531|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|
  • Deployed: The component or element has been deployed to production.
  • |||532|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Deployed|||532|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|
  • Best Practice: The component or element has been deployed for some length of time and is now considered best practice.
  • |||533|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Best Practice|||533|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|
  • Unavailable: A previously available or deployed component or element is now considered lacking and should not be used.
  • |||534|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. WARNING|WCAG2AA.Principle1.Guideline1_4.1_4_3.G18.BgImage|Unavailable|||534|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.

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

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

    |||545|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|||546|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|||546|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|||547|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|||547|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.

    |||549|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|||549|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|||549|66|Check that the link text combined with programmatically determined link context identifies the purpose of the link.