diff options
author | Mark Otto <markdotto@gmail.com> | 2017-05-29 08:50:57 +0300 |
---|---|---|
committer | Mark Otto <markd.otto@gmail.com> | 2017-05-30 09:32:28 +0300 |
commit | 3e76d6565603fafa2c85ad81d7b6345c4e279c72 (patch) | |
tree | fad0aa6a4a70cafb4a803bd920d6ae2fa44dc466 /docs/4.0/utilities/spacing.md | |
parent | 32153eb7cba316b873e82cd7b9362c92ca00eddf (diff) |
Rearrange all the docs to allow for a docs/major.minor/ setup
Diffstat (limited to 'docs/4.0/utilities/spacing.md')
-rw-r--r-- | docs/4.0/utilities/spacing.md | 81 |
1 files changed, 81 insertions, 0 deletions
diff --git a/docs/4.0/utilities/spacing.md b/docs/4.0/utilities/spacing.md new file mode 100644 index 0000000000..d6d2d7b540 --- /dev/null +++ b/docs/4.0/utilities/spacing.md @@ -0,0 +1,81 @@ +--- +layout: docs +title: Spacing +description: Bootstrap includes a wide range of shorthand responsive margin and padding utility classes to modify an element's appearance. +group: utilities +toc: true +--- + +## How it works + +Assign responsive-friendly `margin` or `padding` values to an element or a subset of its sides with shorthand classes. Includes support for individual properties, all properties, and vertical and horizontal properties. Classes are built from a default Sass map ranging from `.25rem` to `3rem`. + +## Notation + +Spacing utilities that apply to all breakpoints, from `xs` to `xl`, have no breakpoint abbreviation in them. This is because those classes are applied from `min-width: 0` and up, and thus are not bound by a media query. The remaining breakpoints, however, do include a breakpoint abbreviation. + +The classes are named using the format `{property}{sides}-{size}` for `xs` and `{property}{sides}-{breakpoint}-{size}` for `sm`, `md`, `lg`, and `xl`. + +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` +* blank - 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 * .25` +* `2` - (by default) for classes that set the `margin` or `padding` to `$spacer * .5` +* `3` - (by default) for classes that set the `margin` or `padding` to `$spacer` +* `4` - (by default) for classes that set the `margin` or `padding` to `$spacer * 1.5` +* `5` - (by default) for classes that set the `margin` or `padding` to `$spacer * 3` + +(You can add more sizes by adding entries to the `$spacers` Sass map variable.) + +## Examples + +Here are some representative examples of these classes: + +{% highlight scss %} +.mt-0 { + margin-top: 0 !important; +} + +.ml-1 { + margin-left: ($spacer * .25) !important; +} + +.px-2 { + padding-left: ($spacer * .5) !important; + padding-right: ($spacer * .5) !important; +} + +.p-3 { + padding: $spacer !important; +} +{% endhighlight %} + +### Horizontal centering +Additionally, Bootstrap also includes an `.mx-auto` class for horizontally centering fixed-width block level content—that is, content that has `display: block` and a `width` set—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 %} |