From 2ccf75c7e2d70ccd9fa38a55fba9554826529097 Mon Sep 17 00:00:00 2001 From: Miriam Suzanne Date: Mon, 19 Jun 2017 10:31:06 -0600 Subject: [PATCH] Bump v3.0.0-beta.1 (breaking) --- .gitignore | 1 + .sassdoc/a-config.html | 4 +- .sassdoc/assets/css/json.css | 2 +- .sassdoc/assets/css/main.css | 2 +- .sassdoc/assets/css/theme.css | 3 -- .sassdoc/assets/js/base.js | 2 +- .sassdoc/assets/js/init.js | 2 +- .sassdoc/assets/js/srcdoc-polyfill.min.js | 60 +++++++++++++++++++++++ .sassdoc/b-api.html | 6 +-- .sassdoc/index.html | 9 ++-- .sassdoc/plugin-utils.html | 4 +- .sassdoc/plugin_svg-grid.html | 2 +- .sassdoc/su-math.html | 2 +- .sassdoc/x--validation.html | 2 +- .sassdoc/x-normal.html | 2 +- .sassdoc/x-parser.html | 2 +- CHANGELOG.md | 4 +- README.md | 1 + package.json | 4 +- yarn.lock | 6 +-- 20 files changed, 89 insertions(+), 31 deletions(-) delete mode 100644 .sassdoc/assets/css/theme.css create mode 100644 .sassdoc/assets/js/srcdoc-polyfill.min.js diff --git a/.gitignore b/.gitignore index c698305e..fc7188db 100644 --- a/.gitignore +++ b/.gitignore @@ -3,6 +3,7 @@ susy-*.gem *.DS_Store .sass-cache .rvmrc +.pages/ pkg/ *.sublime-* docs/_build/ diff --git a/.sassdoc/a-config.html b/.sassdoc/a-config.html index b7ec6dbe..cd39b3f9 100644 --- a/.sassdoc/a-config.html +++ b/.sassdoc/a-config.html @@ -1,4 +1,4 @@ -susy Documentation

susy 3.0.0-alpha.6

$susy (Map)

scss
$susy: () !default;

Description

The grid is defined in a single map variable, with four initial properties: columns, gutters, spread and container-spread. Anything you put in the root $susy variable map will be treated as a global project default. You can create similar configuration maps under different variable names, to override the defaults as-needed.

Map Properties

columns: (list)

Columns are described by a list of numbers, representing the relative width of each column. The syntax is a simplified version of CSS native grid-template-columns, expecting a list of grid-column widths. Unitless numbers create fractional fluid columns (similar to the CSS-native fr unit), while length values (united numbers) are used to define static columns. You can mix-and match units and fractions, to create a mixed grid. Susy will generate calc() values when necessary, to make all your units work together.

Use the susy-repeat($count, $value) function to more easily repetative columns, similar to the CSS-native repeat().

  • susy-repeat(8): an 8-column, symmetrical, fluid grid.
    Identical to (1 1 1 1 1 1 1 1).
  • susy-repeat(6, 8em): a 6-column, symmetrical, em-based grid.
    Identical to (8em 8em 8em 8em 8em 8em).

  • (300px susy-repeat(4) 300px): a 6-column, asymmetrical, mixed fluid/static grid using calc() output.
    Identical to (300px 1 1 1 1 300px).

    NOTE that 12 is no longer a valid 12-column grid definition, and you must list all the columns individually (or by using the susy-repeat() function).

gutters: (number)

Gutters are defined as a single width, or fluid ratio, similar to the native-CSS grid-column-gap syntax. Similar to columns, gutters can use any valid CSS length unit, or unitless numbers to define a relative fraction.

  • 0.5: a fluid gutter, half the size of a single-fraction column.

  • 1em: a static gutter, 1em wide.

    Mix static gutters with fluid columns, or vice versa, and Susy will generate the required calc() to make it work.

spread: narrow (string)

Spread of an element across adjacent gutters: either narrow (none), wide (one), or wider (two)

  • Both spread settings default to narrow, the most common use-case. A narrow spread only has gutters between columns (one less gutter than columns). This is how all css-native grids work, and most margin-based grid systems.
  • A wide spread includes the same number of gutters as columns, spanning across a single side-gutter. This is how most padding-based grid systems often work, and is also useful for pushing and pulling elements into place.
  • The rare wider spread includes gutters on both sides of the column-span (one more gutters than columns).

container-spread: narrow (string)

Spread of a container around adjacent gutters: either narrow (none), wide (one), or wider (two). See spread property for details.

Examples

scss default values
// 4 symmetrical, fluid columns
+susy Documentation
 
susy 3.0.0-beta.1
 $susy (Map)
scss
$susy: () !default;
Description
The grid is defined in a single map variable, with four initial properties: columns, gutters, spread and container-spread. Anything you put in the root $susy variable map will be treated as a global project default. You can create similar configuration maps under different variable names, to override the defaults as-needed.
Map Properties
columns: (list)
Columns are described by a list of numbers, representing the relative width of each column. The syntax is a simplified version of CSS native grid-template-columns, expecting a list of grid-column widths. Unitless numbers create fractional fluid columns (similar to the CSS-native fr unit), while length values (united numbers) are used to define static columns. You can mix-and match units and fractions, to create a mixed grid. Susy will generate calc() values when necessary, to make all your units work together.
Use the susy-repeat($count, $value) function to more easily repetative columns, similar to the CSS-native repeat().
  • susy-repeat(8): an 8-column, symmetrical, fluid grid.
    Identical to (1 1 1 1 1 1 1 1).
  • susy-repeat(6, 8em): a 6-column, symmetrical, em-based grid.
    Identical to (8em 8em 8em 8em 8em 8em).
  • (300px susy-repeat(4) 300px): a 6-column, asymmetrical, mixed fluid/static grid using calc() output.
    Identical to (300px 1 1 1 1 300px).
    NOTE that 12 is no longer a valid 12-column grid definition, and you must list all the columns individually (or by using the susy-repeat() function).
gutters: (number)
Gutters are defined as a single width, or fluid ratio, similar to the native-CSS grid-column-gap syntax. Similar to columns, gutters can use any valid CSS length unit, or unitless numbers to define a relative fraction.
  • 0.5: a fluid gutter, half the size of a single-fraction column.
  • 1em: a static gutter, 1em wide.
    Mix static gutters with fluid columns, or vice versa, and Susy will generate the required calc() to make it work.
spread: narrow (string)
Spread of an element across adjacent gutters: either narrow (none), wide (one), or wider (two)
  • Both spread settings default to narrow, the most common use-case. A narrow spread only has gutters between columns (one less gutter than columns). This is how all css-native grids work, and most margin-based grid systems.
  • A wide spread includes the same number of gutters as columns, spanning across a single side-gutter. This is how most padding-based grid systems often work, and is also useful for pushing and pulling elements into place.
  • The rare wider spread includes gutters on both sides of the column-span (one more gutters than columns).
container-spread: narrow (string)
Spread of a container around adjacent gutters: either narrow (none), wide (one), or wider (two). See spread property for details.
Examples
scss default values
// 4 symmetrical, fluid columns
 // gutters are 1/4 the size of a column
 // elements span 1 less gutter than columns
 // containers span 1 less gutter as well
@@ -42,4 +42,4 @@
 
requires
$_susy-defaults [private]
$susy (Map)
used by
@function susy-get()
@function susy-compile()
@function susy-normalize-columns()
@function susy-get()
Description
Return the current global value of any Susy setting
Parameters & Return
$key: (string)
Setting to retrieve from the configuration.
@return (*)
Value mapped to $key in the configuration maps, in order of specificity: $susy, then $_susy-defaults
Example
scss
/* columns: #{susy-get('columns')} */
 /* gutters: #{susy-get('gutters')} */
css compiled
/* columns: 1 1 1 1 */
 /* gutters: 0.25 */
-
requires
@function susy-settings()
@function _susy-error() [private]
used by
@function susy-svg-grid()
@function susy-normalize()

\ No newline at end of file
+

requires

@function susy-settings()

@function _susy-error() [private]

used by

@function susy-svg-grid()

@function susy-normalize()

