diff options
| -rw-r--r-- | docs/_data/breakpoints.yml | 29 | ||||
| -rw-r--r-- | docs/_data/nav.yml | 1 | ||||
| -rw-r--r-- | docs/utilities/flexbox.md | 196 | ||||
| -rw-r--r-- | scss/utilities/_flex.scss | 42 |
4 files changed, 268 insertions, 0 deletions
diff --git a/docs/_data/breakpoints.yml b/docs/_data/breakpoints.yml new file mode 100644 index 000000000..3c8cfe293 --- /dev/null +++ b/docs/_data/breakpoints.yml @@ -0,0 +1,29 @@ +- breakpoint: xs + abbr: "" + name: Extra small + min-width: 0px + container: "" + +- breakpoint: sm + abbr: -sm + name: Small + min-width: 576px + container: 540px + +- breakpoint: md + abbr: -md + name: Medium + min-width: 768px + container: 720px + +- breakpoint: lg + abbr: -lg + name: Large + min-width: 992px + container: 960px + +- breakpoint: xl + abbr: -xl + name: Extra large + min-width: 1200px + container: 1140px diff --git a/docs/_data/nav.yml b/docs/_data/nav.yml index 6723352f4..256e1bb9d 100644 --- a/docs/_data/nav.yml +++ b/docs/_data/nav.yml @@ -56,6 +56,7 @@ - title: Clearfix - title: Close icon - title: Colors + - title: Flexbox - title: Display property - title: Image replacement - title: Invisible content diff --git a/docs/utilities/flexbox.md b/docs/utilities/flexbox.md new file mode 100644 index 000000000..324bfa2f0 --- /dev/null +++ b/docs/utilities/flexbox.md @@ -0,0 +1,196 @@ +--- +layout: docs +title: Flexbox +group: utilities +--- + +Quickly manage the layout, alignment, and sizing of grid columns, navigation, components, and more with a full suite of responsive flexbox utilities. For more complex implementations, custom CSS may be necessary. + +## Contents + +* Will be replaced with the ToC, excluding the "Contents" header +{:toc} + +## Enable flex behaviors + +Apply `display` utilities to create a flexbox container and transform **direct children elements** into flex items. Flex containers and items are able to be modified further with additional flex properties. Choose from the following options. + +| Class | property: value; | Description | +| --- | --- | --- | +| `.d-flex` | `display: flex;` | Creates a block-level element using the flexbox model. | +| `.d-inline-flex` | `display: inline-flex;` | Creates an inline-level element using the flexbox model. | + +{% example html %} +<div class="d-flex p-2 bd-highlight">I'm a flexbox container!</div> +{% endexample %} + +{% example html %} +<div class="d-inline-flex p-2 bd-highlight">I'm an inline flexbox container!</div> +{% endexample %} + +Responsive variations also exist for `.d-flex` and `.d-inline-flex`. + +<table class="table-responsive"> + <thead> + <tr class="bg-faded"> + <th>Class</th> + <th>Description</th> + </tr> + </thead> + <tbody> + {% for bp in site.data.breakpoints %} + <tr> + <td> + <code>.d{{ bp.abbr }}-flex</code> + </td> + <td> + Sets <code>display: flex;</code> on viewports {{ bp.min-width }} wide and up + </td> + </tr> + {% endfor %} + {% for bp in site.data.breakpoints %} + <tr> + <td> + <code>.d{{ bp.abbr }}-inline-flex</code> + </td> + <td> + Sets <code>display: inline-flex;</code> on viewports {{ bp.min-width }} wide and up + </td> + </tr> + {% endfor %} + </tbody> +</table> + +## Direction + +Set the direction of flex items in a flex container with direction utilities. In most cases you can omit the horizontal class here as the browser default is `row`. However, you may encounter situations where you needed to explicitly set this value (like responsive layouts). + +Use `.flex-row` to set a horizontal direction. + +{% example html %} +<div class="d-flex flex-row bd-highlight"> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> +</div> +{% endexample %} + +Use `.flex-column` to set a vertical direction. + +{% example html %} +<div class="d-flex flex-column bd-highlight"> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> +</div> +{% endexample %} + +Responsive variations also exist for `.flex-row` and `.flex-column`. + +<table class="table-responsive"> + <thead> + <tr class="bg-faded"> + <th>Class</th> + <th>Description</th> + </tr> + </thead> + <tbody> + {% for bp in site.data.breakpoints %} + <tr> + <td> + <code>.flex{{ bp.abbr }}-row</code> + </td> + <td> + Sets <code>flex-direction: row;</code> on viewports {{ bp.min-width }} wide and up + </td> + </tr> + {% endfor %} + {% for bp in site.data.breakpoints %} + <tr> + <td> + <code>.flex{{ bp.abbr }}-column</code> + </td> + <td> + Sets <code>flex-direction: column;</code> on viewports {{ bp.min-width }} wide and up + </td> + </tr> + {% endfor %} + </tbody> +</table> + +## Wrap + +Change how flex items wrap in a flex container. Choose from no wrapping at all (the browser default) with `.flex-nowrap`, or enable wrapping with `.flex-wrap`. + +{% example html %} +<div class="d-flex flex-nowrap bd-highlight"> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +<div class="p-2 bd-highlight">Flex item</div> +</div> +{% endexample %} + +{% example html %} +<div class="d-flex flex-wrap bd-highlight"> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> + <div class="p-2 bd-highlight">Flex item</div> +</div> +{% endexample %} + +Responsive variations also exist for `.flex-nowrap` and `.flex-wrap`. + +<table class="table-responsive"> + <thead> + <tr class="bg-faded"> + <th>Class</th> + <th>Description</th> + </tr> + </thead> + <tbody> + {% for bp in site.data.breakpoints %} + <tr> + <td> + <code>.flex{{ bp.abbr }}-nowrap</code> + </td> + <td> + Sets <code>flex-wrap: nowrap;</code> on viewports {{ bp.min-width }} wide and up + </td> + </tr> + {% endfor %} + {% for bp in site.data.breakpoints %} + <tr> + <td> + <code>.flex{{ bp.abbr }}-wrap</code> + </td> + <td> + Sets <code>flex-wrap: wrap;</code> on viewports {{ bp.min-width }} wide and up + </td> + </tr> + {% endfor %} + </tbody> +</table> diff --git a/scss/utilities/_flex.scss b/scss/utilities/_flex.scss index 4d13e9f8c..c9783c2c8 100644 --- a/scss/utilities/_flex.scss +++ b/scss/utilities/_flex.scss @@ -27,5 +27,47 @@ .flex-items#{$infix}-right { justify-content: flex-end; } .flex-items#{$infix}-around { justify-content: space-around; } .flex-items#{$infix}-between { justify-content: space-between; } + + // + // New flex utils to replace and extend the ones above + // + + .flex#{$infix}-fill { flex: 1 1 auto; } + .flex#{$infix}-justify { flex: 1 1 100%; } + + .flex#{$infix}-row { flex-direction: row !important; } + .flex#{$infix}-column { flex-direction: column !important; } + + .flex#{$infix}-wrap { flex-wrap: wrap !important; } + .flex#{$infix}-nowrap { flex-wrap: nowrap !important; } + + .justify-content#{$infix}-start { justify-content: flex-start !important; } + .justify-content#{$infix}-end { justify-content: flex-end !important; } + .justify-content#{$infix}-center { justify-content: center !important; } + .justify-content#{$infix}-between { justify-content: space-between !important; } + .justify-content#{$infix}-around { justify-content: space-around !important; } + + .align-items#{$infix}-start { align-items: flex-start !important; } + .align-items#{$infix}-end { align-items: flex-end !important; } + .align-items#{$infix}-center { align-items: center !important; } + .align-items#{$infix}-baseline { align-items: baseline !important; } + .align-items#{$infix}-stretch { align-items: stretch !important; } + + .align-content#{$infix}-start { align-content: flex-start !important; } + .align-content#{$infix}-end { align-content: flex-end !important; } + .align-content#{$infix}-center { align-content: center !important; } + .align-content#{$infix}-between { align-content: space-between !important; } + .align-content#{$infix}-around { align-content: space-around !important; } + .align-content#{$infix}-stretch { align-content: stretch !important; } + + // Item + .flex#{$infix}-auto { flex: 1 1 auto !important; } + + .align-self#{$infix}-auto { align-self: auto !important; } + .align-self#{$infix}-start { align-self: flex-start !important; } + .align-self#{$infix}-end { align-self: flex-end !important; } + .align-self#{$infix}-center { align-self: center !important; } + .align-self#{$infix}-baseline { align-self: baseline !important; } + .align-self#{$infix}-stretch { align-self: stretch !important; } } } |