kotovalexarian-likes-github/twbs--bootstrap
1
0
Fork 0
mirror of https://github.com/twbs/bootstrap.git synced 2022-11-09 12:25:43 -05:00
Code Releases Activity

Update docs for spacing utilities themselves to account for #18185

Browse source 
/fyi @mdo There might be prettier/better ways of explaining these,
        but for the sake of having accurate docs for tomorrow,
        this should do in a pinch.

[skip sauce]
This commit is contained in:
Chris Rebert 2015-12-08 04:13:15 -08:00
parent 85032786c3
commit 3b2be4701f
1 changed files with 34 additions and 64 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

98
docs/components/utilities.md
View file

@ -15,78 +15,48 @@ Bootstrap includes dozens of utilities—classes with a single purpose. They're
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`. 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`.
### Margin The classes are named using the format: `{property}-{sides}-{size}`
{% highlight scss %} Where *property* is one of:
.m-a-0 { margin: 0 !important; } * `m` - for classes that set `margin`
.m-t-0 { margin-top: 0 !important; } * `p` - for classes that set `padding`
.m-r-0 { margin-right: 0 !important; }
.m-b-0 { margin-bottom: 0 !important; }
.m-l-0 { margin-left: 0 !important; }
.m-x-0 { margin-right: 0 !important; margin-left: 0 !important; }
.m-y-0 { margin-top: 0 !important; margin-bottom: 0 !important; }
.m-a { margin: $spacer !important; } Where *sides* is one of:
.m-t { margin-top: $spacer-y !important; } * `t` - for classes that set `margin-top` or `padding-top`
.m-r { margin-right: $spacer-x !important; } * `b` - for classes that set `margin-bottom` or `padding-bottom`
.m-b { margin-bottom: $spacer-y !important; } * `l` - for classes that set `margin-left` or `padding-left`
.m-l { margin-left: $spacer-x !important; } * `r` - for classes that set `margin-right` or `padding-right`
.m-x { margin-right: $spacer-x !important; margin-left: $spacer-x !important; } * `x` - for classes that set both `*-left` and `*-right`
.m-y { margin-top: $spacer-y !important; margin-bottom: $spacer-y !important; } * `y` - for classes that set both `*-top` and `*-bottom`
.m-x-auto { margin-right: auto !important; margin-left: auto !important; } * `a` - for classes that set a `margin` or `padding` on all 4 sides of the element
.m-a-md { margin: ($spacer * 1.5) !important; } Where *size* is one of:
.m-t-md { margin-top: ($spacer-y * 1.5) !important; } * `0` - for classes that eliminate the `margin` or `padding` by setting it to `0`
.m-r-md { margin-right: ($spacer-y * 1.5) !important; } * `1` - (by default) for classes that set the `margin` or `padding` to `$spacer-x` or `$spacer-y`
.m-b-md { margin-bottom: ($spacer-y * 1.5) !important; } * `2` - (by default) for classes that set the `margin` or `padding` to `$spacer-x * 1.5` or `$spacer-y * 1.5`
.m-l-md { margin-left: ($spacer-y * 1.5) !important; } * `3` - (by default) for classes that set the `margin` or `padding` to `$spacer-x * 3` or `$spacer-y * 3`
.m-x-md { margin-right: ($spacer-x * 1.5) !important; margin-left: ($spacer-x * 1.5) !important; }
.m-y-md { margin-top: ($spacer-y * 1.5) !important; margin-bottom: ($spacer-y * 1.5) !important; }
.m-a-lg { margin: ($spacer * 3) !important; } Here are some representative examples of these classes:
.m-t-lg { margin-top: ($spacer-y * 3) !important; } ```scss
.m-r-lg { margin-right: ($spacer-y * 3) !important; } .m-t-0 {
.m-b-lg { margin-bottom: ($spacer-y * 3) !important; } margin-top: 0 !important;
.m-l-lg { margin-left: ($spacer-y * 3) !important; } }
.m-x-lg { margin-right: ($spacer-x * 3) !important; margin-left: ($spacer-x * 3) !important; }
.m-y-lg { margin-top: ($spacer-y * 3) !important; margin-bottom: ($spacer-y * 3) !important; }
{% endhighlight %}
### Padding .m-l-1 {
margin-left: $spacer-x !important;
}
{% highlight scss %} .p-x-2 {
.p-a-0 { padding: 0 !important; } padding-left: ($spacer-x * 1.5) !important;
.p-t-0 { padding-top: 0 !important; } padding-right: ($spacer-x * 1.5) !important;
.p-r-0 { padding-right: 0 !important; } }
.p-b-0 { padding-bottom: 0 !important; }
.p-l-0 { padding-left: 0 !important; }
.p-x-0 { padding-left: 0 !important; padding-right: 0 !important; }
.p-y-0 { padding-top: 0 !important; padding-bottom: 0 !important; }
.p-a { padding: $spacer !important; } .p-a-3 {
.p-t { padding-top: $spacer-y !important; } padding: ($spacer-y * 3) ($spacer-x * 3) !important;
.p-r { padding-right: $spacer-x !important; } }
.p-b { padding-bottom: $spacer-y !important; } ```
.p-l { padding-left: $spacer-x !important; }
.p-x { padding-right: $spacer-x !important; padding-left: $spacer-x !important; }
.p-y { padding-top: $spacer-y !important; padding-bottom: $spacer-y !important; }
.p-a-md { padding: ($spacer * 1.5) !important; } Additionally, Bootstrap also includes an `.m-x-auto` class which sets the horizontal margins to `auto`.
.p-t-md { padding-top: ($spacer-y * 1.5) !important; }
.p-r-md { padding-right: ($spacer-y * 1.5) !important; }
.p-b-md { padding-bottom: ($spacer-y * 1.5) !important; }
.p-l-md { padding-left: ($spacer-y * 1.5) !important; }
.p-x-md { padding-right: ($spacer-x * 1.5) !important; padding-left: ($spacer-x * 1.5) !important; }
.p-y-md { padding-top: ($spacer-y * 1.5) !important; padding-bottom: ($spacer-y * 1.5) !important; }
.p-a-lg { padding: ($spacer * 3) !important; }
.p-t-lg { padding-top: ($spacer-y * 3) !important; }
.p-r-lg { padding-right: ($spacer-y * 3) !important; }
.p-b-lg { padding-bottom: ($spacer-y * 3) !important; }
.p-l-lg { padding-left: ($spacer-y * 3) !important; }
.p-x-lg { padding-right: ($spacer-x * 3) !important; padding-left: ($spacer-x * 3) !important; }
.p-y-lg { padding-top: ($spacer-y * 3) !important; padding-bottom: ($spacer-y * 3) !important; }
{% endhighlight %}
## Text alignment ## Text alignment