\ No newline at end of file diff --git a/.sassdoc/assets/css/json.css b/.sassdoc/assets/css/json.css index 443532f0..3acd351a 100644 --- a/.sassdoc/assets/css/json.css +++ b/.sassdoc/assets/css/json.css @@ -1,3 +1,3 @@ -/*! json-encode: {"brand-colors": {"brand-orange": {"output": "#c75000", "rgba": "rgba(199, 80, 0, 1)", "hsla": "hsla(24deg, 100%, 39%, 1)"}, "brand-blue": {"output": "#0d7fa5", "rgba": "rgba(13, 127, 165, 1)", "hsla": "hsla(195deg, 85%, 35%, 1)"}, "brand-pink": {"output": "#e2127a", "rgba": "rgba(226, 18, 122, 1)", "hsla": "hsla(330deg, 85%, 48%, 1)"}}, "neutral-colors": {"light-gray": {"output": "#dedede", "rgba": "rgba(222, 222, 222, 1)", "hsla": "hsla(196deg, 0%, 87%, 1)"}, "gray": {"output": "#555b5e", "rgba": "rgba(85, 91, 94, 1)", "hsla": "hsla(195deg, 5%, 35%, 1)"}, "black": {"output": "#3b4042", "rgba": "rgba(59, 64, 66, 1)", "hsla": "hsla(195deg, 6%, 25%, 1)"}}, "status-colors": {"go": {"output": "#657e1b", "rgba": "rgba(101, 126, 27, 1)", "hsla": "hsla(75deg, 65%, 30%, 1)"}, "yield": {"output": "#c75000", "rgba": "rgba(199, 80, 0, 1)", "hsla": "hsla(24deg, 100%, 39%, 1)"}, "stop": {"output": "#ec1313", "rgba": "rgba(236, 19, 19, 1)", "hsla": "hsla(0deg, 85%, 50%, 1)"}}, "theme-colors": {"theme-dark": {"output": "#0d7fa5", "rgba": "rgba(13, 127, 165, 1)", "hsla": "hsla(195deg, 85%, 35%, 1)"}, "theme-light": {"output": "#cfe5ed", "rgba": "rgba(207, 229, 237, 1)", "hsla": "hsla(196deg, 45%, 87%, 1)"}, "background": {"output": "#fff", "rgba": "rgba(255, 255, 255, 1)", "hsla": "hsla(0deg, 0%, 100%, 1)"}, "text": {"output": "#3b4042", "rgba": "rgba(59, 64, 66, 1)", "hsla": "hsla(195deg, 6%, 25%, 1)"}, "text-light": {"output": "#555b5e", "rgba": "rgba(85, 91, 94, 1)", "hsla": "hsla(195deg, 5%, 35%, 1)"}, "border": {"output": "#555b5e", "rgba": "rgba(85, 91, 94, 1)", "hsla": "hsla(195deg, 5%, 35%, 1)"}, "light-border": {"output": "#dedede", "rgba": "rgba(222, 222, 222, 1)", "hsla": "hsla(196deg, 0%, 87%, 1)"}, "callout": {"output": "#dedede", "rgba": "rgba(222, 222, 222, 1)", "hsla": "hsla(196deg, 0%, 87%, 1)"}, "overlay": {"output": "rgba(222, 222, 222, 0.9)", "hsla": "hsla(196deg, 0%, 87%, 0.9)"}, "shadow": {"output": "rgba(85, 91, 94, 0.5)", "hsla": "hsla(195deg, 5%, 35%, 0.5)"}, "action": {"output": "#0d7fa5", "rgba": "rgba(13, 127, 165, 1)", "hsla": "hsla(195deg, 85%, 35%, 1)"}, "focus": {"output": "#0a5f7c", "rgba": "rgba(10, 95, 124, 1)", "hsla": "hsla(195deg, 85%, 26%, 1)"}, "active": {"output": "#0d7fa5", "rgba": "rgba(13, 127, 165, 1)", "hsla": "hsla(195deg, 85%, 35%, 1)"}, "accent": {"output": "#e2127a", "rgba": "rgba(226, 18, 122, 1)", "hsla": "hsla(330deg, 85%, 48%, 1)"}, "slight": {"output": "#fcfcfc", "rgba": "rgba(252, 252, 252, 1)", "hsla": "hsla(0deg, 0%, 99%, 1)"}, "code": {"output": "#587f8d", "rgba": "rgba(88, 127, 141, 1)", "hsla": "hsla(196deg, 23%, 45%, 1)"}, "code-shadow": {"output": "rgba(88, 127, 141, 0.2)", "hsla": "hsla(196deg, 23%, 45%, 0.2)"}}, "system-colors": {"contrast-light": {"output": "#fff", "rgba": "rgba(255, 255, 255, 1)", "hsla": "hsla(0deg, 0%, 100%, 1)"}, "contrast-dark": {"output": "#3b4042", "rgba": "rgba(59, 64, 66, 1)", "hsla": "hsla(195deg, 6%, 25%, 1)"}}, "text-ratios": {"herman": 1.4}, "text-sizes": {"root": "18px", "large-rem": "1.11111rem", "base-rem": "1rem", "small-rem": "0.88889rem", "large": "calc(1rem + 1.5vw)", "base": "calc(.88889rem + .5vw)", "small": "calc(.88889rem + .25vw)", "code": "calc(0.75rem + 0.25vw)", "h1": "calc(1rem + 2.5vw)", "h2": "calc(1rem + 2vw)", "h3": "calc(1rem + 1.5vw)"}, "spacing-sizes": {"rhythm": "1.4rem", "gutter": "1.4rem", "flex-gutter": "calc(.7rem + 2.5vw)", "double-gutter": "2.8rem", "spacer": "4.2rem", "double-spacer": "8.4rem", "shim": "0.7rem", "half-shim": "0.35rem", "quarter-shim": "0.175rem"}, "pattern-sizes": {"border": "8px", "page": "50rem", "nav-small": "21rem", "nav-medium": "32rem", "project-link-nav": "36rem", "specimen": "4.2rem", "color-swatch": "5.6rem", "icon": "28px", "nav-underline": "4px"}, "sans": {"name": "Source Sans Pro", "source": "https://fonts.google.com/specimen/Source+Sans+Pro", "stack": ["Helvetica Neue", "Helvetica", "Arial", "sans-serif"]}, "code": {"name": "Source Code Pro", "source": "https://fonts.google.com/specimen/Source+Code+Pro", "stack": ["Consolas", "Menlo", "Monaco", "Lucida Console", "Liberation Mono", "DejaVu Sans Mono", "Bitstream Vera Sans Mono", "Courier New", "monospace", "sans-serif"]}} */ +/*! json-encode: {"brand-colors": {"brand-orange": {"output": "#c75000", "rgba": "rgba(199, 80, 0, 1)", "hsla": "hsla(24deg, 100%, 39%, 1)"}, "brand-blue": {"output": "#0d7fa5", "rgba": "rgba(13, 127, 165, 1)", "hsla": "hsla(195deg, 85%, 35%, 1)"}, "brand-pink": {"output": "#e2127a", "rgba": "rgba(226, 18, 122, 1)", "hsla": "hsla(330deg, 85%, 48%, 1)"}}, "neutral-colors": {"light-gray": {"output": "#dedede", "rgba": "rgba(222, 222, 222, 1)", "hsla": "hsla(196deg, 0%, 87%, 1)"}, "gray": {"output": "#555b5e", "rgba": "rgba(85, 91, 94, 1)", "hsla": "hsla(195deg, 5%, 35%, 1)"}, "black": {"output": "#3b4042", "rgba": "rgba(59, 64, 66, 1)", "hsla": "hsla(195deg, 6%, 25%, 1)"}}, "status-colors": {"go": {"output": "#657e1b", "rgba": "rgba(101, 126, 27, 1)", "hsla": "hsla(75deg, 65%, 30%, 1)"}, "yield": {"output": "#c75000", "rgba": "rgba(199, 80, 0, 1)", "hsla": "hsla(24deg, 100%, 39%, 1)"}, "stop": {"output": "#ec1313", "rgba": "rgba(236, 19, 19, 1)", "hsla": "hsla(0deg, 85%, 50%, 1)"}}, "theme-colors": {"theme-dark": {"output": "#0d7fa5", "rgba": "rgba(13, 127, 165, 1)", "hsla": "hsla(195deg, 85%, 35%, 1)"}, "theme-light": {"output": "#cfe5ed", "rgba": "rgba(207, 229, 237, 1)", "hsla": "hsla(196deg, 45%, 87%, 1)"}, "background": {"output": "#fff", "rgba": "rgba(255, 255, 255, 1)", "hsla": "hsla(0deg, 0%, 100%, 1)"}, "text": {"output": "#3b4042", "rgba": "rgba(59, 64, 66, 1)", "hsla": "hsla(195deg, 6%, 25%, 1)"}, "text-light": {"output": "#555b5e", "rgba": "rgba(85, 91, 94, 1)", "hsla": "hsla(195deg, 5%, 35%, 1)"}, "border": {"output": "#555b5e", "rgba": "rgba(85, 91, 94, 1)", "hsla": "hsla(195deg, 5%, 35%, 1)"}, "light-border": {"output": "#dedede", "rgba": "rgba(222, 222, 222, 1)", "hsla": "hsla(196deg, 0%, 87%, 1)"}, "callout": {"output": "#dedede", "rgba": "rgba(222, 222, 222, 1)", "hsla": "hsla(196deg, 0%, 87%, 1)"}, "overlay": {"output": "rgba(222, 222, 222, 0.9)", "hsla": "hsla(196deg, 0%, 87%, 0.9)"}, "shadow": {"output": "rgba(85, 91, 94, 0.5)", "hsla": "hsla(195deg, 5%, 35%, 0.5)"}, "action": {"output": "#0d7fa5", "rgba": "rgba(13, 127, 165, 1)", "hsla": "hsla(195deg, 85%, 35%, 1)"}, "focus": {"output": "#0a5f7c", "rgba": "rgba(10, 95, 124, 1)", "hsla": "hsla(195deg, 85%, 26%, 1)"}, "active": {"output": "#0d7fa5", "rgba": "rgba(13, 127, 165, 1)", "hsla": "hsla(195deg, 85%, 35%, 1)"}, "accent": {"output": "#e2127a", "rgba": "rgba(226, 18, 122, 1)", "hsla": "hsla(330deg, 85%, 48%, 1)"}, "slight": {"output": "#fcfcfc", "rgba": "rgba(252, 252, 252, 1)", "hsla": "hsla(0deg, 0%, 99%, 1)"}, "code": {"output": "#587f8d", "rgba": "rgba(88, 127, 141, 1)", "hsla": "hsla(196deg, 23%, 45%, 1)"}, "code-shadow": {"output": "rgba(88, 127, 141, 0.2)", "hsla": "hsla(196deg, 23%, 45%, 0.2)"}}, "system-colors": {"contrast-light": {"output": "#fff", "rgba": "rgba(255, 255, 255, 1)", "hsla": "hsla(0deg, 0%, 100%, 1)"}, "contrast-dark": {"output": "#3b4042", "rgba": "rgba(59, 64, 66, 1)", "hsla": "hsla(195deg, 6%, 25%, 1)"}}, "text-ratios": {"herman": 1.4}, "text-sizes": {"root": "18px", "large-rem": "1.11111rem", "base-rem": "1rem", "small-rem": "0.88889rem", "large": "calc(1rem + 1.5vw)", "medium": "calc(1rem + .5vw)", "base": "calc(.88889rem + .5vw)", "small": "calc(.88889rem + .25vw)", "code": "calc(0.75rem + 0.25vw)", "h1": "calc(1rem + 2.5vw)", "h2": "calc(1rem + 2vw)", "h3": "calc(1rem + 1.5vw)", "quote": "calc(1rem + .5vw)"}, "spacing-sizes": {"rhythm": "1.4rem", "gutter": "1.4rem", "flex-gutter": "calc(.7rem + 2.5vw)", "double-gutter": "2.8rem", "spacer": "4.2rem", "double-spacer": "8.4rem", "shim": "0.7rem", "half-shim": "0.35rem", "quarter-shim": "0.175rem"}, "pattern-sizes": {"border": "8px", "page": "50rem", "nav-small": "21rem", "nav-medium": "32rem", "project-link-nav": "36rem", "specimen": "4.2rem", "color-swatch": "5.6rem", "icon": "28px", "nav-underline": "4px"}, "sans": {"name": "Source Sans Pro", "source": "https://fonts.google.com/specimen/Source+Sans+Pro", "stack": ["Helvetica Neue", "Helvetica", "Arial", "sans-serif"]}, "code": {"name": "Source Code Pro", "source": "https://fonts.google.com/specimen/Source+Code+Pro", "stack": ["Consolas", "Menlo", "Monaco", "Lucida Console", "Liberation Mono", "DejaVu Sans Mono", "Bitstream Vera Sans Mono", "Courier New", "monospace", "sans-serif"]}} */ /*# sourceMappingURL=json.css.map */ diff --git a/.sassdoc/assets/css/main.css b/.sassdoc/assets/css/main.css index 4463a428..07209b34 100644 --- a/.sassdoc/assets/css/main.css +++ b/.sassdoc/assets/css/main.css @@ -1,3 +1,3 @@ -html{-ms-overflow-style:-ms-autohiding-scrollbar;-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%;-ms-text-size-adjust:100%;text-size-adjust:100%}main{display:block}details{display:block}pre{overflow:auto}progress{display:inline-block}summary{display:block}template{display:none}*,::before,::after{border-style:solid;border-width:0;-webkit-box-sizing:border-box;box-sizing:border-box}*{font-size:inherit;line-height:inherit;margin:0;padding:0}table{border-collapse:collapse;border-spacing:0}audio :not([controls]){display:none}[aria-busy='true']{cursor:progress}[aria-controls]{cursor:pointer}[aria-disabled]{cursor:default}[hidden]{display:none}button{overflow:visible}input{border-radius:0;line-height:normal}button,[type='button'],[type='reset'],[type='submit']{-webkit-appearance:button;-moz-appearance:button;appearance:button;cursor:pointer}button::-moz-focus-inner,[type='button']::-moz-focus-inner,[type='reset']::-moz-focus-inner,[type='submit']::-moz-focus-inner{border:0 none !important;padding:0 !important}[type='checkbox'],[type='radio']{-webkit-box-sizing:border-box;box-sizing:border-box;padding:0}[type='number']{width:auto}[type='search']{-webkit-appearance:textfield;-moz-appearance:textfield;appearance:textfield}button,input,select,textarea{background-color:transparent;color:inherit;font-family:inherit;font-style:inherit;font-weight:inherit}textarea{overflow:auto;resize:vertical}img{border:0}svg:not(:root){overflow:hidden}audio,canvas,iframe,img,svg,video{max-width:100%;vertical-align:middle}a{background-color:transparent}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}code,kbd,pre,samp{font-family:monospace;font-size:inherit}dfn{font-style:italic}nav ol,nav ul{list-style:none}small{font-size:0.75em}sub,sup{font-size:0.75em;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}html,body{overflow-x:hidden}ol,ul{margin:.7rem 1.4rem 1.4rem}[data-sassdoc-region]{width:100%}[data-sassdoc-region='app']{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;height:100%;margin:0 auto;min-height:100vh;padding:0}[data-sassdoc-region='container']{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto;position:relative}[data-sassdoc-region='container']:after{clear:both;content:' ';display:block}@media (min-width: 56.25em){[data-sassdoc-region='container']{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end}}[data-nav-menu]{background-color:#0d7fa5;color:#fff;z-index:3;margin:0;padding:1.4rem;white-space:nowrap}[data-sassdoc-region='breadcrumb']{background:#cfe5ed;padding:.7rem calc(.7rem + 2.5vw)}@media (max-width: 35.99em){[data-sassdoc-region='breadcrumb']{padding-top:calc(.7rem + 2.5vw)}}[data-sassdoc-region='breadcrumb'] a,[data-sassdoc-region='breadcrumb'] span,[data-sassdoc-region='breadcrumb'] strong{display:inline-block}[role='main']{z-index:2;width:100%}@media (min-width: 56.25em){[role='main']{overflow:hidden}}[data-sassdoc-region='main']{padding:1.4rem calc(.7rem + 2.5vw);position:relative}[data-sassdoc='color-palette']{margin:1.4rem 0}[data-sassdoc-color]{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin:.7rem 0;position:relative}[data-sassdoc='color-swatch']{border:1px solid #555b5e;-webkit-box-flex:1;-ms-flex:1 1 5.6rem;flex:1 1 5.6rem;min-height:5.6rem;min-width:2.8rem;position:relative}[data-sassdoc='transparency-grid'],[data-sassdoc='color-overlay']{bottom:0;left:0;position:absolute;right:0;top:0}[data-sassdoc='transparency-grid']{background:url('data:image/svg+xml;utf8,') center repeat scroll;background-size:0.5em 0.5em;left:50%}[data-sassdoc='color-info']{-webkit-box-flex:100;-ms-flex:100 0 auto;flex:100 0 auto;padding:.35rem}[data-sassdoc='color-name']{display:block}[data-sassdoc='color-value']{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;color:#555b5e;font-size:calc(.88889rem + .25vw)}.example{margin-bottom:1.4rem}.example-code{-webkit-box-align:stretch;-ms-flex-align:stretch;align-items:stretch;border:1px solid #cfe5ed;display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;overflow:hidden}.example-code [data-sassdoc='hljs']{margin-bottom:0}.example-code[aria-hidden='true']{display:none}.code-block{-webkit-box-align:stretch;-ms-flex-align:stretch;align-items:stretch;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-flex:1;-ms-flex:1 1 40%;flex:1 1 40%;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;max-height:16.8rem;max-width:100%;min-width:20em;overflow:auto}.code-block+.code-block{border-left:1px solid #cfe5ed}.code-header{background-color:#cfe5ed;color:#3b4042;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;font-size:calc(.88889rem + .25vw);padding:0 .7rem}.code-header+[data-sassdoc='hljs']{-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto}.code-description{font-size:calc(.88889rem + .25vw)}.code-description:before{content:" – "}.example-render{border:1px solid #dedede;border-top:0;padding:1.4rem}[data-sassdoc-font]{margin:4.2rem 0 1.4rem}[data-sassdoc='font-type']{font-size:calc(1rem + 1.5vw);font-weight:bold}[data-sassdoc='font-stack']{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;font-size:calc(.88889rem + .25vw)}[data-specimen-face]{margin:.7rem 0}[data-specimen='sample']{-webkit-box-align:center;-ms-flex-align:center;align-items:center;display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}[data-specimen='aa'],[data-specimen='lorem']{padding:0 .7rem}[data-specimen='aa']{-webkit-box-flex:0;-ms-flex:0 1 auto;flex:0 1 auto;font-size:4.2rem}[data-specimen='lorem']{-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto}[data-specimen='lorem'] span{display:block}[data-sassdoc='hljs'],[data-sassdoc-page='index'] pre{-webkit-box-align:stretch;-ms-flex-align:stretch;align-items:stretch;background-color:#fcfcfc;color:#587f8d;display:-webkit-box;display:-ms-flexbox;display:flex;position:relative}[data-sassdoc='hljs'] code,[data-sassdoc-page='index'] pre code{-webkit-box-flex:0;-ms-flex:0 0 100%;flex:0 0 100%;overflow-x:auto;padding:.7rem;padding-right:1.4rem}[data-sassdoc='hljs']:before,[data-sassdoc-page='index'] pre:before{content:" ";bottom:0;left:0;position:absolute;right:0;top:0;background:-webkit-gradient(linear, left bottom, left top, color-stop(.175rem, #fcfcfc), color-stop(.7rem, rgba(252,252,252,0))),-webkit-gradient(linear, left top, right top, color-stop(.175rem, #fcfcfc), color-stop(.7rem, rgba(252,252,252,0))),-webkit-gradient(linear, left top, left bottom, color-stop(.175rem, #fcfcfc), color-stop(.7rem, rgba(252,252,252,0))),-webkit-gradient(linear, right top, left top, color-stop(.35rem, #fcfcfc), color-stop(2.1rem, rgba(252,252,252,0))) no-repeat scroll;background:linear-gradient(to top, #fcfcfc .175rem, rgba(252,252,252,0) .7rem),linear-gradient(to right, #fcfcfc .175rem, rgba(252,252,252,0) .7rem),linear-gradient(to bottom, #fcfcfc .175rem, rgba(252,252,252,0) .7rem),linear-gradient(to left, #fcfcfc .35rem, rgba(252,252,252,0) 2.1rem) no-repeat scroll;-webkit-box-shadow:0 0 .35rem rgba(88,127,141,0.2) inset;box-shadow:0 0 .35rem rgba(88,127,141,0.2) inset;pointer-events:none}[data-sassdoc-page='index'] pre{margin-bottom:1.4rem}.hljs-comment,.hljs-quote{color:#93a1a1}.hljs-keyword,.hljs-selector-tag,.hljs-addition{color:#859900}.hljs-number,.hljs-string,.hljs-meta .hljs-meta-string,.hljs-literal,.hljs-doctag,.hljs-regexp{color:#2aa198}.hljs-title,.hljs-section,.hljs-name,.hljs-selector-id,.hljs-selector-class{color:#268bd2}.hljs-attribute,.hljs-attr,.hljs-variable,.hljs-template-variable,.hljs-class .hljs-title,.hljs-type{color:#b58900}.hljs-symbol,.hljs-bullet,.hljs-subst,.hljs-meta,.hljs-meta .hljs-keyword,.hljs-selector-attr,.hljs-selector-pseudo,.hljs-link{color:#cb4b16}.hljs-built_in,.hljs-deletion{color:#dc322f}.hljs-formula{background:#eee8d5}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:bold}[data-sassdoc='icon-preview']{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between;margin:1.4rem -.7rem}[data-sassdoc-icon]{color:#555b5e;-webkit-box-flex:1;-ms-flex:1 1 15%;flex:1 1 15%;margin:1.4rem .7rem;min-width:7rem}[data-sassdoc-icon] [data-icon]{height:calc(1rem + 2.5vw);width:calc(1rem + 2.5vw)}[data-sassdoc='icon-info']{font-size:calc(.88889rem + .25vw);padding:.35rem 0;white-space:nowrap}[data-sassdoc='icon-name']{color:#3b4042;font-weight:bold;text-transform:uppercase}[data-sassdoc='icon-path']{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif}[data-sassdoc='ratio-demos']{line-height:1.2;overflow-x:auto;padding:.35rem;white-space:nowrap}[data-sassdoc='size-demos']{margin-bottom:1.4rem}[data-sassdoc='size-details']{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;font-size:calc(.88889rem + .25vw)}[data-sassdoc='size-value']{color:#555b5e}[data-size-demo]{margin-bottom:.7rem}[data-size-demo='text']{overflow:hidden;padding:.35rem;white-space:nowrap}[data-size-demo='ruler']{background:-webkit-gradient(linear, left top, right top, color-stop(50%, currentColor), color-stop(50%, transparent));background:linear-gradient(to right, currentColor 50%, transparent 50%);background-size:2em auto;height:1em} +html{-ms-overflow-style:-ms-autohiding-scrollbar;-webkit-text-size-adjust:100%;-moz-text-size-adjust:100%;-ms-text-size-adjust:100%;text-size-adjust:100%}main{display:block}details{display:block}pre{overflow:auto}progress{display:inline-block}summary{display:block}template{display:none}*,::before,::after{border-style:solid;border-width:0;-webkit-box-sizing:border-box;box-sizing:border-box}*{font-size:inherit;line-height:inherit;margin:0;padding:0}table{border-collapse:collapse;border-spacing:0}audio :not([controls]){display:none}[aria-busy='true']{cursor:progress}[aria-controls]{cursor:pointer}[aria-disabled]{cursor:default}[hidden]{display:none}button{overflow:visible}input{border-radius:0;line-height:normal}button,[type='button'],[type='reset'],[type='submit']{-webkit-appearance:button;-moz-appearance:button;appearance:button;cursor:pointer}button::-moz-focus-inner,[type='button']::-moz-focus-inner,[type='reset']::-moz-focus-inner,[type='submit']::-moz-focus-inner{border:0 none !important;padding:0 !important}[type='checkbox'],[type='radio']{-webkit-box-sizing:border-box;box-sizing:border-box;padding:0}[type='number']{width:auto}[type='search']{-webkit-appearance:textfield;-moz-appearance:textfield;appearance:textfield}button,input,select,textarea{background-color:transparent;color:inherit;font-family:inherit;font-style:inherit;font-weight:inherit}textarea{overflow:auto;resize:vertical}img{border:0}svg:not(:root){overflow:hidden}audio,canvas,iframe,img,svg,video{max-width:100%;vertical-align:middle}a{background-color:transparent}a:active,a:hover{outline:0}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}code,kbd,pre,samp{font-family:monospace;font-size:inherit}dfn{font-style:italic}nav ol,nav ul{list-style:none}small{font-size:0.75em}sub,sup{font-size:0.75em;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}:root{font-size:112.5%;line-height:1.575em;font-family:"Source Sans Pro","Helvetica Neue","Helvetica","Arial",sans-serif;font-size:calc(size('root') + 0.25vw);line-height:1.4}[href]:link,[href]:visited{color:#0d7fa5;text-decoration:none}[href]:hover,[href]:focus,[href]:active{color:#0a5f7c;text-decoration:underline}pre,code{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;font-size:calc(0.75rem + 0.25vw)}code{background-color:#fcfcfc;border-radius:3px;-webkit-box-shadow:0 0 .35rem rgba(88,127,141,0.2) inset;box-shadow:0 0 .35rem rgba(88,127,141,0.2) inset;color:#587f8d;display:inline-block;padding:0 .35rem}pre code{background-color:transparent;border-radius:0;-webkit-box-shadow:none;box-shadow:none;display:block;padding:0}.visually-hidden{clip:rect(1px, 1px, 1px, 1px);-webkit-clip-path:inset(1px 1px 1px 1px);clip-path:inset(1px 1px 1px 1px);height:1px;overflow:hidden;position:absolute;width:1px}[data-sassdoc='project-title']{-webkit-box-align:baseline;-ms-flex-align:baseline;align-items:baseline;display:-webkit-box;display:-ms-flexbox;display:flex;font-size:calc(1rem + 2.5vw);margin-left:auto;margin-right:auto}[data-sassdoc='project-name']{padding-left:.35rem;padding-right:.35rem}[data-sassdoc='project-name'],[data-sassdoc='project-name']:link,[data-sassdoc='project-name']:visited{color:#0d7fa5}[data-sassdoc='project-name']:hover,[data-sassdoc='project-name']:focus,[data-sassdoc='project-name']:active{color:#0a5f7c;text-decoration:none}[data-icon-size='icon-small']{height:28px;width:28px}html,body{overflow-x:hidden}[data-sassdoc-region]{width:100%}[data-sassdoc-region='app']{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;height:100%;margin:0 auto;min-height:100vh;padding:0}[data-sassdoc-region='container']{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto;position:relative}[data-sassdoc-region='container']:after{clear:both;content:' ';display:block}@media (min-width: 56.25em){[data-sassdoc-region='container']{-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end}}[data-nav-menu]{background-color:#0d7fa5;color:#fff;z-index:3;margin:0;padding:1.4rem;white-space:nowrap}[data-sassdoc-region='breadcrumb']{background:#cfe5ed;padding:.7rem calc(.7rem + 2.5vw)}@media (max-width: 35.99em){[data-sassdoc-region='breadcrumb']{padding-top:calc(.7rem + 2.5vw)}}[data-sassdoc-region='breadcrumb'] a,[data-sassdoc-region='breadcrumb'] span,[data-sassdoc-region='breadcrumb'] strong{display:inline-block}[role='main']{z-index:2;width:100%}@media (min-width: 56.25em){[role='main']{overflow:hidden}}[data-sassdoc-region='main']{padding:1.4rem calc(.7rem + 2.5vw);position:relative}.text-block{max-width:90ch}.text-block h1,.text-block h2,.text-block h3,.text-block h4{color:#3b4042;margin-bottom:.7rem}.text-block h1{font-size:calc(1rem + 2vw)}.text-block h2{font-size:calc(1rem + 1.5vw)}.text-block p{margin:1.4rem 0}.text-block ol,.text-block ul{margin:.7rem 1.4rem 1.4rem}.text-block blockquote{border-left:.35rem solid #dedede;font-size:calc(1rem + .5vw);padding-left:1.05rem}.text-block blockquote>:first-child{text-indent:-0.4em}.text-block blockquote>:nth-last-child(2){margin-bottom:.7rem}.text-block blockquote>:last-child{margin-top:.7rem}.text-block blockquote cite{display:block;font-size:calc(.88889rem + .25vw)}[data-sassdoc-region='banner']{border-bottom:8px solid #0d7fa5;display:block;position:relative;width:100%;z-index:4;-webkit-box-shadow:0 2px 2px rgba(85,91,94,0.5);box-shadow:0 2px 2px rgba(85,91,94,0.5);display:-webkit-box;display:-ms-flexbox;display:flex;padding:.7rem}[data-sassdoc-region='banner']:before,[data-sassdoc-region='banner']:after{content:" ";border:1.4rem solid transparent;border-bottom-width:0;border-top-color:#0d7fa5;left:50%;position:absolute;top:100%}[data-sassdoc-region='banner']:before{content:" ";margin-top:8px;-webkit-transform:translateX(-50%) translateY(-2px);transform:translateX(-50%) translateY(-2px)}[data-sassdoc-region='banner']:after{content:" ";border-top-color:#fff;-webkit-transform:translateX(-50%) translateY(-4px);transform:translateX(-50%) translateY(-4px)}[data-sassdoc='project-version']{font-family:"Source Sans Pro","Helvetica Neue","Helvetica","Arial",sans-serif;color:#555b5e;font-size:calc(.88889rem + .5vw);font-weight:normal}.item{margin-bottom:8.4rem}[data-item-section]{margin-bottom:2.8rem}[data-item-section='header']{margin:1.4rem 0}.item-title{font-size:calc(1rem + 1.5vw)}.item-subtitle{border-bottom:1px solid #dedede;color:#555b5e;font-size:calc(.88889rem + .25vw);font-weight:normal;letter-spacing:0.05em;margin-bottom:.7rem;text-transform:uppercase}.item-type,.item-name,.item-value,.alias-title{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;display:inline-block}.item-type,.item-value,.value-type,.item-note{color:#555b5e;display:inline-block;font-weight:normal}.alias{color:#555b5e;font-style:italic}.alias-title{font-style:normal;font-weight:bold}.param-list{margin-bottom:.7rem}.param-title{color:#555b5e;font-size:calc(.88889rem + .5vw)}.param-details{margin-top:.35rem}@media (min-width: 36em){.param-details{margin-left:1.4rem}}.summary-subtitle{color:#555b5e;margin:1.4rem 0 .35rem}@media (min-width: 36em){.requires-wrapper{display:-webkit-box;display:-ms-flexbox;display:flex}.requires-wrapper [data-item-section]{-webkit-box-flex:1;-ms-flex:1 1 40%;flex:1 1 40%;max-width:100%}.requires-wrapper [data-item-section]:first-child{margin-right:1.4rem}}[data-nav-menu='small']{bottom:0;position:absolute;top:0;-webkit-box-shadow:0 0 .35rem rgba(85,91,94,0.5);box-shadow:0 0 .35rem rgba(85,91,94,0.5);-webkit-transform:translatex(-102%);transform:translatex(-102%);-webkit-transition:-webkit-transform 0.4s;transition:-webkit-transform 0.4s;transition:transform 0.4s;transition:transform 0.4s, -webkit-transform 0.4s;width:100%}[data-nav-menu='small'][aria-expanded='true']{-webkit-transform:translatex(0);transform:translatex(0)}@media (max-width: 23.615em){[data-nav-menu='small']{-ms-flex-line-pack:start;align-content:flex-start;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row;-ms-flex-wrap:wrap;flex-wrap:wrap}}@media (min-width: 23.625em){[data-nav-menu='small']{width:auto}}@media (min-width: 56.25em){[data-nav-menu='small']{display:none}}[data-nav-menu='large']{-webkit-box-flex:0;-ms-flex:0 1 0px;flex:0 1 0;margin-left:-100%;-webkit-transition:margin-left 0.4s;transition:margin-left 0.4s}[data-nav-menu='large'][aria-expanded='true']{margin-left:0}@media (max-width: 56.24em){[data-nav-menu='large']{display:none}}@media (min-width: 56.25em){[data-nav-toggle='small']{display:none}}@media (max-width: 56.24em){[data-nav-toggle='large']{display:none}}[data-nav-toggle]{fill:#0d7fa5;padding:.35rem}@media (min-width: 56.25em){[data-nav-toggle]{padding-left:.7rem;padding-right:.7rem}}[data-nav-toggle]:hover,[data-nav-toggle]:focus,[data-nav-toggle]:active{fill:#0a5f7c}[data-sassdoc='nav-item']{list-style:none;margin-bottom:.7rem}@media (max-width: 23.615em){[data-sassdoc='nav-item']{width:50%}[data-sassdoc='nav-item']:nth-of-type(2n){padding-right:1rem}}[data-sassdoc='nav-title']{font-weight:bold;margin:.35rem 0 .7rem;padding-top:.7rem;width:100%}[data-sassdoc='nav-title']:nth-of-type(n+2){border-top:1px solid #cfe5ed;margin-top:1.4rem;padding-top:1.4rem}[data-sassdoc-nav]:link,[data-sassdoc-nav]:visited{color:#fff;line-height:1.1;padding-bottom:.175rem;position:relative;text-decoration:none;-webkit-transition:color 0.4s;transition:color 0.4s}[data-sassdoc-nav]:link:before,[data-sassdoc-nav]:visited:before{content:"";bottom:0;left:0;position:absolute;right:auto;top:auto;background:#cfe5ed;height:4px;-webkit-transform:scale3d(0, 1, 1);transform:scale3d(0, 1, 1);-webkit-transform-origin:center left;transform-origin:center left;-webkit-transition:-webkit-transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1);transition:-webkit-transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1);transition:transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1);transition:transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1), -webkit-transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1);-webkit-transition-delay:0.2s;transition-delay:0.2s;width:100%}[data-sassdoc-nav]:hover:before,[data-sassdoc-nav]:focus:before,[data-sassdoc-nav]:active:before{content:"";-webkit-transform:scale3d(1, 1, 1);transform:scale3d(1, 1, 1);-webkit-transition-delay:0s;transition-delay:0s}[data-sassdoc-nav][data-sassdoc-nav='is-active']:link:before,[data-sassdoc-nav][data-sassdoc-nav='is-active']:visited:before,[data-sassdoc-nav][data-sassdoc-nav='is-active']:hover:before,[data-sassdoc-nav][data-sassdoc-nav='is-active']:focus:before,[data-sassdoc-nav][data-sassdoc-nav='is-active']:active:before{content:"";-webkit-transform:scale3d(1, 1, 1);transform:scale3d(1, 1, 1);-webkit-transition-delay:0s;transition-delay:0s}.project-links{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;margin-left:0;margin-right:0}@media (max-width: 40.49em){.project-links{margin-bottom:.7rem}}.project-link-item{display:-webkit-box;display:-ms-flexbox;display:flex;list-style:none}.project-link-item+.project-link-item{margin-left:.7rem}@media (max-width: 40.49em){.project-link-start{margin-right:auto}}.project-link{border:1px solid #0d7fa5;border-radius:1.4rem;font-size:calc(.88889rem + .25vw);line-height:1.6;padding:.35rem 1.4rem;text-align:center;-webkit-transition:background-color 0.4s;transition:background-color 0.4s}.project-link:hover,.project-link:focus,.project-link:active{background-color:#0d7fa5;color:#fff;text-decoration:none}[data-sassdoc='color-palette']{margin:1.4rem 0}[data-sassdoc-color]{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;margin:.7rem 0;position:relative}[data-sassdoc='color-swatch']{border:1px solid #555b5e;-webkit-box-flex:1;-ms-flex:1 1 5.6rem;flex:1 1 5.6rem;min-height:5.6rem;min-width:2.8rem;position:relative}[data-sassdoc='transparency-grid'],[data-sassdoc='color-overlay']{bottom:0;left:0;position:absolute;right:0;top:0}[data-sassdoc='transparency-grid']{background:url('data:image/svg+xml;utf8,') center repeat scroll;background-size:0.5em 0.5em;left:50%}[data-sassdoc='color-info']{-webkit-box-flex:100;-ms-flex:100 0 auto;flex:100 0 auto;padding:.35rem}[data-sassdoc='color-name']{display:block}[data-sassdoc='color-value']{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;color:#555b5e;font-size:calc(.88889rem + .25vw)}.example{margin-bottom:1.4rem}.example-code{-webkit-box-align:stretch;-ms-flex-align:stretch;align-items:stretch;border:1px solid #cfe5ed;display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;overflow:hidden}.example-code [data-sassdoc='hljs']{margin-bottom:0}.example-code[aria-hidden='true']{display:none}.code-block{-webkit-box-align:stretch;-ms-flex-align:stretch;align-items:stretch;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-flex:1;-ms-flex:1 1 40%;flex:1 1 40%;-webkit-box-orient:vertical;-webkit-box-direction:normal;-ms-flex-direction:column;flex-direction:column;max-height:16.8rem;max-width:100%;min-width:20em;overflow:auto}.code-block+.code-block{border-left:1px solid #cfe5ed}.code-header{background-color:#cfe5ed;color:#3b4042;-webkit-box-flex:0;-ms-flex:0 0 auto;flex:0 0 auto;font-size:calc(.88889rem + .25vw);padding:0 .7rem}.code-header+[data-sassdoc='hljs']{-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto}.code-description{font-size:calc(.88889rem + .25vw)}.code-description:before{content:" – "}.example-render{border:1px solid #dedede;border-top:0;padding:.7rem}.sassdoc{overflow:visible}[data-sassdoc-font]{margin:4.2rem 0 1.4rem}[data-sassdoc='font-type']{font-size:calc(1rem + 1.5vw);font-weight:bold}[data-sassdoc='font-stack']{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;font-size:calc(.88889rem + .25vw)}[data-specimen-face]{margin:.7rem 0}[data-specimen='sample']{-webkit-box-align:center;-ms-flex-align:center;align-items:center;display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between}[data-specimen='aa'],[data-specimen='lorem']{padding:0 .7rem}[data-specimen='aa']{-webkit-box-flex:0;-ms-flex:0 1 auto;flex:0 1 auto;font-size:4.2rem}[data-specimen='lorem']{-webkit-box-flex:1;-ms-flex:1 1 auto;flex:1 1 auto}[data-specimen='lorem'] span{display:block}[data-sassdoc='hljs'],[data-sassdoc-page='index'] pre{-webkit-box-align:stretch;-ms-flex-align:stretch;align-items:stretch;background-color:#fcfcfc;color:#587f8d;display:-webkit-box;display:-ms-flexbox;display:flex;position:relative}[data-sassdoc='hljs'] code,[data-sassdoc-page='index'] pre code{-webkit-box-flex:0;-ms-flex:0 0 100%;flex:0 0 100%;overflow-x:auto;padding:.7rem;padding-right:1.4rem}[data-sassdoc='hljs']:before,[data-sassdoc-page='index'] pre:before{content:" ";bottom:0;left:0;position:absolute;right:0;top:0;background:-webkit-gradient(linear, left bottom, left top, color-stop(.175rem, #fcfcfc), color-stop(.7rem, rgba(252,252,252,0))),-webkit-gradient(linear, left top, right top, color-stop(.175rem, #fcfcfc), color-stop(.7rem, rgba(252,252,252,0))),-webkit-gradient(linear, left top, left bottom, color-stop(.175rem, #fcfcfc), color-stop(.7rem, rgba(252,252,252,0))),-webkit-gradient(linear, right top, left top, color-stop(.35rem, #fcfcfc), color-stop(2.1rem, rgba(252,252,252,0))) no-repeat scroll;background:linear-gradient(to top, #fcfcfc .175rem, rgba(252,252,252,0) .7rem),linear-gradient(to right, #fcfcfc .175rem, rgba(252,252,252,0) .7rem),linear-gradient(to bottom, #fcfcfc .175rem, rgba(252,252,252,0) .7rem),linear-gradient(to left, #fcfcfc .35rem, rgba(252,252,252,0) 2.1rem) no-repeat scroll;-webkit-box-shadow:0 0 .35rem rgba(88,127,141,0.2) inset;box-shadow:0 0 .35rem rgba(88,127,141,0.2) inset;pointer-events:none}[data-sassdoc-page='index'] pre{margin-bottom:1.4rem}.hljs-comment,.hljs-quote{color:#93a1a1}.hljs-keyword,.hljs-selector-tag,.hljs-addition{color:#859900}.hljs-number,.hljs-string,.hljs-meta .hljs-meta-string,.hljs-literal,.hljs-doctag,.hljs-regexp{color:#2aa198}.hljs-title,.hljs-section,.hljs-name,.hljs-selector-id,.hljs-selector-class{color:#268bd2}.hljs-attribute,.hljs-attr,.hljs-variable,.hljs-template-variable,.hljs-class .hljs-title,.hljs-type{color:#b58900}.hljs-symbol,.hljs-bullet,.hljs-subst,.hljs-meta,.hljs-meta .hljs-keyword,.hljs-selector-attr,.hljs-selector-pseudo,.hljs-link{color:#cb4b16}.hljs-built_in,.hljs-deletion{color:#dc322f}.hljs-formula{background:#eee8d5}.hljs-emphasis{font-style:italic}.hljs-strong{font-weight:bold}[data-sassdoc='icon-preview']{display:-webkit-box;display:-ms-flexbox;display:flex;-ms-flex-wrap:wrap;flex-wrap:wrap;-webkit-box-pack:justify;-ms-flex-pack:justify;justify-content:space-between;margin:1.4rem -.7rem}[data-sassdoc-icon]{color:#555b5e;-webkit-box-flex:1;-ms-flex:1 1 15%;flex:1 1 15%;margin:1.4rem .7rem;min-width:7rem}[data-sassdoc-icon] [data-icon]{height:calc(1rem + 2.5vw);width:calc(1rem + 2.5vw)}[data-sassdoc='icon-info']{font-size:calc(.88889rem + .25vw);padding:.35rem 0;white-space:nowrap}[data-sassdoc='icon-name']{color:#3b4042;font-weight:bold;text-transform:uppercase}[data-sassdoc='icon-path']{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif}[data-sassdoc='ratio-demos']{line-height:1.2;overflow-x:auto;padding:.35rem;white-space:nowrap}[data-sassdoc='size-demos']{margin-bottom:1.4rem}[data-sassdoc='size-details']{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;font-size:calc(.88889rem + .25vw)}[data-sassdoc='size-value']{color:#555b5e}[data-size-demo]{margin-bottom:.7rem}[data-size-demo='text']{overflow:hidden;padding:.35rem;white-space:nowrap}[data-size-demo='ruler']{background:-webkit-gradient(linear, left top, right top, color-stop(50%, currentColor), color-stop(50%, transparent));background:linear-gradient(to right, currentColor 50%, transparent 50%);background-size:2em auto;height:1em} /*# sourceMappingURL=main.css.map */ diff --git a/.sassdoc/assets/css/theme.css b/.sassdoc/assets/css/theme.css deleted file mode 100644 index 736753ec..00000000 --- a/.sassdoc/assets/css/theme.css +++ /dev/null @@ -1,3 +0,0 @@ -:root{font-size:112.5%;line-height:1.575em;font-family:"Source Sans Pro","Helvetica Neue","Helvetica","Arial",sans-serif;font-size:calc(size('root') + 0.25vw);line-height:1.4}[href]:link,[href]:visited{color:#0d7fa5;text-decoration:none}[href]:hover,[href]:focus,[href]:active{color:#0a5f7c;text-decoration:underline}pre,code{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;font-size:calc(0.75rem + 0.25vw)}code{background-color:#fcfcfc;border-radius:3px;-webkit-box-shadow:0 0 .35rem rgba(88,127,141,0.2) inset;box-shadow:0 0 .35rem rgba(88,127,141,0.2) inset;color:#587f8d;display:inline-block;padding:0 .35rem}pre code{background-color:transparent;border-radius:0;-webkit-box-shadow:none;box-shadow:none;display:block;padding:0}.visually-hidden{clip:rect(1px, 1px, 1px, 1px);-webkit-clip-path:inset(1px 1px 1px 1px);clip-path:inset(1px 1px 1px 1px);height:1px;overflow:hidden;position:absolute;width:1px}[data-sassdoc='project-title']{-webkit-box-align:baseline;-ms-flex-align:baseline;align-items:baseline;display:-webkit-box;display:-ms-flexbox;display:flex;font-size:calc(1rem + 2.5vw);margin-left:auto;margin-right:auto}[data-sassdoc='project-name']{padding-left:.35rem;padding-right:.35rem}[data-sassdoc='project-name'],[data-sassdoc='project-name']:link,[data-sassdoc='project-name']:visited{color:#0d7fa5}[data-sassdoc='project-name']:hover,[data-sassdoc='project-name']:focus,[data-sassdoc='project-name']:active{color:#0a5f7c;text-decoration:none}[data-icon-size='icon-small']{height:28px;width:28px}[data-sassdoc-region='banner']{border-bottom:8px solid #0d7fa5;display:block;position:relative;width:100%;z-index:4;-webkit-box-shadow:0 2px 2px rgba(85,91,94,0.5);box-shadow:0 2px 2px rgba(85,91,94,0.5);display:-webkit-box;display:-ms-flexbox;display:flex;padding:.7rem}[data-sassdoc-region='banner']:before,[data-sassdoc-region='banner']:after{content:" ";border:1.4rem solid transparent;border-bottom-width:0;border-top-color:#0d7fa5;left:50%;position:absolute;top:100%}[data-sassdoc-region='banner']:before{content:" ";margin-top:8px;-webkit-transform:translateX(-50%) translateY(-2px);transform:translateX(-50%) translateY(-2px)}[data-sassdoc-region='banner']:after{content:" ";border-top-color:#fff;-webkit-transform:translateX(-50%) translateY(-4px);transform:translateX(-50%) translateY(-4px)}[data-sassdoc='project-version']{font-family:"Source Sans Pro","Helvetica Neue","Helvetica","Arial",sans-serif;color:#555b5e;font-size:calc(.88889rem + .5vw);font-weight:normal}[data-sassdoc-page='index']{color:#3b4042}[data-sassdoc-page='index'] h1,[data-sassdoc-page='index'] h2,[data-sassdoc-page='index'] h3,[data-sassdoc-page='index'] h4{color:#3b4042;margin-bottom:.7rem}[data-sassdoc-page='index'] h1{font-size:calc(1rem + 2vw)}[data-sassdoc-page='index'] h2{font-size:calc(1rem + 1.5vw)}[data-sassdoc-page='index'] p{margin:1.4rem 0}.item{margin-bottom:8.4rem}[data-item-section]{margin-bottom:2.8rem}[data-item-section='header']{margin:1.4rem 0}.item-title{font-size:calc(1rem + 1.5vw)}.item-subtitle{border-bottom:1px solid #dedede;color:#555b5e;font-size:calc(.88889rem + .25vw);font-weight:normal;letter-spacing:0.05em;margin-bottom:.7rem;text-transform:uppercase}.item-type,.item-name,.item-value,.alias-title{font-family:"Source Code Pro","Consolas","Menlo","Monaco","Lucida Console","Liberation Mono","DejaVu Sans Mono","Bitstream Vera Sans Mono","Courier New",monospace,sans-serif;display:inline-block}.item-type,.item-value,.value-type,.item-note{color:#555b5e;display:inline-block;font-weight:normal}.alias{color:#555b5e;font-style:italic}.alias-title{font-style:normal;font-weight:bold}.param-list{margin-bottom:.7rem}.param-title{color:#555b5e;font-size:calc(.88889rem + .5vw)}.param-details{margin-top:.35rem}@media (min-width: 36em){.param-details{margin-left:1.4rem}}.text-block{max-width:80ch}.text-block p{margin-bottom:1.4rem}.summary-subtitle{color:#555b5e;margin:1.4rem 0 .35rem}@media (min-width: 36em){.requires-wrapper{display:-webkit-box;display:-ms-flexbox;display:flex}.requires-wrapper [data-item-section]{-webkit-box-flex:1;-ms-flex:1 1 40%;flex:1 1 40%;max-width:100%}.requires-wrapper [data-item-section]:first-child{margin-right:1.4rem}}[data-nav-menu='small']{bottom:0;position:absolute;top:0;-webkit-box-shadow:0 0 .35rem rgba(85,91,94,0.5);box-shadow:0 0 .35rem rgba(85,91,94,0.5);-webkit-transform:translatex(-102%);transform:translatex(-102%);-webkit-transition:-webkit-transform 0.4s;transition:-webkit-transform 0.4s;transition:transform 0.4s;transition:transform 0.4s, -webkit-transform 0.4s;width:100%}[data-nav-menu='small'][aria-expanded='true']{-webkit-transform:translatex(0);transform:translatex(0)}@media (max-width: 23.615em){[data-nav-menu='small']{-ms-flex-line-pack:start;align-content:flex-start;display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-orient:horizontal;-webkit-box-direction:normal;-ms-flex-direction:row;flex-direction:row;-ms-flex-wrap:wrap;flex-wrap:wrap}}@media (min-width: 23.625em){[data-nav-menu='small']{width:auto}}@media (min-width: 56.25em){[data-nav-menu='small']{display:none}}[data-nav-menu='large']{-webkit-box-flex:0;-ms-flex:0 1 0px;flex:0 1 0;margin-left:-100%;-webkit-transition:margin-left 0.4s;transition:margin-left 0.4s}[data-nav-menu='large'][aria-expanded='true']{margin-left:0}@media (max-width: 56.24em){[data-nav-menu='large']{display:none}}@media (min-width: 56.25em){[data-nav-toggle='small']{display:none}}@media (max-width: 56.24em){[data-nav-toggle='large']{display:none}}[data-nav-toggle]{fill:#0d7fa5;padding:.35rem}@media (min-width: 56.25em){[data-nav-toggle]{padding-left:.7rem;padding-right:.7rem}}[data-nav-toggle]:hover,[data-nav-toggle]:focus,[data-nav-toggle]:active{fill:#0a5f7c}[data-sassdoc='nav-item']{list-style:none;margin-bottom:.7rem}@media (max-width: 23.615em){[data-sassdoc='nav-item']{width:50%}[data-sassdoc='nav-item']:nth-of-type(2n){padding-right:1rem}}[data-sassdoc='nav-title']{font-weight:bold;margin:.35rem 0 .7rem;padding-top:.7rem;width:100%}[data-sassdoc='nav-title']:nth-of-type(n+2){border-top:1px solid #cfe5ed;margin-top:1.4rem;padding-top:1.4rem}[data-sassdoc-nav]:link,[data-sassdoc-nav]:visited{color:#fff;line-height:1.1;padding-bottom:.175rem;position:relative;text-decoration:none;-webkit-transition:color 0.4s;transition:color 0.4s}[data-sassdoc-nav]:link:before,[data-sassdoc-nav]:visited:before{content:"";bottom:0;left:0;position:absolute;right:auto;top:auto;background:#cfe5ed;height:4px;-webkit-transform:scale3d(0, 1, 1);transform:scale3d(0, 1, 1);-webkit-transform-origin:center left;transform-origin:center left;-webkit-transition:-webkit-transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1);transition:-webkit-transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1);transition:transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1);transition:transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1), -webkit-transform 0.4s cubic-bezier(0.22, 0.61, 0.36, 1);-webkit-transition-delay:0.2s;transition-delay:0.2s;width:100%}[data-sassdoc-nav]:hover:before,[data-sassdoc-nav]:focus:before,[data-sassdoc-nav]:active:before{content:"";-webkit-transform:scale3d(1, 1, 1);transform:scale3d(1, 1, 1);-webkit-transition-delay:0s;transition-delay:0s}[data-sassdoc-nav][data-sassdoc-nav='is-active']:link:before,[data-sassdoc-nav][data-sassdoc-nav='is-active']:visited:before,[data-sassdoc-nav][data-sassdoc-nav='is-active']:hover:before,[data-sassdoc-nav][data-sassdoc-nav='is-active']:focus:before,[data-sassdoc-nav][data-sassdoc-nav='is-active']:active:before{content:"";-webkit-transform:scale3d(1, 1, 1);transform:scale3d(1, 1, 1);-webkit-transition-delay:0s;transition-delay:0s}.project-links{display:-webkit-box;display:-ms-flexbox;display:flex;-webkit-box-pack:end;-ms-flex-pack:end;justify-content:flex-end;margin-left:0;margin-right:0}@media (max-width: 40.49em){.project-links{margin-bottom:.7rem}}.project-link-item{display:-webkit-box;display:-ms-flexbox;display:flex;list-style:none}.project-link-item+.project-link-item{margin-left:.7rem}@media (max-width: 40.49em){.project-link-start{margin-right:auto}}.project-link{border:1px solid #0d7fa5;border-radius:1.4rem;font-size:calc(.88889rem + .25vw);line-height:1.6;padding:.35rem 1.4rem;text-align:center;-webkit-transition:background-color 0.4s;transition:background-color 0.4s}.project-link:hover,.project-link:focus,.project-link:active{background-color:#0d7fa5;color:#fff;text-decoration:none} - -/*# sourceMappingURL=theme.css.map */ diff --git a/.sassdoc/assets/js/base.js b/.sassdoc/assets/js/base.js index a95690b5..247265b7 100644 --- a/.sassdoc/assets/js/base.js +++ b/.sassdoc/assets/js/base.js @@ -1 +1 @@ -window.Herman=function(t,a){"use strict";var e={SPACE:32,ENTER:13,TAB:9,ESC:27,BACKSPACE:8,SHIFT:16,CTRL:17,ALT:18,CAPS:20,LEFT:37,UP:38,RIGHT:39,DOWN:40,DELETE:46,COMMA:44};return t.initializeToggles=function(){var t=a("body");t.on("toggle:close",'[data-toggle="button"]',function(){var t=a(this).attr("aria-controls"),e=a('[data-target-id="'+t+'"]');a('[data-toggle="button"][aria-controls="'+t+'"][aria-pressed="true"]').attr("aria-pressed","false"),e.trigger("target:close")}),t.on("toggle:open",'[data-toggle="button"]',function(){var t=a(this),e=t.attr("aria-controls"),r=a('[data-target-id="'+e+'"]'),o=a('[data-toggle="button"][aria-controls="'+e+'"]').not(t);t.data("toggle-synced")?o.filter('[data-toggle-synced="true"]').attr("aria-pressed","true"):o.filter('[aria-pressed="true"]').attr("aria-pressed","false"),t.attr("aria-pressed","true"),r.trigger("target:open")}),t.on("target:close",'[data-toggle="target"]',function(t){var e=a(this);a(t.target).is(e)&&e.attr("aria-expanded","false")});var e=0,r=function(t){var e=t.attr("data-target-id"),r=a('[data-toggle="button"][aria-controls="'+e+'"][aria-pressed="true"]');r.length?r.trigger("toggle:close"):t.trigger("target:close")},o=function(e,o){var i=this.attr("data-target-id"),n=a(o.target);(this.data("auto-closing-on-any-click")||!n.closest(this).length||n.closest('[data-close-toggle="'+i+'"]').length)&&(t.off(e),r(this))};t.on("target:open",'[data-toggle="target"]',function(r){var i=a(this);if(a(r.target).is(i)&&(i.attr("aria-expanded","true"),i.data("auto-closing"))){var n="click.toggle_"+(e+=1);t.on(n,o.bind(i,n))}}),t.on("click",'[data-toggle="button"]',function(t){t.preventDefault();var e=a(this);"true"===e.attr("aria-pressed")?e.trigger("toggle:close"):e.trigger("toggle:open")}),t.on("click",'[data-toggle="close"]',function(t){t.preventDefault();var e=a(this).attr("aria-controls"),o=a('[data-target-id="'+e+'"]');r(o)})},t.initializeTabs=function(){var t=a("body"),r=function(t){var e=t.attr("data-tab-group");return a('[role="tab"][data-tab-group="'+e+'"]')},o=function(t){var e=t.attr("data-tab-group");return a('[role="tabpanel"][data-tab-group="'+e+'"]')},i=function(t){var a=r(t),e=o(t),i=e.filter('[aria-labelledby="'+t.attr("id")+'"]');t.attr({tabindex:0,"aria-selected":!0}),a.not(t).attr("tabindex",-1).removeAttr("aria-selected"),i.removeAttr("aria-hidden").trigger("visible"),e.not(i).attr("aria-hidden",!0),t.trigger("tab:active")};t.on("tabs:close",'[role="tab"]',function(){var t=a(this),e=r(t),i=o(t);e.attr("tabindex",-1).removeAttr("aria-selected"),i.attr("aria-hidden",!0)}),t.on("click",'[role="tab"]',function(t){t.preventDefault(),i(a(this))}),t.on("keydown",'[role="tab"]',function(t){var o=a(this),n=r(o),g=n.index(o),l=g;switch(t.keyCode){case e.LEFT:l=g>0?g-1:g;break;case e.RIGHT:l=g+1}var s=n.eq(l);g!==l&&s.length&&(i(s),s.focus())})},t}(window.Herman||{},window.jQuery); \ No newline at end of file +window.Herman=function(t,a){"use strict";var e={SPACE:32,ENTER:13,TAB:9,ESC:27,BACKSPACE:8,SHIFT:16,CTRL:17,ALT:18,CAPS:20,LEFT:37,UP:38,RIGHT:39,DOWN:40,DELETE:46,COMMA:44};return t.initializeToggles=function(){var t=a("body");t.on("toggle:close",'[data-toggle="button"]',function(){var t=a(this).attr("aria-controls"),e=a('[data-target-id="'+t+'"]');a('[data-toggle="button"][aria-controls="'+t+'"][aria-pressed="true"]').attr("aria-pressed","false"),e.trigger("target:close")}),t.on("toggle:open",'[data-toggle="button"]',function(){var t=a(this),e=t.attr("aria-controls"),r=a('[data-target-id="'+e+'"]'),o=a('[data-toggle="button"][aria-controls="'+e+'"]').not(t);t.data("toggle-synced")?o.filter('[data-toggle-synced="true"]').attr("aria-pressed","true"):o.filter('[aria-pressed="true"]').attr("aria-pressed","false"),t.attr("aria-pressed","true"),r.trigger("target:open")}),t.on("target:close",'[data-toggle="target"]',function(t){var e=a(this);a(t.target).is(e)&&e.attr("aria-expanded","false")});var e=0,r=function(t){var e=t.attr("data-target-id"),r=a('[data-toggle="button"][aria-controls="'+e+'"][aria-pressed="true"]');r.length?r.trigger("toggle:close"):t.trigger("target:close")},o=function(e,o){var i=this.attr("data-target-id"),n=a(o.target);(this.data("auto-closing-on-any-click")||!n.closest(this).length||n.closest('[data-close-toggle="'+i+'"]').length)&&(t.off(e),r(this))};t.on("target:open",'[data-toggle="target"]',function(r){var i=a(this);if(a(r.target).is(i)&&(i.attr("aria-expanded","true"),i.data("auto-closing"))){var n="click.toggle_"+(e+=1);t.on(n,o.bind(i,n))}}),t.on("click",'[data-toggle="button"]',function(t){t.preventDefault();var e=a(this);"true"===e.attr("aria-pressed")?e.trigger("toggle:close"):e.trigger("toggle:open")}),t.on("click",'[data-toggle="close"]',function(t){t.preventDefault();var e=a(this).attr("aria-controls"),o=a('[data-target-id="'+e+'"]');r(o)})},t.initializeTabs=function(){var t=a("body"),r=function(t){var e=t.attr("data-tab-group");return a('[role="tab"][data-tab-group="'+e+'"]')},o=function(t){var e=t.attr("data-tab-group");return a('[role="tabpanel"][data-tab-group="'+e+'"]')},i=function(t){var a=r(t),e=o(t),i=e.filter('[aria-labelledby="'+t.attr("id")+'"]');t.attr({tabindex:0,"aria-selected":!0}),a.not(t).attr("tabindex",-1).removeAttr("aria-selected"),i.removeAttr("aria-hidden").trigger("visible"),e.not(i).attr("aria-hidden",!0),t.trigger("tab:active")};t.on("tabs:close",'[role="tab"]',function(){var t=a(this),e=r(t),i=o(t);e.attr("tabindex",-1).removeAttr("aria-selected"),i.attr("aria-hidden",!0)}),t.on("click",'[role="tab"]',function(t){t.preventDefault(),i(a(this))}),t.on("keydown",'[role="tab"]',function(t){var o=a(this),n=r(o),g=n.index(o),l=g;switch(t.keyCode){case e.LEFT:l=g>0?g-1:g;break;case e.RIGHT:l=g+1}var s=n.eq(l);g!==l&&s.length&&(i(s),s.focus())})},t.initializeIframes=function(){var t=function(t){t.contentWindow.document.body&&(t.height=t.contentWindow.document.body.scrollHeight)},e=function(){a("iframe").each(function(){t(this)})};e(),a("iframe").on("load",function(){t(this)}),a(window).on("resize",e)},t}(window.Herman||{},window.jQuery); \ No newline at end of file diff --git a/.sassdoc/assets/js/init.js b/.sassdoc/assets/js/init.js index a067db0f..9c063236 100644 --- a/.sassdoc/assets/js/init.js +++ b/.sassdoc/assets/js/init.js @@ -1 +1 @@ -window.Herman=function(i,n){"use strict";return n(function(){window.hljs.initHighlightingOnLoad(),i.initializeToggles(),i.initializeTabs()}),i}(window.Herman||{},window.jQuery); \ No newline at end of file +window.Herman=function(i,n){"use strict";return n(function(){window.hljs.initHighlightingOnLoad(),i.initializeToggles(),i.initializeTabs(),i.initializeIframes()}),i}(window.Herman||{},window.jQuery); \ No newline at end of file diff --git a/.sassdoc/assets/js/srcdoc-polyfill.min.js b/.sassdoc/assets/js/srcdoc-polyfill.min.js new file mode 100644 index 00000000..d6050c13 --- /dev/null +++ b/.sassdoc/assets/js/srcdoc-polyfill.min.js @@ -0,0 +1,60 @@ +!(function(t, e) { + var o = window.srcDoc; + 'function' == typeof define && define.amd + ? define(['exports'], function(n) { + e(n, o), (t.srcDoc = n); + }) + : 'object' == typeof exports + ? e(exports, o) + : ((t.srcDoc = {}), e(t.srcDoc, o)); +})(this, function(t, e) { + var o, + n, + c, + i = !!('srcdoc' in document.createElement('iframe')), + r = + 'Polyfill may not function in the presence of the `sandbox` attribute. Consider using the `force` option.', + s = /\ballow-same-origin\b/, + f = function(t, e) { + var o = t.getAttribute('sandbox'); + 'string' != typeof o || + s.test(o) || + (e && e.force + ? t.removeAttribute('sandbox') + : (e && !1 === e.force) || + (c(r), t.setAttribute('data-srcdoc-polyfill', r))); + }, + a = { + compliant: function(t, e, o) { + e && (f(t, o), t.setAttribute('srcdoc', e)); + }, + legacy: function(t, e, o) { + var n; + t && + t.getAttribute && + (e + ? t.setAttribute('srcdoc', e) + : (e = t.getAttribute('srcdoc')), e && + (f(t, o), (n = + "javascript: window.frameElement.getAttribute('srcdoc');"), t.contentWindow && + (t.contentWindow.location = n), t.setAttribute('src', n))); + } + }, + d = t; + if ( + ((c = window.console && window.console.error + ? function(t) { + window.console.error('[srcdoc-polyfill] ' + t); + } + : function() {}), (d.set = a.compliant), (d.noConflict = function() { + return (window.srcDoc = e), d; + }), !i) + ) + for ( + (d.set = a.legacy), (n = document.getElementsByTagName('iframe')), (o = + n.length); + o--; + + ) + d.set(n[o]); +}); diff --git a/.sassdoc/b-api.html b/.sassdoc/b-api.html index f401343a..9c18a42d 100644 --- a/.sassdoc/b-api.html +++ b/.sassdoc/b-api.html @@ -1,4 +1,4 @@ -susy Documentation

susy 3.0.0-alpha.6

@function susy-span()

aliased as span()

Description

This is the primary function in Susy — used to return the width of a span across one or more columns, and any relevant gutters along the way. With the default settings, span(3) will return the width of 3 columns, and the 2 intermediate gutters. This can be used to set the width property of grid elements, or margin and padding to push, pull, and pad your elements.

  • This is a thin syntax-sugar shell around the core-math su-span() function.
  • The un-prefixed alias span() is available by default.

Parameters & Return

$span: (list)

Shorthand expression to define the width of the span, optionally containing:

  • a count, length, or column-list span.
  • at $n, first, or last location on asymmetrical grids, where at 1 == first, and last will calculate the proper location based on columns and span.
  • narrow, wide, or wider for optionally spreading across adjacent gutters.
  • of $n <spread> for available grid columns and spread of the container. Span counts like of 6 are valid in the context of symmetrical grids, where Susy can safely infer a slice of the parent columns.
  • and set-gutters $n to override global gutter settings.

$config: () (map)

Optional map of Susy grid configuration settings. See $susy documentation for details.

@return (length)

Calculated length value, using the units given, or converting to % for fraction-based grids, or a full calc function when units/fractions are not comparable outside the browser.

Examples

scss span half the grid
.foo {
+susy Documentation
 
susy 3.0.0-beta.1
@function susy-span()
aliased as span()
Description
This is the primary function in Susy — used to return the width of a span across one or more columns, and any relevant gutters along the way. With the default settings, span(3) will return the width of 3 columns, and the 2 intermediate gutters. This can be used to set the width property of grid elements, or margin and padding to push, pull, and pad your elements.
  • This is a thin syntax-sugar shell around the core-math su-span() function.
  • The un-prefixed alias span() is available by default.
Parameters & Return
$span: (list)
Shorthand expression to define the width of the span, optionally containing:
  • a count, length, or column-list span.
  • at $n, first, or last location on asymmetrical grids, where at 1 == first, and last will calculate the proper location based on columns and span.
  • narrow, wide, or wider for optionally spreading across adjacent gutters.
  • of $n <spread> for available grid columns and spread of the container. Span counts like of 6 are valid in the context of symmetrical grids, where Susy can safely infer a slice of the parent columns.
  • and set-gutters $n to override global gutter settings.
$config: () (map)
Optional map of Susy grid configuration settings. See $susy documentation for details.
@return (length)
Calculated length value, using the units given, or converting to % for fraction-based grids, or a full calc function when units/fractions are not comparable outside the browser.
Examples
scss span half the grid
.foo {
   // the result is a bit under 50% to account for gutters
   width: susy-span(6 of 12);
 }
css compiled
.foo {
@@ -25,6 +25,6 @@
   flex: 1 1 50%;
   padding: 1.72414%;
 }
-
related
@function su-gutter()
$susy
requires
@function susy-compile()
@function su-call()
used by
@function gutter()
@function _susy-svg-offset() [private]
@function susy-slice()
aliased as slice()
Description
Working with asymmetrical grids (un-equal column widths) can be challenging – expecially when they involve fluid/fractional elements. Describing a context of (15em 6em 6em 6em 15em) is a lot to put inside the span or gutter function shorthand. This slice function returns a sub-slice of asymmetrical columns to use for a nested context. slice(3 at 2) will give you a subset of the global grid, spanning 3 columns, starting with the second.
  • This is a thin syntax-sugar shell around the core-math su-slice() function.
  • The un-prefixed alias slice() is available by default.
Parameters & Return
$span: (list)
Shorthand expression to define the subset span, optionally containing:
  • at $n, first, or last location on asymmetrical grids;
  • of $n <spread> for available grid columns and spread of the container
    • Span-counts like of 6 are only valid in the context of symmetrical grids
    • Valid spreads include narrow, wide, or wider
$config: () (map)
Optional map of Susy grid configuration settings. See $susy documentation for details.
@return (list)
Subset list of columns for use for a nested context
Example
scss Return a nested segment of asymmetrical grid
$context: susy-slice(3 at 3 of (1 2 3 5 8));
+
related
@function su-gutter()
$susy
requires
@function susy-compile()
@function su-call()
used by
@function gutter()
@function susy-slice()
aliased as slice()
Description
Working with asymmetrical grids (un-equal column widths) can be challenging – expecially when they involve fluid/fractional elements. Describing a context of (15em 6em 6em 6em 15em) is a lot to put inside the span or gutter function shorthand. This slice function returns a sub-slice of asymmetrical columns to use for a nested context. slice(3 at 2) will give you a subset of the global grid, spanning 3 columns, starting with the second.
  • This is a thin syntax-sugar shell around the core-math su-slice() function.
  • The un-prefixed alias slice() is available by default.
Parameters & Return
$span: (list)
Shorthand expression to define the subset span, optionally containing:
  • at $n, first, or last location on asymmetrical grids;
  • of $n <spread> for available grid columns and spread of the container
    • Span-counts like of 6 are only valid in the context of symmetrical grids
    • Valid spreads include narrow, wide, or wider
$config: () (map)
Optional map of Susy grid configuration settings. See $susy documentation for details.
@return (list)
Subset list of columns for use for a nested context
Example
scss Return a nested segment of asymmetrical grid
$context: susy-slice(3 at 3 of (1 2 3 5 8));
 /* $context: #{$context}; */
css compiled
/* $context: 3 5 8; */
-
related
@function su-slice()
$susy
requires
@function susy-compile()
@function su-call()
used by
@function slice()

\ No newline at end of file
+

related

@function su-slice()

$susy

requires

@function susy-compile()

@function su-call()

used by

@function slice()

\ No newline at end of file diff --git a/.sassdoc/index.html b/.sassdoc/index.html index 0d652012..c3486445 100644 --- a/.sassdoc/index.html +++ b/.sassdoc/index.html @@ -1,4 +1,4 @@ -susy Documentation

susy 3.0.0-alpha.6

Power Tools For The Web

Build Status

Susy is a design-agnostic set of tools for creating powerful, custom layouts. We didn't want another grid system full of rules and restrictions — we wanted a power tool for building our own damn systems. Version Three is trimmed down to it's most basic components — functions that can be used to build any grid system.

"I like the idea of grids-on-demand, rather than a strict framework."
– Chris Coyier, CSS Tricks

"Susy and Zendesk have been getting along magically… It’s precisely what you need and nothing more."
— Stephany Varga, Zendesk

"If you’re interested in reading Sass poetry, be sure to look at Susy’s source code!"
— Hugo Giraudel, SitePoint

Resources

Configuration Overview

Susy3 has 4 core settings, in a single settings map:

// default settings
+susy Documentation
 
susy 3.0.0-beta.1
Power Tools For The Web
npm version
Build Status
Susy is a design-agnostic set of tools for creating powerful, custom layouts. We didn't want another grid system full of rules and restrictions — we wanted a power tool for building our own damn systems. Version Three is trimmed down to it's most basic components — functions that can be used to build any grid system.
"I like the idea of grids-on-demand, rather than a strict framework."
– Chris Coyier, CSS Tricks
"Susy and Zendesk have been getting along magically… It’s precisely what you need and nothing more."
— Stephany Varga, Zendesk
"If you’re interested in reading Sass poetry, be sure to look at Susy’s source code!"
— Hugo Giraudel, SitePoint
Resources
Configuration Overview
Susy3 has 4 core settings, in a single settings map:
// default settings
 $susy: (
   'columns': susy-repeat(4),
   'gutters': 0.25,
@@ -69,7 +69,7 @@
 });
 
Start using Susy:
/* app.scss */
 @import 'susy';
-
Usig Grunt (and Yeoman)
To add Susy to the Sass task, edit your Gruntfile.js at the root level of your project and look for the Sass-related rules. Add require: 'susy' inside the options object:
// Gruntfile.js
+
Using Grunt (and Yeoman)
To add Susy to the Sass task, edit your Gruntfile.js at the root level of your project and look for the Sass-related rules. Add require: 'susy' inside the options object:
// Gruntfile.js
 sass: {
   dist: {
     options: {
@@ -81,13 +81,12 @@
     }
   }
 }
-
Assuming you’ve already installed Susy, it will now be added to the project and will not clash with Yeomans grunt rules.
Start using Susy:
/* app.scss */
+
Assuming you’ve already installed Susy, it will now be added to the project and will not clash with Yeoman's grunt rules.
Start using Susy:
/* app.scss */
 @import 'susy';
-
Undestanding Spread & Container-Spread
Susy3 has two core settings you may not recognize from older versions of Susy: spread and container-spread. Every grid system (especially fluid grids) will have to make a decision about how containers and grid elements spread across adjacent gutters. These were previously defined by the gutter-position setting, but we hope this provides more flexibility and clarity.
  • Both spread settings default to narrow, the most common use-case. A narrow spread only has gutters between columns (one less gutter than columns). This is how all css-native grids work, and most margin-based grid systems.
  • A wide spread includes the same number of gutters as columns, spanning across a single side-gutter. This is how most padding-based grid systems often work, and is also useful for pushing and pulling elements into place.
  • The rare wider spread includes gutters on both sides of the column-span (one more gutters than columns).
Spread Diagram
The spread property describes your target output, while container-spread describes your context, for the sake of fluid grids.
If you are in a "wide" context, that means the parent element contains as many gutters as columns. To describe a "narrow" span inside that "wide" context:
width: span(3 narrow of 6 wide);
 
Plugin: SVG Grid Image
If you want to generate svg-backgrounds for help visualizing and debugging your grids, import the SVG Grid Plugin:
// unprefixed
 @import '<path-to>/susy/sass/plugins/svg-grid';
 
 // prefixed
 @import '<path-to>/susy/sass/plugins/svg-grid/prefix';
 
The plugin adds svg-grid-colors setting to your global defaults, which you can override in $susy. It also provides you with a new function, susy-svg-grid(), which will return inline svg for use in backgrounds or generated content:
background: susy-svg-grid() no-repeat scroll;
-
Susy vs Su
You may notice that some functions have a susy- prefix, while others only have su-. This helps distinguish between the two distinct layers:
  • The core grid-math layer is called Su, and is made up of "pure" functions that expect normalized values. This is useful if you prefer argument-syntax to shorthand syntax, or if you are building your own Susy mixins.
  • The upper Susy layer provides syntax-sugar – global defaults, shorthand-parsing, normalization, and a smaller set of common-use functions that call on the core math as necessary. This is the primary API for most users.

\ No newline at end of file
+

Susy vs Su

You may notice that some functions have a susy- prefix, while others only have su-. This helps distinguish between the two distinct layers:

  • The core grid-math layer is called Su, and is made up of "pure" functions that expect normalized values. This is useful if you prefer argument-syntax to shorthand syntax, or if you are building your own Susy mixins.
  • The upper Susy layer provides syntax-sugar – global defaults, shorthand-parsing, normalization, and a smaller set of common-use functions that call on the core math as necessary. This is the primary API for most users.
\ No newline at end of file diff --git a/.sassdoc/plugin-utils.html b/.sassdoc/plugin-utils.html index cd9fafd1..ddb402d6 100644 --- a/.sassdoc/plugin-utils.html +++ b/.sassdoc/plugin-utils.html @@ -1,4 +1,4 @@ -susy Documentation

susy 3.0.0-alpha.6

@function susy-compile()

Description

Susy's syntax layer has various moving parts, with syntax-parsing for the grid/span shorthand, and normalization for each of the resulting values. The compile function rolls this all together in a single call – for quick access from our internal API functions, or any additional functions and mixins you add to your project. Pass user input and configuration maps to the compiler, and it will hand back a map of values ready for Su. Combine this with the su-call function to quickly parse, normalize, and process grid calculations.

Parameters & Return

$shorthand: (list | map)

Shorthand expression to define the width of the span, optionally containing:

  • a count, length, or column-list span;
  • at $n, first, or last location on asymmetrical grids;
  • narrow, wide, or wider for optionally spreading across adjacent gutters;
  • of $n <spread> for available grid columns and spread of the container (span counts like of 6 are only valid in the context of symmetrical grids);
  • and set-gutters $n to override global gutter settings

$config: null (map)

Optional map of Susy grid configuration settings

$context-only: false (bool)

Allow the parser to ignore span and span-spread values, only parsing context and container-spread

@return (map)

Parsed and normalized map of settings, based on global and local configuration, alongwith shorthad adjustments.

Example

scss
$user-input: 3 wide of susy-repeat(6, 120px) set-gutters 10px;
+susy Documentation
 
susy 3.0.0-beta.1
@function susy-compile()
Description
Susy's syntax layer has various moving parts, with syntax-parsing for the grid/span shorthand, and normalization for each of the resulting values. The compile function rolls this all together in a single call – for quick access from our internal API functions, or any additional functions and mixins you add to your project. Pass user input and configuration maps to the compiler, and it will hand back a map of values ready for Su. Combine this with the su-call function to quickly parse, normalize, and process grid calculations.
Parameters & Return
$shorthand: (list | map)
Shorthand expression to define the width of the span, optionally containing:
  • a count, length, or column-list span;
  • at $n, first, or last location on asymmetrical grids;
  • narrow, wide, or wider for optionally spreading across adjacent gutters;
  • of $n <spread> for available grid columns and spread of the container (span counts like of 6 are only valid in the context of symmetrical grids);
  • and set-gutters $n to override global gutter settings
$config: null (map)
Optional map of Susy grid configuration settings
$context-only: false (bool)
Allow the parser to ignore span and span-spread values, only parsing context and container-spread
@return (map)
Parsed and normalized map of settings, based on global and local configuration, alongwith shorthad adjustments.
Example
scss
$user-input: 3 wide of susy-repeat(6, 120px) set-gutters 10px;
 $grid-data: susy-compile($user-input, $susy);
 
 @each $key, $value in $grid-data {
@@ -16,4 +16,4 @@
 }
css compiled
.su-span {
   width: 390px;
 }
-
related
@function susy-compile()
requires
@function _susy-error() [private]
@function su-span()
@function su-gutter()
@function su-slice()
used by
@function susy-span()
@function susy-gutter()
@function susy-slice()
@function susy-svg-grid()

\ No newline at end of file
+

related

@function susy-compile()

requires

@function _susy-error() [private]

@function su-span()

@function su-gutter()

@function su-slice()

used by

@function susy-span()

@function susy-gutter()

@function susy-slice()

@function susy-svg-grid()

@function _susy-svg-offset() [private]

\ No newline at end of file diff --git a/.sassdoc/plugin_svg-grid.html b/.sassdoc/plugin_svg-grid.html index 9702e64a..fa4e906e 100644 --- a/.sassdoc/plugin_svg-grid.html +++ b/.sassdoc/plugin_svg-grid.html @@ -1 +1 @@ -susy Documentation

susy 3.0.0-alpha.6

@function susy-svg-grid()

aliased as svg-grid()

Description

Return inline svg-data in to display the grid (import plugins/svg-grid/prefix to remove unprefixed alias)

Parameters & Return

$grid: $susy (Map | List)

Map or shorthand defining the current grid

$colors: null (Color | List | null)

Column color, or list of colors for column-gradient, used to override the global svg-grid-colors setting

$offset: null (Length | null)

Manually override the default grid-image offset, to account for grid edges

@return (String)

CSS inline-data SVG string, in url(<svg>) format, for use in image or content properties

requires

@function susy-compile()

@function susy-get()

@function _susy-svg-gradient() [private]

@function _susy-svg-color() [private]

@function su-call()

@function _susy-svg-offset() [private]

@function susy-span()

@function _susy-svg-column-position() [private]

@function _susy-svg-rect() [private]

used by

@function svg-grid()

\ No newline at end of file +susy Documentation

susy 3.0.0-beta.1

@function susy-svg-grid()

aliased as svg-grid()

Description

Return inline svg-data in to display the grid (import plugins/svg-grid/prefix to remove unprefixed alias)

Parameters & Return

$grid: $susy (Map | List)

Map or shorthand defining the current grid

$colors: null (Color | List | null)

Column color, or list of colors for column-gradient, used to override the global svg-grid-colors setting

$offset: null (Length | null)

Manually override the default grid-image offset, to account for grid edges

@return (String)

CSS inline-data SVG string, in url(<svg>) format, for use in image or content properties

requires

@function susy-compile()

@function susy-get()

@function _susy-svg-gradient() [private]

@function _susy-svg-color() [private]

@function su-call()

@function _susy-svg-offset() [private]

@function susy-span()

@function _susy-svg-column-position() [private]

@function _susy-svg-rect() [private]

used by

@function svg-grid()

\ No newline at end of file diff --git a/.sassdoc/su-math.html b/.sassdoc/su-math.html index e570e53e..73ad4eaa 100644 --- a/.sassdoc/su-math.html +++ b/.sassdoc/su-math.html @@ -1 +1 @@ -susy Documentation

susy 3.0.0-alpha.6

@function su-span()

Description

Calculates and returns a CSS-ready span width, based on normalized span and context data – a low-level version of susy-span, with all of the logic and none of the syntax sugar.

  • Grids defined with unitless numbers will return % values.
  • Grids defined with comparable units will return a value in the units provided.
  • Grids defined with a mix of units, or a combination of untiless numbers and unit-lengths, will return a calc() string.

Parameters & Return

$span: (number | list)

Number or list of grid columns to span

$columns: (list)

List of columns available

$gutters: (number)

Width of a gutter in column-comparable units

$spread: (0 | 1 | -1)

Number of gutters spanned, relative to span count

$container-spread: $spread (0 | 1 | -1)

Number of gutters spanned, relative to columns count

$location: 1 (integer)

Optional position of sub-span among full set of columns

@return (length)

Relative or static length of a span on the grid

related

@function susy-span()

requires

@function su-valid-span()

@function su-valid-columns()

@function su-valid-gutters()

@function su-valid-spread()

@function su-valid-location()

@function su-slice()

@function _su-needs-calc-output() [private]

@function _su-calc-span() [private]

@function _su-sum() [private]

used by

@function su-call()

@function su-gutter()

Description

Calculates and returns a CSS-ready gutter width, based on normalized grid data – a low-level version of susy-gutter, with all of the logic and none of the syntax sugar.

  • Grids defined with unitless numbers will return % values.
  • Grids defined with comparable units will return a value in the units provided.
  • Grids defined with a mix of units, or a combination of untiless numbers and unit-lengths, will return a calc() string.

Parameters & Return

$columns: (list)

List of columns in the grid

$gutters: (number)

Width of a gutter in column-comparable units

$container-spread: (0 | 1 | -1)

Number of gutters spanned, relative to columns count

@return (length)

Relative or static length of one gutter in a grid

related

@function susy-gutter()

requires

@function _su-needs-calc-output() [private]

@function _su-calc-span() [private]

@function _su-sum() [private]

used by

@function su-call()

@function su-slice()

Description

Returns a list of columns based on a given span/location slice of the grid – a low-level version of susy-slice, with all of the logic and none of the syntax sugar.

Parameters & Return

$span: (number)

Number of grid columns to span

$columns: (list)

List of columns in the grid

$location: 1 (number)

Starting index of a span in the list of columns

$validate: true (bool)

Check that arguments are valid before proceeding

@return (list)

Subset list of grid columns, based on span and location

related

@function susy-slice()

requires

@function su-valid-columns()

@function su-valid-location()

used by

@function su-call()

@function su-span()

\ No newline at end of file +susy Documentation

susy 3.0.0-beta.1

@function su-span()

Description

Calculates and returns a CSS-ready span width, based on normalized span and context data – a low-level version of susy-span, with all of the logic and none of the syntax sugar.

  • Grids defined with unitless numbers will return % values.
  • Grids defined with comparable units will return a value in the units provided.
  • Grids defined with a mix of units, or a combination of untiless numbers and unit-lengths, will return a calc() string.

Parameters & Return

$span: (number | list)

Number or list of grid columns to span

$columns: (list)

List of columns available

$gutters: (number)

Width of a gutter in column-comparable units

$spread: (0 | 1 | -1)

Number of gutters spanned, relative to span count

$container-spread: $spread (0 | 1 | -1)

Number of gutters spanned, relative to columns count

$location: 1 (integer)

Optional position of sub-span among full set of columns

@return (length)

Relative or static length of a span on the grid

related

@function susy-span()

requires

@function su-valid-span()

@function su-valid-columns()

@function su-valid-gutters()

@function su-valid-spread()

@function su-valid-location()

@function su-slice()

@function _su-needs-calc-output() [private]

@function _su-calc-span() [private]

@function _su-sum() [private]

used by

@function su-call()

@function su-gutter()

Description

Calculates and returns a CSS-ready gutter width, based on normalized grid data – a low-level version of susy-gutter, with all of the logic and none of the syntax sugar.

  • Grids defined with unitless numbers will return % values.
  • Grids defined with comparable units will return a value in the units provided.
  • Grids defined with a mix of units, or a combination of untiless numbers and unit-lengths, will return a calc() string.

Parameters & Return

$columns: (list)

List of columns in the grid

$gutters: (number)

Width of a gutter in column-comparable units

$container-spread: (0 | 1 | -1)

Number of gutters spanned, relative to columns count

@return (length)

Relative or static length of one gutter in a grid

related

@function susy-gutter()

requires

@function _su-needs-calc-output() [private]

@function _su-calc-span() [private]

@function _su-sum() [private]

used by

@function su-call()

@function su-slice()

Description

Returns a list of columns based on a given span/location slice of the grid – a low-level version of susy-slice, with all of the logic and none of the syntax sugar.

Parameters & Return

$span: (number)

Number of grid columns to span

$columns: (list)

List of columns in the grid

$location: 1 (number)

Starting index of a span in the list of columns

$validate: true (bool)

Check that arguments are valid before proceeding

@return (list)

Subset list of grid columns, based on span and location

related

@function susy-slice()

requires

@function su-valid-columns()

@function su-valid-location()

used by

@function su-call()

@function su-span()

\ No newline at end of file diff --git a/.sassdoc/x--validation.html b/.sassdoc/x--validation.html index 37c8bb38..62ce2455 100644 --- a/.sassdoc/x--validation.html +++ b/.sassdoc/x--validation.html @@ -1 +1 @@ -susy Documentation

susy 3.0.0-alpha.6

@function su-valid-span()

Description

Check that the span argument is a number, length, or column-list

Parameters & Return

$span: (number | list)

Number of columns, or length of span

@return (number | list)

Validated $span number, length, or columns list

@error

when span value is not a number, or valid column list

requires

@function su-valid-columns()

@function _susy-error() [private]

used by

@function su-span()

@function _su-sum() [private]

@function _su-calc-span() [private]

@function _su-calc-sum() [private]

@function _su-needs-calc-output() [private]

@function su-valid-columns()

Description

Check that the columns argument is a valid list of column-lengths

Parameters & Return

$columns: (list)

List of column-lengths

$silent-failure: true (bool)

Set false to return null on failure

@return (list)

Validated $columns list

@error

when column value is not a valid list of numbers

requires

@function _susy-error() [private]

used by

@function su-span()

@function su-slice()

@function _su-calc-span() [private]

@function _su-needs-calc-output() [private]

@function _susy-svg-offset() [private]

@function su-valid-span()

@function susy-parse()

@function su-valid-gutters()

Description

Check that the gutters argument is a valid number

Parameters & Return

$gutters: (number)

Width of a gutter

@return (number)

Validated $gutters number

@error

when gutter value is not a number

requires

@function _susy-error() [private]

used by

@function su-span()

@function _su-sum() [private]

@function _su-calc-span() [private]

@function _su-calc-sum() [private]

@function _su-needs-calc-output() [private]

@function _susy-svg-offset() [private]

@function su-valid-spread()

Description

Check that the spread argument is a valid intiger between -1 and 1

Parameters & Return

$spread: (0 | 1 | -1)

Number of gutters to include in a span, relative to the number columns

@return (0 | 1 | -1)

Validated $spread number

@error

when spread value is not a valid spread

requires

@function _susy-error() [private]

used by

@function su-span()

@function _su-sum() [private]

@function _su-calc-span() [private]

@function _su-calc-sum() [private]

@function _susy-svg-offset() [private]

@function su-valid-location()

Description

Check that the location argument is a valid number, within the scope of available columns

Parameters & Return

$span: (number)

Number of grid-columns to be spanned

$location: (integer | string)

Starting (1-indexed) column-position of that span

$columns: (list)

List of available columns in the grid

@return (integer)

Validated $location intiger

@error

when location value is not a valid index, given the context and span.

requires

@function _susy-error() [private]

used by

@function su-span()

@function su-slice()

\ No newline at end of file +susy Documentation

susy 3.0.0-beta.1

@function su-valid-span()

Description

Check that the span argument is a number, length, or column-list

Parameters & Return

$span: (number | list)

Number of columns, or length of span

@return (number | list)

Validated $span number, length, or columns list

@error

when span value is not a number, or valid column list

requires

@function su-valid-columns()

@function _susy-error() [private]

used by

@function su-span()

@function _su-sum() [private]

@function _su-calc-span() [private]

@function _su-calc-sum() [private]

@function _su-needs-calc-output() [private]

@function su-valid-columns()

Description

Check that the columns argument is a valid list of column-lengths

Parameters & Return

$columns: (list)

List of column-lengths

$silent-failure: true (bool)

Set false to return null on failure

@return (list)

Validated $columns list

@error

when column value is not a valid list of numbers

requires

@function _susy-error() [private]

used by

@function su-span()

@function su-slice()

@function _su-calc-span() [private]

@function _su-needs-calc-output() [private]

@function _susy-svg-offset() [private]

@function su-valid-span()

@function susy-parse()

@function su-valid-gutters()

Description

Check that the gutters argument is a valid number

Parameters & Return

$gutters: (number)

Width of a gutter

@return (number)

Validated $gutters number

@error

when gutter value is not a number

requires

@function _susy-error() [private]

used by

@function su-span()

@function _su-sum() [private]

@function _su-calc-span() [private]

@function _su-calc-sum() [private]

@function _su-needs-calc-output() [private]

@function _susy-svg-offset() [private]

@function su-valid-spread()

Description

Check that the spread argument is a valid intiger between -1 and 1

Parameters & Return

$spread: (0 | 1 | -1)

Number of gutters to include in a span, relative to the number columns

@return (0 | 1 | -1)

Validated $spread number

@error

when spread value is not a valid spread

requires

@function _susy-error() [private]

used by

@function su-span()

@function _su-sum() [private]

@function _su-calc-span() [private]

@function _su-calc-sum() [private]

@function _susy-svg-offset() [private]

@function su-valid-location()

Description

Check that the location argument is a valid number, within the scope of available columns

Parameters & Return

$span: (number)

Number of grid-columns to be spanned

$location: (integer | string)

Starting (1-indexed) column-position of that span

$columns: (list)

List of available columns in the grid

@return (integer)

Validated $location intiger

@error

when location value is not a valid index, given the context and span.

requires

@function _susy-error() [private]

used by

@function su-span()

@function su-slice()

\ No newline at end of file diff --git a/.sassdoc/x-normal.html b/.sassdoc/x-normal.html index 6a945221..5a26db4b 100644 --- a/.sassdoc/x-normal.html +++ b/.sassdoc/x-normal.html @@ -1 +1 @@ -susy Documentation

susy 3.0.0-alpha.6

@function susy-normalize()

Description

Normalize the values in a configuration map. In addition to the global $susy properties, this map can include local span-related imformation, like span and location.

Normalization does not check that values are valid, which will happen in the Su math layer. These functions merely look for known Susy syntax – returning a map with those shorthand values converted into low-level data for Su. For example span: all and location: first will be converted into specific numbers.

Parameters & Return

$config: (map)

Map of Susy configuration settings to normalize. See $susy and susy-parse() documentation for details.

$context: null (map | null)

Map of Susy configuration settings to use as global reference, or null to use global settings.

@return (map)

Map of Susy configuration settings, with all values normalized for Su math functions.

related

$susy

@function susy-parse()

used by

@function susy-compile()

@function susy-normalize-span()

Description

Normalize span shorthand for Su. Su span syntax allows an explicit length (e.g. 3em), unitless column-span number (e.g. 3 columns), or an explicit list of columns (e.g. (3 5 8)).

Susy span syntax also allows the all keyword, which will be converted to a slice of the context in normalization.

Parameters & Return

$span: (number | list | 'all')

Span value to normalize.

$columns: (list)

Normalized list of columns in the grid

@return (number | list)

Number or list value for $span

used by

@function susy-normalize()

@function susy-normalize-columns()

Description

Normalize column shorthand for Su. Su column syntax only allows column lists (e.g. 120px 1 1 1 120px).

Susy span syntax also allows a unitless slice number (e.g of 5), which will be converted to a slice of the context in normalization.

Parameters & Return

$columns: (list | integer)

List of available columns, or unitless integer representing a slice of the available context.

$context: null (map | null)

Map of Susy configuration settings to use as global reference, or null to access global settings.

@return (list)

Columns list value, normalized for Su input.

@error

when attempting to access a slice of asymmetrical context

requires

@function susy-settings()

@function _susy-flatten() [private]

@function susy-repeat()

@function _susy-error() [private]

used by

@function susy-normalize()

@function susy-normalize-spread()

Description

Normalize spread shorthand for Su. Su spread syntax only allows the numbers -1, 0, or 1 – representing the number of gutters covered in relation to columns spanned.

Susy spread syntax also allows keywords for each value – narrow for -1, wide for 0, or wider for 1 – which will be converted to their respective integers in normalization.

Parameters & Return

$spread: (0 | 1 | -1 | 'narrow' | 'wide' | 'wider')

Spread across adjacent gutters, relative to a column-count — either narrow (-1), wide (0), or wider (1)

@return (number)

Numeric value for $spread

used by

@function susy-normalize()

@function susy-normalize-location()

Description

Normalize location shorthand for Su. Su location syntax requires the (1-indexed) number for a column.

Susy also allows the first and last keywords, where first is always 1, and last is calculated based on span and column values. Both keywords are normalized into an integer index in normalization.

Parameters & Return

$span: (number)

Number of grid-columns to be spanned

$location: (integer | 'first' | 'last')

Starting (1-indexed) column position of a span, or a named location keyword.

$columns: (list)

Already-normalized list of columns in the grid.

@return (integer)

Numeric value for $location

used by

@function susy-normalize()

\ No newline at end of file +susy Documentation

susy 3.0.0-beta.1

@function susy-normalize()

Description

Normalize the values in a configuration map. In addition to the global $susy properties, this map can include local span-related imformation, like span and location.

Normalization does not check that values are valid, which will happen in the Su math layer. These functions merely look for known Susy syntax – returning a map with those shorthand values converted into low-level data for Su. For example span: all and location: first will be converted into specific numbers.

Parameters & Return

$config: (map)

Map of Susy configuration settings to normalize. See $susy and susy-parse() documentation for details.

$context: null (map | null)

Map of Susy configuration settings to use as global reference, or null to use global settings.

@return (map)

Map of Susy configuration settings, with all values normalized for Su math functions.

related

$susy

@function susy-parse()

used by

@function susy-compile()

@function susy-normalize-span()

Description

Normalize span shorthand for Su. Su span syntax allows an explicit length (e.g. 3em), unitless column-span number (e.g. 3 columns), or an explicit list of columns (e.g. (3 5 8)).

Susy span syntax also allows the all keyword, which will be converted to a slice of the context in normalization.

Parameters & Return

$span: (number | list | 'all')

Span value to normalize.

$columns: (list)

Normalized list of columns in the grid

@return (number | list)

Number or list value for $span

used by

@function susy-normalize()

@function susy-normalize-columns()

Description

Normalize column shorthand for Su. Su column syntax only allows column lists (e.g. 120px 1 1 1 120px).

Susy span syntax also allows a unitless slice number (e.g of 5), which will be converted to a slice of the context in normalization.

Parameters & Return

$columns: (list | integer)

List of available columns, or unitless integer representing a slice of the available context.

$context: null (map | null)

Map of Susy configuration settings to use as global reference, or null to access global settings.

@return (list)

Columns list value, normalized for Su input.

@error

when attempting to access a slice of asymmetrical context

requires

@function susy-settings()

@function _susy-flatten() [private]

@function susy-repeat()

@function _susy-error() [private]

used by

@function susy-normalize()

@function susy-normalize-spread()

Description

Normalize spread shorthand for Su. Su spread syntax only allows the numbers -1, 0, or 1 – representing the number of gutters covered in relation to columns spanned.

Susy spread syntax also allows keywords for each value – narrow for -1, wide for 0, or wider for 1 – which will be converted to their respective integers in normalization.

Parameters & Return

$spread: (0 | 1 | -1 | 'narrow' | 'wide' | 'wider')

Spread across adjacent gutters, relative to a column-count — either narrow (-1), wide (0), or wider (1)

@return (number)

Numeric value for $spread

used by

@function susy-normalize()

@function susy-normalize-location()

Description

Normalize location shorthand for Su. Su location syntax requires the (1-indexed) number for a column.

Susy also allows the first and last keywords, where first is always 1, and last is calculated based on span and column values. Both keywords are normalized into an integer index in normalization.

Parameters & Return

$span: (number)

Number of grid-columns to be spanned

$location: (integer | 'first' | 'last')

Starting (1-indexed) column position of a span, or a named location keyword.

$columns: (list)

Already-normalized list of columns in the grid.

@return (integer)

Numeric value for $location

used by

@function susy-normalize()

\ No newline at end of file diff --git a/.sassdoc/x-parser.html b/.sassdoc/x-parser.html index 75de704c..79f7b5b1 100644 --- a/.sassdoc/x-parser.html +++ b/.sassdoc/x-parser.html @@ -1 +1 @@ -susy Documentation

susy 3.0.0-alpha.6

@function susy-parse()

Description

The parse function provides all the syntax-sugar in Susy, converting user shorthand into a usable map of keys and values that can be normalized and passed to Su.

Parameters & Return

$shorthand: (list)

Shorthand expression to define the width of the span, optionally containing:

  • a count, length, or column-list span;
  • at $n, first, or last location on asymmetrical grids;
  • narrow, wide, or wider for optionally spreading across adjacent gutters;
  • of $n <spread> for available grid columns and spread of the container (span counts like of 6 are only valid in the context of symmetrical grids);
  • and set-gutters $n to override global gutter settings

$context-only: false (bool)

Allow the parser to ignore span and span-spread values, only parsing context and container-spread. This makes it possible to accept spanless values, like the gutters() syntax. When parsing context-only, the of indicator is optional.

@return (map)

Map of span and grid settings parsed from shorthand input – including all the properties available globally – columns, gutters, spread, container-spread – along with the span-specific properties span, and location.

@error

when a shorthand value is not recognized

related

$susy

requires

@function su-valid-columns()

@function _susy-error() [private]

used by

@function susy-compile()

\ No newline at end of file +susy Documentation

susy 3.0.0-beta.1

@function susy-parse()

Description

The parse function provides all the syntax-sugar in Susy, converting user shorthand into a usable map of keys and values that can be normalized and passed to Su.

Parameters & Return

$shorthand: (list)

Shorthand expression to define the width of the span, optionally containing:

  • a count, length, or column-list span;
  • at $n, first, or last location on asymmetrical grids;
  • narrow, wide, or wider for optionally spreading across adjacent gutters;
  • of $n <spread> for available grid columns and spread of the container (span counts like of 6 are only valid in the context of symmetrical grids);
  • and set-gutters $n to override global gutter settings

$context-only: false (bool)

Allow the parser to ignore span and span-spread values, only parsing context and container-spread. This makes it possible to accept spanless values, like the gutters() syntax. When parsing context-only, the of indicator is optional.

@return (map)

Map of span and grid settings parsed from shorthand input – including all the properties available globally – columns, gutters, spread, container-spread – along with the span-specific properties span, and location.

@error

when a shorthand value is not recognized

related

$susy

requires

@function su-valid-columns()

@function _susy-error() [private]

used by

@function susy-compile()

\ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 62a01a00..451218d7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,8 +2,8 @@ Changelog ========= -3.0.0-alpha.7 - UNRELEASED --------------------------- +3.0.0-beta.1 - June 19, 2017 +---------------------------- - BREAKING: `_prefix.scss` has been renamed `_susy-prefix.scss` for clarity when importing. diff --git a/README.md b/README.md index 9dae7686..ea1e57d5 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ Power Tools For The Web ======================= +[![npm version](https://badge.fury.io/js/susy.svg)](https://badge.fury.io/js/susy)
[![Build Status](https://travis-ci.org/oddbird/susy.png?branch=threeish)](https://travis-ci.org/oddbird/susy) Susy is a design-agnostic set of tools diff --git a/package.json b/package.json index b151eb83..703136bd 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "susy", - "version": "3.0.0-alpha.6", + "version": "3.0.0-beta.1", "description": "Sass power-tools for web layout.", "homepage": "http://susy.oddbird.net", "author": "Miriam Eric Suzanne ", @@ -14,7 +14,7 @@ "sass-lint": "^1.10.2", "sass-true": "^3.0.0-beta.1", "sassdoc": "^2.2.2", - "sassdoc-theme-herman": "^1.0.0-alpha.5", + "sassdoc-theme-herman": "^1.0.0-alpha.7", "sassdocify": "^0.3.4" }, "keywords": [ diff --git a/yarn.lock b/yarn.lock index 31689f91..2052ac80 100644 --- a/yarn.lock +++ b/yarn.lock @@ -2518,9 +2518,9 @@ sassdoc-theme-default@^2.5.2: swig "1.4.0" swig-extras "0.0.1" -sassdoc-theme-herman@^1.0.0-alpha.5: - version "1.0.0-alpha.5" - resolved "https://registry.yarnpkg.com/sassdoc-theme-herman/-/sassdoc-theme-herman-1.0.0-alpha.5.tgz#a340a24a12d88ab7d565695a56d5dd6a478a914d" +sassdoc-theme-herman@^1.0.0-alpha.7: + version "1.0.0-alpha.7" + resolved "https://registry.yarnpkg.com/sassdoc-theme-herman/-/sassdoc-theme-herman-1.0.0-alpha.7.tgz#c601534c92e5bf22b5bbe74eba0204911dcb7f59" dependencies: bluebird "^3.4.6" extend "^3.0.0"