Merge branch 'v4-dev' into v4-navbars

1 files changed, 69 insertions, 0 deletions

diff --git a/docs/utilities/spacing.md b/docs/utilities/spacing.md
new file mode 100644
index 000000000..1ee1ab7fb
--- /dev/null
+++ b/docs/utilities/spacing.md
@@ -0,0 +1,69 @@
+---
+layout: docs
+title: Spacing
+group: utilities
+---
+
+Assign `margin` or `padding` to an element or a subset of its sides with shorthand classes. Includes support for individual properties, all properties, and vertical and horizontal properties. All classes are multiples on the global default value, `1rem`.
+
+The classes are named using the format: `{property}{sides}-{size}`
+
+Where *property* is one of:
+
+* `m` - for classes that set `margin`
+* `p` - for classes that set `padding`
+
+Where *sides* is one of:
+
+* `t` - for classes that set `margin-top` or `padding-top`
+* `b` - for classes that set `margin-bottom` or `padding-bottom`
+* `l` - for classes that set `margin-left` or `padding-left`
+* `r` - for classes that set `margin-right` or `padding-right`
+* `x` - for classes that set both `*-left` and `*-right`
+* `y` - for classes that set both `*-top` and `*-bottom`
+* `a` - for classes that set a `margin` or `padding` on all 4 sides of the element
+
+Where *size* is one of:
+
+* `0` - for classes that eliminate the `margin` or `padding` by setting it to `0`
+* `1` - (by default) for classes that set the `margin` or `padding` to `$spacer-x` or `$spacer-y`
+* `2` - (by default) for classes that set the `margin` or `padding` to `$spacer-x * 1.5` or `$spacer-y * 1.5`
+* `3` - (by default) for classes that set the `margin` or `padding` to `$spacer-x * 3` or `$spacer-y * 3`
+
+(You can add more sizes by adding entries to the `$spacers` Sass map variable.)
+
+Here are some representative examples of these classes:
+
+{% highlight scss %}
+.mt-0 {
+  margin-top: 0 !important;
+}
+
+.ml-1 {
+  margin-left: $spacer-x !important;
+}
+
+.px-2 {
+  padding-left: ($spacer-x * 1.5) !important;
+  padding-right: ($spacer-x * 1.5) !important;
+}
+
+.p-3 {
+  padding: ($spacer-y * 3) ($spacer-x * 3) !important;
+}
+{% endhighlight %}
+
+### Horizontal centering
+Additionally, Bootstrap also includes an `.mx-auto` class for horizontally centering fixed-width block level content by setting the horizontal margins to `auto`.
+
+<div class="bd-example">
+  <div class="mx-auto" style="width: 200px; background-color: rgba(86,61,124,.15);">
+    Centered element
+  </div>
+</div>
+
+{% highlight html %}
+<div class="mx-auto" style="width: 200px;">
+  Centered element
+</div>
+{% endhighlight %}