diff options
Diffstat (limited to 'site/content/docs/4.5/utilities/float.md')
-rw-r--r-- | site/content/docs/4.5/utilities/float.md | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/site/content/docs/4.5/utilities/float.md b/site/content/docs/4.5/utilities/float.md new file mode 100644 index 0000000000..be35d729d1 --- /dev/null +++ b/site/content/docs/4.5/utilities/float.md @@ -0,0 +1,60 @@ +--- +layout: docs +title: Float +description: Toggle floats on any element, across any breakpoint, using our responsive float utilities. +group: utilities +toc: true +--- + +## Overview + +These utility classes float an element to the left or right, or disable floating, based on the current viewport size using the [CSS `float` property](https://developer.mozilla.org/en-US/docs/Web/CSS/float). `!important` is included to avoid specificity issues. These use the same viewport breakpoints as our grid system. Please be aware float utilities have no effect on flex items. + +## Classes + +Toggle a float with a class: + +{{< example >}} +<div class="float-left">Float left on all viewport sizes</div><br> +<div class="float-right">Float right on all viewport sizes</div><br> +<div class="float-none">Don't float on all viewport sizes</div> +{{< /example >}} + +## Mixins + +Or by Sass mixin: + +```scss +.element { + @include float-left; +} +.another-element { + @include float-right; +} +.one-more { + @include float-none; +} +``` + +## Responsive + +Responsive variations also exist for each `float` value. + +{{< example >}} +<div class="float-sm-left">Float left on viewports sized SM (small) or wider</div><br> +<div class="float-md-left">Float left on viewports sized MD (medium) or wider</div><br> +<div class="float-lg-left">Float left on viewports sized LG (large) or wider</div><br> +<div class="float-xl-left">Float left on viewports sized XL (extra-large) or wider</div><br> +{{< /example >}} + +Here are all the support classes; + +{{< markdown >}} +{{< float.inline >}} +{{- range $.Site.Data.breakpoints }} +- `.float{{ .abbr }}-left` +- `.float{{ .abbr }}-right` +- `.float{{ .abbr }}-none` +{{- end -}} +{{< /float.inline >}} +{{< /markdown >}} |