mirror of
https://github.com/twbs/bootstrap.git
synced 2024-12-10 22:24:19 +01:00
0e920ce3f4
With the current docs directory setup, I'm making too many mistakes and have to manually address path changes and directory moves on deploy. This makes for a frustrating experience developing locally and shipping releases. With this PR, we're basically back to the same setup from v3—duplicating the dist directory into our docs directory. Not the most ideal, but very straightforward for me as the release manager.
58 lines
1.7 KiB
Markdown
58 lines
1.7 KiB
Markdown
---
|
|
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 affect on flex items.
|
|
|
|
## Classes
|
|
|
|
Toggle a float with a class:
|
|
|
|
{% capture 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>
|
|
{% endcapture %}
|
|
{% include example.html content=example %}
|
|
|
|
## Mixins
|
|
|
|
Or by Sass mixin:
|
|
|
|
{% highlight scss %}
|
|
.element {
|
|
@include float-left;
|
|
}
|
|
.another-element {
|
|
@include float-right;
|
|
}
|
|
.one-more {
|
|
@include float-none;
|
|
}
|
|
{% endhighlight %}
|
|
|
|
## Responsive
|
|
|
|
Responsive variations also exist for each `float` value.
|
|
|
|
{% capture 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>
|
|
{% endcapture %}
|
|
{% include example.html content=example %}
|
|
|
|
Here are all the support classes;
|
|
|
|
{% for bp in site.data.breakpoints %}
|
|
- `.float{{ bp.abbr }}-left`
|
|
- `.float{{ bp.abbr }}-right`
|
|
- `.float{{ bp.abbr }}-none`{% endfor %}
|