Merge branch 'v4-dev' into v4-navbars

1 files changed, 39 insertions, 0 deletions

diff --git a/docs/utilities/clearfix.md b/docs/utilities/clearfix.md
new file mode 100644
index 000000000..e63ba3cda
--- /dev/null
+++ b/docs/utilities/clearfix.md
@@ -0,0 +1,39 @@
+---
+layout: docs
+title: Clearfix
+group: utilities
+---
+
+Easily clear `float`s by adding `.clearfix` **to the parent element**. Utilizes [the micro clearfix](http://nicolasgallagher.com/micro-clearfix-hack/) as popularized by Nicolas Gallagher. Can also be used as a mixin.
+
+{% highlight html %}
+<div class="clearfix">...</div>
+{% endhighlight %}
+
+{% highlight scss %}
+// Mixin itself
+.clearfix() {
+  &:before,
+  &:after {
+    content: " ";
+    display: table;
+  }
+  &:after {
+    clear: both;
+  }
+}
+
+// Usage as a mixin
+.element {
+  @include clearfix;
+}
+{% endhighlight %}
+
+The following example shows how the clearfix can be used. Without the clearfix the wrapping div would not span around the buttons which would cause a broken layout.
+
+{% example html %}
+<div class="bg-info clearfix">
+  <button class="btn btn-secondary float-xs-left">Example Button pulled left</button>
+  <button class="btn btn-secondary float-xs-right">Example Button pullred right</button>
+</div>
+{% endexample %}