uswds-jekyll 1.4.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/LICENSE.md +31 -0
- data/README.md +547 -0
- data/_includes/banner.html +1 -0
- data/_includes/components/banner.html +20 -0
- data/_includes/components/footer.html +71 -0
- data/_includes/components/graphic-list.html +16 -0
- data/_includes/components/header--basic.html +72 -0
- data/_includes/components/header--extended.html +85 -0
- data/_includes/components/hero.html +32 -0
- data/_includes/favicon.html +5 -0
- data/_includes/footer.html +2 -0
- data/_includes/graphic-list.html +2 -0
- data/_includes/header.html +7 -0
- data/_includes/meta.html +6 -0
- data/_includes/scripts.html +21 -0
- data/_includes/sidenav.html +20 -0
- data/_includes/skipnav.html +1 -0
- data/_includes/styles.html +17 -0
- data/_includes/subnav.html +5 -0
- data/_layouts/base.html +21 -0
- data/_layouts/docs.html +19 -0
- data/_layouts/landing.html +30 -0
- data/_layouts/search-results.html +25 -0
- data/_sass/uswds/_all.scss +1 -0
- data/_sass/uswds/components/_accordions.scss +150 -0
- data/_sass/uswds/components/_alerts.scss +94 -0
- data/_sass/uswds/components/_banner.scss +204 -0
- data/_sass/uswds/components/_footer.scss +382 -0
- data/_sass/uswds/components/_forms.scss +164 -0
- data/_sass/uswds/components/_graphic-list.scss +35 -0
- data/_sass/uswds/components/_header.scss +221 -0
- data/_sass/uswds/components/_hero.scss +43 -0
- data/_sass/uswds/components/_layout.scss +36 -0
- data/_sass/uswds/components/_media-block.scss +12 -0
- data/_sass/uswds/components/_navigation.scss +454 -0
- data/_sass/uswds/components/_search.scss +106 -0
- data/_sass/uswds/components/_section.scss +37 -0
- data/_sass/uswds/components/_sidenav.scss +8 -0
- data/_sass/uswds/components/_skipnav.scss +19 -0
- data/_sass/uswds/core/_base.scss +30 -0
- data/_sass/uswds/core/_defaults.scss +8 -0
- data/_sass/uswds/core/_fonts.scss +65 -0
- data/_sass/uswds/core/_grid-settings.scss +3 -0
- data/_sass/uswds/core/_grid.scss +199 -0
- data/_sass/uswds/core/_utilities.scss +232 -0
- data/_sass/uswds/core/_variables.scss +123 -0
- data/_sass/uswds/elements/_buttons.scss +191 -0
- data/_sass/uswds/elements/_embed.scss +26 -0
- data/_sass/uswds/elements/_figure.scss +13 -0
- data/_sass/uswds/elements/_inputs.scss +346 -0
- data/_sass/uswds/elements/_labels.scss +20 -0
- data/_sass/uswds/elements/_list.scss +32 -0
- data/_sass/uswds/elements/_table.scss +47 -0
- data/_sass/uswds/elements/_typography.scss +257 -0
- data/_sass/uswds/lib/_bourbon-deprecated-upcoming.scss +411 -0
- data/_sass/uswds/lib/_bourbon.scss +87 -0
- data/_sass/uswds/lib/_neat-helpers.scss +11 -0
- data/_sass/uswds/lib/_neat.scss +23 -0
- data/_sass/uswds/lib/_normalize.scss +424 -0
- data/_sass/uswds/lib/addons/_border-color.scss +26 -0
- data/_sass/uswds/lib/addons/_border-radius.scss +48 -0
- data/_sass/uswds/lib/addons/_border-style.scss +25 -0
- data/_sass/uswds/lib/addons/_border-width.scss +25 -0
- data/_sass/uswds/lib/addons/_buttons.scss +64 -0
- data/_sass/uswds/lib/addons/_clearfix.scss +25 -0
- data/_sass/uswds/lib/addons/_ellipsis.scss +30 -0
- data/_sass/uswds/lib/addons/_font-stacks.scss +31 -0
- data/_sass/uswds/lib/addons/_hide-text.scss +27 -0
- data/_sass/uswds/lib/addons/_margin.scss +26 -0
- data/_sass/uswds/lib/addons/_padding.scss +26 -0
- data/_sass/uswds/lib/addons/_position.scss +48 -0
- data/_sass/uswds/lib/addons/_prefixer.scss +66 -0
- data/_sass/uswds/lib/addons/_retina-image.scss +25 -0
- data/_sass/uswds/lib/addons/_size.scss +51 -0
- data/_sass/uswds/lib/addons/_text-inputs.scss +113 -0
- data/_sass/uswds/lib/addons/_timing-functions.scss +34 -0
- data/_sass/uswds/lib/addons/_triangle.scss +63 -0
- data/_sass/uswds/lib/addons/_word-wrap.scss +29 -0
- data/_sass/uswds/lib/css3/_animation.scss +43 -0
- data/_sass/uswds/lib/css3/_appearance.scss +3 -0
- data/_sass/uswds/lib/css3/_backface-visibility.scss +3 -0
- data/_sass/uswds/lib/css3/_background-image.scss +42 -0
- data/_sass/uswds/lib/css3/_background.scss +55 -0
- data/_sass/uswds/lib/css3/_border-image.scss +59 -0
- data/_sass/uswds/lib/css3/_calc.scss +4 -0
- data/_sass/uswds/lib/css3/_columns.scss +47 -0
- data/_sass/uswds/lib/css3/_filter.scss +4 -0
- data/_sass/uswds/lib/css3/_flex-box.scss +287 -0
- data/_sass/uswds/lib/css3/_font-face.scss +24 -0
- data/_sass/uswds/lib/css3/_font-feature-settings.scss +4 -0
- data/_sass/uswds/lib/css3/_hidpi-media-query.scss +10 -0
- data/_sass/uswds/lib/css3/_hyphens.scss +4 -0
- data/_sass/uswds/lib/css3/_image-rendering.scss +14 -0
- data/_sass/uswds/lib/css3/_keyframes.scss +36 -0
- data/_sass/uswds/lib/css3/_linear-gradient.scss +38 -0
- data/_sass/uswds/lib/css3/_perspective.scss +8 -0
- data/_sass/uswds/lib/css3/_placeholder.scss +8 -0
- data/_sass/uswds/lib/css3/_radial-gradient.scss +39 -0
- data/_sass/uswds/lib/css3/_selection.scss +42 -0
- data/_sass/uswds/lib/css3/_text-decoration.scss +19 -0
- data/_sass/uswds/lib/css3/_transform.scss +15 -0
- data/_sass/uswds/lib/css3/_transition.scss +71 -0
- data/_sass/uswds/lib/css3/_user-select.scss +3 -0
- data/_sass/uswds/lib/functions/_assign-inputs.scss +11 -0
- data/_sass/uswds/lib/functions/_contains-falsy.scss +20 -0
- data/_sass/uswds/lib/functions/_contains.scss +26 -0
- data/_sass/uswds/lib/functions/_is-length.scss +11 -0
- data/_sass/uswds/lib/functions/_is-light.scss +21 -0
- data/_sass/uswds/lib/functions/_is-number.scss +11 -0
- data/_sass/uswds/lib/functions/_is-size.scss +13 -0
- data/_sass/uswds/lib/functions/_modular-scale.scss +69 -0
- data/_sass/uswds/lib/functions/_new-breakpoint.scss +49 -0
- data/_sass/uswds/lib/functions/_private.scss +114 -0
- data/_sass/uswds/lib/functions/_px-to-em.scss +13 -0
- data/_sass/uswds/lib/functions/_px-to-rem.scss +15 -0
- data/_sass/uswds/lib/functions/_shade.scss +24 -0
- data/_sass/uswds/lib/functions/_strip-units.scss +17 -0
- data/_sass/uswds/lib/functions/_tint.scss +24 -0
- data/_sass/uswds/lib/functions/_transition-property-name.scss +22 -0
- data/_sass/uswds/lib/functions/_unpack.scss +27 -0
- data/_sass/uswds/lib/grid/_box-sizing.scss +15 -0
- data/_sass/uswds/lib/grid/_direction-context.scss +33 -0
- data/_sass/uswds/lib/grid/_display-context.scss +28 -0
- data/_sass/uswds/lib/grid/_fill-parent.scss +22 -0
- data/_sass/uswds/lib/grid/_media.scss +92 -0
- data/_sass/uswds/lib/grid/_omega.scss +87 -0
- data/_sass/uswds/lib/grid/_outer-container.scss +34 -0
- data/_sass/uswds/lib/grid/_pad.scss +25 -0
- data/_sass/uswds/lib/grid/_private.scss +35 -0
- data/_sass/uswds/lib/grid/_row.scss +52 -0
- data/_sass/uswds/lib/grid/_shift.scss +50 -0
- data/_sass/uswds/lib/grid/_span-columns.scss +94 -0
- data/_sass/uswds/lib/grid/_to-deprecate.scss +97 -0
- data/_sass/uswds/lib/grid/_visual-grid.scss +42 -0
- data/_sass/uswds/lib/helpers/_convert-units.scss +21 -0
- data/_sass/uswds/lib/helpers/_directional-values.scss +96 -0
- data/_sass/uswds/lib/helpers/_font-source-declaration.scss +43 -0
- data/_sass/uswds/lib/helpers/_gradient-positions-parser.scss +13 -0
- data/_sass/uswds/lib/helpers/_linear-angle-parser.scss +25 -0
- data/_sass/uswds/lib/helpers/_linear-gradient-parser.scss +41 -0
- data/_sass/uswds/lib/helpers/_linear-positions-parser.scss +61 -0
- data/_sass/uswds/lib/helpers/_linear-side-corner-parser.scss +31 -0
- data/_sass/uswds/lib/helpers/_radial-arg-parser.scss +69 -0
- data/_sass/uswds/lib/helpers/_radial-gradient-parser.scss +50 -0
- data/_sass/uswds/lib/helpers/_radial-positions-parser.scss +18 -0
- data/_sass/uswds/lib/helpers/_render-gradients.scss +26 -0
- data/_sass/uswds/lib/helpers/_shape-size-stripper.scss +10 -0
- data/_sass/uswds/lib/helpers/_str-to-num.scss +50 -0
- data/_sass/uswds/lib/mixins/_clearfix.scss +25 -0
- data/_sass/uswds/lib/settings/_asset-pipeline.scss +7 -0
- data/_sass/uswds/lib/settings/_disable-warnings.scss +13 -0
- data/_sass/uswds/lib/settings/_grid.scss +51 -0
- data/_sass/uswds/lib/settings/_prefixer.scss +9 -0
- data/_sass/uswds/lib/settings/_px-to-em.scss +1 -0
- data/_sass/uswds/lib/settings/_visual-grid.scss +27 -0
- data/_sass/uswds/uswds.scss +41 -0
- data/assets/uswds/CONTRIBUTING.md +145 -0
- data/assets/uswds/LICENSE.md +63 -0
- data/assets/uswds/README.md +259 -0
- data/assets/uswds/css/uswds.css +4463 -0
- data/assets/uswds/css/uswds.min.css +4 -0
- data/assets/uswds/css/uswds.min.css.map +1 -0
- data/assets/uswds/fonts/merriweather-bold-webfont.eot +0 -0
- data/assets/uswds/fonts/merriweather-bold-webfont.ttf +0 -0
- data/assets/uswds/fonts/merriweather-bold-webfont.woff +0 -0
- data/assets/uswds/fonts/merriweather-bold-webfont.woff2 +0 -0
- data/assets/uswds/fonts/merriweather-italic-webfont.eot +0 -0
- data/assets/uswds/fonts/merriweather-italic-webfont.ttf +0 -0
- data/assets/uswds/fonts/merriweather-italic-webfont.woff +0 -0
- data/assets/uswds/fonts/merriweather-italic-webfont.woff2 +0 -0
- data/assets/uswds/fonts/merriweather-light-webfont.eot +0 -0
- data/assets/uswds/fonts/merriweather-light-webfont.ttf +0 -0
- data/assets/uswds/fonts/merriweather-light-webfont.woff +0 -0
- data/assets/uswds/fonts/merriweather-light-webfont.woff2 +0 -0
- data/assets/uswds/fonts/merriweather-regular-webfont.eot +0 -0
- data/assets/uswds/fonts/merriweather-regular-webfont.ttf +0 -0
- data/assets/uswds/fonts/merriweather-regular-webfont.woff +0 -0
- data/assets/uswds/fonts/merriweather-regular-webfont.woff2 +0 -0
- data/assets/uswds/fonts/sourcesanspro-bold-webfont.eot +0 -0
- data/assets/uswds/fonts/sourcesanspro-bold-webfont.ttf +0 -0
- data/assets/uswds/fonts/sourcesanspro-bold-webfont.woff +0 -0
- data/assets/uswds/fonts/sourcesanspro-bold-webfont.woff2 +0 -0
- data/assets/uswds/fonts/sourcesanspro-italic-webfont.eot +0 -0
- data/assets/uswds/fonts/sourcesanspro-italic-webfont.ttf +0 -0
- data/assets/uswds/fonts/sourcesanspro-italic-webfont.woff +0 -0
- data/assets/uswds/fonts/sourcesanspro-italic-webfont.woff2 +0 -0
- data/assets/uswds/fonts/sourcesanspro-light-webfont.eot +0 -0
- data/assets/uswds/fonts/sourcesanspro-light-webfont.ttf +0 -0
- data/assets/uswds/fonts/sourcesanspro-light-webfont.woff +0 -0
- data/assets/uswds/fonts/sourcesanspro-light-webfont.woff2 +0 -0
- data/assets/uswds/fonts/sourcesanspro-regular-webfont.eot +0 -0
- data/assets/uswds/fonts/sourcesanspro-regular-webfont.ttf +0 -0
- data/assets/uswds/fonts/sourcesanspro-regular-webfont.woff +0 -0
- data/assets/uswds/fonts/sourcesanspro-regular-webfont.woff2 +0 -0
- data/assets/uswds/img/alerts/error.png +0 -0
- data/assets/uswds/img/alerts/error.svg +17 -0
- data/assets/uswds/img/alerts/info.png +0 -0
- data/assets/uswds/img/alerts/info.svg +18 -0
- data/assets/uswds/img/alerts/success.png +0 -0
- data/assets/uswds/img/alerts/success.svg +12 -0
- data/assets/uswds/img/alerts/warning.png +0 -0
- data/assets/uswds/img/alerts/warning.svg +16 -0
- data/assets/uswds/img/angle-arrow-down-hover.png +0 -0
- data/assets/uswds/img/angle-arrow-down-hover.svg +1 -0
- data/assets/uswds/img/angle-arrow-down-primary-hover.png +0 -0
- data/assets/uswds/img/angle-arrow-down-primary-hover.svg +1 -0
- data/assets/uswds/img/angle-arrow-down-primary.png +0 -0
- data/assets/uswds/img/angle-arrow-down-primary.svg +1 -0
- data/assets/uswds/img/angle-arrow-down.png +0 -0
- data/assets/uswds/img/angle-arrow-down.svg +1 -0
- data/assets/uswds/img/angle-arrow-up-primary-hover.png +0 -0
- data/assets/uswds/img/angle-arrow-up-primary-hover.svg +1 -0
- data/assets/uswds/img/angle-arrow-up-primary.png +0 -0
- data/assets/uswds/img/angle-arrow-up-primary.svg +1 -0
- data/assets/uswds/img/arrow-down.png +0 -0
- data/assets/uswds/img/arrow-down.svg +1 -0
- data/assets/uswds/img/arrow-right.png +0 -0
- data/assets/uswds/img/arrow-right.svg +1 -0
- data/assets/uswds/img/circle-124.png +0 -0
- data/assets/uswds/img/close.png +0 -0
- data/assets/uswds/img/close.svg +1 -0
- data/assets/uswds/img/correct8.png +0 -0
- data/assets/uswds/img/correct8.svg +1 -0
- data/assets/uswds/img/correct9.png +0 -0
- data/assets/uswds/img/correct9.svg +1 -0
- data/assets/uswds/img/external-link-alt-hover.png +0 -0
- data/assets/uswds/img/external-link-alt-hover.svg +1 -0
- data/assets/uswds/img/external-link-alt.png +0 -0
- data/assets/uswds/img/external-link-alt.svg +1 -0
- data/assets/uswds/img/external-link-hover.png +0 -0
- data/assets/uswds/img/external-link-hover.svg +1 -0
- data/assets/uswds/img/external-link.png +0 -0
- data/assets/uswds/img/external-link.svg +1 -0
- data/assets/uswds/img/favicons/favicon-114.png +0 -0
- data/assets/uswds/img/favicons/favicon-144.png +0 -0
- data/assets/uswds/img/favicons/favicon-16.png +0 -0
- data/assets/uswds/img/favicons/favicon-192.png +0 -0
- data/assets/uswds/img/favicons/favicon-40.png +0 -0
- data/assets/uswds/img/favicons/favicon-57.png +0 -0
- data/assets/uswds/img/favicons/favicon-72.png +0 -0
- data/assets/uswds/img/favicons/favicon.ico +0 -0
- data/assets/uswds/img/favicons/favicon.png +0 -0
- data/assets/uswds/img/hero.png +0 -0
- data/assets/uswds/img/icon-dot-gov.svg +1 -0
- data/assets/uswds/img/icon-https.svg +1 -0
- data/assets/uswds/img/logo-img.png +0 -0
- data/assets/uswds/img/minus-alt.png +0 -0
- data/assets/uswds/img/minus-alt.svg +1 -0
- data/assets/uswds/img/minus.png +0 -0
- data/assets/uswds/img/minus.svg +1 -0
- data/assets/uswds/img/plus-alt.png +0 -0
- data/assets/uswds/img/plus-alt.svg +1 -0
- data/assets/uswds/img/plus.png +0 -0
- data/assets/uswds/img/plus.svg +1 -0
- data/assets/uswds/img/search-alt.png +0 -0
- data/assets/uswds/img/search-alt.svg +1 -0
- data/assets/uswds/img/search.png +0 -0
- data/assets/uswds/img/search.svg +1 -0
- data/assets/uswds/img/social-icons/png/facebook25.png +0 -0
- data/assets/uswds/img/social-icons/png/rss25.png +0 -0
- data/assets/uswds/img/social-icons/png/twitter16.png +0 -0
- data/assets/uswds/img/social-icons/png/youtube15.png +0 -0
- data/assets/uswds/img/social-icons/svg/facebook25.svg +1 -0
- data/assets/uswds/img/social-icons/svg/rss25.svg +1 -0
- data/assets/uswds/img/social-icons/svg/twitter16.svg +1 -0
- data/assets/uswds/img/social-icons/svg/youtube15.svg +1 -0
- data/assets/uswds/img/us_flag_small.png +0 -0
- data/assets/uswds/js/uswds.js +1831 -0
- data/assets/uswds/js/uswds.min.js +2 -0
- data/assets/uswds/js/uswds.min.js.map +1 -0
- data/assets/uswds/scss/_all.scss +1 -0
- data/assets/uswds/scss/components/_accordions.scss +150 -0
- data/assets/uswds/scss/components/_alerts.scss +94 -0
- data/assets/uswds/scss/components/_banner.scss +204 -0
- data/assets/uswds/scss/components/_footer.scss +382 -0
- data/assets/uswds/scss/components/_forms.scss +164 -0
- data/assets/uswds/scss/components/_graphic-list.scss +35 -0
- data/assets/uswds/scss/components/_header.scss +221 -0
- data/assets/uswds/scss/components/_hero.scss +43 -0
- data/assets/uswds/scss/components/_layout.scss +36 -0
- data/assets/uswds/scss/components/_media-block.scss +12 -0
- data/assets/uswds/scss/components/_navigation.scss +454 -0
- data/assets/uswds/scss/components/_search.scss +106 -0
- data/assets/uswds/scss/components/_section.scss +37 -0
- data/assets/uswds/scss/components/_sidenav.scss +8 -0
- data/assets/uswds/scss/components/_skipnav.scss +19 -0
- data/assets/uswds/scss/core/_base.scss +30 -0
- data/assets/uswds/scss/core/_defaults.scss +8 -0
- data/assets/uswds/scss/core/_fonts.scss +65 -0
- data/assets/uswds/scss/core/_grid-settings.scss +3 -0
- data/assets/uswds/scss/core/_grid.scss +199 -0
- data/assets/uswds/scss/core/_utilities.scss +232 -0
- data/assets/uswds/scss/core/_variables.scss +123 -0
- data/assets/uswds/scss/elements/_buttons.scss +191 -0
- data/assets/uswds/scss/elements/_embed.scss +26 -0
- data/assets/uswds/scss/elements/_figure.scss +13 -0
- data/assets/uswds/scss/elements/_inputs.scss +346 -0
- data/assets/uswds/scss/elements/_labels.scss +20 -0
- data/assets/uswds/scss/elements/_list.scss +32 -0
- data/assets/uswds/scss/elements/_table.scss +47 -0
- data/assets/uswds/scss/elements/_typography.scss +257 -0
- data/assets/uswds/scss/lib/_bourbon-deprecated-upcoming.scss +411 -0
- data/assets/uswds/scss/lib/_bourbon.scss +87 -0
- data/assets/uswds/scss/lib/_neat-helpers.scss +11 -0
- data/assets/uswds/scss/lib/_neat.scss +23 -0
- data/assets/uswds/scss/lib/_normalize.scss +424 -0
- data/assets/uswds/scss/lib/addons/_border-color.scss +26 -0
- data/assets/uswds/scss/lib/addons/_border-radius.scss +48 -0
- data/assets/uswds/scss/lib/addons/_border-style.scss +25 -0
- data/assets/uswds/scss/lib/addons/_border-width.scss +25 -0
- data/assets/uswds/scss/lib/addons/_buttons.scss +64 -0
- data/assets/uswds/scss/lib/addons/_clearfix.scss +25 -0
- data/assets/uswds/scss/lib/addons/_ellipsis.scss +30 -0
- data/assets/uswds/scss/lib/addons/_font-stacks.scss +31 -0
- data/assets/uswds/scss/lib/addons/_hide-text.scss +27 -0
- data/assets/uswds/scss/lib/addons/_margin.scss +26 -0
- data/assets/uswds/scss/lib/addons/_padding.scss +26 -0
- data/assets/uswds/scss/lib/addons/_position.scss +48 -0
- data/assets/uswds/scss/lib/addons/_prefixer.scss +66 -0
- data/assets/uswds/scss/lib/addons/_retina-image.scss +25 -0
- data/assets/uswds/scss/lib/addons/_size.scss +51 -0
- data/assets/uswds/scss/lib/addons/_text-inputs.scss +113 -0
- data/assets/uswds/scss/lib/addons/_timing-functions.scss +34 -0
- data/assets/uswds/scss/lib/addons/_triangle.scss +63 -0
- data/assets/uswds/scss/lib/addons/_word-wrap.scss +29 -0
- data/assets/uswds/scss/lib/css3/_animation.scss +43 -0
- data/assets/uswds/scss/lib/css3/_appearance.scss +3 -0
- data/assets/uswds/scss/lib/css3/_backface-visibility.scss +3 -0
- data/assets/uswds/scss/lib/css3/_background-image.scss +42 -0
- data/assets/uswds/scss/lib/css3/_background.scss +55 -0
- data/assets/uswds/scss/lib/css3/_border-image.scss +59 -0
- data/assets/uswds/scss/lib/css3/_calc.scss +4 -0
- data/assets/uswds/scss/lib/css3/_columns.scss +47 -0
- data/assets/uswds/scss/lib/css3/_filter.scss +4 -0
- data/assets/uswds/scss/lib/css3/_flex-box.scss +287 -0
- data/assets/uswds/scss/lib/css3/_font-face.scss +24 -0
- data/assets/uswds/scss/lib/css3/_font-feature-settings.scss +4 -0
- data/assets/uswds/scss/lib/css3/_hidpi-media-query.scss +10 -0
- data/assets/uswds/scss/lib/css3/_hyphens.scss +4 -0
- data/assets/uswds/scss/lib/css3/_image-rendering.scss +14 -0
- data/assets/uswds/scss/lib/css3/_keyframes.scss +36 -0
- data/assets/uswds/scss/lib/css3/_linear-gradient.scss +38 -0
- data/assets/uswds/scss/lib/css3/_perspective.scss +8 -0
- data/assets/uswds/scss/lib/css3/_placeholder.scss +8 -0
- data/assets/uswds/scss/lib/css3/_radial-gradient.scss +39 -0
- data/assets/uswds/scss/lib/css3/_selection.scss +42 -0
- data/assets/uswds/scss/lib/css3/_text-decoration.scss +19 -0
- data/assets/uswds/scss/lib/css3/_transform.scss +15 -0
- data/assets/uswds/scss/lib/css3/_transition.scss +71 -0
- data/assets/uswds/scss/lib/css3/_user-select.scss +3 -0
- data/assets/uswds/scss/lib/functions/_assign-inputs.scss +11 -0
- data/assets/uswds/scss/lib/functions/_contains-falsy.scss +20 -0
- data/assets/uswds/scss/lib/functions/_contains.scss +26 -0
- data/assets/uswds/scss/lib/functions/_is-length.scss +11 -0
- data/assets/uswds/scss/lib/functions/_is-light.scss +21 -0
- data/assets/uswds/scss/lib/functions/_is-number.scss +11 -0
- data/assets/uswds/scss/lib/functions/_is-size.scss +13 -0
- data/assets/uswds/scss/lib/functions/_modular-scale.scss +69 -0
- data/assets/uswds/scss/lib/functions/_new-breakpoint.scss +49 -0
- data/assets/uswds/scss/lib/functions/_private.scss +114 -0
- data/assets/uswds/scss/lib/functions/_px-to-em.scss +13 -0
- data/assets/uswds/scss/lib/functions/_px-to-rem.scss +15 -0
- data/assets/uswds/scss/lib/functions/_shade.scss +24 -0
- data/assets/uswds/scss/lib/functions/_strip-units.scss +17 -0
- data/assets/uswds/scss/lib/functions/_tint.scss +24 -0
- data/assets/uswds/scss/lib/functions/_transition-property-name.scss +22 -0
- data/assets/uswds/scss/lib/functions/_unpack.scss +27 -0
- data/assets/uswds/scss/lib/grid/_box-sizing.scss +15 -0
- data/assets/uswds/scss/lib/grid/_direction-context.scss +33 -0
- data/assets/uswds/scss/lib/grid/_display-context.scss +28 -0
- data/assets/uswds/scss/lib/grid/_fill-parent.scss +22 -0
- data/assets/uswds/scss/lib/grid/_media.scss +92 -0
- data/assets/uswds/scss/lib/grid/_omega.scss +87 -0
- data/assets/uswds/scss/lib/grid/_outer-container.scss +34 -0
- data/assets/uswds/scss/lib/grid/_pad.scss +25 -0
- data/assets/uswds/scss/lib/grid/_private.scss +35 -0
- data/assets/uswds/scss/lib/grid/_row.scss +52 -0
- data/assets/uswds/scss/lib/grid/_shift.scss +50 -0
- data/assets/uswds/scss/lib/grid/_span-columns.scss +94 -0
- data/assets/uswds/scss/lib/grid/_to-deprecate.scss +97 -0
- data/assets/uswds/scss/lib/grid/_visual-grid.scss +42 -0
- data/assets/uswds/scss/lib/helpers/_convert-units.scss +21 -0
- data/assets/uswds/scss/lib/helpers/_directional-values.scss +96 -0
- data/assets/uswds/scss/lib/helpers/_font-source-declaration.scss +43 -0
- data/assets/uswds/scss/lib/helpers/_gradient-positions-parser.scss +13 -0
- data/assets/uswds/scss/lib/helpers/_linear-angle-parser.scss +25 -0
- data/assets/uswds/scss/lib/helpers/_linear-gradient-parser.scss +41 -0
- data/assets/uswds/scss/lib/helpers/_linear-positions-parser.scss +61 -0
- data/assets/uswds/scss/lib/helpers/_linear-side-corner-parser.scss +31 -0
- data/assets/uswds/scss/lib/helpers/_radial-arg-parser.scss +69 -0
- data/assets/uswds/scss/lib/helpers/_radial-gradient-parser.scss +50 -0
- data/assets/uswds/scss/lib/helpers/_radial-positions-parser.scss +18 -0
- data/assets/uswds/scss/lib/helpers/_render-gradients.scss +26 -0
- data/assets/uswds/scss/lib/helpers/_shape-size-stripper.scss +10 -0
- data/assets/uswds/scss/lib/helpers/_str-to-num.scss +50 -0
- data/assets/uswds/scss/lib/mixins/_clearfix.scss +25 -0
- data/assets/uswds/scss/lib/settings/_asset-pipeline.scss +7 -0
- data/assets/uswds/scss/lib/settings/_disable-warnings.scss +13 -0
- data/assets/uswds/scss/lib/settings/_grid.scss +51 -0
- data/assets/uswds/scss/lib/settings/_prefixer.scss +9 -0
- data/assets/uswds/scss/lib/settings/_px-to-em.scss +1 -0
- data/assets/uswds/scss/lib/settings/_visual-grid.scss +27 -0
- data/assets/uswds/scss/uswds.scss +41 -0
- data/assets/uswds/uswds-1.3.1.zip +0 -0
- metadata +490 -0
@@ -0,0 +1,50 @@
|
|
1
|
+
@function _radial-gradient-parser($image) {
|
2
|
+
$image: unquote($image);
|
3
|
+
$gradients: ();
|
4
|
+
$start: str-index($image, "(");
|
5
|
+
$end: str-index($image, ",");
|
6
|
+
$first-val: str-slice($image, $start + 1, $end - 1);
|
7
|
+
|
8
|
+
$prefix: str-slice($image, 1, $start);
|
9
|
+
$suffix: str-slice($image, $end, str-length($image));
|
10
|
+
|
11
|
+
$is-spec-syntax: str-index($first-val, "at");
|
12
|
+
|
13
|
+
@if $is-spec-syntax and $is-spec-syntax > 1 {
|
14
|
+
$keyword: str-slice($first-val, 1, $is-spec-syntax - 2);
|
15
|
+
$pos: str-slice($first-val, $is-spec-syntax + 3, str-length($first-val));
|
16
|
+
$pos: append($pos, $keyword, comma);
|
17
|
+
|
18
|
+
$gradients: (
|
19
|
+
webkit-image: -webkit- + $prefix + $pos + $suffix,
|
20
|
+
spec-image: $image
|
21
|
+
);
|
22
|
+
}
|
23
|
+
|
24
|
+
@else if $is-spec-syntax == 1 {
|
25
|
+
$pos: str-slice($first-val, $is-spec-syntax + 3, str-length($first-val));
|
26
|
+
|
27
|
+
$gradients: (
|
28
|
+
webkit-image: -webkit- + $prefix + $pos + $suffix,
|
29
|
+
spec-image: $image
|
30
|
+
);
|
31
|
+
}
|
32
|
+
|
33
|
+
@else if str-index($image, "cover") or str-index($image, "contain") {
|
34
|
+
@warn "Radial-gradient needs to be updated to conform to latest spec.";
|
35
|
+
|
36
|
+
$gradients: (
|
37
|
+
webkit-image: null,
|
38
|
+
spec-image: $image
|
39
|
+
);
|
40
|
+
}
|
41
|
+
|
42
|
+
@else {
|
43
|
+
$gradients: (
|
44
|
+
webkit-image: -webkit- + $image,
|
45
|
+
spec-image: $image
|
46
|
+
);
|
47
|
+
}
|
48
|
+
|
49
|
+
@return $gradients;
|
50
|
+
}
|
@@ -0,0 +1,18 @@
|
|
1
|
+
@function _radial-positions-parser($gradient-pos) {
|
2
|
+
$shape-size: nth($gradient-pos, 1);
|
3
|
+
$pos: nth($gradient-pos, 2);
|
4
|
+
$shape-size-spec: _shape-size-stripper($shape-size);
|
5
|
+
|
6
|
+
$pre-spec: unquote(if($pos, "#{$pos}, ", null))
|
7
|
+
unquote(if($shape-size, "#{$shape-size},", null));
|
8
|
+
$pos-spec: if($pos, "at #{$pos}", null);
|
9
|
+
|
10
|
+
$spec: "#{$shape-size-spec} #{$pos-spec}";
|
11
|
+
|
12
|
+
// Add comma
|
13
|
+
@if ($spec != " ") {
|
14
|
+
$spec: "#{$spec},";
|
15
|
+
}
|
16
|
+
|
17
|
+
@return $pre-spec $spec;
|
18
|
+
}
|
@@ -0,0 +1,26 @@
|
|
1
|
+
// User for linear and radial gradients within background-image or border-image properties
|
2
|
+
|
3
|
+
@function _render-gradients($gradient-positions, $gradients, $gradient-type, $vendor: false) {
|
4
|
+
$pre-spec: null;
|
5
|
+
$spec: null;
|
6
|
+
$vendor-gradients: null;
|
7
|
+
@if $gradient-type == linear {
|
8
|
+
@if $gradient-positions {
|
9
|
+
$pre-spec: nth($gradient-positions, 1);
|
10
|
+
$spec: nth($gradient-positions, 2);
|
11
|
+
}
|
12
|
+
}
|
13
|
+
@else if $gradient-type == radial {
|
14
|
+
$pre-spec: nth($gradient-positions, 1);
|
15
|
+
$spec: nth($gradient-positions, 2);
|
16
|
+
}
|
17
|
+
|
18
|
+
@if $vendor {
|
19
|
+
$vendor-gradients: -#{$vendor}-#{$gradient-type}-gradient(#{$pre-spec} $gradients);
|
20
|
+
}
|
21
|
+
@else if $vendor == false {
|
22
|
+
$vendor-gradients: "#{$gradient-type}-gradient(#{$spec} #{$gradients})";
|
23
|
+
$vendor-gradients: unquote($vendor-gradients);
|
24
|
+
}
|
25
|
+
@return $vendor-gradients;
|
26
|
+
}
|
@@ -0,0 +1,10 @@
|
|
1
|
+
@function _shape-size-stripper($shape-size) {
|
2
|
+
$shape-size-spec: null;
|
3
|
+
@each $value in $shape-size {
|
4
|
+
@if ($value == "cover") or ($value == "contain") {
|
5
|
+
$value: null;
|
6
|
+
}
|
7
|
+
$shape-size-spec: "#{$shape-size-spec} #{$value}";
|
8
|
+
}
|
9
|
+
@return $shape-size-spec;
|
10
|
+
}
|
@@ -0,0 +1,50 @@
|
|
1
|
+
//************************************************************************//
|
2
|
+
// Helper function for linear/radial-gradient-parsers.
|
3
|
+
// Source: http://sassmeister.com/gist/9647408
|
4
|
+
//************************************************************************//
|
5
|
+
@function _str-to-num($string) {
|
6
|
+
// Matrices
|
7
|
+
$strings: "0" "1" "2" "3" "4" "5" "6" "7" "8" "9";
|
8
|
+
$numbers: 0 1 2 3 4 5 6 7 8 9;
|
9
|
+
|
10
|
+
// Result
|
11
|
+
$result: 0;
|
12
|
+
$divider: 0;
|
13
|
+
$minus: false;
|
14
|
+
|
15
|
+
// Looping through all characters
|
16
|
+
@for $i from 1 through str-length($string) {
|
17
|
+
$character: str-slice($string, $i, $i);
|
18
|
+
$index: index($strings, $character);
|
19
|
+
|
20
|
+
@if $character == "-" {
|
21
|
+
$minus: true;
|
22
|
+
}
|
23
|
+
|
24
|
+
@else if $character == "." {
|
25
|
+
$divider: 1;
|
26
|
+
}
|
27
|
+
|
28
|
+
@else {
|
29
|
+
@if not $index {
|
30
|
+
$result: if($minus, $result * -1, $result);
|
31
|
+
@return _convert-units($result, str-slice($string, $i));
|
32
|
+
}
|
33
|
+
|
34
|
+
$number: nth($numbers, $index);
|
35
|
+
|
36
|
+
@if $divider == 0 {
|
37
|
+
$result: $result * 10;
|
38
|
+
}
|
39
|
+
|
40
|
+
@else {
|
41
|
+
// Move the decimal dot to the left
|
42
|
+
$divider: $divider * 10;
|
43
|
+
$number: $number / $divider;
|
44
|
+
}
|
45
|
+
|
46
|
+
$result: $result + $number;
|
47
|
+
}
|
48
|
+
}
|
49
|
+
@return if($minus, $result * -1, $result);
|
50
|
+
}
|
@@ -0,0 +1,25 @@
|
|
1
|
+
@charset "UTF-8";
|
2
|
+
|
3
|
+
/// Provides an easy way to include a clearfix for containing floats.
|
4
|
+
///
|
5
|
+
/// @link http://goo.gl/yP5hiZ
|
6
|
+
///
|
7
|
+
/// @example scss
|
8
|
+
/// .element {
|
9
|
+
/// @include clearfix;
|
10
|
+
/// }
|
11
|
+
///
|
12
|
+
/// @example css
|
13
|
+
/// .element::after {
|
14
|
+
/// clear: both;
|
15
|
+
/// content: "";
|
16
|
+
/// display: block;
|
17
|
+
/// }
|
18
|
+
|
19
|
+
@mixin clearfix {
|
20
|
+
&::after {
|
21
|
+
clear: both;
|
22
|
+
content: "";
|
23
|
+
display: block;
|
24
|
+
}
|
25
|
+
}
|
@@ -0,0 +1,13 @@
|
|
1
|
+
@charset "UTF-8";
|
2
|
+
|
3
|
+
/// Disable all deprecation warnings. Defaults to `false`. Set with a `!global` flag.
|
4
|
+
///
|
5
|
+
/// @type Bool
|
6
|
+
|
7
|
+
$disable-warnings: false !default;
|
8
|
+
|
9
|
+
@mixin -neat-warn($message) {
|
10
|
+
@if $disable-warnings == false {
|
11
|
+
@warn "#{$message}";
|
12
|
+
}
|
13
|
+
}
|
@@ -0,0 +1,51 @@
|
|
1
|
+
@charset "UTF-8";
|
2
|
+
|
3
|
+
/// Sets the relative width of a single grid column. The unit used should be the same one used to define `$gutter`. Set with a `!global` flag.
|
4
|
+
///
|
5
|
+
/// @type Number (Unit)
|
6
|
+
|
7
|
+
$column: 4.2358em !default;
|
8
|
+
|
9
|
+
/// Sets the relative width of a single grid gutter. The unit used should be the same one used to define `$column`. Set with the `!global` flag.
|
10
|
+
///
|
11
|
+
/// @type Number (Unit)
|
12
|
+
|
13
|
+
$gutter: 1.618em !default;
|
14
|
+
|
15
|
+
/// Sets the total number of columns in the grid. Its value can be overridden inside a media query using the `media()` mixin. Set with the `!global` flag.
|
16
|
+
///
|
17
|
+
/// @type Number (Unitless)
|
18
|
+
|
19
|
+
$grid-columns: 12 !default;
|
20
|
+
|
21
|
+
/// Sets the max-width property of the element that includes `outer-container()`. Set with the `!global` flag.
|
22
|
+
///
|
23
|
+
/// @type Number (Unit)
|
24
|
+
///
|
25
|
+
$max-width: 1200px !default;
|
26
|
+
|
27
|
+
/// When set to true, it sets the box-sizing property of all elements to `border-box`. Set with a `!global` flag.
|
28
|
+
///
|
29
|
+
/// @type Bool
|
30
|
+
///
|
31
|
+
/// @example css - CSS Output
|
32
|
+
/// html {
|
33
|
+
/// box-sizing: border-box; }
|
34
|
+
///
|
35
|
+
/// *, *::after, *::before {
|
36
|
+
/// box-sizing: inherit;
|
37
|
+
/// }
|
38
|
+
|
39
|
+
$border-box-sizing: true !default;
|
40
|
+
|
41
|
+
/// Sets the default [media feature](http://www.w3.org/TR/css3-mediaqueries/#media) that `media()` and `new-breakpoint()` revert to when only a breakpoint value is passed. Set with a `!global` flag.
|
42
|
+
///
|
43
|
+
/// @type String
|
44
|
+
|
45
|
+
$default-feature: min-width; // Default @media feature for the breakpoint() mixin
|
46
|
+
|
47
|
+
///Sets the default layout direction of the grid. Can be `LTR` or `RTL`. Set with a `!global` flag.
|
48
|
+
///
|
49
|
+
///@type String
|
50
|
+
|
51
|
+
$default-layout-direction: LTR !default;
|
@@ -0,0 +1,9 @@
|
|
1
|
+
@charset "UTF-8";
|
2
|
+
|
3
|
+
/// Global variables to enable or disable vendor prefixes
|
4
|
+
|
5
|
+
$prefix-for-webkit: true !default;
|
6
|
+
$prefix-for-mozilla: true !default;
|
7
|
+
$prefix-for-microsoft: true !default;
|
8
|
+
$prefix-for-opera: true !default;
|
9
|
+
$prefix-for-spec: true !default;
|
@@ -0,0 +1 @@
|
|
1
|
+
$em-base: 16px !default;
|
@@ -0,0 +1,27 @@
|
|
1
|
+
@charset "UTF-8";
|
2
|
+
|
3
|
+
/// Displays the visual grid when set to true. The overlaid grid may be few pixels off depending on the browser's rendering engine and pixel rounding algorithm. Set with the `!global` flag.
|
4
|
+
///
|
5
|
+
/// @type Bool
|
6
|
+
|
7
|
+
$visual-grid: false !default;
|
8
|
+
|
9
|
+
/// Sets the visual grid color. Set with `!global` flag.
|
10
|
+
///
|
11
|
+
/// @type Color
|
12
|
+
|
13
|
+
$visual-grid-color: #eee !default;
|
14
|
+
|
15
|
+
/// Sets the `z-index` property of the visual grid. Can be `back` (behind content) or `front` (in front of content). Set with `!global` flag.
|
16
|
+
///
|
17
|
+
/// @type String
|
18
|
+
|
19
|
+
$visual-grid-index: back !default;
|
20
|
+
|
21
|
+
/// Sets the opacity property of the visual grid. Set with `!global` flag.
|
22
|
+
///
|
23
|
+
/// @type Number (unitless)
|
24
|
+
|
25
|
+
$visual-grid-opacity: 0.4 !default;
|
26
|
+
|
27
|
+
$visual-grid-breakpoints: () !default;
|
@@ -0,0 +1,41 @@
|
|
1
|
+
/*! uswds @version */
|
2
|
+
|
3
|
+
// Vendor -------------- //
|
4
|
+
@import 'lib/bourbon';
|
5
|
+
@import 'lib/neat';
|
6
|
+
@import 'lib/normalize';
|
7
|
+
|
8
|
+
// Core -------------- //
|
9
|
+
@import 'core/variables';
|
10
|
+
@import 'core/fonts';
|
11
|
+
@import 'core/base';
|
12
|
+
@import 'core/grid';
|
13
|
+
@import 'core/utilities';
|
14
|
+
|
15
|
+
// Elements -------------- //
|
16
|
+
// Styles basic HTML elements
|
17
|
+
@import 'elements/buttons';
|
18
|
+
@import 'elements/embed';
|
19
|
+
@import 'elements/figure';
|
20
|
+
@import 'elements/inputs';
|
21
|
+
@import 'elements/labels';
|
22
|
+
@import 'elements/list';
|
23
|
+
@import 'elements/table';
|
24
|
+
@import 'elements/typography';
|
25
|
+
|
26
|
+
// Components -------------- //
|
27
|
+
@import 'components/accordions';
|
28
|
+
@import 'components/alerts';
|
29
|
+
@import 'components/banner';
|
30
|
+
@import 'components/footer';
|
31
|
+
@import 'components/forms';
|
32
|
+
@import 'components/graphic-list';
|
33
|
+
@import 'components/header';
|
34
|
+
@import 'components/hero';
|
35
|
+
@import 'components/layout';
|
36
|
+
@import 'components/media-block';
|
37
|
+
@import 'components/navigation';
|
38
|
+
@import 'components/search';
|
39
|
+
@import 'components/section';
|
40
|
+
@import 'components/sidenav';
|
41
|
+
@import 'components/skipnav';
|
@@ -0,0 +1,145 @@
|
|
1
|
+
## Welcome!
|
2
|
+
|
3
|
+
We’re so glad you’re thinking about contributing to an 18F open source project! If you’re unsure about anything, just ask — or submit your issue or pull request anyway. The worst that can happen is we’ll politely ask you to change something. We appreciate all friendly contributions.
|
4
|
+
|
5
|
+
One of our goals is to ensure a welcoming environment for all contributors to our projects. Our staff follows the [18F Code of Conduct](https://18f.gsa.gov/code-of-conduct/), and all contributors should do the same.
|
6
|
+
|
7
|
+
We encourage you to read this project’s CONTRIBUTING policy (you are here), its [LICENSE](https://github.com/18F/web-design-standards/blob/develop/LICENSE.md), [README](https://github.com/18F/web-design-standards/blob/develop/README.md) and its [Workflow](https://github.com/18F/web-design-standards/wiki/Workflow) process.
|
8
|
+
|
9
|
+
If you have any questions or want to read more, check out the [18F Open Source Policy GitHub repository]( https://github.com/18f/open-source-policy), or just [shoot us an email](mailto:18f@gsa.gov).
|
10
|
+
|
11
|
+
## Guidelines
|
12
|
+
|
13
|
+
### Contributor Guidelines for Design
|
14
|
+
|
15
|
+
We have provided some guidelines for folks that would like to submit new components to the U.S. Web Design Standards and the lifecycle those new components will go through. For more detail, please visit the [guidelines on our wiki](https://github.com/18F/web-design-standards/wiki/Contribution-Guidelines:-Design).
|
16
|
+
|
17
|
+
### Submitting an issue
|
18
|
+
|
19
|
+
To help us get a better understanding of the issue you’re submitting, follow our ISSUE TEMPLATE and the guidelines it describes.
|
20
|
+
|
21
|
+
### Submitting a pull request
|
22
|
+
|
23
|
+
Here are a few guidelines to follow when submitting a pull request:
|
24
|
+
|
25
|
+
1. Create a GitHub account or sign in to your existing account.
|
26
|
+
1. Fork this repo into your GitHub account (or just clone it if you’re an 18F team member). Read more about forking a repo here on GitHub:
|
27
|
+
[https://help.github.com/articles/fork-a-repo/](https://help.github.com/articles/fork-a-repo/)
|
28
|
+
1. Create a branch from `develop` that lightly defines what you’re working on (for example, add-styles).
|
29
|
+
1. Ensure that your contribution works via `npm`, if applicable.
|
30
|
+
1. Once you’re ready to submit a pull request, fill out the PULL REQUEST template provided.
|
31
|
+
1. Submit your pull request against the `develop` branch.
|
32
|
+
|
33
|
+
[Open an issue](https://github.com/18F/web-design-standards/issues/new) if you have questions or need help with setup.
|
34
|
+
|
35
|
+
### Running locally
|
36
|
+
|
37
|
+
The U.S. Web Design Standards `uswds` package (the zip download and the
|
38
|
+
files needed to use the Standards on your project) is built primarily with
|
39
|
+
two [Node.js] tools: [Fractal] and [Gulp]. Once you've cloned this
|
40
|
+
repository, you'll need to install its dependencies:
|
41
|
+
|
42
|
+
```sh
|
43
|
+
npm install
|
44
|
+
```
|
45
|
+
|
46
|
+
**ProTip**: You can also use [Yarn], which tends to install dependencies more quickly than npm.
|
47
|
+
|
48
|
+
To start the [Fractal] live reload server, run:
|
49
|
+
|
50
|
+
```sh
|
51
|
+
npm start
|
52
|
+
```
|
53
|
+
|
54
|
+
Then, visit [localhost:3000](http://localhost:3000) in a web browser to
|
55
|
+
peruse the component library. While the server is running, any changes that
|
56
|
+
you make to the component templates or configurations will reload the page
|
57
|
+
automatically.
|
58
|
+
|
59
|
+
If you're working on the JavaScript or CSS, you can run the "watch" task in
|
60
|
+
another shell to automatically rebuild the distribution files that Fractal
|
61
|
+
references with:
|
62
|
+
|
63
|
+
```sh
|
64
|
+
npm run watch
|
65
|
+
```
|
66
|
+
|
67
|
+
### Testing
|
68
|
+
|
69
|
+
To run the component unit tests, run:
|
70
|
+
|
71
|
+
```sh
|
72
|
+
npm test
|
73
|
+
```
|
74
|
+
|
75
|
+
This will also run [eslint] and [stylelint] to ensure that the JavaScript
|
76
|
+
and SCSS source files meet our coding standards. To lint without the unit
|
77
|
+
tests, you'll need [Gulp][]. Install it globally (`npm install -g
|
78
|
+
gulp-cli`), then run:
|
79
|
+
|
80
|
+
```sh
|
81
|
+
gulp eslint
|
82
|
+
gulp stylelint
|
83
|
+
```
|
84
|
+
|
85
|
+
(Or, if you don't want to install Gulp globally, you can run `$(npm
|
86
|
+
bin)/gulp` instead of `gulp`.)
|
87
|
+
|
88
|
+
### Building
|
89
|
+
|
90
|
+
To build the `uswds` package in preparation for releases, run:
|
91
|
+
|
92
|
+
```sh
|
93
|
+
npm run build:package
|
94
|
+
# or
|
95
|
+
gulp release
|
96
|
+
```
|
97
|
+
|
98
|
+
## Coding guidelines
|
99
|
+
|
100
|
+
The purpose of our coding styleguides are to create consistent coding practices across 18F. The styleguide should be treated as a guide — rules can be modified according to project needs.
|
101
|
+
|
102
|
+
This project follows the 18F Front End Guide [CSS](https://pages.18f.gov/frontend/#css) and [JavaScript](https://pages.18f.gov/frontend/#javascript). Please use this guide for your reference.
|
103
|
+
|
104
|
+
### Code coverage
|
105
|
+
|
106
|
+
We use [code coverage](https://en.wikipedia.org/wiki/Code_coverage) tools to understand how much of our JavaScript is tested by our [unit test suite](spec/unit). Code coverage is one way (among many) of measuring code _quality_ more generally. Here's how it works for contributions:
|
107
|
+
|
108
|
+
1. Each pull request creates a new coverage report on [Code Climate](https://codeclimate.com/).
|
109
|
+
1. Code Climate then posts a status message back to GitHub that lists the coverage percentage on that branch, and the difference between that number and the one last reported on our default branch.
|
110
|
+
|
111
|
+
For JavaScript contributions, we will review the code coverage percentage and change to ensure that the quality of our code is not dramatically affected.
|
112
|
+
|
113
|
+
High code coverage numbers are generally good, and we would prefer that our coverage increases over time. We will not categorically reject contributions that reduce code coverage, but we may ask contributors to refactor their code, add new unit tests, or modify existing tests to avoid significant reductions in coverage.
|
114
|
+
|
115
|
+
## Our use of branches
|
116
|
+
|
117
|
+
See the [release documentation](RELEASE.md#release-process) for more information on our git/GitHub release workflow.
|
118
|
+
|
119
|
+
## Licenses and attribution
|
120
|
+
|
121
|
+
### A few parts of this project are not in the public domain
|
122
|
+
|
123
|
+
For complete attribution and licensing information for parts of the project that are not in the public domain, see [LICENSE.md](https://github.com/18F/web-design-standards/blob/develop/LICENSE.md).
|
124
|
+
|
125
|
+
### The rest of this project is in the public domain
|
126
|
+
|
127
|
+
The rest of this project is in the worldwide [public domain](https://github.com/18F/web-design-standards/blob/develop/LICENSE.md).
|
128
|
+
|
129
|
+
This project is in the public domain within the United States, and
|
130
|
+
copyright and related rights in the work worldwide are waived through
|
131
|
+
the [CC0 1.0 Universal public domain dedication](https://creativecommons.org/publicdomain/zero/1.0/).
|
132
|
+
|
133
|
+
### Contributions will be released into the public domain
|
134
|
+
|
135
|
+
All contributions to this project will be released under the CC0
|
136
|
+
dedication. By submitting a pull request, you are agreeing to comply
|
137
|
+
with this waiver of copyright interest.
|
138
|
+
|
139
|
+
|
140
|
+
[Node.js]: https://nodejs.org
|
141
|
+
[Fractal]: http://fractal.build
|
142
|
+
[Gulp]: http://gulpjs.com/
|
143
|
+
[Yarn]: https://yarnpkg.com/
|
144
|
+
[eslint]: http://eslint.org/
|
145
|
+
[stylelint]: https://stylelint.io/
|